Whamcloud - gitweb
LU-11566 utils: fix lctl llog_print for large configs
[fs/lustre-release.git] / lustre / doc / lctl-llog_print.8
1 .TH lctl-llog_print 8 "2017 Feb 24" 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.
21 .SH OPTIONS
22 .TP
23 .B --end
24 Stop printing records at
25 .IR end_index .
26 .TP
27 .B --start
28 Start printing records at
29 .IR start_index .
30 .TP
31 .B logname
32 The name of the configuration log, in the form
33 .IR fsname - target ,
34 like
35 .B testfs-client
36 or
37 .BR lustrefs-MDT0000 .
38 .TP
39 .I start_index
40 The first record number in the config log to dump.  Note that deactivated
41 records and comment records will not be printed.
42 .TP
43 .I end_index
44 The last record number in the config log to dump, including the specified
45 index number.
46 .SH EXAMPLES
47 .TP
48 To print all of the records from the testfs-client configuration log:
49 .br
50 # lctl --device MGS llog_print testfs-client
51 .br
52 - { index: 3, event: attach, device: testfs-clilov, type: lov,
53 .br
54     UUID: testfs-clilov_UUID }
55 .br
56 - { index: 6, event: setup, device: testfs-clilov, UUID: }
57 .br
58 - { index: 9, event: attach, device: testfs-clilmv, type: lov,
59 .br
60     UUID: testfs-clilmv_UUID }
61 .br
62 - { index: 12, event: setup, device: testfs-clilmv, UUID: }
63 .br
64 - { index: 15, add_uuid: nid: 10.211.55.6@tcp(0x200000ad33706),
65 .br
66     node: 10.211.55.6@tcp }
67 .br
68 :
69 .br
70 :
71 .SH AVAILABILITY
72 .B lctl llog_print
73 is a subcommand of
74 .BR lctl (8)
75 and is distributed as part of the
76 .BR lustre (7)
77 filesystem package.
78 .SH SEE ALSO
79 .BR lctl (8)
80 .BR lctl-llog_info (8)
81 .BR lctl-llog_catlist (8)