From c759f236bf5d7807ff6cf2d635393c4b7c85c744 Mon Sep 17 00:00:00 2001 From: Patrick Farrell Date: Thu, 2 Jan 2014 09:44:25 -0600 Subject: [PATCH] LU-4237 lfs: Include lfs mkdir in lfs man page This patch adds the usage information for lfs mkdir to the lfs man page. Signed-off-by: Patrick Farrell Change-Id: I33a7ad1f48d2a14ad6b0c212a38140622f47c8a7 Reviewed-on: http://review.whamcloud.com/8221 Tested-by: Jenkins Reviewed-by: Andreas Dilger Tested-by: Maloo Reviewed-by: Emoly Liu --- lustre/doc/lfs.1 | 26 +++++++++++++++++++++++++- 1 file changed, 25 insertions(+), 1 deletion(-) diff --git a/lustre/doc/lfs.1 b/lustre/doc/lfs.1 index 6f42109..6537be1 100644 --- a/lustre/doc/lfs.1 +++ b/lustre/doc/lfs.1 @@ -1,6 +1,6 @@ .TH lfs 1 "2009 Jan 29" Lustre "user utilities" .SH NAME -lfs \- Lustre utility to create a file with specific striping pattern, find the striping pattern of existing files +lfs \- Lustre utility to create a file with specific striping pattern, find the striping pattern of existing files, do certain quota operations, and manage distributed namespace options for directories .SH SYNOPSIS .br .B lfs @@ -84,6 +84,8 @@ lfs \- Lustre utility to create a file with specific striping pattern, find the .br .B lfs data_version [-n] \fB\fR .br +.B lfs mkdir <--index|-i mdt_index> +.br .B lfs help .SH DESCRIPTION .B lfs @@ -265,6 +267,25 @@ Even without -n, race conditions are possible and data version should be checked before and after an operation to be confident the data did not change during it. .TP +.B mkdir <--index|-i mdt_index> +Allocate a new directory on a specified MDT. + +The "lfs mkdir" command is only executable by root unless +"mdt.*.enable_remote_dir_gid" is set via "lctl set_param" to be either a +non-zero GID to limit it to a single group (e.g. "operator" or "admin"), +or "-1" to allow any group to create remote directories. + +The root of the file system is on MDT0000, and directories and files inherit the +MDT of their parent directory unless a different MDT is specified with this +command. + +By default, only directories on MDT0000 can contain directories that are not on +the same MDT. However, if "mdt.*.enable_remote_dir" is set non-zero on an MDT +then it will allow creating remote directories that have parents other than +MDT0000. This is restricted to avoid creating directory trees that have +intermediate path components on a series different MDTs and become unavailable +if any of the intermediate MDTs are offline. +.TP .B help Provides brief help on the various arguments .TP @@ -328,6 +349,9 @@ Set quotas of user `bob': 1GB block quota hardlimit and 2 GB block quota softlim .TP .B $ lfs setquota -t -u --block-grace 1000 --inode-grace 1w4d /mnt/lustre Set grace times for user quotas: 1000 seconds for block quotas, 1 week and 4 days for inode quotas +.TP +.B $ lfs mkdir -i 1 new_directory +Create directory 'new_directory' on the mdt with index 1. .SH BUGS The \fBlfs find\fR command isn't as comprehensive as \fBfind\fR(1). .SH AUTHOR -- 1.8.3.1