Include -Wunreachable-code when building.
[sysvinit.git] / man / 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 [ \-froh ]
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 .SH OPTIONS
29 .IP \fB\-f\fP
30 output appended data as the file grows.
31 .IP "\fB\-r\fP"
32 reverse. Write back edited login information into utmp or wtmp files.
33 .IP \fB\-o\fP
34 use old libc5 format.
35 .IP \fB\-h\fP
36 usage information.
37 .PP
38 utmpdump can be useful in cases of corrupted utmp or wtmp entries.
39 It can dump out utmp/wtmp to an ASCII file, then that file can
40 be edited to remove bogus entries and reintegrated, using
41 .PP
42 .sp 1
43 .in +1c
44 .nf
45 \fButmpdump -r < ascii file > wtmp\fP
46 .fi
47 .in -1c
48 .sp 1
49 but be warned as
50 .B utmpdump
51 was written for debugging purpose only.
52 .SH BUGS
53 You may
54 .B not
55 use the option \fB\-r\fP as the format for the
56 utmp/wtmp files strongly depends on the
57 input format. This tool was
58 .B not
59 written for normal use but for debugging.
60 .SH AUTHOR
61 Michael Krapp
62 .SH "SEE ALSO"
63 .BR last (1),
64 .BR w (1),
65 .BR who (1),
66 .BR utmp (5),