pmdaopenlog(3) — Linux manual page

PMDAOPENLOG(3)           Library Functions Manual          PMDAOPENLOG(3)

NAME         top

       pmdaOpenLog - redirect stderr to a logfile

C SYNOPSIS         top

       #include <pcp/pmapi.h>
       #include <pcp/pmda.h>

       void pmdaOpenLog(pmdaInterface * dispatch);

       cc ... -lpcp_pmda -lpcp

DESCRIPTION         top

       pmdaOpenLog  redirects stderr to the logfile specified in the dis‐
       patch structure, set by the  previous  call  to  pmdaDaemon(3)  or
       pmdaGetOpt(3).   The  first  line  of the log file will detail the
       name of the calling process, the host the process is  running  on,
       and  the  current time.  In addition, the log is appended with the
       exit time of the process by a routine registered with atexit(3).

CAVEAT         top

       The PMDA must be using PMDA_INTERFACE_2 or later, as specified  in
       the call to pmdaDSO(3) or pmdaDaemon(3).

PCP ENVIRONMENT         top

       Environment  variables with the prefix PCP_ are used to parameter‐
       ize the file and directory names used by PCP.  On  each  installa‐
       tion,  the  file /etc/pcp.conf contains the local values for these
       variables.  The $PCP_CONF variable may be used to specify  an  al‐
       ternative configuration file, as described in pcp.conf(5).  Values
       for  these  variables  may  be obtained programmatically using the
       pmGetConfig(3) function.

SEE ALSO         top

       pmcd(1),   atexit(2),   PMAPI(3),   PMDA(3),   pmdaDaemon(3)   and
       pmdaGetOpt(3).

COLOPHON         top

       This  page is part of the PCP (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 is not part of the original manual page),  send  a
       mail to man-pages@man7.org

Performance Co-Pilot               PCP                     PMDAOPENLOG(3)

Pages that refer to this page: pmda(3)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH.