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)