summaryrefslogtreecommitdiff
path: root/static/openbsd/man8/zdump.8
diff options
context:
space:
mode:
authorJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 19:54:44 -0400
committerJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 19:54:44 -0400
commita9157ce950dfe2fc30795d43b9d79b9d1bffc48b (patch)
tree9df484304b560466d145e662c1c254ff0e9ae0ba /static/openbsd/man8/zdump.8
parent160aa82b2d39c46ad33723d7d909cb4972efbb03 (diff)
docs: Added All OpenBSD Manuals
Diffstat (limited to 'static/openbsd/man8/zdump.8')
-rw-r--r--static/openbsd/man8/zdump.887
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.