1 .\" Copyright (c) 2001 Nik Clayton
3 .\" Redistribution and use in source and binary forms, with or without
4 .\" modification, are permitted provided that the following conditions
6 .\" 1. Redistributions of source code must retain the above copyright
7 .\" notice, this list of conditions and the following disclaimer.
8 .\" 2. Redistributions in binary form must reproduce the above copyright
9 .\" notice, this list of conditions and the following disclaimer in the
10 .\" documentation and/or other materials provided with the distribution.
12 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
13 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
14 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
15 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
16 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
17 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
18 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
19 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
20 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
21 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30 .Nm quota.user , quota.group
31 .Nd per file system quota database
33 Each file system with active quotas should contain a
37 file in the file system root.
38 These files are created by
40 and should be edited with
42 It is possible to specify a different location and file name with the
50 The data files contain the following information:
52 .Bl -bullet -offset indent -compact
56 Current number of files
66 Block grace time remaining if over the soft limit
68 File grace time remaining if over the soft limit
73 for an explanation on the various limits and grace periods.
75 During normal quota operations the
77 interface is used to query or set quota information and the kernel
78 will maintain the data files as needed.
79 If quotas are disabled on
80 a file system, but marked as having quotas enabled in
82 then the quota data files will be used directly.
84 The data files are stored as an array of
86 structures, as defined in
88 and indexed by UID or GID.
89 The data files will be written as a sparse file if possible.
90 Data is only maintained for ids that have either non-zero usage or
91 non-zero quota limits.
92 If an attempt is made to access data for an id that would exist past the
93 end of the current data file, a quota structure with all values set
94 to zero will be created, and the data file extended as needed.
97 utility will truncate the data files to the minimum size needed
98 to store the highest id with either non-zero file usage or
99 non-zero quota limits.
101 The data record for id 0 has special meaning. If the
105 fields are non-zero, they are used to indicate the grace period on
106 that file system for users who have exceeded their soft limit.
107 These times can be set by
112 If no explicit grace period has been set with
114 then the default value of 7 days will be used.
115 The default values are defined by
120 .In ufs/ufs/quota.h .