pmnewzone

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(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

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

Diagnostics

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

Referenced By

__pmConvertTime(3), pmCtime(3), pmLocaltime(3), __pmMktime(3), pmNewContextZone(3), __pmParseTime(3), pmParseTimeWindow(3), pmseries(1), pmUseZone(3), pmWhichZone(3).

The man page pmnewzone(3) is an alias of pmNewZone(3).