From c7ee88bfce7394121b6771657d5f40cfea022e37 Mon Sep 17 00:00:00 2001 From: Richard Henwood Date: Mon, 16 Dec 2024 14:04:23 -0500 Subject: [PATCH] LU-18564 doc: difference between lfs 'osts' and 'check ost' Update man page for lfs.1 to record commands behave differently. 'check ost' will perform RPC, 'osts' will not. Test-Parameters: trivial Signed-off-by: Richard Henwood Change-Id: If7faf0d0108fad2f79486ca1a768a23c99b1dfb3 Reviewed-on: https://review.whamcloud.com/c/fs/lustre-release/+/57468 Tested-by: jenkins Tested-by: Maloo Reviewed-by: Andreas Dilger Reviewed-by: Mathieu Dube Reviewed-by: Oleg Drokin --- lustre/doc/lfs.1 | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/lustre/doc/lfs.1 b/lustre/doc/lfs.1 index 7f35f98..033f768 100644 --- a/lustre/doc/lfs.1 +++ b/lustre/doc/lfs.1 @@ -24,13 +24,16 @@ as listed in the .B SEE ALSO section at the end. .TP -.BR check { mgts | mdts | osts | all "} [" \fIPATH ] +.BR check " {" mgts | mdts | osts | all "} [" \fIPATH ] Display the status of the MGTs, MDTs or OSTs (as specified in the command) or all the servers (MGTs, MDTs and OSTs). If .I PATH is provided, display the status of the lustre file system mounted at specified .I PATH -only. +only. This command will make an RPC to all the servers in scope to discover +the server status. NOTE: +.B lfs osts +may be preferable for some use cases. .TP .BR data_version " [" -nrw "] " \fIFILENAME Display the current version of file data and optionally set the data version @@ -59,7 +62,13 @@ See lfs-flushctx(1). List all the OSTs for all mounted filesystems. If a .I PATH is provided that is located on a lustre mounted file system -then only the OSTs belonging to that filesystem are displayed. +then only the OSTs belonging to that filesystem are displayed. This command will +use a cached value for the OST status and will not make a RPC to discover +status. The cached value will be updated by the client during the +course of normal operations and would typically be less than 30 seconds old. +NOTE: +.B lfs check osts +may be preferable for some use cases. .TP .BR pool_list " {" \fIFILESYSTEM }[ .\fIPOOLNAME "] | {" \fIPATHNAME } List the pools in -- 1.8.3.1