perfmonctl(2)                 System Calls Manual                perfmonctl(2)

NUME
       perfmonctl - interfa<?>a pentru unitatea de monitorizare a
       performan<?>ei IA-64

REZUMAT
       #include <syscall.h>
       #include <perfmon.h>

       long perfmonctl(int fd, int cmd, void arg[.narg], int narg);

       Nota: Nu exista nicio func<?>ie invaluitoare glibc pentru acest apel de
       sistem; consulta<?>i sec<?>iunea ISTORIC.

DESCRIERE
       Apelul de sistem specific IA-64 perfmonctl() ofera o interfa<?>a cu PMU
       (unitatea de monitorizare a performan<?>elor). PMU consta din
       registrele PMD (date de monitorizare a performan<?>elor) <?>i PMC
       (controlul monitorizarii performan<?>elorl), care colecteaza
       statisticile hardware.

       perfmonctl() aplica opera<?>ia cmd la argumentele de intrare
       specificate de arg. Numarul de argumente este definit de narg.
       Argumentul fd specifica contextul perfmon pe care se opereaza.

       Valorile acceptate pentru cmd sunt:

       PFM_CREATE_CONTEXT
              perfmonctl(int fd, PFM_CREATE_CONTEXT, pfarg_context_t *ctxt, 1);
              Stabile<?>te un context.

              Parametrul fd este ignorat. Se creeaza un nou context perfmon,
              dupa cum se specifica in ctxt, iar descriptorul sau de fi<?>ier
              este returnat in ctxt->ctx_fd.

              Descriptorul de fi<?>ier poate fi utilizat in apelurile
              ulterioare la perfmonctl() <?>i poate fi utilizat pentru a citi
              notificarile de evenimente (tip pfm_msg_t) utilizand read(2).
              Descriptorul de fi<?>ier poate fi interogat folosind select(2),
              poll(2) <?>i epoll(7).

              Contextul poate fi distrus prin apelarea close(2) pe
              descriptorul de fi<?>ier.

       PFM_WRITE_PMCS
              perfmonctl(int fd, PFM_WRITE_PMCS, pfarg_reg_t *pmcs, n);
              Stabile<?>te registrele PMC.

       PFM_WRITE_PMDS
              perfmonctl(int fd, PFM_WRITE_PMDS, pfarg_reg_t *pmds, n);
              Stabile<?>te registrele PMD.

       PFM_READ_PMDS
              perfmonctl(int fd, PFM_READ_PMDS, pfarg_reg_t *pmds, n);
              Cite<?>te registrele PMD.

       PFM_START
              perfmonctl(int fd, PFM_START, NULL, 0);
              Porne<?>te monitorizarea.

       PFM_STOP
              perfmonctl(int fd, PFM_STOP, NULL, 0);
              Opre<?>te monitorizarea.

       PFM_LOAD_CONTEXT
              perfmonctl(int fd, PFM_LOAD_CONTEXT, pfarg_load_t *largs, 1);
              Ata<?>eaza contextul la un fir.

       PFM_UNLOAD_CONTEXT
              perfmonctl(int fd, PFM_UNLOAD_CONTEXT, NULL, 0);
              Deta<?>eaza contextul de la un fir.

       PFM_RESTART
              perfmonctl(int fd, PFM_RESTART, NULL, 0);
              Reporne<?>te monitorizarea dupa primirea unei notificari de
              depa<?>ire.

       PFM_GET_FEATURES
              perfmonctl(int fd, PFM_GET_FEATURES, pfarg_features_t *arg, 1);

       PFM_DEBUG
              perfmonctl(int fd, PFM_DEBUG, val, 0);
              Daca val este diferit de zero, se activeaza modul de depanare,
              altfel se dezactiveaza.

       PFM_GET_PMC_RESET_VAL
              perfmonctl(int fd, PFM_GET_PMC_RESET_VAL, pfarg_reg_t *req, n);
              Reini<?>ializeaza registrele PMC la valorile implicite.

VALOAREA RETURNATA
       perfmonctl() returneaza zero atunci cand opera<?>ia este reu<?>ita.  In
       caz de eroare, se returneaza -1, iar errno este configurata pentru a
       indica eroarea.

STANDARDE
       Linux pe IA-64.

ISTORIC
       Adaugat in Linux 2.4; eliminat in Linux 5.10.

       Acest apel de sistem a fost defect timp de mai mul<?>i ani <?>i, in
       cele din urma, a fost eliminat in Linux 5.10.

       glibc nu ofera o func<?>ie de invaluire pentru acest apel de sistem; pe
       nucleele in care exista, apela<?>i-l folosind syscall(2).

CONSULTA<?>I <?>I
       gprof(1)

       Specifica<?>ia interfe<?>ei perfmon2

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.06 31 octombrie 2023                 perfmonctl(2)