quota.group(5) [freebsd man page]
QUOTA.USER(5) BSD File Formats Manual QUOTA.USER(5) NAME
quota.user, quota.group -- per file system quota database DESCRIPTION
Each file system with active quotas should contain a quota.user and quota.group file in the file system root. These files are created by quotacheck(8), and should be edited with edquota(8). It is possible to specify a different location and file name with the ``userquota'' and ``groupquota'' options in the fstab(5) file. The data files contain the following information: o Current block usage o Current number of files o Soft block limit o Soft file limit o Hard block limit o Hard file limit o Block grace time remaining if over the soft limit o File grace time remaining if over the soft limit See edquota(8) for an explanation on the various limits and grace periods. During normal quota operations the quotactl(2) interface is used to query or set quota information and the kernel will maintain the data files as needed. If quotas are disabled on a file system, but marked as having quotas enabled in fstab(5), then the quota data files will be used directly. The data files are stored as an array of ``struct dqblk'' structures, as defined in <ufs/ufs/quota.h>, and indexed by UID or GID. The data files will be written as a sparse file if possible. Data is only maintained for ids that have either non-zero usage or non-zero quota lim- its. If an attempt is made to access data for an id that would exist past the end of the current data file, a quota structure with all val- ues set to zero will be created, and the data file extended as needed. The quotacheck(8) utility will truncate the data files to the minimum size needed to store the highest id with either non-zero file usage or non-zero quota limits. The data record for id 0 has special meaning. If the ``dqb_btime'' or ``dbq_itime'' fields are non-zero, they are used to indicate the grace period on that file system for users who have exceeded their soft limit. These times can be set by edquota(8) with the -t flag. If no explicit grace period has been set with edquota(8), then the default value of 7 days will be used. The default values are defined by MAX_DQ_TIME and MAX_IQ_TIME in <ufs/ufs/quota.h>. SEE ALSO
quota(1), quotactl(2), fstab(5), edquota(8), quotacheck(8), quotaoff(8), quotaon(8), repquota(8) BSD
October 30, 2007 BSD
Check Out this Related Man Page
edquota(8) System Manager's Manual edquota(8) NAME
edquota - edits quotas SYNOPSIS
/usr/sbin/edquota [-gGuU] -t /usr/sbin/edquota [-p proto_username] [-u] username ... /usr/sbin/edquota [-P proto_userID] -U userID ... /usr/sbin/edquota [-P proto_userID] [-u] username ... /usr/sbin/edquota [-p proto_username] -U userID ... /usr/sbin/edquota [-p proto_groupname] -g groupname ... /usr/sbin/edquota [-P proto_groupID] -G groupID ... /usr/sbin/edquota [-P proto_groupID] -g groupname ... /usr/sbin/edquota [-p proto_groupname] -G groupID ... PARAMETERS
Specifies a prototypical user or group by the user name or group name. A prototypical user or group has previously-defined, valid quota files that you want to duplicate for other user or group quota files. Specifies a prototypical user or group by the user id or group id. A prototypical user or group has previously-defined, valid quota files that you want to duplicate for other user or group quota files. FLAGS
Edits the quotas of one or more groups, specified by groupname on the command line. When used with the -t flag, sets or changes the grace period for all file systems with group quotas specified in the /etc/fstab file. Edits the quotas of one or more groups, specified by groupID on the command line. When used with the -t flag, sets or changes the grace period for all file systems with group quotas specified in the /etc/fstab file. Initializes the specified quotas by duplicating the established quotas of the prototypical user's name (when used with the -u flag, the -U flag, or no other flags) or the prototypical group's name (when used with the -g or -G flags). The proto_username or proto_groupname must have a valid quota file. Establishing quotas for one user or group and then using the -p flag to duplicate these quotas for other users is the normal mechanism for initializing quotas for a group of users. Initializes the specified quotas by duplicat- ing the established quotas of the prototypical user's id (when used with the -U flag or the -u flag) or the prototypical group's id (when used with the -G flag or the -g flag). The proto_userID or proto_groupID must have a valid quota file. Establishing quotas for one user or group and then using the -P flag to duplicate these quotas for other users is the normal mechanism for initializing quotas for a group of users. Sets or changes the default grace period for which users may exceed their soft limits. By default, or when you specify -t with the -u flag, the grace period is set for all file systems with user quotas specified in the /etc/fstab file. When you specify -t with the -g flag, the grace period is set for all of the file systems with group quotas specified in the /etc/fstab file. Edits the quotas of one or more users, specified by username ... on the command line. The -u flag is the default. The -u flag, used with the -t flag, changes the grace period for all file systems with user quotas specified in the /etc/fstab file. Edits the quotas of one or more users, specified by userID ... on the command line. The -U flag used with the -t flag, changes the grace period for all file systems with user quotas speci- fied in the /etc/fstab file. DESCRIPTION
The edquota command is a quota editor that allows you to add and modify user and group quotas and modify file system quota grace periods. Use the quota command to display the existing quota information. Note that disk quotas are displayed as 1 kilobyte blocks. For each user or group specified, the edquota command creates a temporary file with an ASCII representation of the current quotas for that user or group, then invokes an editor to allow you to modify the file. The vi editor is invoked by default. To override the default, specify a different editor for the EDITOR environment variable in your login file. Setting a hard limit to 0 (zero) indicates that no quota should be imposed. Setting a hard limit to 1 (one) indicates that no allocations should be permitted. Setting a soft limit to 1 (one) with a hard limit of 0 (zero) indicates that allocations should be permitted on only a temporary basis (see the -t flag). The current usage information in the file is for informational purposes; only the hard and soft lim- its can be changed. For each file system, the edquota command creates a temporary file with an ASCII representation of the current grace period for that user or group, then invokes an editor to allow you to modify the grace period. The grace period may be specified in days, hours, minutes, or seconds. Setting a grace period to 0 (zero) indicates that the default grace period should be imposed. Setting a grace period to 1 second indicates that no grace period should be granted. When you exit the editor, edquota reads the temporary file and modifies the quota.user and quota.group files for the target file system to reflect the changes made. Changes in grace periods take effect immediately unless a grace period is currently in effect. For example, assume a user exceeds a soft limit and receives a grace period of 7 days. A subsequent change to a grace period of 1 day will not affect the user's already-invoked grace period, unless the user drops below the soft limit and exceeds it once again. The default grace period for a file system is speci- fied in the quota.user and quota.group files for the target file system. RESTRICTIONS
You can use the edquota command to edit only those file systems that are in the /etc/fstab file and have userquota and groupquota entries. You must be the root user to edit quotas. NOTES
The term file system represents either a UFS file system or an AdvFS fileset. The root user can exceed user and group quotas. The fileset grace period is equal to the group grace period. When you use the edquota command to set the group grace period for a fileset causes that same value to be used for the fileset grace period. EXAMPLES
To apply the existing quotas of the user named user1 to the user named user2: /usr/sbin/edquota -p user1 -u user2 To apply the existing quotas of the user named user1 to the user named user2, using the default: /usr/sbin/edquota -p user1 user2 To apply the existing quotas of the user with the user id 361 to the user with the user id 382: /usr/sbin/edquota -P 361 -U 382 To apply the existing quotas of the user named user1 to the user with the user id 382: /usr/sbin/edquota -p user1 -U 382 FILES
Specifies the command path Contains user quotas for file systems Contains group quotas for file systems Contains file system names and locations RELATED INFORMATION
quota(1), quotacheck(8), quotaon(8), quotactl(2), fstab(4). delim off edquota(8)