Whamcloud - gitweb
LU-11997 ptlrpc: Properly swab ll_fiemap_info_key
[fs/lustre-release.git] / lustre / doc / lfs-getsom.1
1 .TH LFS-GETSOM 1 2018-10-04 "Lustre" "lustre Utilities"
2 .SH NAME
3 lfs getsom \- list file attributes that are stored on an MDS
4 .SH SYNOPSIS
5 .B lfs getsom
6 [\fB\-s\fR | \fB\-b\fR | \fB\-f\fR] <file>
7 .SH DESCRIPTION
8 This command lists file attributes that are stored on the MDS. It is called
9 with the full path and file name for a file on the Lustre file system. If no
10 flags are used, then all file attributes stored on the MDS will be shown.
11 .SH OPTIONS
12 .TP
13 .BR \-s\fR
14 Only show the size value of the SOM data for a given file.
15 .TP
16 .BR \-b\fR
17 Only show the blocks value of the SOM data for a given file.
18 .TP
19 .BR \-f\fR
20 Only show the flag value of the SOM data for a given file.Valid flags are:
21 .br
22 0 - Unknown or no SoM data, must get size from OSTs.
23 .br
24 1 - Known strictly correct, FLR or DoM file (SoM guaranteed).
25 .br
26 2 - Known stale - was right at some point in the past, but it is known
27 (or likely) to be incorrect now (e.g. opened for write).
28 .br
29 4 - Approximate, may never have been strictly correct, need to sync SOM
30 data to achieve eventual consistency.
31 .SH AUTHOR
32 The \fBlfs getsom\fR command is part of the Lustre filesystem.
33 .SH SEE ALSO
34 .BR lfs (1),
35 .BR llsom_sync (8)