quotactl(2)quotactl(2)NAMEquotactl - manipulate disk quotas
SYNOPSISDESCRIPTION
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 sys‐
tem. The quota file must exist; it is nor‐
mally created using the command (see quo‐
tacheck(1M)). The id parameter is ignored.
This call is restricted to users having appro‐
priate privileges.
Turn off quotas for a file system.
The addr and id parameters are ignored. This
call is restricted to the user with appropri‐
ate 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 him‐
self.
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 him‐
self. 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 appropriate 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-dependent.
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 subsys‐
tem.
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 ALSOquota(1), edquota(1M), quotacheck(1M), quotaon(1M), rquotad(1M),
mount(2), privileges(5), quota(5).
quotactl(2)