Whamcloud - gitweb
LU-11566 utils: improve usage/docs for lctl llog commands 04/34004/11
authorAndreas Dilger <adilger@whamcloud.com>
Thu, 10 Jan 2019 01:06:26 +0000 (18:06 -0700)
committerOleg Drokin <green@whamcloud.com>
Mon, 8 Apr 2019 05:35:26 +0000 (05:35 +0000)
commit2ec11b04dd76ea176ba9c76f809f576a04dafc1a
tree33c3d2da9897226843e26c28b90623505dfe6e8b
parent07b271c0972757772a129e9a6370dbb163f16a06
LU-11566 utils: improve usage/docs for lctl llog commands

Improve the usage message and man pages for the llog_print,
llog_info, llog_catlist, and llog_cancel sub-commands.  Move
them out of the obsolete section of the lctl usage message.

Reorder some man pages to be in alphabetical order in Makefile.

Add named options to the various commands to make them
consistent with each other.  The --catalog option is not
required for ease of use, but is kept for compatibility
with the previous llog_cancel interface.

The llog_cancel --log_id option is removed from the usage
message and man page, since the ability to cancel individual
records from MDT recovery logs is currently not implemented
(no IOC_LLOG_CANCEL handler in mdt_iocontrol()).  There is
also no IOC_LLOG_PRINT method for the MDS either, so these
commands are mostly useful only for the MGS configuration
logs at this time.

Add a test case for llog_cancel.

Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: I66c95c289f161370896e6764da4fc2f5803ebbe5
Reviewed-on: https://review.whamcloud.com/34004
Tested-by: Jenkins
Reviewed-by: Joseph Gmitter <jgmitter@whamcloud.com>
Reviewed-by: Ben Evans <bevans@cray.com>
Tested-by: Maloo <maloo@whamcloud.com>
Reviewed-by: Oleg Drokin <green@whamcloud.com>
lustre/doc/Makefile.am
lustre/doc/lctl-llog_cancel.8 [new file with mode: 0644]
lustre/doc/lctl-llog_catlist.8
lustre/doc/lctl-llog_info.8
lustre/doc/lctl-llog_print.8
lustre/obdclass/llog_ioctl.c
lustre/obdclass/obd_config.c
lustre/tests/conf-sanity.sh
lustre/utils/lctl.c
lustre/utils/obd.c