lustre/doc/lctl-llog_cancel.8

   1 .TH lctl-llog_cancel 8 "2019 Jan 10" Lustre "configuration utilities"
   2 .SH NAME
   3 lctl llog_cancel \- cancel a record in a Lustre llog file
   4 .SH SYNOPSIS
   5 .B lctl --device
   6 .RI < device >
   7 .B llog_cancel --log_idx
   8 .RI < index >
   9 .RI < logname >
  10
  11 .SH DESCRIPTION
  12 .B lctl llog_cancel
  13 is used to cancel the configuration record given by
  14 .I index
  15 from the
  16 .I logname
  17 configuration log, typically on the MGS.  This is useful if a persistent
  18 configuration record was set incorrectly or is no longer needed.  Note
  19 that cancelling a record does not "undo" any effect it had on currently
  20 mounted clients, it only prevents the record from being seen in the future.
  21 See
  22 .BR lctl-llog_catlist (8)
  23 for a list of configuration logs.
  24 .SH OPTIONS
  25 .TP
  26 .B --log_idx
  27 .I index
  28 The record
  29 .I index
  30 number to cancel, as printed by
  31 .B lctl llog_print
  32 for that log.
  33 .TP
  34 .SH EXAMPLES
  35 .TP
  36 To cancel record 15 from the \fBtestfs-client\fR conf_param log:
  37 .br
  38 # lctl --device MGS llog_cancel --log_idx=15 testfs-client
  39 .TP
  40 To cancel record 22 from the \fBparams\fR set_param log:
  41 .br
  42 # lctl --device MGS llog_cancel --log_idx=22 params
  43 .SH AVAILABILITY
  44 .B lctl llog_cancel
  45 is a subcommand of
  46 .BR lctl (8)
  47 and is distributed as part of the
  48 .BR lustre (7)
  49 filesystem package.
  50 .SH SEE ALSO
  51 .BR lctl (8),
  52 .BR lctl-llog_info (8),
  53 .BR lctl-llog_catlist (8),
  54 .BR lctl-llog_print (8)