NAME | C SYNOPSIS | DESCRIPTION | SEE ALSO | DIAGNOSTICS | COLOPHON

PMNEWZONE(3)              Library Functions Manual              PMNEWZONE(3)

NAME         top

       pmNewZone - establish a reporting timezone

C SYNOPSIS         top

       #include <pcp/pmapi.h>
       int pmNewZone(const char *tz);
       cc ... -lpcp

DESCRIPTION         top

       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.

SEE ALSO         top

       PMAPI(3), pmCtime(3), pmGetConfig(3), pmLocaltime(3),
       pmNewContextZone(3), pmUseZone(3), pmWhichZone(3), pcp.conf(5),
       pcp.env(5) and environ(7).

DIAGNOSTICS         top

       A return value less than zero indicates a fatal error from a system
       call, most likely malloc(3).

COLOPHON         top

       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
       pcp@oss.sgi.com.  This page was obtained from the project's upstream
       Git repository ⟨git://git.pcp.io/pcp⟩ on 2017-07-05.  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: pmconverttime(3)pmctime(3)pmlocaltime(3)pmmktime(3)pmnewcontextzone(3)pmparsetime(3)pmparsetimewindow(3)pmusezone(3)pmwhichzone(3)