pmwhichzone(3) — Linux manual page


PMWHICHZONE(3)          Library Functions Manual          PMWHICHZONE(3)

NAME         top

       pmWhichZone - return current reporting timezone

C SYNOPSIS         top

       #include <pcp/pmapi.h>

       int pmWhichZone(char **tz);

       cc ... -lpcp

DESCRIPTION         top

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

       pmWhichZone returns the handle of the current timezone, as
       previously established by a call to pmNewZone(3) or
       pmNewContextZone(3).  If the call is successful (i.e. there
       exists a current reporting timezone) then a non-negative integer
       is returned and tz is set to point to a static buffer containing
       the timezone string itself.

SEE ALSO         top

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

DIAGNOSTICS         top

       A return value less than zero indicates there is no current
       reporting timezone.

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 2021-04-01.
       (At that time, the date of the most recent commit that was found
       in the repository was 2021-04-01.)  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                    PMWHICHZONE(3)

Pages that refer to this page: pmnewcontextzone(3)pmnewzone(3)pmusezone(3)