unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 quotactl(2)							 quotactl(2)




 NAME
      quotactl - manipulate disk quotas

 SYNOPSIS
      #include <&lt&lt&lt;sys/quota.h>&gt&gt&gt;

      int quotactl(int cmd, const char *special, uid_t uid, void *addr);

 DESCRIPTION
      quotactl() manipulates disk quotas.  cmd indicates a command to be
      applied to the user ID uid.  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:

	   Q_QUOTAON	  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
			  quotacheck command (see quotacheck(1M)).  The uid
			  parameter is ignored.	 This call is restricted to
			  users having appropriate privileges.

	   Q_QUOTAOFF	  Turn off quotas for a file system.  The addr and
			  uid parameters are ignored.  This call is
			  restricted to the user with appropriate
			  privileges.

	   Q_GETQUOTA	  Get disk quota limits and current usage for user
			  uid.	addr is a pointer to a dqblk structure
			  (defined in <&lt&lt&lt;sys/quota.h>&gt&gt&gt;).  Only users having
			  appropriate privileges can get the quotas of a
			  user other than himself.

	   Q_SETQUOTA	  Set disk quota limits and current usage of files
			  and blocks for user uid.  Note vxfs does not allow
			  the current usage fields to be changed addr is a
			  pointer to a dqblk structure (defined in
			  <&lt&lt&lt;sys/quota.h>&gt&gt&gt;).  This call is restricted to users
			  with appropriate privileges.

	   Q_SETQLIM	  Set disk quota limits for user uid.  The parameter
			  addr is a pointer to a dqblk structure (defined in
			  <&lt&lt&lt;sys/quota.h>&gt&gt&gt;).  This call is restricted to users
			  with appropriate privileges.

	   Q_SYNC	  Update the on-disk copy of quota usages for a file
			  system.  If special is null, all file systems with



 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 quotactl(2)							 quotactl(2)




			  active quotas are synced.  The parameters addr and
			  uid are ignored.

 RETURN VALUE
      Upon successful completion, quotactl() returns 0; otherwise, it
      returns -1 and sets errno to indicate the error.

 ERRORS
      quotactl() fails when any of the following occurs:

	   [ENOSYS]	  The kernel has not been configured with the disk
			  quota subsystem.

	   [EINVAL]	  The parameters cmd and/or uid are invalid.

	   [ESRCH]	  No disc quota is found for the indicated user or
			  quotas have not been turned on for this file
			  system.

	   [EPERM]	  The call is privileged and the calling process
			  does not have appropriate privileges.

	   [ENODEV]	  The parameter special contains a type of file
			  system that does not support quotas.	Currently,
			  quotas are supported on HFS and VxFS file systems.

	   [ENOTBLK]	  The parameter special is not a block device.

	   [EACCES]	  (Q_QUOTAON) 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.

	   [EBUSY]	  Q_QUOTAON attempted while another Q_QUOTAON or
			  Q_QUOTAOFF is in progress.

	   [ENOENT]	  The file specified by special or addr does not
			  exist.

	   [EFAULT]	  The addr or special parameter points to an invalid
			  address.  Reliable detection of this error is
			  implementation-dependent.

	   [EDQUOT]	  User's disk quota block limit has been reached for
			  this file system.

 WARNINGS
      The quotactl() system call is incompatible with the 4.2/4.3BSD
      implementation of Melbourne quotas which uses a different system call
      interface and on-disk data structure.





 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 quotactl(2)							 quotactl(2)




 AUTHOR
      quotactl() was developed by HP and Sun Microsystems, Inc.

 SEE ALSO
      quota(1), edquota(1M), rquotad(1M), quotacheck(1M), quotaon(1M),
      mount(2), quota(5), quota(5).
















































 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000