HP-UX Reference (11i v2 04/09) - 1M System Administration Commands A-M (vol 3)

e
edquota(1M) edquota(1M)
NAME
edquota - edit user disk quotas
SYNOPSIS
/usr/sbin/edquota
[-p proto-user ] username ...
/usr/sbin/edquota -t
DESCRIPTION
The edquota command is the quota editor. One or more user names 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 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 specified by the
EDITOR environment variable. It defaults to vi (see vi(1)).
In order for quotas to be established on a file system, the root directory of the file system must contain a
file named
quotas. See quota(5) for details.
Quotas can be established only for users whose user ID is less than 67,000,000. Attempts to establish
quotas for other users will result in an error message. This restriction will be removed in a future version
of
HP-UX.
Only users who have appropriate privileges can edit quotas.
Options
-p proto_user Duplicate the quotas of the user name 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 countdown
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 (the required action is given by the quota com-
mand). 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 quotas for a user who has had none before, (for either blocks or inodes), the quota
statistics for that user do not include any currently occupied file system resources. Therefore, it is neces-
sary to run
quotacheck (see 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.
edquota will only edit quotas on local file systems.
AUTHOR
edquota was developed by the University of California, Berkeley, and by Sun Microsystems, Inc.
Section 1M−−156 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: September 2004