Unix/Linux Go Back    


BSD 2.11 - man page for quota (bsd section 2)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


QUOTA(2)										 QUOTA(2)

NAME
       quota - manipulate disk quotas

SYNOPSIS
       #include <sys/quota.h>

       quota(cmd, uid, arg, addr)
       int cmd, uid, arg;
       char *addr;

DESCRIPTION
       The  quota call manipulates disk quotas for file systems that have had quotas enabled with
       setquota(2).  The cmd parameter indicates a command to be applied to the user ID uid.  Arg
       is  a  command specific argument and addr is the address of an optional, command specific,
       data structure that is copied in or out of the system.  The interpretation of arg and addr
       is given with each command below.

       Q_SETDLIM
	      Set  disc quota limits and current usage for the user with ID uid.  Arg is a major-
	      minor device indicating a particular file system.  Addr is a pointer  to	a  struct
	      dqblk  structure (defined in <sys/quota.h>).  This call is restricted to the super-
	      user.

       Q_GETDLIM
	      Get disc quota limits and current usage for the user with ID  uid.   The	remaining
	      parameters are as for Q_SETDLIM.

       Q_SETDUSE
	      Set  disc usage limits for the user with ID uid.	Arg is a major-minor device indi-
	      cating a particular file system.	Addr is a pointer to a struct  dqusage	structure
	      (defined in <sys/quota.h>).  This call is restricted to the super-user.

       Q_SYNC Update  the  on-disc  copy of quota usages.  Arg is a major-minor device indicating
	      the file system to be sync'ed.  If the arg parameter is  specified  as  NODEV,  all
	      file  systems  that  have disc quotas will be sync'ed.  The uid and addr parameters
	      are ignored.

       Q_SETUID
	      Change the calling process's quota limits to those of the user with  ID  uid.   The
	      arg and addr parameters are ignored.  This call is restricted to the super-user.

       Q_SETWARN
	      Alter the disc usage warning limits for the user with ID uid.  Arg is a major-minor
	      device indicating a particular file system.  Addr is a pointer to a  struct  dqwarn
	      structure (defined in <sys/quota.h>).  This call is restricted to the super-user.

       Q_DOWARN
	      Warn  the  user  with user ID uid about excessive disc usage.  This call causes the
	      system to check its current disc usage information and print a message on the  ter-
	      minal  of  the caller for each file system on which the user is over quota.  If the
	      user is under  quota,  his  warning  count  is  reset  to  MAX_*_WARN  (defined  in
	      <sys/quota.h>).	If the arg parameter is specified as NODEV, all file systems that
	      have disc quotas will be checked.  Otherwise, arg indicates a specific  major-minor
	      device to be checked.  This call is restricted to the super-user.

RETURN VALUE
       A  successful  call  returns 0, otherwise the value -1 is returned and the global variable
       errno indicates the reason for the failure.

ERRORS
       A quota call will fail when one of the following occurs:

       [EINVAL]       The kernel has not been compiled with the QUOTA option.

       [EINVAL]       Cmd is invalid.

       [ESRCH]	      No disc quota is found for the indicated user.

       [EPERM]	      The call is priviledged and the caller was not the super-user.

       [ENODEV]       The arg parameter is being interpreted as a major-minor device and it indi-
		      cates an unmounted file system.

       [EFAULT]       An  invalid  addr is supplied; the associated structure could not be copied
		      in or out of the kernel.

       [EUSERS]       The quota table is full.

SEE ALSO
       setquota(2), quotaon(8), quotacheck(8)

BUGS
       There should be some way to integrate this call with the resource limit interface provided
       by setrlimit(2) and getrlimit(2).

       The  Australian	spelling  of disk is used throughout the quota facilities in honor of the
       implementors.

4.2 Berkeley Distribution		   May 15, 1986 				 QUOTA(2)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 07:59 AM.