Whamcloud - gitweb
LU-930 doc: remove mention of no_precreate option 52/59952/3
authorAndreas Dilger <adilger@whamcloud.com>
Thu, 26 Jun 2025 21:43:32 +0000 (15:43 -0600)
committerOleg Drokin <green@whamcloud.com>
Tue, 8 Jul 2025 04:00:29 +0000 (04:00 +0000)
The no_precreate mount option and obdfilter tunable parameter is
deprecated, so remove it from the man pages.  It will continue
to work for the next few Lustre releases, but will be removed in
Lustre 2.21.

Test-Parameters: trivial
Fixes: 614a76c466 ("LU-930 doc: document no_create mount option")
Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: Ibe49b4c8aea667b84890879171098787933f8ba6
Reviewed-on: https://review.whamcloud.com/c/fs/lustre-release/+/59952
Tested-by: jenkins <devops@whamcloud.com>
Tested-by: Maloo <maloo@whamcloud.com>
Reviewed-by: Arshad Hussain <arshad.hussain@aeoncomputing.com>
Reviewed-by: Frederick Dilger <fdilger@whamcloud.com>
Reviewed-by: Oleg Drokin <green@whamcloud.com>
Documentation/man1/lfs-df.1
lustre/doc/mount.lustre.8

index 02637e6..27e0d17 100644 (file)
@@ -63,13 +63,15 @@ on the OST.  This target will be avoided for new allocations, but
 will still be used for existing files located there or if there are
 not enough non-degraded OSTs to make up a widely-striped file.
 .TP
-.B N: no-precreate
-The target is configured to deny object precreation by the
-.BI "'lctl set_param obdfilter." TARGET ".no_precreate=1'"
+.B N: no-create
+The target is configured to deny new OST object creation by the
+.BI "'lctl set_param obdfilter." FSNAME -OST XXXX ".no_create=1'"
+option, or new subdirectory creation by the
+.BI "'lctl set_param obdfilter." FSNAME -MDT XXXX ".no_create=1'"
 parameter or
-.B '-o no_precreate'
-mount option.  This may be done to add an OST to the filesystem without
-allowing objects to be allocated on it yet, or for other reasons.
+.B '-o no_create'
+mount option.  This can be used to add an OST or MDT to the filesystem
+without allowing objects to be allocated on it yet, or for other reasons.
 .TP
 .B R: read-only
 The target filesystem is marked read-only due to filesystem
index 8367169..d084f43 100644 (file)
@@ -270,10 +270,10 @@ on an MDT after mounting. This allows a (potentially newly-formatted)
 MDT or OST to be started without clients starting to use it immediately.
 To allow the new target to be used for allocation, unmount and mount the
 target again without this option, or run
-.BI "lctl set_param mdt." fsname -OST nnnn .no_create=0
+.BI "'lctl set_param obdfilter." FSNAME -OST XXXX ".no_create=0'"
 or
-.BI "lctl set_param obdfilter." fsname -MDT nnnn .no_create=0
-on the server node.
+.BI "'lctl set_param mdt." FSNAME -MDT XXXX ".no_create=0'"
+on the appropriate server node.
 .BR NOTE :
 this does not start the OST or MDT read-only, it only disables the
 creation of new objects there. This means existing objects can be