man pages: Change a HYPHEN-MINUS (-) to a minus (\-) for options and numbers

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

diff --git a/login-utils/utmpdump.1 b/login-utils/utmpdump.1
index 7a7442a8e7f028cae7f5ffa8c82af73ed66c7c64..d98117da4cdedba7b7b077f34aad8aa313b7728d 100644 (file)
--- a/login-utils/utmpdump.1
+++ b/login-utils/utmpdump.1
@@ -1,4 +1,3 @@
-'\" -*- coding: UTF-8 -*-
 .\" Copyright (C) 2010 Michael Krapp
 .\"
 .\" This program is free software; you can redistribute it and/or modify
@@ -15,11 +14,12 @@
 .\" 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
-utmpdump [\-frohV] [ filename ]
+.BR utmpdump " [options]"
+.RI [ filename ]
 .SH DESCRIPTION
 .B utmpdump
 is a simple program to dump UTMP and WTMP files in raw format, so they
@@ -29,29 +29,46 @@ 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\-r\fR, \fB\-\-reverse\fP
-Undump, write back edited login information into the utmp or wtmp files.
-.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\-h\fR, \fB\-\-help\fP"
-Display help text and exit.
-.IP "\fB\-V\fR, \fB\-\-version\fP"
+.TP
+.BR \-r , " \-\-reverse"
+Undump, write back edited login information into the utmp or wtmp files.
+.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
-out utmp/wtmp to an ASCII file, whic can then be edited to remove
-bogus entries and reintegrated, using
+out utmp/wtmp to an ASCII file, which can then be edited to remove
+bogus entries, and reintegrated using:
 .PP
 .RS
-utmpdump -r < ascii_file > wtmp
+.B utmpdump \-r < ascii_file > wtmp
 .RE
 .PP
-but be warned, as
+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 .