4.3BSD - /usr/man/cat2/quota.0

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  struc‐
       ture 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  indicating  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 informa‐
              tion and print a message on the terminal 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.   Other‐
              wise, 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 indicates 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)