pmnewzone(3) [centos man page]

PMNEWZONE(3)						     Library Functions Manual						      PMNEWZONE(3)

NAME

       pmNewZone - establish a reporting timezone

C SYNOPSIS

       #include <pcp/pmapi.h>

       int pmNewZone(const char *tz);

       cc ... -lpcp

DESCRIPTION

       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(5).

       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

       PMAPI(3), pmCtime(3), pmGetConfig(3), pmLocaltime(3), pmNewContextZone(3), pmUseZone(3), pmWhichZone(3), pcp.conf(5), pcp.env(5) and  envi-
       ron(5).

DIAGNOSTICS

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

Performance Co-Pilot							PCP							      PMNEWZONE(3)

PMMKTIME(3)						     Library Functions Manual						       PMMKTIME(3)

NAME

       __pmMktime - convert a tm structure to a calendar time

C SYNOPSIS

       #include <time.h>
       #include <pcp/pmapi.h>
       #include <pcp/impl.h>

       time_t *__pmMktime(struct tm *timeptr);

       cc ... -lpcp

DESCRIPTION

       __pmMktime  is  very similar to mktime(3), except the timezone used is the current ``reporting timezone'' (rather than the default TZ envi-
       ronment variable scheme).

       Like mktime(3) the time to be converted is passed via timeptr, and the function result contains the calendar time (the  number  of  seconds
       since 00:00:00 UTC, January 1, 1970).

       The  default  current  reporting  timezone is as defined by the TZ environment variable, so __pmMktime and mktime(3) will initially produce
       similar conversions.

       Use pmNewZone(3), pmNewContextZone(3) or pmUseZone(3) to establish a new current reporting timezone that will  effect  __pmMktime  but  not
       mktime(3).

SEE ALSO

       mktime(3), PMAPI(3), pmCtime(3), pmLocaltime(3), pmNewContextZone(3), pmNewZone(3) and pmUseZone(3).

Performance Co-Pilot							PCP							       PMMKTIME(3)