Whamcloud - gitweb
LU-11473 doc: add lfs-getsom man page 90/33290/2
authorJames Nunez <jnunez@whamcloud.com>
Thu, 4 Oct 2018 21:32:42 +0000 (15:32 -0600)
committerOleg Drokin <green@whamcloud.com>
Fri, 12 Oct 2018 23:50:34 +0000 (23:50 +0000)
The Lazy Size on MDT feature added a flag to 'lfs' to allow
users to get the LSOM data. Add the lfs "getsom" flag to the
lfs man page.

Also, make a minor correction to the llsom_sync man page that
corrects the order of the --device flag for changelog_register
and changelog_deregister.

Test-Parameters: trivial
Signed-off-by: James Nunez <jnunez@whamcloud.com>
Change-Id: I9a5acab6de3b7f32eb246c94e9975e30f63f10e1
Reviewed-on: https://review.whamcloud.com/33290
Tested-by: Jenkins
Tested-by: Maloo <hpdd-maloo@intel.com>
Reviewed-by: Yingjin Qian <qian@ddn.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>
Reviewed-by: Oleg Drokin <green@whamcloud.com>
lustre/doc/lfs-getsom.1 [new file with mode: 0644]

diff --git a/lustre/doc/lfs-getsom.1 b/lustre/doc/lfs-getsom.1
new file mode 100644 (file)
index 0000000..64e2164
--- /dev/null
@@ -0,0 +1,35 @@
+.TH LFS-GETSOM 1 2018-10-04 "Lustre" "lustre Utilities"
+lfs getsom \- list file attributes that are stored on an MDS
+.B lfs getsom
+[\fB\-s\fR | \fB\-b\fR | \fB\-f\fR] <file>
+This command lists file attributes that are stored on the MDS. It is called
+with the full path and file name for a file on the Lustre file system. If no
+flags are used, then all file attributes stored on the MDS will be shown.
+.BR \-s\fR
+Only show the size value of the SOM data for a given file.
+.BR \-b\fR
+Only show the blocks value of the SOM data for a given file.
+.BR \-f\fR
+Only show the flag value of the SOM data for a given file.Valid flags are:
+0 - Unknown or no SoM data, must get size from OSTs.
+1 - Known strictly correct, FLR or DoM file (SoM guaranteed).
+2 - Known stale - was right at some point in the past, but it is known
+(or likely) to be incorrect now (e.g. opened for write).
+4 - Approximate, may never have been strictly correct, need to sync SOM
+data to achieve eventual consistency.
+The \fBlfs getsom\fR command is part of the Lustre filesystem.
+.BR lfs (1),
+.BR llsom_sync (8)
index 083a848..ba7348e 100644 (file)
@@ -64,7 +64,7 @@ performance significantly if thousands of fsync requests are sent.
 Register a changelog consumer for MDT lustre-MDT0000
-$ cl_user=$(ssh root@mds01 lctl changelog_register --device lustre-MDT0000 -n)
+$ cl_user=$(ssh root@mds01 lctl --device lustre-MDT0000 changelog_register -n)
 $ echo $cl_user
@@ -82,11 +82,11 @@ $ llsom_sync --mdt=lustre-MDT0000 --user=$cl_user \\
 To deregister the changelog user (e.g. after this example, or if SOM
 updates are no longer needed):
-$ ssh root@mds01 lctl changelog_deregister --device lustre-MDT0000 $cl_user
+$ ssh root@mds01 lctl --device lustre-MDT0000 changelog_deregister $cl_user
 The llsom_sync command is part of the Lustre filesystem.
 .BR lustre (7),
-.BR lctl (8),
+.BR lctl (8)