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.

Referenced By

pmNewContextZone(3), pmNewZone(3), pmUseZone(3).

The man page pmwhichzone(3) is an alias of pmWhichZone(3).

PCP Performance Co-Pilot