Whamcloud - gitweb
LU-12616 obclass: fix MDS start/stop race
[fs/lustre-release.git] / lustre / doc / lfs-getdirstripe.1
1 .TH LFS-GETDIRSTRIPE 1 2017-11-07 "Lustre" "Lustre Utilities"
2 .SH NAME
3 lfs getdirstripe \- list the layout pattern of a given directory
4 .SH SYNOPSIS
5 .BR "lfs getdirstripe" " [" -cDimOrTy "]... " \fIDIR\fR...
6 .SH DESCRIPTION
7 Get the layout pattern of striped directories. This
8 .BR lfs (1)
9 command is similar to
10 .BR "lfs getstripe" ,
11 but is used for the directory layout.
12 .SH OPTIONS
13 .TP
14 .BR \-c ", " \-T ", " \-\-mdt-count
15 Only show the number of MDTs the directory is striped across.
16 .TP
17 .BR \-D ", " \-\-default
18 Show the default layout used when creating new subdirectories.
19 .TP
20 .BR \-H ", " \-\-mdt-hash
21 Only show the hash function being used for this directory.
22 .TP
23 .BR \-i ", " \-m ", " \-\-mdt-index
24 Only show the master MDT index of the directory.
25 .TP
26 \fB\-O\fR, \fB\-\-obd\fR=\fIFSNAME-MDTnnnn_UUID\fR
27 Limit the returned directories to those with objects on a specific MDT,
28 whose UUID is
29 .I FSNAME-MDTnnnn_UUID.
30 .TP
31 .BR \-r ", " \-\-recursive
32 The default behavior when a directory is specified is to list the striping
33 information for all sub-directories within the specified directory. This
34 can be expanded with
35 .BR --recursive ,
36 which will recurse into all subdirectories.
37 .TP
38 .BR \-y ", " \-\-yaml
39 Show the layout in YAML format for easier parsing.
40 .SH EXAMPLES
41 .TP
42 .B $ lfs getdirstripe -O lustre-MDT0001_UUID -r /mnt/lustre/dir1
43 List the striping information of sub-directories, that are located on MDT1,
44 under
45 .BR /mnt/lustre/dir1 .
46 .SH AVAILABILTY
47 The lfs getdirstripe command is part of the Lustre filesystem.
48 .SH SEE ALSO
49 .BR lfs (1),
50 .BR lfs-setdirstripe (1),
51 .BR lfs-getstripe (1),
52 .BR lustre (7)