Symantec logo

vxedquota

NAME

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

SYNOPSIS

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

vxedquota -g [ -p proto_group ] 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 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 or quotas.grp 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.

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, 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, \

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.

SEE ALSO

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