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" " [" -cDhHimOrTXvy "]... " \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 ", " \-\-help
  21 Print usage message.
  22 .TP
  23 .BR \-H ", " \-\-mdt-hash
  24 Only show the hash function being used for this directory.
  25 .TP
  26 .BR --hex-idx
  27 Print MDT indexes in hexademical rather than decimal.
  28 .TP
  29 .BR \-i ", " \-m ", " \-\-mdt-index
  30 Only show the master MDT index of the directory.
  31 .TP
  32 \fB\-O\fR, \fB\-\-obd\fR=\fIFSNAME-MDTnnnn_UUID\fR
  33 Limit the returned directories to those with objects on a specific MDT,
  34 whose UUID is
  35 .I FSNAME-MDTnnnn_UUID.
  36 .TP
  37 .BR \-r ", " \-\-recursive
  38 The default behavior when a directory is specified is to list the striping
  39 information for all sub-directories within the specified directory. This
  40 can be expanded with
  41 .BR --recursive ,
  42 which will recurse into all subdirectories.
  43 .TP
  44 .BR \-X ",  " \-\-max-inherit
  45 Show the inherit depth of default layout.
  46 .TP
  47 .BR \-y ", " \-\-yaml
  48 Show the layout in YAML format for easier parsing.
  49 .TP
  50 .BR \-\-max-inherit-rr
  51 Show the inherit depth of default layout to roundrobin mkdir.
  52 .SH EXAMPLES
  53 .TP
  54 .B $ lfs getdirstripe -O lustre-MDT0001_UUID -r /mnt/lustre/dir1
  55 List the striping information of sub-directories, that are located on MDT1,
  56 under
  57 .BR /mnt/lustre/dir1 .
  58 .SH AVAILABILTY
  59 The lfs getdirstripe command is part of the Lustre filesystem.
  60 .SH SEE ALSO
  61 .BR lfs (1),
  62 .BR lfs-setdirstripe (1),
  63 .BR lfs-getstripe (1),
  64 .BR lustre (7)