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, and so forth. 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 result in an error message. This restriction will be removed in a future version of HP-UX.

If you have the HP DiskQuota-Enh product installed, the above restriction for user IDs does not exist for VxFS filesystems that are mounted with largefiles enabled (see mkfs_vxfs(1M)).

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 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 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 necessary 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 only edits quotas on local file systems.

AUTHOR

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

FILES

/etc/fstab: Static information about the file systems.
/etc/mnttab: Mounted file system table.
directory/quotas: Quota statistics static storage for a file system, where directory is the root of the file system as specified to the mount command (see mount(1M)).

edquota(1M)

Technical documentation

» Table of Contents

» Index