Return to zdump.8 CVS log

Up to [cvs.NetBSD.org] / src / lib / libc / time

Annotation of src/lib/libc/time/zdump.8, Revision 1.10

1.10    ! christos    1: .\"    $NetBSD: zdump.8,v 1.9 2012/08/09 12:38:26 christos Exp $
        !             2: .Dd July 17, 2013
1.6       joerg       3: .Dt ZDUMP 8
1.4       wiz         4: .Os
                      5: .Sh NAME
                      6: .Nm zdump
                      7: .Nd time zone dumper
                      8: .Sh SYNOPSIS
                      9: .Nm zdump
1.5       kleink     10: .Op Fl \-version
1.4       wiz        11: .Op Fl v
1.10    ! christos   12: .Op Fl V
1.7       mlelstv    13: .Op Fl c Ar [loyear,]highyear
1.4       wiz        14: .Op Ar zonename ...
1.10    ! christos   15: .Nm zdump
        !            16: .Fl t
        !            17: .Ar [loyear,]highyear
        !            18: .Op Ar zonename ...
1.4       wiz        19: .Sh DESCRIPTION
                     20: .Nm
1.1       jtc        21: prints the current time in each
1.4       wiz        22: .Ar zonename
1.1       jtc        23: named on the command line.
1.4       wiz        24: .Pp
1.1       jtc        25: These options are available:
1.5       kleink     26: .Bl -tag -width XXXXXXXXX -compact
                     27: .It Fl \-version
                     28: Output version information and exit.
1.4       wiz        29: .It Fl v
1.1       jtc        30: For each
1.4       wiz        31: .Ar zonename
1.1       jtc        32: on the command line,
1.3       jtc        33: print the time at the lowest possible time value,
1.1       jtc        34: the time one day after the lowest possible time value,
                     35: the times both one second before and exactly at
                     36: each detected time discontinuity,
                     37: the time at one day less than the highest possible time value,
                     38: and the time at the highest possible time value,
                     39: Each line ends with
1.4       wiz        40: .Dl isdst=1
1.1       jtc        41: if the given time is Daylight Saving Time or
1.4       wiz        42: .Dl isdst=0
1.1       jtc        43: otherwise.
1.7       mlelstv    44: .It Fl c Ar [loyear,]highyear
                     45: Cut off the verbose output near the start of the given year(s).
                     46: By default,
1.10    ! christos   47: the program cuts off verbose output near the starts of the years \-500 and 2500.
        !            48: .It Fl t Ar [loyear,]highyear
        !            49: Cut off verbose output at the start of the given time(s),
        !            50: given in decimal seconds since 1970-01-01 00:00:00 UTC.
        !            51: .It Fl V
        !            52: Like
        !            53: .Fl v ,
        !            54: except omit the times relative to the extreme time values.
        !            55: This generates output that is easier to compare to that of
        !            56: implementations with different time representations.
1.4       wiz        57: .El
1.8       joerg      58: .Sh LIMITATIONS
1.7       mlelstv    59: The
1.8       joerg      60: .Fl v
1.10    ! christos   61: and
        !            62: .Fl V
        !            63: options may not be used on systems with floating-point time_t values
1.7       mlelstv    64: that are neither float nor double.
1.8       joerg      65: .Pp
1.7       mlelstv    66: Time discontinuities are found by sampling the results returned by localtime
                     67: at twelve-hour intervals.
                     68: This works in all real-world cases;
                     69: one can construct artificial time zones for which this fails.
1.4       wiz        70: .Sh SEE ALSO
                     71: .Xr ctime 3 ,
                     72: .Xr tzfile 5 ,
                     73: .Xr zic 8
1.7       mlelstv    74: .\" @(#)zdump.8        8.2
                     75: .\" This file is in the public domain, so clarified as of
                     76: .\" 2009-05-17 by Arthur David Olson.