pmwhichzone(3) - Linux man page

Name

pmWhichZone - return current reporting timezone

C Synopsis

#include <pcp/pmapi.h>

int pmWhichZone(char **tz);

cc ... -lpcp

Description

The current reporting timezone effects the timezone used by pmctime(3) and pmlocaltime(3).

pmWhichZone returns the handle of the current timezone, as previously established by a call to pmnewzone(3) or pmnewcontextzone(3). If the call is successful (i.e. there exists a current reporting timezone) then a non-negative integer is returned and tz is set to point to a static buffer containing the timezone string itself.

See Also

pmapi(3), pmctime(3), pmlocaltime(3), pmnewcontextzone(3), pmnewzone(3) and pmusezone(3).

Diagnostics

A return value less than zero indicates there is no current reporting timezone.