1 .TH lfs-getstripe 1 "2018-01-24" Lustre "user utilities"
3 lfs getstripe \- Lustre client command to print layout parameters of a file
6 [\fB--component-count\fR|\fB--comp-count\fR]
7 [\fB--component-end\fR|\fB--comp-end\fR|\fB-E\fR[\fB=\fR[\fB+-\fR]\fIend\fR[\fBKMGTPE\fR]]
8 [\fB--component-flags\fR|\fB--comp-flags\fR[\fB=\fIflags\fR]]
9 [\fB--component-id\fR|\fB--comp-id\fR[=\fIid\fR]|\fB-I\fR[\fIid\fR]]
10 [\fB--component-start\fR[\fB=\fR[\fB+-\fR]\fIstart\fR[\fBKMGTPE\fR]]]
11 [\fB--extension-size\fR|\fB--ext-size\fR|\fB-z\fR]
12 [\fB--directory\fR|\fB-d\fR]
13 [\fB--fid\fR|\fB-F\fR]
14 [\fB--generation\fR|\fB-g\fR]
15 [\fB--layout\fR|\fB-L\fR]
16 [\fB--mdt\fR|\fB--mdt-index\fR|\fB-m\fR]
17 [\fB--ost\fR|\fB-O\fR <\fIuuid\fR>]
18 [\fB--pool\fR|\fB-p\fR]
19 [\fB--quiet\fR|\fB-q\fR]
20 [\fB--recursive\fR|\fB-r\fR]
21 [\fB--raw\fR|\fB-R\fR]
22 [\fB--stripe-count\fR|\fB-c\fR]
23 [\fB--stripe-index\fR|\fB-i\fR]
24 [\fB--stripe-size\fR|\fB-S\fR]
25 [[\fB!\fR] \fB--mirror-index\fR=[\fB+-\fR]\fI<index>\fR | [\fB!\fR] \fB--mirror-id\fR=[\fB+-\fR]\fI<id>\fR]
26 [\fB--verbose\fR|\fB-v\fR]
27 [\fB--yaml\fR|\fB-y\fR]
28 <\fIdirname\fR|\fIfilename\fR> ...
31 is used to list the layout/striping information for a given filename or
32 directory tree. By default the stripe_count, stripe_size, stripe_offset,
33 and allocated OST objects for each file will be shown. If you only want
34 specific layout information to be printed, then the
37 .BR --extension-size ,
43 .BR --component-flags ,
44 .BR --component-count ,
45 .BR --component-start ,
52 options, or equivalent single-character options, can be used without an
53 argument to return only the specified field(s).
55 You can limit the displayed content to one or more specific components or
56 mirror of a composite file layout by specifying the matching
59 .BR --component-flags ,
60 .BR --component-start ,
65 or their single-character options. For single-character options, the
66 argument must follow the option without a space, and for long options an
70 The default behavior when a directory is specified is to list the striping
71 information for all files within the specified directory (like
72 .RB ' "ls -l <directory>" ').
75 .BR --component-count | --comp-count
76 Print only the number of components in the file's layout.
78 .BR --component-end | --comp-end [ = [ +- ] \fIend [ KMGTPE ]]| -E [[ +- ] \fIend [ KMGTPE ]]
79 Print only the component end offset (in bytes) for the component(s).
82 offset is specified (with optional suffix for SI units), print only the
83 attributes of the component(s) with the given end offset. If
87 is used, print components with respectively a larger or smaller
91 .BR --component-flags | --comp-flags [ = [ ^ ] \fIflag ,...]]
92 Print only the component flags. If
94 is specified, print only components matching the specified
98 is used, print only components not matching
100 Multiple flags may be specified, separated by commas. Valid flag names are:
104 Component has been initialized (has allocated OST objects).
107 Replicated (mirrored) components that do not have up-to-date data. Stale
108 components will not be used for read or write operations, and need to be
111 before they can be accessed again.
114 Replicated (mirrored) components that are preferred for read or write.
115 For example, because they are located on SSD-based OSTs, or are more
116 local on the network to clients.
119 Replicated (mirrored) components that do not resync using \fB
120 lfs mirror resync\fR. Files with the \fBnosync\fR flag will also
121 print the timestamp when the flag was set on the replica.
124 .BR --component-id | --comp-id [ =\fIid ]| -I [ \fIid ]
125 Print only the component ID number for the component(s). The file-unique
126 component ID is assigned as each component is created, and is not re-used.
129 necessarily related to the offset of the component within the file, in
130 particular since replicated file layouts may have overlapping extents.
133 is specified, then print only the fields for the matching component.
135 .BR --component-start | --comp-start [ = [ +- ] \fIstart [ KMGTPE ]]
136 Print only the component start offset (in bytes) for the component(s).
139 offset is specified (with optional suffix for SI units), print only the
140 attributes of the component(s) with the given starting offset. If
144 is used, print components with respectively a larger or smaller
148 .BR --mirror-index = [\fB+-\fR]\fR<\fIindex\fR>
149 Print only the components of \fI<index>\fR-th mirror, based on the order
150 that the mirror components are stored in the file layout, The \fIindex\fR
155 is used, print components of mirror(s) respectively a later or earlier
156 \fIindex\fR-th mirror.
160 Negates the meaning. Using + before \fIindex\fR means mirror appears 'later
162 - before \fIindex\fR means mirror appears 'earlier than \fIindex\fR'. If
163 neither is used, it means 'equal to \fIindex\fR'.
166 .BR --mirror-id = [\fB+-\fR]\fR<\fIid\fR>
167 Print only the component s of the mirror with ID of \fIid\fR. The mirror IDs
168 are assigned to new mirrors as they are created, but may not be sequential if
169 some mirrors are removed. If
173 is used, print components of mirror(s) with respectively a larger or smaller
180 Negates the meaning. Using + before \fIid\fR means mirror with ID 'larger
181 than \fIid\fR', - before \fIid\fR means mirror with ID 'smaller than \fIid\fR'.
182 If neither is used, it means 'equal to \fIid\fR'.
186 Get striping information for only the specified directory, like
190 Show only the 128-bit unique Lustre File Identifier (FID).
193 Print only the layout generation number.
196 Show only the file layout, which is one of:
200 Traditional Lustre RAID-0 striping format.
203 HSM-archived files that are not resident in the filesystem.
206 Files that have the first data component on an MDT.
209 .BR --mdt | --mdt-index | -m
210 Show the MDT index on which the file or directory inode is located.
213 Print the starting OST index for the file layout.
216 Print only the OST pool name on which the file was created.
219 Print only allocated objects for each file, not other layout parameters.
222 Print layout information without substituting the filesystem's default values
223 for unspecified fields. If the file layout is not set, 0, 0, and -1 will be
224 printed for the stripe_count, stripe_size, and stripe_offset respectively.
227 Recurse into all subdirectories.
229 .BR --stripe-count | -c
230 Print the number of stripes in the file. For composite files this is
231 the stripe count of the last initialized component.
233 .BR --stripe-index | -i
234 Print the starting OST index for the file layout.
236 .BR --stripe-size | -S
237 Print the stripe size in bytes. For composite files this is the stripe
238 size of the last initialized component.
240 .BR --extension-size | --ext-size | -z
241 Print the extension size in bytes. For composite files this is the extension
242 size of the first extension component.
245 Also print the layout magic, FID sequence, FID object ID, and FID, in
246 addition to the normally-printed attributes.
249 Always print the layout in YAML format, rather than only using this
250 format for composite files.
254 .B $ lfs getstripe -v /mnt/lustre/file1
255 List the detailed object allocation of the given file.
257 .B $ lfs getstripe -v -I2 /mnt/lustre/file1
258 List the detailed information of only component with ID 2 of the given file.
260 .B $ lfs getstripe --mirror-index=+1 /mnt/lustre/file1
261 Print the mirror(s) appearing later than the first mirror in the the file.
263 .B $ lfs getstripe ! --mirror-id=2 /mnt/lustre/file1
264 Print the mirror(s) with mirror ID other than 2 in the file.
266 .B $ lfs getstripe --component-flags=^init -I /mnt/lustre/file1
267 Print only the component IDs for all the uninitialized components.
269 .B $ lfs getstripe --component-flags=init,^stale -I /mnt/lustre/file1
270 Print only the component(s) that are instantiated but not stale.
272 .B $ lfs getstripe -E-64M /mnt/lustre/file1
273 List information of components in a file with extent end less than 64MiB.
275 .B $ lfs getstripe -I3 --component-start /mnt/lustre/file1
276 Print only the component start for the component with ID of 3
278 .B $ lfs getstripe --yaml /mnt/lustre/file1
279 Lists the information of the components of a file in YAML format.
281 The lfs command is part of the Lustre filesystem.
285 .BR lfs-getdirstripe (1),
286 .BR lfs-setstripe (1),