НАИМЕНОВАНИЕ

       perfmonctl - интерфейс к блоку слежения за производительностью IA-64

ОБЗОР

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

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

       Note: There is no glibc wrapper for this system call; see HISTORY.

ОПИСАНИЕ

       Специальный  системный  вызов  perfmonctl()  для  IA-64  предоставляет  интерфейс к PMU (блок слежения за
       производительностью, perfomance monitoring unit). PMU содержит регистры PMD  (данные  производительности,
       performance  monitoring  data) и PMC (управление слежением за производительностью, performance monitoring
       control), в которых собирается статистика по аппаратному обеспечению.

       Вызов perfmonctl() выполняет  операцию  cmd  над  входными  аргументами,  указанными  в  arg.  Количество
       аргументов указывается в narg. В аргументе fd задаётся контекст perfmon для операции.

       Поддерживаемые значения cmd:

       PFM_CREATE_CONTEXT
              perfmonctl(int fd, PFM_CREATE_CONTEXT, pfarg_context_t *ctxt, 1);
              Создаёт контекст.

              Параметр fd игнорируется. Создаётся новый контекст perfmon согласно ctxt и его файловый дескриптор
              возвращается в ctxt->ctx_fd.

              Файловый  дескриптор  можно  использовать  в  последующих вызовах perfmonctl(), а также для чтения
              уведомлений о событиях (тип pfm_msg_t) с помощью read(2). Файловый дескриптор можно  опрашивать  с
              помощью select(2), poll(2) и epoll(7).

              Контекст можно уничтожить вызвав close(2), указав файловый дескриптор.

       PFM_WRITE_PMCS
              perfmonctl(int fd, PFM_WRITE_PMCS, pfarg_reg_t *pmcs, n);
              Назначает значения регистрам PMC.

       PFM_WRITE_PMDS
              perfmonctl(int fd, PFM_WRITE_PMDS, pfarg_reg_t *pmds, n);
              Назначает значения регистрам PMD.

       PFM_READ_PMDS
              perfmonctl(int fd, PFM_READ_PMDS, pfarg_reg_t *pmds, n);
              Читает регистры PMD.

       PFM_START
              perfmonctl(int fd, PFM_START, NULL, 0);
              Запускает слежение.

       PFM_STOP
              perfmonctl(int fd, PFM_STOP, NULL, 0);
              Останавливает слежение.

       PFM_LOAD_CONTEXT
              perfmonctl(int fd, PFM_LOAD_CONTEXT, pfarg_load_t *largs, 1);
              Присоединяет контекст к нити.

       PFM_UNLOAD_CONTEXT
              perfmonctl(int fd, PFM_UNLOAD_CONTEXT, NULL, 0);
              Отсоединяет контекст от нити.

       PFM_RESTART
              perfmonctl(int fd, PFM_RESTART, NULL, 0);
              Перезапускает слежение после приёма уведомления о переполнении.

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

       PFM_DEBUG
              perfmonctl(int fd, PFM_DEBUG, val, 0);
              Если val не равно нулю, то включает режим отладки, в противном случае выключает.

       PFM_GET_PMC_RESET_VAL
              perfmonctl(int fd, PFM_GET_PMC_RESET_VAL, pfarg_reg_t *req, n);
              Сбрасывает регистры PMC в их значения по умолчанию.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

       perfmonctl()   returns  zero when the operation is successful.  On error, -1 is returned and errno is set
       to indicate the error.

СТАНДАРТЫ

       Linux on IA-64.

ИСТОРИЯ

       Added in Linux 2.4; removed in Linux 5.10.

       This system call was broken for many years, and ultimately removed in Linux 5.10.

       glibc does not provide a wrapper for this system  call;  on  kernels  where  it  exists,  call  it  using
       syscall(2).

СМОТРИТЕ ТАКЖЕ

       gprof(1)

       Спецификация интерфейса perfmon2

ПЕРЕВОД

       Русский     перевод     этой    страницы    руководства    разработал(и)    Alexey,    Azamat    Hackimov
       <azamat.hackimov@gmail.com>,      kogamatranslator49      <r.podarov@yandex.ru>,       Darima       Kogan
       <silverdk99@gmail.com>,  Max  Is  <ismax799@gmail.com>,  Yuri  Kozlov  <yuray@komyakino.ru>,  Иван Павлов
       <pavia00@gmail.com> и Kirill Rekhov <krekhov.dev@gmail.com>

       Этот перевод является свободной программной документацией; он распространяется на условиях  общедоступной
       лицензии  GNU  (GNU  General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или
       более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

       Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите  об  этом
       разработчику(ам)   по   его(их)  адресу(ам)  электронной  почты  или  по  адресу  списка рассылки русских
       переводчиков.

Справочные страницы Linux 6.9.1                   2 мая 2024 г.                                    perfmonctl(2)