share/man/man8/zdump.8

   1 '\" te
   2 .\" Copyright (c) 2000 Sun Microsystems, Inc. All Rights Reserved.
   3 .\" Copyright 1989 AT&T
   4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   7 .TH ZDUMP 8 "Jan 3, 2006"
   8 .SH NAME
   9 zdump \- time zone dumper
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fBzdump\fR [\fB--\fR\fIversion\fR] [\fB-v\fR] [\fB-c\fR [\fIloyear\fR,]\fIhiyear\fR] [\fIzonename\fR]...
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 The \fBzdump\fR command prints the current time for each time zone
  20 (\fIzonename\fR) listed on the command line. Specify \fIzonename\fR as the name
  21 of the time zone database file relative to \fB/usr/share/zoneinfo\fR.
  22 .sp
  23 .LP
  24 Specifying an invalid time zone (\fIzonename\fR) to \fBzdump\fR does not return
  25 an error, rather \fBzdump\fR uses \fBGMTO.\fR This is consistent with the
  26 behavior of the library calls; \fBzdump\fR reflects the same behavior of the
  27 time routines in \fBlibc\fR. See \fBctime\fR(3C) and \fBmktime\fR(3C).
  28 .SH OPTIONS
  29 .sp
  30 .LP
  31 The following options are supported:
  32 .sp
  33 .ne 2
  34 .na
  35 \fB\fB--\fR\fIversion\fR\fR
  36 .ad
  37 .RS 22n
  38 Outputs version information and exits.
  39 .RE
  40
  41 .sp
  42 .ne 2
  43 .na
  44 \fB\fB-v\fR\fR
  45 .ad
  46 .RS 22n
  47 Displays the entire contents of the time zone database file for \fIzonename\fR.
  48 Prints the time at the lowest possible time value; the time one day after the
  49 lowest possible time value; the times both one second before and exactly at
  50 each time at which the rules for computing local time change; the time at the
  51 highest possible time value; and the time at one day less than the highest
  52 possible time value. See \fBmktime\fR(3C) and \fBctime\fR(3C) for information
  53 regarding time value (\fBtime_t\fR). Each line of output ends with
  54 \fBisdst=1\fR if the given time is Daylight Saving Time, or \fBisdst=0\fR
  55 otherwise.
  56 .RE
  57
  58 .sp
  59 .ne 2
  60 .na
  61 \fB\fB-c\fR [\fIloyear\fR],\fIhiyear\fR\fR
  62 .ad
  63 .RS 22n
  64 Cuts off the verbose output near the start of the given year(s) . By default,
  65 the program cuts off verbose output near the start of the years -500 and 2500.
  66 .RE
  67
  68 .SH EXIT STATUS
  69 .sp
  70 .LP
  71 The following exit values are returned:
  72 .sp
  73 .ne 2
  74 .na
  75 \fB\fB0\fR\fR
  76 .ad
  77 .RS 5n
  78 Successful completion.
  79 .RE
  80
  81 .sp
  82 .ne 2
  83 .na
  84 \fB\fB1\fR\fR
  85 .ad
  86 .RS 5n
  87 An error occurred.
  88 .RE
  89
  90 .SH FILES
  91 .sp
  92 .ne 2
  93 .na
  94 \fB\fB/usr/share/zoneinfo\fR\fR
  95 .ad
  96 .RS 27n
  97 Standard zone information directory
  98 .RE
  99
 100 .SH ATTRIBUTES
 101 .sp
 102 .LP
 103 See \fBattributes\fR(5) for descriptions of the following attributes:
 104 .sp
 105
 106 .sp
 107 .TS
 108 box;
 109 c | c
 110 l | l .
 111 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 112 _
 113 Interface Stability     Stable
 114 .TE
 115
 116 .SH SEE ALSO
 117 .sp
 118 .LP
 119 \fBzic\fR(8), \fBctime\fR(3C), \fBmktime\fR(3C), \fBattributes\fR(5),
 120 \fBenviron\fR(5)