NAME | C SYNOPSIS | DESCRIPTION | DIAGNOSTICS | SEE ALSO | COLOPHON |
|
|
PMNEWZONE(3) Library Functions Manual PMNEWZONE(3)
pmNewZone - establish a reporting timezone
#include <pcp/pmapi.h> int pmNewZone(const char *tz); cc ... -lpcp
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.
A return value less than zero indicates a fatal error from a sys‐ tem call, most likely malloc(3).
PMAPI(3), pmCtime(3), pmGetConfig(3), pmLocaltime(3), pmNewContextZone(3), pmUseZone(3), pmWhichZone(3), pcp.conf(5), pcp.env(5) and environ(7).
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)