pmnewzone(3) — Linux manual page

NAME | C SYNOPSIS | DESCRIPTION | DIAGNOSTICS | SEE ALSO | COLOPHON

PMNEWZONE(3)             Library Functions Manual            PMNEWZONE(3)

NAME         top

       pmNewZone - establish a reporting timezone

C SYNOPSIS         top

       #include <pcp/pmapi.h>

       int pmNewZone(const char *tz);

       cc ... -lpcp

DESCRIPTION         top

       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         top

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

SEE ALSO         top

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

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                       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)