.\" -*- coding: UTF-8 -*- .\" Copyright (C) 2006 Red Hat, Inc. All Rights Reserved. .\" and Copyright (C) 2013 Michael Kerrisk .\" Written by Ivana Varekova .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH perfmonctl 2 "30 martie 2023" "Pagini de manual de Linux 6.05.01" .SH NUME perfmonctl \- interfață pentru unitatea de monitorizare a performanței IA\-64 .SH REZUMAT .nf \fB#include \fP \fB#include \fP .PP \fBlong perfmonctl(int \fP\fIfd\fP\fB, int \fP\fIcmd\fP\fB, void \fP\fIarg\fP\fB[.\fP\fInarg\fP\fB], int \fP\fInarg\fP\fB);\fP .fi .PP \fINota\fP: Nu există nicio funcție învăluitoare glibc pentru acest apel de sistem; consultați secțiunea ISTORIC. .SH DESCRIERE Apelul de sistem specific IA\-64 \fBperfmonctl\fP() 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. .PP \fBperfmonctl\fP() aplică operația \fIcmd\fP la argumentele de intrare specificate de \fIarg\fP. Numărul de argumente este definit de \fInarg\fP. Argumentul \fIfd\fP specifică contextul perfmon pe care se operează. .PP Valorile acceptate pentru \fIcmd\fP sunt: .TP \fBPFM_CREATE_CONTEXT\fP .nf \fBperfmonctl(int \fP\fIfd\fP\fB, PFM_CREATE_CONTEXT, pfarg_context_t *\fP\fIctxt\fP\fB, 1);\fP .fi Stabilește un context. .IP Parametrul \fIfd\fP este ignorat. Se creează un nou context perfmon, după cum se specifică în \fIctxt\fP, iar descriptorul său de fișier este returnat în \fIctxt\->ctx_fd\fP. .IP Descriptorul de fișier poate fi utilizat în apelurile ulterioare la \fBperfmonctl\fP() și poate fi utilizat pentru a citi notificările de evenimente (tip \fIpfm_msg_t\fP) utilizând \fBread\fP(2). Descriptorul de fișier poate fi interogat folosind \fBselect\fP(2), \fBpoll\fP(2) și \fBepoll\fP(7). .IP Contextul poate fi distrus prin apelarea \fBclose\fP(2) pe descriptorul de fișier. .TP \fBPFM_WRITE_PMCS\fP .\" pfm_write_pmcs() .nf \fBperfmonctl(int \fP\fIfd\fP\fB, PFM_WRITE_PMCS, pfarg_reg_t *\fP\fIpmcs\fP\fB, n);\fP .fi Stabilește registrele PMC. .TP \fBPFM_WRITE_PMDS\fP .nf \fBperfmonctl(int \fP\fIfd\fP\fB, PFM_WRITE_PMDS, pfarg_reg_t *\fP\fIpmds\fP\fB, n);\fP .fi .\" pfm_write_pmds() Stabilește registrele PMD. .TP \fBPFM_READ_PMDS\fP .\" pfm_read_pmds() .nf \fBperfmonctl(int \fP\fIfd\fP\fB, PFM_READ_PMDS, pfarg_reg_t *\fP\fIpmds\fP\fB, n);\fP .fi Citește registrele PMD. .TP \fBPFM_START\fP .\" pfm_start() .nf .\" .BI "perfmonctl(int " fd ", PFM_START, arg, 1); \fBperfmonctl(int \fP\fIfd\fP\fB, PFM_START, NULL, 0);\fP .fi Pornește monitorizarea. .TP \fBPFM_STOP\fP .\" pfm_stop() .nf \fBperfmonctl(int \fP\fIfd\fP\fB, PFM_STOP, NULL, 0);\fP .fi Oprește monitorizarea. .TP \fBPFM_LOAD_CONTEXT\fP .\" pfm_context_load() .nf \fBperfmonctl(int \fP\fIfd\fP\fB, PFM_LOAD_CONTEXT, pfarg_load_t *\fP\fIlargs\fP\fB, 1);\fP .fi Atașează contextul la un fir. .TP \fBPFM_UNLOAD_CONTEXT\fP .\" pfm_context_unload() .nf \fBperfmonctl(int \fP\fIfd\fP\fB, PFM_UNLOAD_CONTEXT, NULL, 0);\fP .fi Detașează contextul de la un fir. .TP \fBPFM_RESTART\fP .\" pfm_restart() .nf \fBperfmonctl(int \fP\fIfd\fP\fB, PFM_RESTART, NULL, 0);\fP .fi Repornește monitorizarea după primirea unei notificări de depășire. .TP \fBPFM_GET_FEATURES\fP .\" pfm_get_features() .nf \fBperfmonctl(int \fP\fIfd\fP\fB, PFM_GET_FEATURES, pfarg_features_t *\fP\fIarg\fP\fB, 1);\fP .fi .TP \fBPFM_DEBUG\fP .\" pfm_debug() .nf \fBperfmonctl(int \fP\fIfd\fP\fB, PFM_DEBUG, \fP\fIval\fP\fB, 0);\fP .fi Dacă \fIval\fP este diferit de zero, se activează modul de depanare, altfel se dezactivează. .TP \fBPFM_GET_PMC_RESET_VAL\fP .\" pfm_get_pmc_reset() .nf \fBperfmonctl(int \fP\fIfd\fP\fB, PFM_GET_PMC_RESET_VAL, pfarg_reg_t *\fP\fIreq\fP\fB, n);\fP .fi .\" .\" .\" .TP .\" .B PFM_CREATE_EVTSETS .\" .\" create or modify event sets .\" .nf .\" .BI "perfmonctl(int " fd ", PFM_CREATE_EVTSETS, pfarg_setdesc_t *desc , n); .\" .fi .\" .TP .\" .B PFM_DELETE_EVTSETS .\" delete event sets .\" .nf .\" .BI "perfmonctl(int " fd ", PFM_DELETE_EVTSET, pfarg_setdesc_t *desc , n); .\" .fi .\" .TP .\" .B PFM_GETINFO_EVTSETS .\" get information about event sets .\" .nf .\" .BI "perfmonctl(int " fd ", PFM_GETINFO_EVTSETS, pfarg_setinfo_t *info, n); .\" .fi Reinițializează registrele PMC la valorile implicite. .SH "VALOAREA RETURNATĂ" \fBperfmonctl\fP() returnează zero atunci când operația este reușită. În caz de eroare, se returnează \-1, iar \fIerrno\fP este configurată pentru a indica eroarea. .SH STANDARDE Linux pe IA\-64. .SH ISTORIC .\" commit ecf5b72d5f66af843f189dfe9ce31598c3e48ad7 Adăugat în Linux 2.4; eliminat în Linux 5.10. .PP 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. .PP glibc nu oferă o funcție de învăluire pentru acest apel de sistem; pe nucleele în care există, apelați\-l folosind \fBsyscall\fP(2). .SH "CONSULTAȚI ȘI" \fBgprof\fP(1) .PP Specificația interfeței perfmon2 .PP .SH TRADUCERE Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu . .PP Această traducere este documentație gratuită; citiți .UR https://www.gnu.org/licenses/gpl-3.0.html Licența publică generală GNU Versiunea 3 .UE sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE. .PP Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la .MT translation-team-ro@lists.sourceforge.net .ME .