mirror of
https://git.FreeBSD.org/src.git
synced 2024-12-22 11:17:19 +00:00
151 lines
5.0 KiB
Groff
151 lines
5.0 KiB
Groff
.\" Copyright (c) 1983, 1990, 1993
|
|
.\" The Regents of the University of California. All rights reserved.
|
|
.\"
|
|
.\" This code is derived from software contributed to Berkeley by
|
|
.\" Robert Elz at The University of Melbourne.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. All advertising materials mentioning features or use of this software
|
|
.\" must display the following acknowledgement:
|
|
.\" This product includes software developed by the University of
|
|
.\" California, Berkeley and its contributors.
|
|
.\" 4. Neither the name of the University nor the names of its contributors
|
|
.\" may be used to endorse or promote products derived from this software
|
|
.\" without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" @(#)edquota.8 8.1 (Berkeley) 6/6/93
|
|
.\"
|
|
.TH EDQUOTA 8 "June 6, 1993"
|
|
.UC 5
|
|
.SH NAME
|
|
edquota \- edit user quotas
|
|
.SH SYNOPSIS
|
|
.B edquota
|
|
[
|
|
.I \-u
|
|
] [
|
|
.I \-p
|
|
proto-username
|
|
]
|
|
username ...
|
|
.br
|
|
.B edquota
|
|
.I \-g
|
|
[
|
|
.I \-p
|
|
proto-groupname
|
|
]
|
|
groupname ...
|
|
.br
|
|
.B edquota
|
|
.I -t
|
|
[
|
|
.I -u
|
|
]
|
|
.br
|
|
.B edquota
|
|
.I -t
|
|
.I -g
|
|
.br
|
|
.SH DESCRIPTION
|
|
.I Edquota
|
|
is a quota editor.
|
|
By default, or if the \fI-u\fP flag is specified,
|
|
one or more users may be specified on the command line.
|
|
For each user a temporary file is created
|
|
with an ASCII representation of the current
|
|
disk quotas for that user.
|
|
The list of filesystems with user quotas is determined from
|
|
.IR /etc/fstab .
|
|
An editor is invoked on the ASCII file.
|
|
The editor invoked is
|
|
.IR vi (1)
|
|
unless the environment variable EDITOR specifies otherwise.
|
|
.PP
|
|
The quotas may then be modified, new quotas added, etc.
|
|
Setting a quota to zero indicates that no quota should be imposed.
|
|
Setting a hard limit to one indicates that no allocations should
|
|
be permitted.
|
|
Setting a soft limit to one with a hard limit of zero
|
|
indicates that allocations should be permitted on
|
|
only a temporary basis (see \fI-t\fP below).
|
|
The current usage information in the file is for informational purposes;
|
|
only the hard and soft limits can be changed.
|
|
.PP
|
|
On leaving the editor,
|
|
.I edquota
|
|
reads the temporary file and modifies the binary
|
|
quota files to reflect the changes made.
|
|
.PP
|
|
If the
|
|
.B \-p
|
|
option is specified,
|
|
.I edquota
|
|
will 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.
|
|
.PP
|
|
If the \fI-g\fP flag is specified,
|
|
.I edquota
|
|
is invoked to edit the quotas of
|
|
one or more groups specified on the command line.
|
|
The \fI-p\fP flag can be specified in conjunction with
|
|
the \fI-g\fP flag to specify a prototypical group
|
|
to be duplicated among the listed set of groups.
|
|
.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.
|
|
The default grace period for a filesystem is specified in
|
|
.IR /usr/include/ufs/quota.h .
|
|
The \fI-t\fP flag can be used to change the grace period.
|
|
By default, or when invoked with the \fI-u\fP flag,
|
|
the grace period is set for all the filesystems with user
|
|
quotas specified in
|
|
.IR /etc/fstab .
|
|
When invoked with the \fI-g\fP flag the grace period is
|
|
set for all the filesystems with group quotas specified in
|
|
.IR /etc/fstab .
|
|
The grace period may be specified in days, hours, minutes, or seconds.
|
|
Setting a grace period to zero indicates that the default
|
|
grace period should be imposed.
|
|
Setting a grace period to one second indicates that no
|
|
grace period should be granted.
|
|
.PP
|
|
Only the super-user may edit quotas.
|
|
.SH FILES
|
|
.DT
|
|
\fIquota.user\fP at the filesystem root with user quotas
|
|
.br
|
|
\fIquota.group\fP at the filesystem root with group quotas
|
|
.br
|
|
/etc/fstab to find filesystem names and locations
|
|
.SH SEE ALSO
|
|
quota(1),
|
|
quotactl(2),
|
|
fstab(5),
|
|
quotacheck(8), quotaon(8), repquota(8)
|
|
.SH DIAGNOSTICS
|
|
Various messages about inaccessible files; self-explanatory.
|