1 .\" Copyright (c) 1983, 1990, 1993
2 .\" The Regents of the University of California. All rights reserved.
4 .\" This code is derived from software contributed to Berkeley by
5 .\" Robert Elz at The University of Melbourne.
7 .\" Redistribution and use in source and binary forms, with or without
8 .\" modification, are permitted provided that the following conditions
10 .\" 1. Redistributions of source code must retain the above copyright
11 .\" notice, this list of conditions and the following disclaimer.
12 .\" 2. Redistributions in binary form must reproduce the above copyright
13 .\" notice, this list of conditions and the following disclaimer in the
14 .\" documentation and/or other materials provided with the distribution.
15 .\" 4. Neither the name of the University nor the names of its contributors
16 .\" may be used to endorse or promote products derived from this software
17 .\" without specific prior written permission.
19 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
20 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
23 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31 .\" @(#)edquota.8 8.1 (Berkeley) 6/6/93
44 .Op Fl p Ar proto-username
50 .Ar fspath Op : Ar bslim Op : Ar bhlim Op : Ar islim Op : Ar ihlim
58 .Op Fl p Ar proto-groupname
64 .Ar fspath Op : Ar bslim Op : Ar bhlim Op : Ar islim Op : Ar ihlim
79 utility is a quota editor.
83 one or more users may be specified on the command line.
84 For each user a temporary file is created
87 representation of the current
88 disk quotas for that user.
89 The list of file systems with user quotas is determined from
91 An editor is invoked on the
96 unless the environment variable
100 The quotas may then be modified, new quotas added, etc.
101 Block quotas can be specified in bytes (B), kilobytes (K),
102 megabytes (M), terabytes (T), petabytes (P), or exabytes (E).
103 If no units are specified, kilobytes are assumed.
104 Inode quotas can be specified in kiloinodes (K),
105 megainodes (M), terainodes (T), petainodes (P), or exainodes (E).
106 If no units are specified, the number of inodes specified are used.
109 flag is specified, the editor will always display the
110 block usage and limits in a more human readable format
111 rather than displaying them in the historic kilobyte format.
112 Setting a quota to zero indicates that no quota should be imposed.
113 Setting a hard limit to one indicates that no allocations should
115 Setting a soft limit to one with a hard limit of zero
116 indicates that allocations should be permitted only on
117 a temporary basis (see
120 The current usage information in the file is for informational purposes;
121 only the hard and soft limits can be changed.
123 On leaving the editor,
125 reads the temporary file and modifies the binary
126 quota files to reflect the changes made.
132 will duplicate the quotas of the prototypical user
133 specified for each user specified.
134 This is the normal mechanism used to
135 initialize quotas for groups of users.
136 If the user given to assign quotas to is a numerical uid
137 range (e.g.\& 1000-2000), then
139 will duplicate the quotas of the prototypical user
140 for each uid in the range specified.
142 for easy setup of default quotas for a group of users.
143 The uids in question do not have to be currently assigned in
149 .Ar fspath Op : Ar bslim Op : Ar bhlim Op : Ar islim Op : Ar ihlim
151 options are specified,
153 will non-interactively set quotas defined by
154 .Ar bslim , bhlim , islim ,
157 on each particular file system referenced by
161 is the soft limit on the number of blocks,
163 is the hard limit on the number of blocks,
165 is the soft limit on the number of files, and
167 is the hard limit on the number of files.
169 .Ar bslim , bhlim , islim ,
172 values is omitted, it is assumed to be zero, therefore
173 indicating that no particular quota should be imposed.
174 Block quotas can be specified in bytes (B), kilobytes (K),
175 megabytes (M), terabytes (T), petabytes (P), or exabytes (E).
176 If no units are specified, kilobytes are assumed.
177 Inode quotas can be specified in kiloinodes (K),
178 megainodes (M), terainodes (T), petainodes (P), or exainodes (E).
179 If no units are specified, the number of inodes specified are used.
185 will read and modify quotas on the file system specified by
190 argument may be either a special device
191 or a file system mount point.
192 The primary purpose of this option is to set the scope for the
194 option, which would overwrite quota records on every
195 file system with quotas otherwise.
201 is invoked to edit the quotas of
202 one or more groups specified on the command line.
205 flag can be specified in conjunction with
208 flag to specify a prototypical group
209 to be duplicated among the listed set of groups.
212 flag can be specified in conjunction with
215 flag to non-interactively set-up quotas on the listed set
218 Users are permitted to exceed their soft limits
219 for a grace period that may be specified per file system.
220 Once the grace period has expired,
221 the soft limit is enforced as a hard limit.
222 The default grace period for a file system is specified in
223 .In ufs/ufs/quota.h .
226 flag can be used to change the grace period.
227 By default, or when invoked with the
230 the grace period is set for all the file systems with user
233 When invoked with the
235 flag the grace period is
236 set for all the file systems with group quotas specified in
238 The grace period may be specified in days, hours, minutes, or seconds.
239 Setting a grace period to zero indicates that the default
240 grace period should be imposed.
241 Setting a grace period to one second indicates that no
242 grace period should be granted.
243 Quotas must be turned off for the file system and
244 then turned back on for the new grace period to take effect.
246 Only the super-user may edit quotas.
248 .Bl -tag -width quota.group -compact
250 at the file system root with user quotas
252 at the file system root with group quotas
254 to find file system names and locations
257 Various messages about inaccessible files; self-explanatory.