 |
Index for
Section 8 |
|
 |
Alphabetical
listing for E |
|
 |
Bottom of
page |
|
edquota(8)
NAME
edquota - 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
-g 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.
-G 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 specified in the
/etc/fstab file.
-p proto_username | proto_groupname
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.
-P proto_userID | proto_groupID
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. 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.
-t 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.
-u 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.
-U 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
proto_username, proto_groupname
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.
proto_userID, proto_groupID
Specifies a prototypical user or group by the user ID or group ID. A
prototypical 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 environment 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 limits 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-inclusive.
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
/usr/sbin/edquota
Specifies the command path.
<filename>[filesystem_root] /quota.user</filename>
Contains user quotas for file systems.
[filesystem_root]/quota.group
Contains group quotas for file systems.
/etc/fstab
Contains file system names and locations.
SEE ALSO
Commands: quota(1), quotacheck(8), quotaon(8)
Functions: quotactl(2)
Files: fstab(4)
|
Index for
Section 8 |
|
|
Alphabetical
listing for E |
|
 |
Top of
page |
|