2012-11-15 12:06:41 +01:00
|
|
|
.\" $NetBSD: zdump.8,v 1.9 2012/08/09 12:38:26 christos Exp $
|
2011-02-14 20:36:03 +01:00
|
|
|
.Dd October 29, 2003
|
|
|
|
|
.Dt ZDUMP 8
|
|
|
|
|
.Os
|
|
|
|
|
.Sh NAME
|
|
|
|
|
.Nm zdump
|
|
|
|
|
.Nd time zone dumper
|
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
|
.Nm zdump
|
|
|
|
|
.Op Fl \-version
|
|
|
|
|
.Op Fl v
|
|
|
|
|
.Op Fl c Ar [loyear,]highyear
|
|
|
|
|
.Op Ar zonename ...
|
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
|
.Nm
|
|
|
|
|
prints the current time in each
|
|
|
|
|
.Ar zonename
|
|
|
|
|
named on the command line.
|
|
|
|
|
.Pp
|
|
|
|
|
These options are available:
|
|
|
|
|
.Bl -tag -width XXXXXXXXX -compact
|
|
|
|
|
.It Fl \-version
|
|
|
|
|
Output version information and exit.
|
|
|
|
|
.It Fl v
|
|
|
|
|
For each
|
|
|
|
|
.Ar zonename
|
|
|
|
|
on the command line,
|
|
|
|
|
print the time at the lowest possible time value,
|
|
|
|
|
the time one day after the lowest possible time value,
|
|
|
|
|
the times both one second before and exactly at
|
|
|
|
|
each detected time discontinuity,
|
|
|
|
|
the time at one day less than the highest possible time value,
|
|
|
|
|
and the time at the highest possible time value,
|
|
|
|
|
Each line ends with
|
|
|
|
|
.Dl isdst=1
|
|
|
|
|
if the given time is Daylight Saving Time or
|
|
|
|
|
.Dl isdst=0
|
|
|
|
|
otherwise.
|
|
|
|
|
.It Fl c Ar [loyear,]highyear
|
|
|
|
|
Cut off the verbose output near the start of the given year(s).
|
|
|
|
|
By default,
|
|
|
|
|
the program cuts off verbose output near the starts of the years -500 and 2500.
|
|
|
|
|
.El
|
|
|
|
|
.Sh LIMITATIONS
|
|
|
|
|
The
|
|
|
|
|
.Fl v
|
|
|
|
|
option may not be used on systems with floating-point time_t values
|
|
|
|
|
that are neither float nor double.
|
|
|
|
|
.Pp
|
|
|
|
|
Time discontinuities are found by sampling the results returned by localtime
|
|
|
|
|
at twelve-hour intervals.
|
|
|
|
|
This works in all real-world cases;
|
|
|
|
|
one can construct artificial time zones for which this fails.
|
|
|
|
|
.Sh SEE ALSO
|
|
|
|
|
.Xr ctime 3 ,
|
|
|
|
|
.Xr tzfile 5 ,
|
|
|
|
|
.Xr zic 8
|
|
|
|
|
.\" @(#)zdump.8 8.2
|
|
|
|
|
.\" This file is in the public domain, so clarified as of
|
|
|
|
|
.\" 2009-05-17 by Arthur David Olson.
|
