Whamcloud - gitweb
b693b9ce90f3f495318b78fc59dad3e0e671414f
[fs/lustre-release.git] / lustre / doc / lctl-device_list.8
1 .TH lctl-device_list 8 "2023-01-09" Lustre "configuration utilities"
2 .SH NAME
3 lctl device_list \- show all local Lustre Object Based Devices
4 .SH SYNOPSIS
5 .B lctl device_list
6 .RB "[ --target|-t ]"
7 .RB "[ --yaml|-y ]"
8
9 .B lctl dl
10 is the same command.
11 .SH DESCRIPTION
12 .B lctl device_list
13 reports details about the local Lustre OBDs. The information reported for the
14 OBD are the type, name, and UUID. Also reported are the device number, status
15 and reference count of the OBD device. The device number is needed for lctl
16 --device argument.
17 .TP
18 .SH OPTIONS
19 .TP
20 \fB\-t\fR, \fB\-\-target\fR
21 Retrieve the servers' export NID that communicates with the local OBD.
22 .TP
23 \fB\-y\fR, \fB\-\-yaml\fR
24 An option provided so that the OBD information can be provided in YAML format
25 .TP
26 .SH EXAMPLES
27 .TP
28 .B $ lctl --device_list -t -y
29 .SH AVAILABILITY
30 .B lctl device_list
31 is a subcommand of
32 .BR lctl (8)
33 and is distributed as part of the
34 .BR lustre (7)
35 filesystem package.
36 .SH SEE ALSO
37 .BR lctl (8),
38 .BR lustre (7)