summaryrefslogtreecommitdiff
path: root/edquota.8
blob: 69f56d1fcff2ee31ead31bb2b62dc4cbbc5a3c77 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
.TH EDQUOTA 8
.SH NAME
edquota \- edit user quotas
.SH SYNOPSIS
.B edquota
[
.B \-p
.I proto-username
] [
.B \-ug
]
.IR username .\|.\|.
.LP
.B edquota
[
.B \-r
]
[
.B \-ug
]
.B \-t
.SH DESCRIPTION
.IX  "edquota command"  ""  "\fLedquota\fP \(em edit user quotas"
.IX  edit "user quotas \(em \fLedquota\fP"
.IX  "user quotas"  "edquota command"  ""  "\fLedquota\fP \(em edit user quotas"
.IX  "disk quotas"  "edquota command"  ""  "\fLedquota\fP \(em edit user quotas"
.IX  "quotas"  "edquota command"  ""  "\fLedquota\fP \(em edit user quotas"
.IX  "filesystem"  "edquota command"  ""  "\fLedquota\fP \(em edit user quotas"
.B edquota
is a quota editor.  One or more users or groups may be specified on the command
line.  For each user or group a temporary file is created with an
.SM ASCII
representation of the current disk quotas for that user or group and an editor
is then invoked on the file.  The quotas may then be modified, new
quotas added, etc.
Setting a quota to zero indicates that no quota should be imposed.
.PP
Users are permitted to exceed their soft limits for a grace period that
may be specified per filesystem.  Once the grace period has expired, the
soft limit is enforced as a hard limit.
.PP
The current usage information in the file is for imformational purposes;
only the hard and soft limits can be changed.
.PP
Upon leaving the editor,
.B edquota
reads the temporary file and modifies the binary quota files to reflect
the changes made.
.LP
The editor invoked is
.BR vi (1)
unless either the
.SB EDITOR
or the
.SB VISUAL
environment variable specifies otherwise.
.LP
Only the super-user may edit quotas.
.SH OPTIONS
.TP
.B \-r
Edit also non-local quota use rpc.rquotad on remote server to set quota.
The
.B \-n
option is equivalent, and is maintained for backward compatibility.
.TP
.B \-u
Edit the user quota. This is the default.
.TP
.B \-g
Edit the group quota.
.TP
.B \-p
Duplicate the quotas of the prototypical user
specified for each user specified.  This is the normal
mechanism used to initialize quotas for groups of users.
.TP
.B \-t
Edit the soft time limits for each filesystem.
If the time limits are zero, the default time limits in
.B <linux/quota.h>
are used.
Time units of seconds, minutes, hours, days, weeks, and months
are understood.
Time limits are printed in the greatest possible time unit such that
the value is greater than or equal to one.
.SH FILES
.PD 0
.TP 20
.B aquota.user or aquota.group
quota file at the filesystem root (version 2 quota, non-XFS filesystems)
.TP
.B quota.user or quota.group
quota file at the filesystem root (version 1 quota, non-XFS filesystems)
.TP
.B /etc/mtab
mounted filesystems table
.PD
.SH SEE ALSO
.BR quota (1),
.BR vi (1),
.BR quotactl (2),
.BR quotacheck (8),
.BR quotaon (8),
.BR repquota (8)