lustre/doc/lctl-llog_print.8

   1 .TH lctl-llog_print 8 "2019 Jan 10" Lustre "configuration utilities"
   2 .SH NAME
   3 lctl llog_print \- print the content of a configuration log
   4 .SH SYNOPSIS
   5 .B lctl llog_print
   6 .RB [ --start
   7 .IR start_index ]
   8 .RB [ --end
   9 .IR end_index ]
  10 .RI < logname >
  11
  12 .SH DESCRIPTION
  13 .B lctl llog_print
  14 is used to dump the contents of the
  15 .I logname
  16 configuration log on the MGS in YAML format.  This is useful for debugging
  17 configuration problems and to list any permanent configuration options
  18 saved via
  19 .B lctl conf_param
  20 on the MGS.  The
  21 .B lctl llog_catlist
  22 command can be used to list the different configuration logs, and the
  23 .B lctl llog_cancel
  24 command can be used to cancel configuration records.
  25 .SH OPTIONS
  26 .TP
  27 .B --end
  28 Stop printing records at
  29 .IR end_index .
  30 .TP
  31 .B --start
  32 Start printing records at
  33 .IR start_index .
  34 .TP
  35 .B logname
  36 The name of the configuration log, in the form
  37 .IR fsname - target ,
  38 like
  39 .B testfs-client
  40 or
  41 .BR lustrefs-MDT0000 .
  42 .TP
  43 .I start_index
  44 The first record number in the config log to dump.  Note that deactivated
  45 records and comment records will not be printed.
  46 .TP
  47 .I end_index
  48 The last record number in the config log to dump, including the specified
  49 index number.
  50 .SH EXAMPLES
  51 .TP
  52 To print the configuration records from the \fBtestfs-client\fR logfile:
  53 .br
  54 # lctl --device MGS llog_print testfs-client
  55 .br
  56 - { index: 3, event: attach, device: testfs-clilov, type: lov,
  57 .br
  58     UUID: testfs-clilov_UUID }
  59 .br
  60 - { index: 6, event: setup, device: testfs-clilov, UUID: }
  61 .br
  62 - { index: 9, event: attach, device: testfs-clilmv, type: lov,
  63 .br
  64     UUID: testfs-clilmv_UUID }
  65 .br
  66 - { index: 12, event: setup, device: testfs-clilmv, UUID: }
  67 .br
  68 - { index: 15, add_uuid: nid: 10.211.55.6@tcp(0x200000ad33706),
  69 .br
  70     node: 10.211.55.6@tcp }
  71 .br
  72 :
  73 .br
  74 :
  75 .TP
  76 To print the first 10 \fBset_param -P\fR records from \fBparams\fR:
  77 # lctl --device MGS llog_print --end=10 params
  78 .br
  79 - { index: 2, event: set_param, device: general, parameter: osc.*.max_dirty_mb, value: 32 }
  80 .br
  81 - { index: 4, event: set_param, device: general, parameter: osc.*.checksum_type, value: crc32c }
  82 .SH AVAILABILITY
  83 .B lctl llog_print
  84 is a subcommand of
  85 .BR lctl (8)
  86 and is distributed as part of the
  87 .BR lustre (7)
  88 filesystem package.
  89 .SH SEE ALSO
  90 .BR lctl (8),
  91 .BR lctl-llog_info (8),
  92 .BR lctl-llog_cancel (8),
  93 .BR lctl-llog_catlist (8)