4.3BSD-UWisc/man/cat2/quota.2

QUOTA(2)            UNIX Programmer's Manual             QUOTA(2)



NAME
     quota - manipulate disk quotas

SYNOPSIS
     #include <sys/quota.h>

     quota(cmd, uid, arg, addr)
     int cmd, uid, arg;
     caddr_t addr;

DESCRIPTION
     N.B.: This call is not implemented in the current version of
     the system.

     The _q_u_o_t_a call manipulates disk quotas for file systems
     which have had quotas enabled with _s_e_t_q_u_o_t_a(2).  The _c_m_d
     parameter indicates a command to be applied to the user ID
     _u_i_d.  _A_r_g is a command specific argument and _a_d_d_r is the
     address of an optional, command specific, data structure
     which is copied in or out of the system.  The interpretation
     of _a_r_g and _a_d_d_r is given with each command below.

     Q_SETDLIM
          Set disc quota limits and current usage for the user
          with ID _u_i_d.  _A_r_g is a major-minor device indicating a
          particular file system.  _A_d_d_r is a pointer to a struct
          dqblk structure (defined in <_s_y_s/_q_u_o_t_a._h>).  This call
          is restricted to the super-user.

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

     Q_SETDUSE
          Set disc usage limits for the user with ID _u_i_d.  _A_r_g is
          a major-minor device indicating a particular file sys-
          tem.  _A_d_d_r is a pointer to a struct dqusage structure
          (defined in <_s_y_s/_q_u_o_t_a._h>).  This call is restricted to
          the super-user.

     Q_SYNC
          Update the on-disc copy of quota usages.  The _u_i_d, _a_r_g,
          and _a_d_d_r parameters are ignored.

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

     Q_SETWARN
          Alter the disc usage warning limits for the user with



Printed 12/27/86           7 July 1983                          1






QUOTA(2)            UNIX Programmer's Manual             QUOTA(2)



          ID _u_i_d.  _A_r_g is a major-minor device indicating a par-
          ticular file system.  _A_d_d_r is a pointer to a struct
          dqwarn structure (defined in <_s_y_s/_q_u_o_t_a._h>).  This call
          is restricted to the super-user.

     Q_DOWARN
          Warn the user with user ID _u_i_d about excessive disc
          usage.  This call causes the system to check its
          current disc usage information and print a message on
          the terminal of the caller for each file system on
          which the user is over quota.  If the _a_r_g parameter is
          specified as NODEV, all file systems which have disc
          quotas will be checked.  Otherwise, _a_r_g indicates a
          specific major-minor device to be checked.  This call
          is restricted to the super-user.

RETURN VALUE
     A successful call returns 0 and, possibly, more information
     specific to the _c_m_d performed; when an error occurs, the
     value -1 is returned and _e_r_r_n_o is set to indicate the rea-
     son.

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

     [EINVAL]       _C_m_d 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.

     [EINVAL]       The _a_r_g parameter is being interpreted as a
                    major-minor device and it indicates an
                    unmounted file system.

     [EFAULT]       An invalid _a_d_d_r 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 someway to integrate this call with the
     resource limit interface provided by _s_e_t_r_l_i_m_i_t(2) and
     _g_e_t_r_l_i_m_i_t(2).





Printed 12/27/86           7 July 1983                          2






QUOTA(2)            UNIX Programmer's Manual             QUOTA(2)



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





















































Printed 12/27/86           7 July 1983                          3