77 lines
2.0 KiB
Groff
77 lines
2.0 KiB
Groff
.\" $NetBSD: zdump.8,v 1.10 2013/07/17 20:13:04 christos Exp $
|
|
.Dd July 17, 2013
|
|
.Dt ZDUMP 8
|
|
.Os
|
|
.Sh NAME
|
|
.Nm zdump
|
|
.Nd time zone dumper
|
|
.Sh SYNOPSIS
|
|
.Nm zdump
|
|
.Op Fl \-version
|
|
.Op Fl v
|
|
.Op Fl V
|
|
.Op Fl c Ar [loyear,]highyear
|
|
.Op Ar zonename ...
|
|
.Nm zdump
|
|
.Fl t
|
|
.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.
|
|
.It Fl t Ar [loyear,]highyear
|
|
Cut off verbose output at the start of the given time(s),
|
|
given in decimal seconds since 1970-01-01 00:00:00 UTC.
|
|
.It Fl V
|
|
Like
|
|
.Fl v ,
|
|
except omit the times relative to the extreme time values.
|
|
This generates output that is easier to compare to that of
|
|
implementations with different time representations.
|
|
.El
|
|
.Sh LIMITATIONS
|
|
The
|
|
.Fl v
|
|
and
|
|
.Fl V
|
|
options 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.
|