Whamcloud - gitweb
LU-15115 ptlrpc: recalc timer on EINPROGRESS reply
[fs/lustre-release.git] / lustre / doc / lctl-snapshot-list.8
1 .TH LCTL-SNAPSHOT_LIST 8 "2017-05-13" Lustre "configuration utilities"
2 .SH NAME
3 lctl-snapshot_list \- query Lustre snapshot
4 .SH SYNOPSIS
5 .TP
6 .B lctl snapshot_list \fR[-d | --detail] {-F | --fsname fsname} [-h | --help]
7             [-n | --name ssname] [-r | --rsh remote_shell]
8 .br
9 .SH DESCRIPTION
10 Query the snapshot information, such as fsname of the snapshot, comment,
11 create time, the latest modification time, whether mounted or not, and so on.
12 .SH OPTIONS
13 .TP
14 .BR  -d ", " --detail
15 List all the information available for each piece of the snapshot on every
16 target (MGT/MDT/OST). Usually, the information for each piece of the snapshot
17 are the same unless some error occurred during the snapshot operations, such
18 as partly modified or mount. This option allows to check related issues.
19 .TP
20 .BR  -F ", " --fsname " "\fIfsname
21 The filesystem name.
22 .TP
23 .BR  -h ", " --help
24 For help information.
25 .TP
26 .BR  -n ", " --name " "\fIssname
27 The snapshot's name to be queried. If no snapshot name is specified, then all
28 the snapshots belonging to current Lustre filesystem will be listed.
29 .TP
30 .BR  -r ", " --rsh " "\fIremote_shell
31 Specify a shell to communicate with remote targets. The default value is
32 .BR ssh .
33 It is the system admin's duty to guarantee that the specified
34 .I remote_shell
35 works well among targets without password authentication.
36
37 .SH AVAILABILITY
38 .B lctl-snapshot-list
39 is part of the
40 .BR lustre (7)
41 filesystem package.
42 .SH SEE ALSO
43 .BR lctl (8),
44 .BR lctl-lcfg (8),
45 .BR lctl-barrier (8),
46 .BR lctl-snapshot-create (8),
47 .BR lctl-snapshot-destroy (8),
48 .BR lctl-snapshot-modify (8),
49 .BR lctl-snapshot-mount (8),
50 .BR lctl-snapshot-umount (8)