From ad6c5f9929b403b31bf6e926b7fa79529817f3f5 Mon Sep 17 00:00:00 2001 From: Andreas Dilger Date: Thu, 26 Jun 2025 15:43:32 -0600 Subject: [PATCH] LU-930 doc: remove mention of no_precreate option 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 Change-Id: Ibe49b4c8aea667b84890879171098787933f8ba6 Reviewed-on: https://review.whamcloud.com/c/fs/lustre-release/+/59952 Tested-by: jenkins Tested-by: Maloo Reviewed-by: Arshad Hussain Reviewed-by: Frederick Dilger Reviewed-by: Oleg Drokin --- Documentation/man1/lfs-df.1 | 14 ++++++++------ lustre/doc/mount.lustre.8 | 6 +++--- 2 files changed, 11 insertions(+), 9 deletions(-) diff --git a/Documentation/man1/lfs-df.1 b/Documentation/man1/lfs-df.1 index 02637e6..27e0d17 100644 --- a/Documentation/man1/lfs-df.1 +++ b/Documentation/man1/lfs-df.1 @@ -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 diff --git a/lustre/doc/mount.lustre.8 b/lustre/doc/mount.lustre.8 index 8367169..d084f43 100644 --- a/lustre/doc/mount.lustre.8 +++ b/lustre/doc/mount.lustre.8 @@ -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 -- 1.8.3.1