pmnewzone(3) — Linux manual page

PMNEWZONE(3)            Library Functions Manual            PMNEWZONE(3)

NAME

       pmNewZone - establish a reporting timezone

C SYNOPSIS

       #include <pcp/pmapi.h>

       int pmNewZone(const char *tz);

       cc ... -lpcp

DESCRIPTION

       The current reporting timezone affects the timezone used by
       pmCtime(3) and pmLocaltime(3).

       The argument tz defines a timezone string, in the format
       described for the TZ environment variable, see environ(7).

       pmNewZone sets the current reporting timezone, and returns a
       value that may be used in a subsequent call to pmUseZone(3) to
       restore this reporting timezone.

DIAGNOSTICS

       A return value less than zero indicates a fatal error from a
       system call, most likely malloc(3).

SEE ALSO

       PMAPI(3), pmCtime(3), pmGetConfig(3), pmLocaltime(3),
       pmNewContextZone(3), pmUseZone(3), pmWhichZone(3), pcp.conf(5),
       pcp.env(5) and environ(7).

COLOPHON

       This page is part of the PCP (Performance Co-Pilot) project.
       Information 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 2024-06-14.
       (At that time, the date of the most recent commit that was found
       in the repository was 2024-06-14.)  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                      PMNEWZONE(3)

Pages that refer to this page: pmseries(1), __pmconverttime(3), pmctime(3), pmlocaltime(3), __pmmktime(3), pmnewcontextzone(3), __pmparsetime(3), pmparsetimewindow(3), pmusezone(3), pmwhichzone(3)

---