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  previ‐
       ously    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  re‐
       turned  and  tz  is set to point to a static buffer containing the
       timezone string itself.

DIAGNOSTICS         top

       A return value less than zero indicates there is  no  current  re‐
       porting timezone.

SEE ALSO         top

       PMAPI(3),    pmCtime(3),    pmLocaltime(3),   pmNewContextZone(3),
       pmNewZone(3) and pmUseZone(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                     PMWHICHZONE(3)

Pages that refer to this page: pmnewcontextzone(3),  pmnewzone(3),  pmusezone(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.