Whamcloud - gitweb
LU-56 lnet: allow to create EQ with zero eq_size
[fs/lustre-release.git] / lustre / doc / llog_reader.8
1 .TH llog_reader 8 "2009 Apr 02" Lustre "System management commands"
2 .SH NAME
3 llog_reader \- lustre on-disk log parsing utility
4 .SH SYNOPSIS
5 .B "llog_reader filename"
6 .br
7 .SH DESCRIPTION
8 .B llog_reader
9 parses the binary format of Lustre's on-disk configuration logs.
10 It can only read the logs.  Use
11 .B tunefs.lustre
12 to write to them.
13 .LP
14 To examine a log file on a stopped Lustre server, first mount its
15 backing file system as ldiskfs, then use
16 .B llog_reader
17 to dump the log file's contents, e.g.
18 .IP
19 .nf
20 mount -t ldiskfs /dev/sda /mnt/mgs
21 llog_reader /mnt/mgs/CONFIGS/tfs-client
22 .fi
23 .LP
24 To examine the same log file on a running Lustre server, use the
25 ldiskfs-enabled debugfs utility (called
26 .B debug.ldiskfs
27 on some distros) to extract the file, e.g.
28 .IP
29 .nf
30 debugfs -c -R 'dump CONFIGS/tfs-client /tmp/tfs-client' /dev/sda
31 llog_reader /tmp/tfs-client
32 .fi
33 .SH CAVEATS
34 Although they are stored in the CONFIGS directory, \fImountdata\fR
35 files do not use the config log format and will confuse \fBllog_reader\fR.
36 .SH SEE ALSO
37 Lustre Operations Manual, Section 21.1, \fITroubleshooting Lustre\fR.
38 .br
39 .BR lustre (7),
40 .BR tunefs.lustre (8)