Movatterモバイル変換

pmdelprofile(3) — Linux manual page

PMDELPROFILE(3)          Library Functions ManualPMDELPROFILE(3)

NAME        top

pmDelProfile- delete instance(s) from the current PMAPI instance       profile

C SYNOPSIS        top

#include <pcp/pmapi.h>int pmDelProfile(pmInDomindom, intnuminst, int *instlist);cc ... -lpcp

DESCRIPTION        top

       The  set  of  instances  for  performance  metrics returned from apmFetch(3) call may be filtered or restricted  using  an  instance       profile.   There  is one instance profile for each context the ap‐       plication creates at the Performance Metrics Application  Program‐       ming  Interface (PMAPI), and each instance profile may include in‐       stances from one or more instance domains (seepmLookupDesc(3)).pmDelProfilemay be used to delete  instance  specifications  from       the instance profile of the current PMAPI context.       In  the  simplest variant, the list of instances identified by theinstlist argument for theindom instance domain are  removed  from       the  instance  profile.  The list of instance identifiers containsnuminst values.       Theindom value  would  normally  be  extracted  from  a  call  topmLookupDesc(3)  for  a particular performance metric, and the in‐       stances ininstlist would typically  be  determined  by  calls  topmGetInDom(3) orpmLookupInDom(3).       Ifindom  equalsPM_INDOM_NULLandnuminst is zero, then all in‐       stance domains are selected for deletion.  Ifinstlist  isNULL,       then  all instances in the selected domain(s) are removed from the       profile.       To disable all available instances in all domains,  usepmDelPro‐file(PM_INDOM_NULL, 0, NULL).  This is the only situation in whichindom may bePM_INDOM_NULL.

CAVEAT        top

       It is possible to delete non-existent instance domains and non-ex‐       istent  instances  from an instance profile.  None of the routines       that use the instance profile will ever issue an error if  you  do       this.   The cost of checking, when checking is possible, outweighs       any benefits.

DIAGNOSTICS        top

PM_ERR_PROFILESPECindom wasPM_INDOM_NULLandinstlist was not empty

SEE ALSO        top

pmAddProfile(3),PMAPI(3),pmFetch(3),pmGetInDom(3),pmLookupDesc(3),pmLookupInDom(3),pmNewContext(3),pmUseContext(3) andpmWhichContext(3).

COLOPHON        top

       This page is part of thePCP (Performance Co-Pilot) project.  In‐       formation about the project can be found at ⟨http://www.pcp.io/⟩.       If you have a bug report for this manual page, send it to       pcp@groups.io.  This page was obtained from the project's upstream       Git repository ⟨https://github.com/performancecopilot/pcp.git⟩ on       2025-08-11.  (At that time, the date of the most recent commit       that was found in the repository was 2025-08-11.)  If you discover       any rendering problems in this HTML version of the page, or you       believe there is a better or more up-to-date source for the page,       or you have corrections or improvements to the information in this       COLOPHON (which isnot part of the original manual page), send a       mail to man-pages@man7.orgPerformance Co-Pilot               PCPPMDELPROFILE(3)

Pages that refer to this page:pcpintro(3), pmaddprofile(3), pmapi(3), pmfetch(3), pmnewcontext(3), pmwebapi(3)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH.