From 85bcdb66426a5fcc5dfd303c41dbfe2dfdd5bc29 Mon Sep 17 00:00:00 2001 From: Patrick Farrell Date: Fri, 4 Apr 2025 10:24:18 -0400 Subject: [PATCH] LU-18890 doc: add "lfs find -ls" option to lfs-find.1 man page The "lfs find -ls" option added in LU-15504 was not documented in the lustre/doc/lfs-find.1 man page. This patch adds proper documentation for this option, including: - Adding the option to the SYNOPSIS section - Adding a detailed description in the OPTIONS section - Adding an example showing how to use the option Fixes: 1d8164fa ("LU-15504 utils: lfs find -ls function") Test-Parameters: trivial Signed-off-by: Patrick Farrell Change-Id: Iecdc99d490f840c9beea62fb3b2c0bf49031b08c Reviewed-on: https://review.whamcloud.com/c/fs/lustre-release/+/58688 Reviewed-by: Andreas Dilger Reviewed-by: Timothy Day Reviewed-by: Frederick Dilger Reviewed-by: Oleg Drokin Tested-by: jenkins Tested-by: Maloo --- lustre/doc/lfs-find.1 | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/lustre/doc/lfs-find.1 b/lustre/doc/lfs-find.1 index 0ed0bc6..2ff027b 100644 --- a/lustre/doc/lfs-find.1 +++ b/lustre/doc/lfs-find.1 @@ -69,6 +69,7 @@ lfs-find \- Lustre client utility to list files with specific attributes .BR --layout | -L .BR mdt | raid0 | released ] .RB [ --lazy | -l ] +.RB [ --ls ] .br .RB [[ ! ] .B --links @@ -325,6 +326,9 @@ Files that have the first data component on an MDT. .BR -l ", " --lazy Use file size and blocks from MDT, if available, to avoid extra RPCs. .TP +.BR --ls +Print files in a format similar to 'ls -l', showing the inode number, allocated blocks, permissions, link count, owner, group, size, file type, and path. This is equivalent to using --printf with the format string "%i\t%k\t%M\t%n\t%u\t%g\t%s\t%t\t%p\n". +.TP .BR --links File has .I N @@ -869,6 +873,14 @@ but that do NOT have an SELinux extended attribute with a value containing /var/www .EE .RE +.PP +Recursively list all files in a directory with detailed information in a format +similar to 'ls -l': +.RS +.EX +.B # lfs find /mnt/lustre --ls +.EE +.RE .SH AVAILABILITY .B lfs find is part of the -- 1.8.3.1