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) BSD System Manager's Manual EDQUOTA(8) NAME
edquota -- edit user quotas SYNOPSIS
edquota [-Hu] [-f file-system] [-p proto-username] -d | username ... edquota [-H] -g [-f file-system] [-p proto-groupname] -d | groupname ... edquota [-Hu] [-f file-system] [-h block#/inode#] [-s block#/inode#] [-t block grace time/inode grace time] -d | username ... edquota [-H] -g [-f file-system] [-h block#/inode#] [-s block#/inode#] [-t block grace time/inode grace time] -d | groupname ... edquota [-Hu] -c [-f file-system] username ... edquota [-H] -g -c [-f file-system] groupname ... DESCRIPTION
edquota is a quota editor. By default, or if the -u flag is specified, one or more users may be specified on the command line. Unless -h, -s, or -t are used, a temporary file is created for each user with an ASCII representation of the current disk quotas and grace time for that user. By default, quota for all quota-enabled file systems are edited; the -f option can be used to restrict it to a single file system. An editor is invoked on the ASCII file. The editor invoked is vi(1) unless the environment variable EDITOR specifies otherwise. The quotas may then be modified, new quotas added, etc. Setting a quota to - or unlimited indicates that no quota should be imposed. Set- ting a quota to zero indicates that no allocation is permited. Setting a soft limit to zero with a unlimited hard limit indicates that allocations should be permitted on only a temporary basis. The current usage information in the file is for informational purposes; only the hard and soft limits, and grace time can be changed. Users are permitted to exceed their soft limits for a grace period that may be specified per user (or per-file system for quota version 1). Once the grace period has expired, the soft limit is enforced as a hard limit. The default grace period is one week. By default, disk quotas are in KB, grace time in seconds. Disk and inodes quota can be entered with a humanize_number(9) suffix (K for kilo, M for mega, G for giga, T for tera). Time can be entered with Y (year), W (week), D (day), H (hour) and M (minute) suffixes. Suffixes can be mixed (see EXAMPLES below). If the -H option if used, current quota, disk usage and time are displayed in a human-readable format. On leaving the editor, edquota reads the temporary file and modifies the on-disk quotas to reflect the changes made. If the -p flag is specified, edquota will duplicate the quotas of the prototypical user specified for each user specified. The -h, -s, and -t flags can be used to change quota limits (hard, soft and grace time, respectively) without user interaction, for usage in e.g. batch scripts. The arguments are the new block and inode number limit or grace time, separated by a slash. Units suffix may be used, as in the editor above. If the -g flag is specified, edquota is invoked to edit the quotas of one or more groups specified on the command line. With quota version 2, there is a per-file system user or group default quota to be copied to a user or group quota on the first allocation. The -d flag adds the default quota to the list of users or groups to edit. For quota version 1, there is no default block/inode quota, and no per-user/group grace time. To edit the file system-wide grace time, use -d. On quota2-enabled file systems, the -c flag cause edquota to clear quota entries for the specified users or groups. If disk or inode usages is not 0, limits are reverted to the default quota. If disk and inode usages are 0, the existing quota entries are freed. Only the super-user may edit quotas. EXAMPLES
Edit quotas for group games on all quota-enabled file systems: edquota -g Set 4MB hard block limit, 2MB soft block limit, 2048 inode hard limit, 1024 inode soft limit, 2 weeks and 3 days (or 17 days) block and inode grace time for the default quotas on file system /home: edquota -h 4M/2k -s 2M/1k -t 2W3D/2W3D -f /home -u -d SEE ALSO
quota(1), humanize_number(3), libquota(3), fstab(5), quotacheck(8), quotaon(8), quotarestore(8), repquota(8) BSD
January 29, 2012 BSD