Whamcloud - gitweb
0636e411aa83d22c0906c3885f956ffca1beb9b6
[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" " [" -cDimOrTXy "]... " \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 \-X ",  " \-\-max-inherit
39 Show the inherit depth of default layout.
40 .TP
41 .BR \-y ", " \-\-yaml
42 Show the layout in YAML format for easier parsing.
43 .TP
44 .BR \-\-max-inherit-rr
45 Show the inherit depth of default layout to roundrobin mkdir.
46 .SH EXAMPLES
47 .TP
48 .B $ lfs getdirstripe -O lustre-MDT0001_UUID -r /mnt/lustre/dir1
49 List the striping information of sub-directories, that are located on MDT1,
50 under
51 .BR /mnt/lustre/dir1 .
52 .SH AVAILABILTY
53 The lfs getdirstripe command is part of the Lustre filesystem.
54 .SH SEE ALSO
55 .BR lfs (1),
56 .BR lfs-setdirstripe (1),
57 .BR lfs-getstripe (1),
58 .BR lustre (7)