pmNewZone(3)

pmNewZone3

Establish a reporting timezone

C synopsis

#include <pcp/pmapi.h>

int pmNewZone(const char *tz);

cc ... -lpcp

Overview

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.

Diagnostics

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

Releases

8 releases since Debian 5.0 (Lenny); the text changed 6 times.

  1. 5.0
  2. 6.0
  3. 8
  4. 10
  5. 11
  6. 12–13
  7. Arch

From pcp 7.2.2-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.