vxedquota - edit user and group quotas for a VxFS file system

vxedquota [ -Hu ] [ -p proto_user ] username ...

vxedquota [ -gH ] [ -p proto_group ] groupname ...

vxedquota [ -u ] -t

vxedquota [ -g ] -t

VRTSvxfs

vxedquota is a quota editor to modify quota limits for one or more users or groups. You can specify either username or UID as the user name on the command line. For group quotas, you can specify either groupname or GID. For each user and each group, a temporary file is created with an ASCII representation of the current disk quotas for each mounted VxFS file system that has quota files in the root directory. The quota files are dependent on layout version of the file system and are as follows:

Layout Version User Quota File Group Quota File Quota Support Quota Limit
               -----------------------------------------------------------------
     10 | quotas.64 | quotas.grp.64 | 64-bit | 4 Exabytes |
               -----------------------------------------------------------------
9 (or earlier) | quotas | quotas.grp | 32-bit | 1 Terabyte |
               -----------------------------------------------------------------

The temporary file is invoked in an editor with which you can modify existing quotas and add new quotas. After exiting the editor, vxedquota reads the temporary file and modifies the contents of the binary quota file to reflect the new quota limits. If you supply a proto_user or proto_group, quotas for the given user or group are duplicated from the quota limits of the proto-user.

You must be a privileged user to edit quotas. You can create quotas on any mounted VxFS file system that contains a quotas/quotas.64 or quotas.grp/quotas.grp.64 file owned by root in the root directory of the mounted file system. vxedquota can set user or group quota limits even when quotas are not turned on (see the vxquotaon(1M) manual page).

The default editor invoked is vi unless the environment variable EDITOR specifies a different editor. Unassigned UIDs or GIDs can be specified to create quotas limits for future users or groups. This can be useful for establishing default quotas for users or groups who are later assigned a UID or GID. Unassigned user and group names cannot be used similarly.

If no options are specified (a user name or user ID is expected), the temporary file created has one line per file system in the form:

fs mount_point blocks (soft = limit, hard = limit) \inodes (soft = limit, hard = limit)

where a block is 1024 (1K) bytes. You can modify the limit to set up desired blocks and file limits for a user.

When quotas are turned on, use only the vxedquota editor to modify the quotas. If you copy the quotas/quotas.64 or quotas.grp/quotas.grp.64 file from another file system, turn off quotas on the target file system before doing the copy.

Quota limits cannot exceed four exabytes for 64-bit quota and one terabyte for 32-bit quota.

This command operates the same on cluster file systems, however, to enable quotas for CFS, the quotas/quotas.64 file must be on the same file system; links to another file system are not allowed.

-g	Opens a temporary file containing one line per file system in the form: fs mount_point blocks (soft = limit, hard = limit) \inodes (soft = limit, hard = limit)
	where a block is 1024 (1K) bytes. You can modify the limit fields to specify block and file limits for a group.
-H	When specified with the -u or -g option, allows you to set quota limits in human-friendly units. Limits can be specified in blocks (the default; a block is 1024 (1k) bytes), as a percentage of the file system’s size, or in normal units. To specify a percentage, append the value with a percent sign (%), such as 90%. To specify normal units, append the value with k or K for kilobytes, m or M for megabytes, g or G for gigabytes, t or T for terabytes, p or P for petabytes, or x or X for exabytes.
-p	Duplicates the quotas of the proto_user specified for each username specified, or the quotas of the proto_group specified for each groupname. This is the normal mechanism used to initialize quotas for groups of users.
-t	Edits the soft time limits for each file system. If the time limits are zero, the default time limits are used. The temporary file created has one or more lines in the form:   fs mount_point blocks time limit = number tmunit, les time limit = number tmunit
	You can modify the number and tmunit fields to set desired values. tmunit can be one of month, week, day, hour, min or sec; characters appended to these keywords are ignored, so months or minutes is accepted. Time limits are printed in the greatest possible time unit such that the value is greater than or equal to one. If default is printed after the tmunit, it indicates that the value shown is zero (the default).
-u	Works as though no options are specified.

If there is a user, user1, with quota limits already set up, you can set up the same quota limits for user2:

# vxedquota -p user1 user2

Similarly for groups, if there is a group, group1, with quota limits already set up, you can set up the same quota limits for group2:

# vxedquota -g -p group1 group2

This method is useful for automating the setting of quota limits in a script, avoiding the need to use a text editor every time you run vxedquota.

The following example displays quotas in human-friendly units for the user user1:

# vxedquota -uH user1
fs /mnt3 blocks (soft = 12%, hard = 12 g) inodes (soft = 0, hard = 0)
Disk quotas for user1 (uid 20020):
Filesystem usage quota limit timeleft files quota limit timeleft
/mnt3 90 MB 4.8 GB 12 GB 9 0 0

/etc/mtab	Table of mounted file systems.
quotas/quotas.64	The user quotas file in the file system root directory.
quotas.grp/quotas.grp.64	The group quotas file in the file system root directory.

vi(1), vxquota(1M), vxquotaon(1M), vxrepquota(1M), vxfsio(7)