edquota(8)edquota(8)NAMEedquota - Edits quotas.
SYNOPSIS
/usr/sbin/edquota [-gGuU] -t
/usr/sbin/edquota [-p proto_username] [-u] username...
/usr/sbin/edquota [-P proto_userID] -U userID...
/usr/sbin/edquota [-P proto_userID] [-u] username...
/usr/sbin/edquota [-p proto_username] -U userID...
/usr/sbin/edquota [-p proto_groupname] -g groupname...
/usr/sbin/edquota [-P proto_groupID] -G groupID ...
/usr/sbin/edquota [-P proto_groupID] -g groupname...
/usr/sbin/edquota [-p proto_groupname] -G groupID...
OPTIONS
Edits the quotas of one or more groups, specified by groupname from the
command line. When used with the -t option, sets or changes the grace
period for all file systems with group quotas specified in the
/etc/fstab file. Edits the quotas of one or more groups, specified by
groupID from the command line. When used with the -t option, sets or
changes the grace period for all file systems with group quotas speci‐
fied in the /etc/fstab file. Initializes the specified quotas by
duplicating the established quotas of the prototypical user's name
(when used with the -u option, the -U option, or no other options), or
the prototypical group's name (when used with the -g or -G options).
The proto_username or proto_groupname must have a valid quota file.
Establishing quotas for one user or group and then using the -p option
to duplicate these quotas for other users is the normal mechanism for
initializing quotas for a group of users. Initializes the specified
quotas by duplicating the established quotas of the prototypical user's
id (when used with the -U option or the -u option), or the prototypical
group's id (when used with the -G option or the -g option). The
proto_userID or proto_groupID must have a valid quota file. Establish‐
ing quotas for one user or group and then using the -P option to dupli‐
cate these quotas for other users is the normal mechanism for initial‐
izing quotas for a group of users. Sets or changes the default grace
period for which users may exceed their soft limits. To set a temporary
grace period, enter the edquota command with the -t option and set the
soft limit for the number of blocks or inodes to 1 and the hard limit
for the number of blocks or inodes to 0 (zero). By default, or when you
specify -t with the -u option, the grace period is set for all file
systems with user quotas specified in the /etc/fstab file. When you
specify -t with the -g option, the grace period is set for all of the
file systems with group quotas specified in the /etc/fstab file. Edits
the quotas of one or more users, specified by username ... from the
command line. The -u option, used with the -t option, changes the
grace period for all file systems with user quotas specified in the
/etc/fstab file. The -u option is the default and can be omitted from
the command. Edits the quotas of one or more users, specified by
userID ... from the command line. The -U option used with the -t
option, changes the grace period for all file systems with user quotas
specified in the /etc/fstab file.
OPERANDS
Specifies a prototypical user or group by the user name or group name.
A prototypical user or group has previously-defined, valid quota files
that you want to duplicate for other user or group quota files. Speci‐
fies a prototypical user or group by the user ID or group ID. A proto‐
typical user or group has previously-defined, valid quota files that
you want to duplicate for other user or group quota files.
DESCRIPTION
The edquota command invokes an editor that allows you to add and modify
user and group quotas and modify file system quota grace periods. Use
the quota command to display the existing quota information. Note that
disk quotas are displayed as 1 kilobyte blocks.
For each user and group specified (using -u or -g, respectively), the
edquota command creates a temporary file with an ASCII representation
of the current quotas for that user or group, then invokes an editor to
allow you to modify the file. The vi editor is invoked by default. To
override the default, specify a different editor for the EDITOR envi‐
ronment variable in your login file. To change quota values, edit the
numbers in the hard and soft limits fields and exit the editor.
Setting a hard limit to 0 (zero) indicates that no quota should be
imposed. Setting a hard limit to 1 indicates that no allocations should
be permitted. If you set the soft limit to 1 (one) and the hard limit
to 0 (zero), files can only be created for the length of time specified
by the grace period (default of 7 days). The current usage information
in the file is for informational purposes; only the hard and soft lim‐
its can be changed.
Hard and soft quota limits for the number of files are non-inclusive.
You can only create files if you remain below the limit. For example,
if your hard limit is 1000 files, you can only create 999 files. Hard
and soft quota limits for the number of blocks are similarly non-inclu‐
sive.
For each file system, the edquota-t command creates a temporary file
with an ASCII representation of the current grace period for that user
or group, then invokes an editor to allow you to modify the grace
period. The grace period may be specified in days, hours, minutes, or
seconds. Setting a grace period to 0 (zero) indicates that the default
grace period should be imposed. Setting a grace period to 1 second
indicates that no grace period should be granted. When you exit the
editor, edquota reads the temporary file and modifies the quota.user
and quota.group files for the target file system to reflect the changes
made.
Changes in grace periods take effect immediately unless a grace period
is currently in effect. For example, assume a user exceeds a soft
limit and receives a grace period of 7 days. A subsequent change to a
grace period of 1 day will not affect the user's already-invoked grace
period, unless the user drops below the soft limit and exceeds it once
again. The default grace period for a file system is specified in the
quota.user and quota.group files for the target file system.
NOTES
The term file system represents either a UFS file system or an AdvFS
fileset.
The root user can exceed user and group quotas. The fileset grace
period is equal to the group grace period. When you use the edquota
command to set the group grace period, it causes that same value to be
used for the fileset grace period.
RESTRICTIONS
You can use the edquota command to edit only those file systems that
are in the /etc/fstab file and have userquota and groupquota entries.
You can use the edquota command to edit only those file systems that
are currently mounted. Editing quota information for file systems that
are currently unmounted will not be saved on exit from the editor.
You must be the root user to edit quotas.
The default grace period is 7 days.
EXAMPLES
Set quotas for user1: /usr/sbin/edquota user1
To apply the existing quotas of the user named user1 to the user named
user2: /usr/sbin/edquota -p user1 user2
To apply the existing quotas of the user with the user ID 361 to the
user with the user ID 382: /usr/sbin/edquota -P 361 -U 382
To apply the existing quotas of the user named user1 to the user with
the user ID 382: /usr/sbin/edquota -p user1 -U 382
To set the grace period for all the file systems with group quotas
specified in the /etc/fstab file: /usr/sbin/edquota -gt
FILES
Specifies the command path. Contains user quotas for file systems.
Contains group quotas for file systems. Contains file system names and
locations.
SEE ALSO
Commands: quota(1), quotacheck(8), quotaon(8)
Functions: quotactl(2)
Files: fstab(4)edquota(8)