[LUDOC-413] lfs mkdir documentation should be fixed

• Type: Bug
• Resolution: Unresolved
• Priority: Minor
• Environment: CentOS 7.5, Lustre 2.11.55
• Severity: 3
• Assignee: Lustre Manual Triage
• Reporter: Stephane Thiell

Description

Hello,
I think the lfs mkdir help/usage string should be clarified and fixed as it says the following:

$ lfs mkdir
lfs mkdir: DIR must be specified
To create a striped directory on a specified MDT. This can only
be done on MDT0 with the right of administrator.
usage: mkdir [OPTION] <directory>
		[--mdt-count|-c stripe_count>
		[--mdt-index|-i mdt_index]
		[--mdt-hash|-H mdt_hash]
		[--default|-D] [--mode|-m mode] <dir>
	stripe_count: stripe count of the striped directory
	mdt_index: MDT index of first stripe
	mdt_hash:  hash type of the striped directory. mdt types:
	fnv_1a_64 FNV-1a hash algorithm (default)
	all_char  sum of characters % MDT_COUNT (not recommended)
	default_stripe: set default dirstripe of the directory
	mode: the mode of the directory

This doesn't seem to be correct a striped directory can be created on other MDTs too, not only MDT0 right?

# lfs mkdir -c 1 -i 3 mdt3
# cd mdt3
# lfs mkdir -c 4 dnewide
# lfs getstripe --mdt-index dnewide
3
# cd dnewide
# touch 1 2 3 4
# lfs getstripe --mdt-index *
3
2
3
0

Thanks,
Stephane

Issue Links

• is related to: LUDOC-415 Update DNE documentation to capture setdirstripe and lfs mkdir -D