NUME

       perfmonctl - interfață pentru unitatea de monitorizare a performanței IA-64

SINOPSIS

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

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

       Nota:  Nu  există  nicio  funcție  învăluitoare  glibc  pentru acest apel de sistem; consultați secțiunea
       ISTORIC.

DESCRIERE

       Apelul de sistem specific IA-64 perfmonctl() oferă  o  interfață  cu  PMU  (unitatea  de  monitorizare  a
       performanțelor).  PMU constă din registrele PMD (date de monitorizare a performanțelor) și PMC (controlul
       monitorizării performanțelorl), care colectează statisticile hardware.

       perfmonctl() aplică operația cmd la argumentele de intrare specificate de arg. Numărul de argumente  este
       definit de narg. Argumentul fd specifică contextul perfmon pe care se operează.

       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 creează un nou context perfmon, după cum se specifică în ctxt, iar
              descriptorul său de fișier este returnat în ctxt->ctx_fd.

              Descriptorul de fișier poate fi utilizat în apelurile  ulterioare  la  perfmonctl()  și  poate  fi
              utilizat  pentru a citi notificările de evenimente (tip pfm_msg_t) utilizând 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șează contextul la un fir.

       PFM_UNLOAD_CONTEXT
              perfmonctl(int fd, PFM_UNLOAD_CONTEXT, NULL, 0);
              Detașează contextul de la un fir.

       PFM_RESTART
              perfmonctl(int fd, PFM_RESTART, NULL, 0);
              Repornește monitorizarea după primirea unei notificări de depășire.

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

       PFM_DEBUG
              perfmonctl(int fd, PFM_DEBUG, val, 0);
              Dacă val este diferit de zero, se activează modul de depanare, altfel se dezactivează.

       PFM_GET_PMC_RESET_VAL
              perfmonctl(int fd, PFM_GET_PMC_RESET_VAL, pfarg_reg_t *req, n);
              Reinițializează registrele PMC la valorile implicite.

VALOAREA RETURNATĂ

       perfmonctl() returnează zero atunci când operația este reușită.  În caz de eroare, se returnează -1,  iar
       errno este configurată pentru a indica eroarea.

STANDARDE

       Linux pe IA-64.

ISTORIC

       Adăugat în Linux 2.4; eliminat în Linux 5.10.

       Acest  apel  de sistem a fost defect timp de mai mulți ani și, în cele din urmă, a fost eliminat în Linux
       5.10.

       glibc nu oferă o funcție de învăluire pentru acest apel de sistem; pe nucleele în care există,  apelați-l
       folosind syscall(2).

CONSULTAȚI ȘI

       gprof(1)

       Specificația interfeței perfmon2

TRADUCERE

       Traducerea    în   limba   română   a   acestui   manual   a   fost   făcută   de   Remus-Gabriel   Chelu
       <remusgabriel.chelu@disroot.org>

       Această traducere este  documentație  gratuită;  citiți  Licența publică generală GNU Versiunea 3  sau  o
       versiune   ulterioară   cu  privire  la  condiții  privind  drepturile  de  autor.   NU  se  asumă  NICIO
       RESPONSABILITATE.

       Dacă găsiți erori în traducerea acestui manual, vă rugăm să  trimiteți  un  e-mail  la  translation-team-
       ro@lists.sourceforge.net.

Pagini de manual de Linux 6.9.1                    2 mai 2024                                      perfmonctl(2)