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  previ‐
       ously    established    by    a    call    to    pmNewZone(3)   or
       pmNewContextZone(3), and this becomes the current reporting  time‐
       zone.

DIAGNOSTICS         top

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

SEE ALSO         top

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

Pages that refer to this page: __pmconverttime(3),  pmctime(3),  pmlocaltime(3),  __pmmktime(3),  pmnewcontextzone(3),  pmnewzone(3),  __pmparsetime(3),  pmparsetimewindow(3),  pmwhichzone(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.