|
|
1.1 root 1: .\" Copyright (c) 1983, 1990 Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" This code is derived from software contributed to Berkeley by
5: .\" Robert Elz at The University of Melbourne.
6: .\"
7: .\" Redistribution and use in source and binary forms are permitted provided
8: .\" that: (1) source distributions retain this entire copyright notice and
9: .\" comment, and (2) distributions including binaries display the following
10: .\" acknowledgement: ``This product includes software developed by the
11: .\" University of California, Berkeley and its contributors'' in the
12: .\" documentation or other materials provided with the distribution and in
13: .\" all advertising materials mentioning features or use of this software.
14: .\" Neither the name of the University nor the names of its contributors may
15: .\" be used to endorse or promote products derived from this software without
16: .\" specific prior written permission.
17: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
18: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
19: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
20: .\"
21: .\" @(#)edquota.8 6.6 (Berkeley) 6/24/90
22: .\"
23: .TH EDQUOTA 8 "June 24, 1990"
24: .UC 5
25: .SH NAME
26: edquota \- edit user quotas
27: .SH SYNOPSIS
28: .B edquota
29: [
30: .I \-u
31: ] [
32: .I \-p
33: proto-username
34: ]
35: username ...
36: .br
37: .B edquota
38: .I \-g
39: [
40: .I \-p
41: proto-groupname
42: ]
43: groupname ...
44: .br
45: .B edquota
46: .I -t
47: [
48: .I -u
49: ]
50: .br
51: .B edquota
52: .I -t
53: .I -g
54: .br
55: .SH DESCRIPTION
56: .I Edquota
57: is a quota editor.
58: By default, or if the \fI-u\fP flag is specified,
59: one or more users may be specified on the command line.
60: For each user a temporary file is created
61: with an ASCII representation of the current
62: disk quotas for that user.
63: The list of filesystems with user quotas is determined from
64: .IR /etc/fstab .
65: An editor is invoked on the ASCII file.
66: The editor invoked is
67: .IR vi (1)
68: unless the environment variable EDITOR specifies otherwise.
69: .PP
70: The quotas may then be modified, new quotas added, etc.
71: Setting a quota to zero indicates that no quota should be imposed.
72: Setting a hard limit to one indicates that no allocations should
73: be permitted.
74: Setting a soft limit to one with a hard limit of zero
75: indicates that allocations should be permitted on
76: only a temporary basis (see \fI-t\fP below).
77: The current usage information in the file is for informational purposes;
78: only the hard and soft limits can be changed.
79: .PP
80: On leaving the editor,
81: .I edquota
82: reads the temporary file and modifies the binary
83: quota files to reflect the changes made.
84: .PP
85: If the
86: .B \-p
87: option is specified,
88: .I edquota
89: will duplicate the quotas of the prototypical user
90: specified for each user specified.
91: This is the normal mechanism used to
92: initialize quotas for groups of users.
93: .PP
94: If the \fI-g\fP flag is specified,
95: .I edquota
96: is invoked to edit the quotas of
97: one or more groups specified on the command line.
98: The \fI-p\fP flag can be specified in conjunction with
99: the \fI-g\fP flag to specify a prototypical group
100: to be duplicated among the listed set of groups.
101: .PP
102: Users are permitted to exceed their soft limits
103: for a grace period that may be specified per filesystem.
104: Once the grace period has expired,
105: the soft limit is enforced as a hard limit.
106: The default grace period for a filesystem is specified in
107: .IR /usr/include/ufs/quota.h .
108: The \fi-t\fP flag can be used to change the grace period.
109: By default, or when invoked with the \fI-u\fP flag,
110: the grace period is set for all the filesystems with user
111: quotas specified in
112: .IR /etc/fstab .
113: When invoked with the \fI-g\fP flag the grace period is
114: set for all the filesystems with group quotas specified in
115: .IR /etc/fstab .
116: The grace period may be specified in days, hours, minutes, or seconds.
117: Setting a grace period to zero indicates that the default
118: grace period should be imposed.
119: Setting a grace period to one second indicates that no
120: grace period should be granted.
121: .PP
122: Only the super-user may edit quotas.
123: .SH FILES
124: .DT
125: \fIquota.user\fP at the filesystem root with user quotas
126: .br
127: \fIquota.group\fP at the filesystem root with group quotas
128: .br
129: /etc/fstab to find filesystem names and locations
130: .SH SEE ALSO
131: quota(1),
132: quotactl(2),
133: fstab(5),
134: quotacheck(8), quotaon(8), repquota(8)
135: .SH DIAGNOSTICS
136: Various messages about inaccessible files; self-explanatory.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.