scriptreplay: cleanup usage()

[thirdparty/util-linux.git] / login-utils / utmpdump.1

diff --git a/login-utils/utmpdump.1 b/login-utils/utmpdump.1
index 933a3c9a70aa8a3f5de0cdba49dc0774cff87b07..9e6b5a3c27f1644fada498a4955b1ca966de5faf 100644 (file)
--- a/login-utils/utmpdump.1
+++ b/login-utils/utmpdump.1
@@ -14,7 +14,7 @@
 .\" along with this program; if not, write to the Free Software
 .\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 .\"
-.TH UTMPDUMP "1" "July 2012" "util-linux" "System Administration"
+.TH UTMPDUMP 1 "July 2014" "util-linux" "User Commands"
 .SH NAME
 utmpdump \- dump UTMP and WTMP files in raw format
 .SH SYNOPSIS
@@ -29,16 +29,21 @@ reads from stdin unless a
 .I filename
 is passed.
 .SH OPTIONS
-.IP "\fB\-f\fR, \fB\-\-follow\fP"
+.TP
+.BR \-f , " \-\-follow"
 Output appended data as the file grows.
-.IP "\fB\-o\fR, \fB\-\-output\fP \fIfile\fR
+.TP
+.BR \-o , " \-\-output " \fIfile
 Write command output to \fIfile\fR instead of standard output.
-.IP "\fB\-r\fR, \fB\-\-reverse\fP
+.TP
+.BR \-r , " \-\-reverse"
 Undump, write back edited login information into the utmp or wtmp files.
-.IP "\fB\-h\fR, \fB\-\-help\fP"
-Display help text and exit.
-.IP "\fB\-V\fR, \fB\-\-version\fP"
+.TP
+.BR \-V , " \-\-version"
 Display version information and exit.
+.TP
+.BR \-h , " \-\-help"
+Display help text and exit.
 .SH NOTES
 .B utmpdump
 can be useful in cases of corrupted utmp or wtmp entries.  It can dump
@@ -52,6 +57,18 @@ bogus entries, and reintegrated using:
 But be warned,
 .B utmpdump
 was written for debugging purposes only.
+.SS File formats
+.PP
+Only the binary version of the
+.BR utmp (5)
+is standardised.  Textual dumps may become incompatible in future.
+.PP
+The version 2.28 was the last one that printed text output using
+.BR ctime (3)
+timestamp format.  Newer dumps use millisecond precision ISO-8601 timestamp
+format in UTC-0 timezone.  Conversion from former timestamp format can be
+made to binary, although attempt to do so can lead the timestamps to drift
+amount of timezone offset.
 .SH BUGS
 You may
 .B not
@@ -71,6 +88,6 @@ Michael Krapp
 .SH AVAILABILITY
 The utmpdump command is part of the util-linux package and is available
 from
-.UR ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
+.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
 Linux Kernel Archive
 .UE .