edquota(1M)

NAME

edquota − edit user disk quotas

SYNOPSIS

/etc/edquota [−p proto-user] username...
/etc/edquota −t

Remarks

When establishing quotas for a user who has had none before, the quota statistics for that user will not include any currently occupied file system resources. See WARNINGS below.

DESCRIPTION

edquota is the quota editor. One or more users can be specified on the command line. For each username, a temporary file is created with a textual representation of the current disk quotas for that user, and an editor is then invoked on the file. The quotas can then be modified, new quotas added, etc. Upon leaving the editor, edquota reads the temporary file and modifies the binary quota files to reflect the changes made.

The editor invoked is vi(1) unless the EDITOR environment variable specifies otherwise.

Only users who have appropriate privileges can edit quotas. (In order for quotas to be established on a file system, the root directory of the file system must contain a file called quotas. See quota(5) for details.)

Options

−p proto_user Duplicate the quotas of proto_user for each username. This is the normal mechanism used to initialize quotas for groups of users.

−t Edit the time limits for each file system. Time limits are set for file systems, not users. When a user exceeds the soft limit for blocks or inodes on a file system, a count-down timer is started and the user has an amount of time equal to the time limit in which to reduce usage to below the soft limit (required action is given by the quota command). If the time limit expires before corrective action is taken, the quota system enforces policy as if the hard limit had been exceeded. The default time limit of 0 is interpreted to mean the value in <sys/quota.h>, or one week (7 days). Time units of sec(onds), min(utes), hour(s), day(s), week(s), and month(s) are understood. Time limits are printed in the greatest possible time unit such that the value is greater than or equal to one.

Temporary File Formats

Here is an example of the temporary file created for editing user block and inode quotas:

fs /mnt blocks (soft = 100, hard = 120) inodes (soft = 0, hard = 0)
fs / blocks (soft = 1000, hard = 1200) inodes (soft = 200, hard = 200)

Here is the format for editing quota time limits:

fs /mnt blocks time limit = 10.00 days, files time limit = 20.00 days
fs / blocks time limit = 0 (default), files time limit = 0 (default)

When editing (default) values, it is not necessary to remove the (default) string. For example, to change the blocks time limit for /, changing the 0 to 4 days is sufficient.

WARNINGS

When establishing non-zero quotas for a user who has had none before (for either blocks or inodes), it is necessary to run quotacheck(1M) to collect statistics for that user’s current usage of that file system. See quota(5) for a detailed discussion of this topic.

AUTHOR

edquota was developed by the University of California, Berkeley, and by Sun Microsystems, Inc.

FILES

/etc/checklist default file systems

/etc/mnttab information about mounted file systems

directory/quotas quota statistics static storage for file system where directory is the root of the file system specified to mount(1M).

Museum

Related Articles