Home > Veritas Storage Foundation™ File System Manual Pages

VXEDQUOTA (1M)

Maintenance Commands

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
NOTES
Cluster File System Issues
OPTIONS
EXAMPLES
FILES
SEE ALSO

NAME

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

SYNOPSIS

vxedquota [ -u ] [ -p username ] username ...

vxedquota -g [ -p groupname ] groupname ...

vxedquota [ -u ] -t

vxedquota -g -t

AVAILABILITY

VRTSvxfs

DESCRIPTION

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 a quotas file for users, or a quotas.grp file for groups, in the root directory. 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|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 or quotas.grp file owned by root in the root directory. vxedquota can set user or group quota limits even when quotas are not turned on (see the vxquotaon(1M) manual page).

Quotas cannot be set for users with a UID|GID greater than 67,108,864.

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|groups. This can be useful for establishing default quotas for users or groups who are later assigned a UID|GID. Unassigned user|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.

NOTES

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

Quotas limits cannot exceed one terabyte.

Cluster File System Issues

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

OPTIONS

-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.

-p

Duplicates the quotas of the proto_user specified for each username specified. 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, \ files 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.

EXAMPLES

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.

FILES

/etc/filesystems: File system characteristics.
quotas: The user quotas file in the file system root directory.
quotas.grp: The group quotas file in the file system root directory.

VXEDQUOTA (1M)

Table of contents