]> git.ipfire.org Git - thirdparty/util-linux.git/blob - login-utils/utmpdump.1
Merge branch 'master' of https://github.com/dankamongmen/util-linux
[thirdparty/util-linux.git] / login-utils / utmpdump.1
1 '\" -*- coding: UTF-8 -*-
2 .\" Copyright (C) 2010 Michael Krapp
3 .\"
4 .\" This program is free software; you can redistribute it and/or modify
5 .\" it under the terms of the GNU General Public License as published by
6 .\" the Free Software Foundation; either version 2 of the License, or
7 .\" (at your option) any later version.
8 .\"
9 .\" This program is distributed in the hope that it will be useful,
10 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
11 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 .\" GNU General Public License for more details.
13 .\"
14 .\" You should have received a copy of the GNU General Public License
15 .\" along with this program; if not, write to the Free Software
16 .\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17 .\"
18 .TH UTMPDUMP 1 "Februar 8, 2010" "" "Linux System Administrator's Manual"
19 .SH NAME
20 utmpdump \- dump UTMP and WTMP files in raw format
21 .SH SYNOPSIS
22 .B utmpdump
23 .RB [ \-frh ]
24 .I [ filename ]
25 .SH DESCRIPTION
26 \fButmpdump\fP is a simple program to dump UTMP and WTMP files
27 in raw format, so they can be examined.
28 \fButmpdump\fP reads from stdin unless a
29 .I filename
30 is passed.
31 .SH OPTIONS
32 .IP "\fB\-f, \-\-follow\fP"
33 output appended data as the file grows.
34 .IP "\fB\-r, \-\-reverse\fP
35 Undump, write back edited login information into utmp or wtmp files.
36 .IP "\fB\-h, \-\-help\fP"
37 Print a help text and exit.
38 .IP "\fB\-V, \-\-version\fP"
39 Output version information and exit.
40 .SH NOTES
41 utmpdump can be useful in cases of corrupted utmp or wtmp entries. It can dump
42 out utmp/wtmp to an ASCII file, then that file can be edited to remove bogus
43 entries and reintegrated, using
44 .PP
45 .sp 1
46 .in +1c
47 .nf
48 \fButmpdump -r < ascii file > wtmp\fP
49 .fi
50 .in -1c
51 .sp 1
52 but be warned as
53 .B utmpdump
54 was written for debugging purpose only.
55 .SH BUGS
56 You may
57 .B not
58 use the option \fB\-r\fP as the format for the
59 utmp/wtmp files strongly depends on the
60 input format. This tool was
61 .B not
62 written for normal use but for debugging.
63 .SH AUTHOR
64 Michael Krapp
65 .SH "SEE ALSO"
66 .BR last (1),
67 .BR w (1),
68 .BR who (1),
69 .BR utmp (5),