NAME

edquota − Edits user quotas

SYNOPSIS

/usr/sbin/edquota [−p proto_user] [−u] username ... 

/usr/sbin/edquota [−p proto_group] −g groupname ... 

/usr/sbin/edquota [−u | −g] −t

DESCRIPTION

The edquota command is a quota editor. 

For each user or group, the program creates a temporary file with an ASCII representation of the current disk quotas for that user or group, then invokes an editor that you use 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. 

Note that disk quotas are given in block sizes of 1024 byte blocks. 

Using the editor, you can then modify quotas, add new quotas, and so on.  Setting a quota to 0 (zero) indicates that no quota should be imposed.  Setting a hard limit to 1 (one) indicates that no allocations should be permitted.  Setting a soft limit to 1 (one) with a hard limit of 0 (zero) indicates that allocations should be permitted on only a temporary basis (see the −t flag).  The current usage information in the file is for informational purposes; only the hard and soft limits can be changed. 

For each filesystem, the program creates a temporary file with an ASCII representation of the current grace period for that user or group, then invokes an editor that you use 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 filesystem to reflect the changes made. 

Changes in grace periods take effect immediately, unless a grace period is currently in effect.  For example, let’s assume that 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-established grace period, unless the user drops below the soft limit and exceeds it once again.  The default grace period for a filesystem is specified in the quota.user and quota.group files for the target filesystem. 

Only a user who is root can edit quotas. 

FLAGS

−gEdits the quotas of one or more groups, specified by groupname on the command line.  When used with −t, changes the grace period for all filesystems with group quotas specified in /etc/fstab. 

−p proto_user | proto_group
Causes edquota to initialize the specified quotas by duplicating the quotas of the specified prototypical proto_user (if used with the −u flag or no other flags) or proto_group (if used with the −g flag).  proto_user or proto_group must have a previously defined and valid quota file.  Editing quotas for one user, then using the −p flag to duplicate these quotas is the normal mechanism used to initialize quotas for a group of users. 

−tChanges the default grace period for which users may exceed their soft limits.  By default, or when you specify −t with the −u flag, the grace period is set for all filesystems with user quotas specified in /etc/fstab; when you specify −t with the −g flag, the grace period is set for all the filesystems with group quotas specified in /etc/fstab. 

−uEdits the quotas of one or more users, specified by username ... on the command line.  −u  is the default.  When used with −t, changes the grace period for all filesystems with user quotas specified in /etc/fstab. 

FILES

/usr/sbin/edquota
Specifies the command path

[filesystem_root]/quota.user
Contains user quotas for filesystem

[filesystem_root]/quota.group
Contains user quotas for filesystem

/etc/fstabContains filesystem names and locations

RELATED INFORMATION

Commands:  quota(1), quotacheck(8), quotaon(8), repquota(8). 

Functions:   quotactl(2). 

Files:  fstab(4).