source: gpfs_3.1_ker2.6.20/share/man/man8/mmlsfs.8 @ 123

.TH mmlsfs 12/04/06
mmlsfs Command
.SH "Name"
.PP
\fBmmlsfs\fR - Displays file system attributes.
.SH "Synopsis"
.PP
\fBmmlsfs\fR {\fIDevice\fR\fB | all\fR} [\fB-A\fR]
[\fB-a\fR] [\fB-B\fR] [\fB-D\fR]
[\fB-d\fR] [\fB-E\fR] [\fB-F\fR]
[\fB-f\fR] [\fB-I\fR] [\fB-i\fR]
[\fB-j\fR] [\fB-k\fR] [\fB-K\fR]
[\fB-M\fR] [\fB-m\fR] [\fB-n\fR]
[\fB-o\fR] [\fB-P\fR] [\fB-Q\fR]
[\fB-R\fR] [\fB-r\fR] [\fB-S\fR]
[\fB-s\fR] [\fB-T\fR] [\fB-u\fR]
[\fB-V\fR] [\fB-z\fR]
.SH "Description"
.PP
Use the \fBmmlsfs\fR command to list the attributes of a file
system.
.PP
Depending on your configuration, additional information that is set by GPFS
may be displayed to assist in problem determination when contacting the
IBM Support Center.
.PP
\fBResults\fR
.PP
If you do not specify any options, all attributes of the file system are
displayed. When you specify options, only those attributes specified
are listed, in the order issued in the command. Some parameters are
preset for optimum performance and, although they display in the
\fBmmlsfs\fR command output, you cannot change them.
.SH "Parameters"
.PP
.RS +3
\fB\fIDevice\fR | all
\fR
.RE
.RS +9
The device name of the file system to be listed. File system names
need not be fully-qualified. \fBfs0\fR is as acceptable as
\fB/dev/fs0\fR. Specify \fBall\fR to list the attributes of all
GPFS file systems that are owned by this cluster, as well as all remote file
systems to which this cluster has access.
.PP
This must be the first parameter.
.RE
.SH "Options"
.PP
.RS +3
\fB-A
\fR
.RE
.RS +9
Automatically mount the file system when the GPFS daemon starts
.RE
.PP
.RS +3
\fB-a
\fR
.RE
.RS +9
Estimated average file size, in bytes
.RE
.PP
.RS +3
\fB-B
\fR
.RE
.RS +9
Size of data block, in bytes
.RE
.PP
.RS +3
\fB-D
\fR
.RE
.RS +9
The type of file locking semantics that are in effect (\fBnfs4\fR or
\fBposix\fR)
.RE
.PP
.RS +3
\fB-d
\fR
.RE
.RS +9
Names of all of the disks in the file system
.RE
.PP
.RS +3
\fB-E
\fR
.RE
.RS +9
Exact \fBmtime\fR values reported
.RE
.PP
.RS +3
\fB-F
\fR
.RE
.RS +9
Maximum number of files currently supported
.RE
.PP
.RS +3
\fB-f
\fR
.RE
.RS +9
Minimum fragment size, in bytes
.RE
.PP
.RS +3
\fB-I
\fR
.RE
.RS +9
Indirect block size, in bytes
.RE
.PP
.RS +3
\fB-i
\fR
.RE
.RS +9
Inode size, in bytes
.RE
.PP
.RS +3
\fB-j
\fR
.RE
.RS +9
Block allocation map type
.RE
.PP
.RS +3
\fB-k
\fR
.RE
.RS +9
Type of authorization supported by the file system
.RE
.PP
.RS +3
\fB-K
\fR
.RE
.RS +9
Strict replication enforcement
.RE
.PP
.RS +3
\fB-M
\fR
.RE
.RS +9
Maximum number of metadata replicas
.RE
.PP
.RS +3
\fB-m
\fR
.RE
.RS +9
Default number of metadata replicas
.RE
.PP
.RS +3
\fB-n
\fR
.RE
.RS +9
Estimated number of nodes for mounting the file system
.RE
.PP
.RS +3
\fB-o
\fR
.RE
.RS +9
Additional mount options
.RE
.PP
.RS +3
\fB-P
\fR
.RE
.RS +9
Storage pools defined within the file system.
.RE
.PP
.RS +3
\fB-Q
\fR
.RE
.RS +9
Which quotas are currently enforced on the file system
.RE
.PP
.RS +3
\fB-R
\fR
.RE
.RS +9
Maximum number of data replicas
.RE
.PP
.RS +3
\fB-r
\fR
.RE
.RS +9
Default number of data replicas
.RE
.PP
.RS +3
\fB-s
\fR
.RE
.RS +9
Stripe method
.RE
.PP
.RS +3
\fB-S
\fR
.RE
.RS +9
Whether the updating of \fBatime\fR is suppressed for the
\fBgpfs_stat()\fR, \fBgpfs_fstat()\fR, \fBstat()\fR, and
\fBfstat()\fR calls
.RE
.PP
.RS +3
\fB-T
\fR
.RE
.RS +9
Default mount point
.RE
.PP
.RS +3
\fB-u
\fR
.RE
.RS +9
Whether support for large LUNs is enabled
.RE
.PP
.RS +3
\fB-V
\fR
.RE
.RS +9
Current format version of the file system
.RE
.PP
.RS +3
\fB-z
\fR
.RE
.RS +9
DMAPI is enabled for this file system
.RE
.SH "Exit status"
.PP
.PP
.RS +3
\fB0
\fR
.RE
.RS +9
Successful completion.
.RE
.PP
.RS +3
\fBnonzero
\fR
.RE
.RS +9
A failure has occurred.
.RE
.SH "Security"
.PP
If you are a root user:
.RS +3
.HP 3
1. You may issue the \fBmmlsfs\fR command from any node in the GPFS
cluster.
.HP 3
2. 
When using the \fBrcp\fR and \fBrsh\fR commands for remote
communication, a properly configured \fB.rhosts\fR file must exist
in the root user's home directory on each node in the GPFS
cluster. If you have designated the use of a different remote
communication program on either the \fBmmcrcluster\fR or the
\fBmmchcluster\fR command, you must ensure:
.RS +3
.HP 3
a. Proper authorization is granted to all nodes in the GPFS cluster.
.HP 3
b. The nodes in the GPFS cluster can communicate without the use of a
password, and without any extraneous messages.
.RE
.HP 3
3. As root, a user can also issue the \fBmmlsfs\fR on remote file
systems.
.RE
.PP
If you are a non-root user, you may specify only file systems that belong
to the same cluster as the node on which the \fBmmlsfs\fR command was
issued.
.SH "Examples"
.PP
If you issue the \fBmmlsfs\fR command with no options for the file
system \fBgpfs1\fR:
.sp
.nf
mmlsfs gpfs1
.fi
.sp
.PP
The system displays information similar to this. Output appears in
the order the option were specified in the command.
.sp
.nf
flag value          description
---- -------------- ------------------------------------------------
 -s  roundRobin     Stripe method
 -f  8192           Minimum fragment size in bytes
 -i  512            Inode size in bytes
 -I  16384          Indirect block size in bytes
 -m  1              Default number of metadata replicas
 -M  1              Maximum number of metadata replicas
 -r  1              Default number of data replicas
 -R  1              Maximum number of data replicas
 -j  cluster        Block allocation type
 -D  posix          File locking semantics in effect
 -k  posix          ACL semantics in effect
 -a  1048576        Estimated average file size
 -n  32             Estimated number of nodes that will mount file
                    system
 -B  262144         Block size
 -Q  none           Quotas enforced
     none           Default quotas enabled
 -F  33792          Maximum number of inodes
 -V  9.03           File system version. Highest supported version:
                    9.03
 -u  yes            Support for large LUNs?
 -z  no             Is DMAPI enabled?
 -E  yes            Exact mtime mount option
 -S  no             Suppress atime mount option
 -P  system         Disk storage pools in file system
 -d  gpfs2nsd;gpfs3nsd;gpfs4nsd;gpfs5nsd  Disks in file system
 -A  yes            Automatic mount option
 -o  none           Additional mount options
 -T  /gpfs1         Default mount point
.fi
.sp
.SH "See also"
.PP
mmcrfs Command
.PP
mmchfs Command
.PP
mmdelfs Command
.SH "Location"
.PP
\fB/usr/lpp/mmfs/bin\fR