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

Last change on this file since 173 was 16, checked in by rock, 17 years ago
File size: 6.4 KB
Line 
1.TH mmlsfs 12/04/06
2mmlsfs Command
3.SH "Name"
4.PP
5\fBmmlsfs\fR - Displays file system attributes.
6.SH "Synopsis"
7.PP
8\fBmmlsfs\fR {\fIDevice\fR\fB | all\fR} [\fB-A\fR]
9[\fB-a\fR] [\fB-B\fR] [\fB-D\fR]
10[\fB-d\fR] [\fB-E\fR] [\fB-F\fR]
11[\fB-f\fR] [\fB-I\fR] [\fB-i\fR]
12[\fB-j\fR] [\fB-k\fR] [\fB-K\fR]
13[\fB-M\fR] [\fB-m\fR] [\fB-n\fR]
14[\fB-o\fR] [\fB-P\fR] [\fB-Q\fR]
15[\fB-R\fR] [\fB-r\fR] [\fB-S\fR]
16[\fB-s\fR] [\fB-T\fR] [\fB-u\fR]
17[\fB-V\fR] [\fB-z\fR]
18.SH "Description"
19.PP
20Use the \fBmmlsfs\fR command to list the attributes of a file
21system.
22.PP
23Depending on your configuration, additional information that is set by GPFS
24may be displayed to assist in problem determination when contacting the
25IBM Support Center.
26.PP
27\fBResults\fR
28.PP
29If you do not specify any options, all attributes of the file system are
30displayed. When you specify options, only those attributes specified
31are listed, in the order issued in the command. Some parameters are
32preset for optimum performance and, although they display in the
33\fBmmlsfs\fR command output, you cannot change them.
34.SH "Parameters"
35.PP
36.RS +3
37\fB\fIDevice\fR | all
38\fR
39.RE
40.RS +9
41The device name of the file system to be listed. File system names
42need not be fully-qualified. \fBfs0\fR is as acceptable as
43\fB/dev/fs0\fR. Specify \fBall\fR to list the attributes of all
44GPFS file systems that are owned by this cluster, as well as all remote file
45systems to which this cluster has access.
46.PP
47This must be the first parameter.
48.RE
49.SH "Options"
50.PP
51.RS +3
52\fB-A
53\fR
54.RE
55.RS +9
56Automatically mount the file system when the GPFS daemon starts
57.RE
58.PP
59.RS +3
60\fB-a
61\fR
62.RE
63.RS +9
64Estimated average file size, in bytes
65.RE
66.PP
67.RS +3
68\fB-B
69\fR
70.RE
71.RS +9
72Size of data block, in bytes
73.RE
74.PP
75.RS +3
76\fB-D
77\fR
78.RE
79.RS +9
80The type of file locking semantics that are in effect (\fBnfs4\fR or
81\fBposix\fR)
82.RE
83.PP
84.RS +3
85\fB-d
86\fR
87.RE
88.RS +9
89Names of all of the disks in the file system
90.RE
91.PP
92.RS +3
93\fB-E
94\fR
95.RE
96.RS +9
97Exact \fBmtime\fR values reported
98.RE
99.PP
100.RS +3
101\fB-F
102\fR
103.RE
104.RS +9
105Maximum number of files currently supported
106.RE
107.PP
108.RS +3
109\fB-f
110\fR
111.RE
112.RS +9
113Minimum fragment size, in bytes
114.RE
115.PP
116.RS +3
117\fB-I
118\fR
119.RE
120.RS +9
121Indirect block size, in bytes
122.RE
123.PP
124.RS +3
125\fB-i
126\fR
127.RE
128.RS +9
129Inode size, in bytes
130.RE
131.PP
132.RS +3
133\fB-j
134\fR
135.RE
136.RS +9
137Block allocation map type
138.RE
139.PP
140.RS +3
141\fB-k
142\fR
143.RE
144.RS +9
145Type of authorization supported by the file system
146.RE
147.PP
148.RS +3
149\fB-K
150\fR
151.RE
152.RS +9
153Strict replication enforcement
154.RE
155.PP
156.RS +3
157\fB-M
158\fR
159.RE
160.RS +9
161Maximum number of metadata replicas
162.RE
163.PP
164.RS +3
165\fB-m
166\fR
167.RE
168.RS +9
169Default number of metadata replicas
170.RE
171.PP
172.RS +3
173\fB-n
174\fR
175.RE
176.RS +9
177Estimated number of nodes for mounting the file system
178.RE
179.PP
180.RS +3
181\fB-o
182\fR
183.RE
184.RS +9
185Additional mount options
186.RE
187.PP
188.RS +3
189\fB-P
190\fR
191.RE
192.RS +9
193Storage pools defined within the file system.
194.RE
195.PP
196.RS +3
197\fB-Q
198\fR
199.RE
200.RS +9
201Which quotas are currently enforced on the file system
202.RE
203.PP
204.RS +3
205\fB-R
206\fR
207.RE
208.RS +9
209Maximum number of data replicas
210.RE
211.PP
212.RS +3
213\fB-r
214\fR
215.RE
216.RS +9
217Default number of data replicas
218.RE
219.PP
220.RS +3
221\fB-s
222\fR
223.RE
224.RS +9
225Stripe method
226.RE
227.PP
228.RS +3
229\fB-S
230\fR
231.RE
232.RS +9
233Whether the updating of \fBatime\fR is suppressed for the
234\fBgpfs_stat()\fR, \fBgpfs_fstat()\fR, \fBstat()\fR, and
235\fBfstat()\fR calls
236.RE
237.PP
238.RS +3
239\fB-T
240\fR
241.RE
242.RS +9
243Default mount point
244.RE
245.PP
246.RS +3
247\fB-u
248\fR
249.RE
250.RS +9
251Whether support for large LUNs is enabled
252.RE
253.PP
254.RS +3
255\fB-V
256\fR
257.RE
258.RS +9
259Current format version of the file system
260.RE
261.PP
262.RS +3
263\fB-z
264\fR
265.RE
266.RS +9
267DMAPI is enabled for this file system
268.RE
269.SH "Exit status"
270.PP
271.PP
272.RS +3
273\fB0
274\fR
275.RE
276.RS +9
277Successful completion.
278.RE
279.PP
280.RS +3
281\fBnonzero
282\fR
283.RE
284.RS +9
285A failure has occurred.
286.RE
287.SH "Security"
288.PP
289If you are a root user:
290.RS +3
291.HP 3
2921. You may issue the \fBmmlsfs\fR command from any node in the GPFS
293cluster.
294.HP 3
2952.
296When using the \fBrcp\fR and \fBrsh\fR commands for remote
297communication, a properly configured \fB.rhosts\fR file must exist
298in the root user's home directory on each node in the GPFS
299cluster. If you have designated the use of a different remote
300communication program on either the \fBmmcrcluster\fR or the
301\fBmmchcluster\fR command, you must ensure:
302.RS +3
303.HP 3
304a. Proper authorization is granted to all nodes in the GPFS cluster.
305.HP 3
306b. The nodes in the GPFS cluster can communicate without the use of a
307password, and without any extraneous messages.
308.RE
309.HP 3
3103. As root, a user can also issue the \fBmmlsfs\fR on remote file
311systems.
312.RE
313.PP
314If you are a non-root user, you may specify only file systems that belong
315to the same cluster as the node on which the \fBmmlsfs\fR command was
316issued.
317.SH "Examples"
318.PP
319If you issue the \fBmmlsfs\fR command with no options for the file
320system \fBgpfs1\fR:
321.sp
322.nf
323mmlsfs gpfs1
324.fi
325.sp
326.PP
327The system displays information similar to this. Output appears in
328the order the option were specified in the command.
329.sp
330.nf
331flag value          description
332---- -------------- ------------------------------------------------
333 -s  roundRobin     Stripe method
334 -f  8192           Minimum fragment size in bytes
335 -i  512            Inode size in bytes
336 -I  16384          Indirect block size in bytes
337 -m  1              Default number of metadata replicas
338 -M  1              Maximum number of metadata replicas
339 -r  1              Default number of data replicas
340 -R  1              Maximum number of data replicas
341 -j  cluster        Block allocation type
342 -D  posix          File locking semantics in effect
343 -k  posix          ACL semantics in effect
344 -a  1048576        Estimated average file size
345 -n  32             Estimated number of nodes that will mount file
346                    system
347 -B  262144         Block size
348 -Q  none           Quotas enforced
349     none           Default quotas enabled
350 -F  33792          Maximum number of inodes
351 -V  9.03           File system version. Highest supported version:
352                    9.03
353 -u  yes            Support for large LUNs?
354 -z  no             Is DMAPI enabled?
355 -E  yes            Exact mtime mount option
356 -S  no             Suppress atime mount option
357 -P  system         Disk storage pools in file system
358 -d  gpfs2nsd;gpfs3nsd;gpfs4nsd;gpfs5nsd  Disks in file system
359 -A  yes            Automatic mount option
360 -o  none           Additional mount options
361 -T  /gpfs1         Default mount point
362.fi
363.sp
364.SH "See also"
365.PP
366mmcrfs Command
367.PP
368mmchfs Command
369.PP
370mmdelfs Command
371.SH "Location"
372.PP
373\fB/usr/lpp/mmfs/bin\fR
Note: See TracBrowser for help on using the repository browser.