pmUseZone(3) — Linux manual page


PMUSEZONE(3)              Library Functions Manual              PMUSEZONE(3)

NAME         top

       pmUseZone - re-establish a reporting timezone

C SYNOPSIS         top

       #include <pcp/pmapi.h>

       int pmUseZone(const int tz_handle);

       cc ... -lpcp

DESCRIPTION         top

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

       The argument tz_handle identifies a reporting timezone as previously
       established by a call to pmNewZone(3) or pmNewContextZone(3), and
       this becomes the current reporting timezone.

SEE ALSO         top

       PMAPI(3), pmCtime(3), pmLocaltime(3), pmNewContextZone(3),
       pmNewZone(3) and pmWhichZone(3).

DIAGNOSTICS         top

       A return value less than zero indicates the value of tz_handle is not

COLOPHON         top

       This page is part of the PCP (Performance Co-Pilot) project.
       Information about the project can be found at ⟨⟩.
       If you have a bug report for this manual page, send it to  This page was obtained from the project's upstream
       Git repository ⟨⟩ on
       2020-09-18.  (At that time, the date of the most recent commit that
       was found in the repository was 2020-09-18.)  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

Performance Co-Pilot                 PCP                        PMUSEZONE(3)

Pages that refer to this page: __pmconverttime(3)__pmConvertTime(3)pmctime(3)pmCtime(3)pmlocaltime(3)pmLocaltime(3)__pmmktime(3)__pmMktime(3)pmnewcontextzone(3)pmNewContextZone(3)pmnewzone(3)pmNewZone(3)__pmparsetime(3)__pmParseTime(3)pmparsetimewindow(3)pmParseTimeWindow(3)pmwhichzone(3)pmWhichZone(3)