edquota_vxfs(1M)

edquota_vxfs - edit user quotas for a VERITAS File System

Synopsis

edquota [ -F vxfs ]
edquota [ -p proto_user ] username ...
edquota -t

Description

edquota is a quota editor. It is used to modify quota limits for one or more users. Either username or UID can be specified as the user name on the command line. For each user, a temporary file is created with an ASCII representation of the current disk quotas for each mounted vxfs file system with a quotas file in the root directory. The temporary file is then invoked in an editor, where existing quotas can be modified and new quotas can be added. Upon leaving the editor, edquota reads the temporary file and modifies the contents of the binary quota file to reflect the new quota limits. Given a proto_user option, quotas for the given user are duplicated from the quota limits of the proto-user.

Only a privileged user can edit quotas. Quotas can be created on a mounted vxfs file system that contains a quotas file owned by root in the root directory. edquota may set user quota limits even when quotas are not turned on (see quotaon_vxfs(1M)) on a vxfs file system.

The editor invoked is vi(1) unless the environment variable EDITOR specifies some other editor. Unassigned UIDs may be specified to create quotas limits for future users. This may be useful for establishing default quotas for users who are later assigned a UID. Unassigned user names cannot be used similarly.

If no options are specified, the temporary file created will have one line per file system of the form:

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

where a block is considered to be a 1024 byte (1K) block. The limit may be modified to set up desired blocks and file limits for a user.

Options

-F vxfs

Specify the vxfs file system type. If -F vxfs is not specified heuristics similiar to those used by fstyp(1M) are used to determine the file system type.

This command executes faster if it is not required to autodetect file system types. If possible, specify -F vxfs

-p

Duplicate 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

Edit the soft time limits for each file system. If the time limits are zero, the default time limits in /usr/include/sys/fs/ufs_quota.h are used. The temporary file created will have one or more lines of the form:

fs mount_point blocks time limit = number tmunit, files time limit = number tmunit

tmunit may be one of month, week, day, hour, min or sec; characters appended to these keywords are ignored, so you may write months or minutes for example. The number and tmunit fields may be modified to set desired values. 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, this indicates that the value shown is zero (the default).

Notices

When quotas are on, it is recommended that only edquota be used to modify the quotas. If the quotas file from another file system is to be copied to the target file system, then quotas should be turned off on the target file system before copying the quotas file.

Files

quotas: Quotas file at the file system root.
/etc/mnttab: Table of mounted file systems.

References

fstyp(1M), vi(1), quota_vxfs(1M), quotaon_vxfs(1M), repquota_vxfs(1M), vxfsio(7)