Man Linux: Main Page and Category List

NAME

       pmCtime - format the date and time for a reporting timezone

C SYNOPSIS

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

       char *pmCtime(const time_t *clock, char *buf)

       cc ... -lpcp

DESCRIPTION

       pmCtime  is  very  similar to ctime(3), except the timezone used is the
       current ‘‘reporting timezone’’ (rather than the default TZ  environment
       variable  scheme),  and  the  result is returned into a caller-declared
       buffer (rather than a private buffer).

       Like ctime(3) the time to be converted is passed  via  clock,  and  the
       result in buf is fixed width fields in the format:

                 Fri Sep 13 00:00:00 1986\n\0

       The result buffer buf must be at least 26 bytes long, and no attempt is
       made to check this.  pmCtime returns buf as the value of the  function.

       The  default  current  reporting  timezone  is  as  defined  by  the TZ
       environment variable, so pmCtime and ctime(3)  will  initially  produce
       similar encoding of the date and time.

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

SEE ALSO

       ctime(3),  PMAPI(3),  pmLocaltime(3), pmNewContextZone(3), pmNewZone(3)
       and pmUseZone(3).