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)