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 system 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. Information about the project can be found at ⟨http://www.pcp.io/⟩. If you have a bug report for this manual page, send it to firstname.lastname@example.org. This page was obtained from the project's upstream Git repository ⟨https://github.com/performancecopilot/pcp.git⟩ on 2021-08-27. (At that time, the date of the most recent commit that was found in the repository was 2021-08-27.) 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 email@example.com 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)