perfmonctl(2) System Calls Manual perfmonctl(2) NOM perfmonctl - Interface a l'unite de surveillance des performances IA-64 SYNOPSIS #include #include long perfmonctl(int fd, int cmd, void arg[.narg], int narg); Note : il n'existe pas d'enveloppe pour cet appel systeme dans la glibc ; voir HISTORIQUE. DESCRIPTION L'appel systeme perfmonctl() specifique a IA-64 fournit une interface a la PMU (unite de surveillance des performances). La PMU est constituee de registres PMD (donnees de surveillance des performances) et de registres PMC (controle de surveillance des performances) qui rassemblent des statistiques sur le materiel. perfmonctl() applique l'operation cmd aux arguments d'entree indiques par arg. Le nombre d'arguments est defini par narg. L'argument fd indique le contexte perfmon sur lequel operer. Les valeurs possibles pour cmd sont : PFM_CREATE_CONTEXT perfmonctl(int fd, PFM_CREATE_CONTEXT, pfarg_context_t *ctxt, 1); Definir un contexte. Le parametre fd est ignore. Un nouveau contexte perfmon est cree comme indique dans ctxt et son descripteur de fichier est renvoye dans ctxt->ctx_fd. Le descripteur de fichier peut etre utilise dans les appels suivants de perfmonctl() et peut etre utilise pour des notifications d'evenement (type pfm_msg_t) en utilisant read(2). Le descripteur de fichier est surveillable en utilisant select(2), poll(2) et epoll(7). Le contexte peut etre detruit en appelant close(2) sur le descripteur de fichier. PFM_WRITE_PMCS perfmonctl(int fd, PFM_WRITE_PMCS, pfarg_reg_t *pmcs, n); Definir les registres PMC. PFM_WRITE_PMDS perfmonctl(int fd, PFM_WRITE_PMDS, pfarg_reg_t *pmds, n); Definir les registres PMD. PFM_READ_PMDS perfmonctl(int fd, PFM_READ_PMDS, pfarg_reg_t *pmds, n); Lire les registres PMD. PFM_START perfmonctl(int fd, PFM_START, NULL, 0); Commencer la surveillance. PFM_STOP perfmonctl(int fd, PFM_STOP, NULL, 0); Arreter la surveillance. PFM_LOAD_CONTEXT perfmonctl(int fd, PFM_LOAD_CONTEXT, pfarg_load_t *largs, 1); Attacher le contexte a un thread. PFM_UNLOAD_CONTEXT perfmonctl(int fd, PFM_UNLOAD_CONTEXT, NULL, 0); Detacher le contexte d'un thread. PFM_RESTART perfmonctl(int fd, PFM_RESTART, NULL, 0); Redemarrer la surveillance apres avoir recu une notification de depassement. PFM_GET_FEATURES perfmonctl(int fd, PFM_GET_FEATURES, pfarg_features_t *arg, 1); PFM_DEBUG perfmonctl(int fd, PFM_DEBUG, val, 0); Si val est non nul, activer le mode de debogage, sinon le desactiver. PFM_GET_PMC_RESET_VAL perfmonctl(int fd, PFM_GET_PMC_RESET_VAL, pfarg_reg_t *req, n); Reinitialiser les registres PMC aux valeurs par defaut. VALEUR RENVOYEE perfmonctl() renvoie zero si l'operation reussit. En cas d'erreur, -1 est renvoye et errno est definie pour indiquer l'erreur. STANDARDS Linux sur IA-64. HISTORIQUE Ajoute dans Linux 2.4 ; retire dans Linux 5.10. Cet appel systeme est casse depuis plusieurs annee et il afini par etre retire de Linux. La glibc ne fournit pas de fonction d'enveloppe pour cet appel systeme ; avec les noyaux ou il existe, appelez-le avec syscall(2). VOIR AUSSI gprof(1) La specification d'interface perfmon2 TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot et Jean-Pierre Giraud Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.06 31 octobre 2023 perfmonctl(2)