source: gpfs_3.1_ker2.6.20/share/man/man8/mmdefedquota.8 @ 219

Last change on this file since 219 was 16, checked in by rock, 17 years ago
File size: 4.3 KB
Line 
1.TH mmdefedquota 03/02/06
2mmdefedquota Command
3.SH "Name"
4.PP
5\fBmmdefedquota\fR - Sets default quota limits to a file
6system.
7.SH "Synopsis"
8.PP
9\fBmmdefedquota\fR {\fB-u\fR | \fB-g\fR | \fB-j\fR}
10\fIDevice\fR
11.SH "Description"
12.PP
13Use the \fBmmdefedquota\fR command to set or change default quota
14limits for new users, group and filesets for a file system. Default quota limits
15for a file system may be set or changed only if the file system was created
16with the \fB-Q yes\fR option on the
17\fBmmcrfs\fR
18command or changed with the
19\fBmmchfs\fR
20command.
21.PP
22The \fBmmdefedquota\fR command displays the current values for these
23limits, if any, and prompts you to enter new values using your default
24editor:
25.RS +3
26.HP 3
27\(bu Current block usage (display only)
28.HP 3
29\(bu Current inode usage (display only)
30.HP 3
31\(bu Inode soft limit
32.HP 3
33\(bu Inode hard limit
34.HP 3
35\(bu Block soft limit
36.sp
37Displayed in \fBKB\fR, but may be specified using \fBk\fR,
38\fBK\fR, \fBm\fR, \fBM\fR, \fBg\fR, or \fBG\fR . If no
39suffix is provided, the number is assumed to be in \fBbytes\fR.
40.HP 3
41\(bu Block hard limit
42.sp
43Displayed in \fBKB\fR, but may be specified using \fBk\fR,
44\fBK\fR, \fBm\fR, \fBM\fR, \fBg\fR, or \fBG\fR. If no
45suffix is provided, the number is assumed to be in \fBbytes\fR.
46.RE
47.RS +3
48\fBNote:\fR
49.RE
50.RS +9
51A block or inode limit of 0 indicates no limit.
52.RE
53.PP
54The \fBmmdefedquota\fR command waits for the edit window to be closed
55before checking and applying new values. If an incorrect entry is made,
56you must reissue the command and enter the correct values.
57.PP
58When setting quota limits for a file system, replication within the file
59system should be considered. GPFS quota management takes replication
60into account when reporting on and determining if quota limits have been
61exceeded for both block and file usage. In a file system that has
62either type of replication set to a value of two, the values reported on by
63both the
64\fBmmlsquota\fR command and the \fBmmrepquota\fR command are double the value reported
65by the \fBls\fR command.
66.PP
67The EDITOR environment variable must contain a complete path name, for
68example:
69.sp
70.nf
71export EDITOR=/bin/vi
72.fi
73.sp
74.SH "Parameters"
75.PP
76.RS +3
77\fB\fIDevice\fR
78\fR
79.RE
80.RS +9
81The device name of the file system to have default quota values set
82for.
83.PP
84File system names need not be fully-qualified. \fBfs0\fR is
85just as acceptable as \fB/dev/fs0\fR.
86.RE
87.SH "Options"
88.PP
89.RS +3
90\fB-g
91\fR
92.RE
93.RS +9
94Specifies that the default quota value is to be applied for new groups
95accessing the specified file system.
96.RE
97.PP
98.RS +3
99\fB-j
100\fR
101.RE
102.RS +9
103Specifies that the default quota value is to be applied for new filesets
104in the specified file system.
105.RE
106.PP
107.RS +3
108\fB-u
109\fR
110.RE
111.RS +9
112Specifies that the default quota value is to be applied for new users
113accessing the specified file system.
114.RE
115.SH "Exit status"
116.PP
117.PP
118.RS +3
119\fB0
120\fR
121.RE
122.RS +9
123Successful completion.
124.RE
125.PP
126.RS +3
127\fBnonzero
128\fR
129.RE
130.RS +9
131A failure has occurred.
132.RE
133.SH "Security"
134.PP
135You must have root authority to run the \fBmmdefedquota\fR
136command.
137.PP
138You must specify either the \fB-u\fR or the \fB-g\fR option.
139.PP
140GPFS must be running on the node from which the \fBmmdefedquota\fR
141command is issued.
142.SH "Examples"
143.PP
144To set default quotas for new users of the file system \fBfs1\fR,
145issue this command:
146.sp
147.nf
148mmdefedquota -u fs1
149.fi
150.sp
151.PP
152The system displays information in your default editor similar to:
153.sp
154.nf
155*** Edit quota limits for USR DEFAULT entry
156NOTE: block limits will be rounded up to the next multiple
157         of the block size.
158block units may be: K, M, or G.
159fs1: blocks in use: 0K, limits (soft = 0K, hard = 0K)
160inodes in use: 0, limits (soft = 0, hard = 0)
161.fi
162.sp
163.PP
164To confirm the change, issue this command:
165.sp
166.nf
167mmlsquota -d -u
168.fi
169.sp
170.PP
171The system displays information similar to:
172.sp
173.nf
174                    Block Limits              |         File Limits
175Filesystem type KB quota limit in_doubt grace |files quota limit in_doubt grace
176fs0        USR  0K 2500  10M    0        none |  0     100  1000    0     none
177fs1        USR  no default limits
178fs2        USR  no default limits
179.fi
180.sp
181.SH "See also"
182.PP
183mmcheckquota Command
184.PP
185mmdefquotaoff Command
186.PP
187mmdefquotaon Command
188.PP
189mmedquota Command
190.PP
191mmlsquota Command
192.PP
193mmquotaoff Command
194.PP
195mmrepquota Command
196.SH "Location"
197.PP
198\fB/usr/lpp/mmfs/bin\fR
199.PP
Note: See TracBrowser for help on using the repository browser.