quotactl(2)							System Calls Manual						       quotactl(2)

NAME
quotactl - manipulate disk quotas SYNOPSIS
DESCRIPTION
manipulates disk quotas. cmd indicates a command to be applied to the user or group ID id. A command is composed of a primary command and a type that is used to interpret the id parameter. Types supported are USRQUOTA for users and GRPQUOTA for groups. To set the type of quota use the macro. Parameter special is a pointer to a null-terminated string containing the path name of the block special device for the file system being manipulated. The block special device must be mounted. The parameter addr is the address of an optional, command- specific, data structure which is copied in or out of the system. The interpretation of addr is explained with each command below: Turn on quotas for a file system. The parameter addr points to the path name of file containing the quotas for the file system. The quota file must exist; it is normally created using the command (see quotacheck(1M)). The id parameter is ignored. This call is restricted to users having appropriate privileges. Turn off quotas for a file system. The addr and id parameters are ignored. This call is restricted to the user with appropriate privileges. Get disk quota limits and current usage for user or group id. addr is a pointer to a structure (defined in Only users having appropriate privileges can get the quotas of a user other than himself. Get 64-bit disk quota limits and current usage for user or group id. addr is a pointer to a structure (defined in Only users having appropriate privileges can get the quotas of a user other than himself. VxFS 3.5 will only track usage for dqb64_curblocks up to to 2 TB. Set disk quota limits and current usage of files and blocks for user or group id. Note does not allow the current usage fields to be changed. addr is a pointer to a structure (defined in This call is restricted to users with appropriate privileges. Set 64-bit disk quota limits and current usage of files and blocks for user or group id. Note does not allow the current usage fields to be changed. addr is a pointer to a structure (defined in This call is restricted to users with the appropriate privileges. Set disk quota limits for user or group id. The parameter addr is a pointer to a structure (defined in This call is restricted to users with appropriate privileges. Set 64-bit disk quota limits for user or group id. The parameter addr is a pointer to a structure (defined in This call is restricted to users with the appro- priate privileges. Retrieve information about quotas supported by file system id. The parameter addr is a pointer to a flags word. The meaning of the various bit fields are defined in Update the on-disk copy of quota usages for a file system. If special is null, all file systems with active quotas are synced. The parameters addr and id are ignored. RETURN VALUE
Upon successful completion, returns 0; otherwise, it returns -1 and sets to indicate the error. ERRORS
fails when any of the following occurs: The quota file pointed to by addr exists but is either not a regular file or is not on the file system pointed to by special. attempted while another or is in progress. User's disk quota block limit has been reached for this file system. The addr or special parameter points to an invalid address. Reliable detection of this error is implementation-depen- dent. The parameters cmd and/or id are invalid. The parameter special contains a type of file system that does not support quotas. Currently, quotas are supported on HFS and VxFS file systems. The file specified by special or addr does not exist. The kernel has not been configured with the disk quota subsystem. The parameter special is not a block device. Type of quota not supported on the file system. 64-bit values will overflow 32-bit fields, either in the struct in the user level (for or in a 32-bit file system in the kernel (for and The call is privileged and the calling process does not have appropriate privileges. No disc quota is found for the indicated user or quotas have not been turned on for this file system. WARNINGS
The system call is incompatible with the 4.2/4.3 BSD implementation of Melbourne quotas which uses a different system call interface and on-disk data structure. Use and commands for 64-bit field values. AUTHOR
was developed by HP and Sun Microsystems, Inc. SEE ALSO
quota(1), edquota(1M), quotacheck(1M), quotaon(1M), rquotad(1M), mount(2), privileges(5), quota(5). quotactl(2)