-'\" -*- coding: UTF-8 -*-
.\" Copyright (C) 2010 Michael Krapp
.\"
.\" This program is free software; you can redistribute it and/or modify
-.\" it under the terms of the GNU General Public License as published by
+.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
-.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" 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 [\-frh] [ 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
can be examined.
.B utmpdump
-eads from stdin unless a
+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 utmp or wtmp files.
-.IP "\fB\-h\fR, \fB\-\-help\fP"
-Print a help text and exit.
-.IP "\fB\-V\fR, \fB\-\-version\fP"
-Output version information and exit.
+.TP
+.BR \-o , " \-\-output " \fIfile
+Write command output to \fIfile\fR instead of standard output.
+.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, then that file can be edited to remove
-bogus entries and reintegrated, using
-.PP
+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 purpose only.
+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
-use the option
+use the
.B \-r
-as the format for the utmp/wtmp files strongly depends on the input
+option, as the format for the utmp/wtmp files strongly depends on the input
format. This tool was
.B not
-written for normal use but for debugging.
+written for normal use, but for debugging only.
.SH AUTHOR
Michael Krapp
.SH "SEE ALSO"
.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 .