EDQUOTA(8) BSD System Manager's Manual EDQUOTA(8)NAMEedquota - edit user quotas
SYNOPSISedquota [-u] [-p proto-username] username ...
edquota-g [-p proto-groupname] groupname ...
edquota-t [-u]
edquota-t -g
DESCRIPTION
Edquota is a quota editor used to edit the user and group disk quotas.
Options:
-g Edit the quotas for the groups specified on the command line.
-u Edit the quotas for the specified users specified on the command
line. This flag is optional and is the default if -g and -t are
not specified.
-p proto-username
-p proto-groupname
When used with the -u or -g flags, the quotas for the specified
prototype user or prototype group will be used to initialize the
quotas for the specified users and groups. The editor will not
be invoked. This is the normal mechanism used to initialize quo-
tas for a number of users or groups.
-t Edit the per-filesystem user and group grace periods. When -g is
specified, edit the group grace periods. If -u or no flags are
specified, edit the user grace periods.
Editing quotas
By default, or if the -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 ASCII representation of the current disk quotas for that user.
The list of filesystems with user quotas is determined from /etc/fstab.
An editor is invoked on the ASCII file. The editor invoked is vi(1) un-
less the environment variable EDITOR specifies otherwise.
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 -t below). The current usage
information in the file is for informational purposes; only the hard and
soft limits can be changed.
On leaving the editor, edquota reads the temporary file and modifies the
binary quota files to reflect the changes made.
If the -g flag is specified, edquota is invoked to edit the quotas of one
or more groups specified on the command line.
Initializing quotas from prototypes
The -p flag may be specified with the -u (or -g) flag to specify a proto-
type user (or group) to be used to initialize the quotas for the speci-
fied user(s) (or group(s)). This facilitates initializing the quotas for
many users and groups at once, or automating the initialization of quo-
tas.
The editor is not invoked when initializing quotas from a prototype.
Grace periods
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 /usr/include/ufs/ufs/quota.h.
The -t flag can be used to change the grace period. By default, or when
invoked with the -u flag, the grace period is set for all the filesystems
with user quotas specified in /etc/fstab. When invoked with the -g flag
the grace period is set for all the filesystems with group quotas speci-
fied in /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.
Users or groups already operating within a grace period will not be af-
fected when a new grace period is set for a filesystem until their usage
drops below the soft limit. This can be precipitated by momentarily in-
creasing the soft limit.
Only the super-user may edit quotas.
FILES
quota.user at the filesystem root with user quotas
quota.group at the filesystem root with group quotas
/etc/fstab to find filesystem names and locations
SEE ALSOquota(1), quotactl(2), fstab(5), quotacheck(8), quotaon(8), repquo-
ta(8)DIAGNOSTICS
Various messages about inaccessible files; self-explanatory.
BSDI BSD/OS April 27, 1995 2