summaryrefslogtreecommitdiff
path: root/man/man3/pmusezone.3
diff options
context:
space:
mode:
Diffstat (limited to 'man/man3/pmusezone.3')
-rw-r--r--man/man3/pmusezone.353
1 files changed, 53 insertions, 0 deletions
diff --git a/man/man3/pmusezone.3 b/man/man3/pmusezone.3
new file mode 100644
index 0000000..c5ef0b9
--- /dev/null
+++ b/man/man3/pmusezone.3
@@ -0,0 +1,53 @@
+'\"macro stdmacro
+.\"
+.\" Copyright (c) 2000-2004 Silicon Graphics, Inc. All Rights Reserved.
+.\"
+.\" This program is free software; you can redistribute it and/or modify it
+.\" under the terms of the GNU General Public License as published by the
+.\" Free Software Foundation; either version 2 of the License, or (at your
+.\" option) any later version.
+.\"
+.\" This program is distributed in the hope that it will be useful, but
+.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+.\" or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+.\" for more details.
+.\"
+.\"
+.TH PMUSEZONE 3 "PCP" "Performance Co-Pilot"
+.SH NAME
+\f3pmUseZone\f1 \- re-establish a reporting timezone
+.SH "C SYNOPSIS"
+.ft 3
+#include <pcp/pmapi.h>
+.sp
+int pmUseZone(const int \fItz_handle\fP);
+.sp
+cc ... \-lpcp
+.ft 1
+.SH DESCRIPTION
+The current reporting timezone effects the timezone used by
+.BR pmCtime (3)
+and
+.BR pmLocaltime (3).
+.PP
+The argument
+.I tz_handle
+identifies a reporting timezone as previously established by
+a call to
+.BR pmNewZone (3)
+or
+.BR pmNewContextZone (3),
+and this becomes
+the current reporting timezone.
+.SH SEE ALSO
+.BR PMAPI (3),
+.BR pmCtime (3),
+.BR pmLocaltime (3),
+.BR pmNewContextZone (3),
+.BR pmNewZone (3)
+and
+.BR pmWhichZone (3).
+.SH DIAGNOSTICS
+A return value less than zero indicates the value of
+.I tz_handle
+is not legal.