diff options
| author | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-25 19:54:44 -0400 |
|---|---|---|
| committer | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-25 19:54:44 -0400 |
| commit | a9157ce950dfe2fc30795d43b9d79b9d1bffc48b (patch) | |
| tree | 9df484304b560466d145e662c1c254ff0e9ae0ba /static/openbsd/man8/zdump.8 | |
| parent | 160aa82b2d39c46ad33723d7d909cb4972efbb03 (diff) | |
docs: Added All OpenBSD Manuals
Diffstat (limited to 'static/openbsd/man8/zdump.8')
| -rw-r--r-- | static/openbsd/man8/zdump.8 | 87 |
1 files changed, 87 insertions, 0 deletions
diff --git a/static/openbsd/man8/zdump.8 b/static/openbsd/man8/zdump.8 new file mode 100644 index 00000000..211f289a --- /dev/null +++ b/static/openbsd/man8/zdump.8 @@ -0,0 +1,87 @@ +.\" $OpenBSD: zdump.8,v 1.7 2025/06/23 13:53:11 millert Exp $ +.Dd $Mdocdate: June 23 2025 $ +.Dt ZDUMP 8 +.Os +.Sh NAME +.Nm zdump +.Nd time zone dumper +.Sh SYNOPSIS +.Nm zdump +.Op Fl Vv +.Oo +.Fl c +.Oo Ar loyear , Oc Ns Ar hiyear +.Oc +.Oo +.Fl t +.Oo Ar lotime , Oc Ns Ar hitime +.Oc +.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 Ds +.It Xo +.Fl c +.Oo Ar loyear , Oc Ns Ar hiyear +.Xc +Cut off verbose output near the start of the given year(s). +By default, +the program cuts off verbose output near the start of the years \-500 and 2500. +.It Xo +.Fl t +.Oo Ar lotime , Oc Ns Ar hitime +.Xc +Cut off verbose output at the start of the given time(s), +given in 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. +.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 +.Dq isdst=1 +if the given time is Daylight Saving Time or +.Dq isdst=0 +otherwise. +.El +.Sh LIMITATIONS +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. +.Pp +In the output, +.Dq UT +denotes the value returned by +.Xr gmtime 3 , +which uses UTC for modern time stamps and some other UT flavor for +time stamps that predate the introduction of UTC. +No attempt is currently made to have the output use +.Dq UTC +for newer and +.Dq UT +for older time stamps, +partly because the exact date of the introduction of UTC is problematic. +.\" @(#)zdump.8 8.1 +.Sh SEE ALSO +.Xr ctime 3 , +.Xr tzfile 5 , +.Xr zic 8 +.\" This file is in the public domain, so clarified as of +.\" 2009-05-17 by Arthur David Olson. |
