195 lines
5.8 KiB
Groff
195 lines
5.8 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
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.Dd June 6, 1993
|
|
.Dt EDQUOTA 8
|
|
.Os
|
|
.Sh NAME
|
|
.Nm edquota
|
|
.Nd edit user quotas
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl u
|
|
.Op Fl f Ar fspath
|
|
.Op Fl p Ar proto-username
|
|
.Ar username ...
|
|
.Nm
|
|
.Fl g
|
|
.Op Fl f Ar fspath
|
|
.Op Fl p Ar proto-groupname
|
|
.Ar groupname ...
|
|
.Nm
|
|
.Fl t
|
|
.Op Fl u
|
|
.Op Fl f Ar fspath
|
|
.Nm
|
|
.Fl t
|
|
.Fl g
|
|
.Op Fl f Ar fspath
|
|
.Sh DESCRIPTION
|
|
.Nm Edquota
|
|
is a quota editor.
|
|
By default, or if the
|
|
.Fl u
|
|
flag is specified,
|
|
one or more users may be specified on the command line.
|
|
For each user a temporary file is created
|
|
with an
|
|
.Tn ASCII
|
|
representation of the current
|
|
disk quotas for that user.
|
|
The list of filesystems with user quotas is determined from
|
|
.Pa /etc/fstab .
|
|
An editor is invoked on the
|
|
.Tn ASCII
|
|
file.
|
|
The editor invoked is
|
|
.Xr vi 1
|
|
unless the environment variable
|
|
.Ev 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 only on
|
|
a temporary basis (see
|
|
.Fl t
|
|
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,
|
|
.Nm
|
|
reads the temporary file and modifies the binary
|
|
quota files to reflect the changes made.
|
|
.Pp
|
|
If the
|
|
.Fl p
|
|
option is specified,
|
|
.Nm
|
|
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.
|
|
If the user given to assign quotas to is a numerical uid
|
|
range (e.g. 1000-2000), then
|
|
.Nm
|
|
will duplicate the quotas of the prototypical user
|
|
for each uid in the range specified. This allows
|
|
for easy setup of default quotas for a group of users.
|
|
The uids in question do not have to be currently assigned in
|
|
.Pa /etc/passwd .
|
|
.Pp
|
|
If invoked with the
|
|
.Fl f
|
|
option,
|
|
.Nm
|
|
will read and modify quotas on the filesystem specified by
|
|
.Ar fspath
|
|
only.
|
|
The
|
|
.Ar fspath
|
|
argument may be either a special device
|
|
or a filesystem mount point.
|
|
The primary purpose of this option is to set the scope for the
|
|
.Fl p
|
|
option, which would overwrite quota records on every
|
|
filesystem with quotas otherwise.
|
|
.Pp
|
|
If the
|
|
.Fl g
|
|
flag is specified,
|
|
.Nm
|
|
is invoked to edit the quotas of
|
|
one or more groups specified on the command line.
|
|
The
|
|
.Fl p
|
|
flag can be specified in conjunction with
|
|
the
|
|
.Fl g
|
|
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
|
|
.Pa /usr/include/ufs/ufs/quota.h .
|
|
The
|
|
.Fl t
|
|
flag can be used to change the grace period.
|
|
By default, or when invoked with the
|
|
.Fl u
|
|
flag,
|
|
the grace period is set for all the filesystems with user
|
|
quotas specified in
|
|
.Pa /etc/fstab .
|
|
When invoked with the
|
|
.Fl g
|
|
flag the grace period is
|
|
set for all the filesystems with group quotas specified in
|
|
.Pa /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
|
|
.Bl -tag -width quota.group -compact
|
|
.It Pa quota.user
|
|
at the filesystem root with user quotas
|
|
.It Pa quota.group
|
|
at the filesystem root with group quotas
|
|
.It Pa /etc/fstab
|
|
to find filesystem names and locations
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr quota 1 ,
|
|
.Xr quotactl 2 ,
|
|
.Xr fstab 5 ,
|
|
.Xr quotacheck 8 ,
|
|
.Xr quotaon 8 ,
|
|
.Xr repquota 8
|
|
.Sh DIAGNOSTICS
|
|
Various messages about inaccessible files; self-explanatory.
|