login-utils/utmpdump.1

   1 .\" Copyright (C) 2010 Michael Krapp
   2 .\"
   3 .\" This program is free software; you can redistribute it and/or modify
   4 .\" it under the terms of the GNU General Public License as published by
   5 .\" the Free Software Foundation; either version 2 of the License, or
   6 .\" (at your option) any later version.
   7 .\"
   8 .\" This program is distributed in the hope that it will be useful,
   9 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  10 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  11 .\" GNU General Public License for more details.
  12 .\"
  13 .\" You should have received a copy of the GNU General Public License
  14 .\" along with this program; if not, write to the Free Software
  15 .\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  16 .\"
  17 .TH UTMPDUMP "1" "July 2012" "util-linux" "System Administration"
  18 .SH NAME
  19 utmpdump \- dump UTMP and WTMP files in raw format
  20 .SH SYNOPSIS
  21 .BR utmpdump " [options]"
  22 .RI [ filename ]
  23 .SH DESCRIPTION
  24 .B utmpdump
  25 is a simple program to dump UTMP and WTMP files in raw format, so they
  26 can be examined.
  27 .B utmpdump
  28 reads from stdin unless a
  29 .I filename
  30 is passed.
  31 .SH OPTIONS
  32 .IP "\fB\-f\fR, \fB\-\-follow\fP"
  33 Output appended data as the file grows.
  34 .IP "\fB\-o\fR, \fB\-\-output\fP \fIfile\fR
  35 Write command output to \fIfile\fR instead of standard output.
  36 .IP "\fB\-r\fR, \fB\-\-reverse\fP
  37 Undump, write back edited login information into the utmp or wtmp files.
  38 .IP "\fB\-h\fR, \fB\-\-help\fP"
  39 Display help text and exit.
  40 .IP "\fB\-V\fR, \fB\-\-version\fP"
  41 Display version information and exit.
  42 .SH NOTES
  43 .B utmpdump
  44 can be useful in cases of corrupted utmp or wtmp entries.  It can dump
  45 out utmp/wtmp to an ASCII file, which can then be edited to remove
  46 bogus entries, and reintegrated using:
  47 .PP
  48 .RS
  49 .B utmpdump -r < ascii_file > wtmp
  50 .RE
  51 .PP
  52 But be warned,
  53 .B utmpdump
  54 was written for debugging purposes only.
  55 .SH BUGS
  56 You may
  57 .B not
  58 use the
  59 .B \-r
  60 option, as the format for the utmp/wtmp files strongly depends on the input
  61 format.  This tool was
  62 .B not
  63 written for normal use, but for debugging only.
  64 .SH AUTHOR
  65 Michael Krapp
  66 .SH "SEE ALSO"
  67 .BR last (1),
  68 .BR w (1),
  69 .BR who (1),
  70 .BR utmp (5)
  71 .SH AVAILABILITY
  72 The utmpdump command is part of the util-linux package and is available
  73 from
  74 .UR ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
  75 Linux Kernel Archive
  76 .UE .