Manual Pages for UNIX Operating System command usage for man quotactl

Ioctl Requests                                       quotactl(7I)



NAME
     quotactl - manipulate disk quotas

SYNOPSIS
     #include 
     int ioctl(int fd, Q_QUOTACTL, struct quotcl *qp)


DESCRIPTION
     This ioctl() call manipulates disk quotas. fd  is  the  file
     descriptor  returned by the open() system call after opening
     the quotas file  (located  in  the  root  directory  of  the
     filesystem   running   quotas.)  Q_QUOTACTL  is  defined  in
     /usr/include/sys/fs/ufs_quota.h. qp is the  address  of  the
     quotctl structure which is defined as

       struct quotctl {
         int op;
         uid_t uid;
         caddr_t addr;
       };



     op indicates an operation to be applied to the user ID  uid.
     (See  below.)  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 given with each value
     of op below.

     Q_QUOTAON     Turn on quotas for a file system. addr  points
                   to  the  full pathname of the quotas file. uid
                   is ignored. It is recommended  that  uid  have
                   the value of 0. This call is restricted to the
                   super-user.


     Q_QUOTAOFF    Turn off quotas for a file  system.  addr  and
                   uid  are  ignored. It is recommended that addr
                   have the value of NULL and uid have the  value
                   of  0.  This  call is restricted to the super-
                   user.


     Q_GETQUOTA    Get disk quota limits and  current  usage  for
                   user  uid. addr is a pointer to a dqblk struc-
                   ture (defined in  ).  Only
                   the  super-user  may  get the quotas of a user
                   other than himself.






SunOS 5.11          Last change: 14 June 2004                   1






Ioctl Requests                                       quotactl(7I)



     Q_SETQUOTA    Set disk quota limits and  current  usage  for
                   user  uid. addr is a pointer to a dqblk struc-
                   ture  (defined  in  sys/fs/ufs_quota.h).  This
                   call is restricted to the super-user.


     Q_SETQLIM     Set disk quota limits for user uid. addr is  a
                   pointer  to  a  dqblk  structure  (defined  in
                   sys/fs/ufs_quota.h). This call  is  restricted
                   to the super-user.


     Q_SYNC        Update the on-disk copy of  quota  usages  for
                   this file system. addr and uid are ignored.


     Q_ALLSYNC     Update the on-disk copy of  quota  usages  for
                   all  file systems with active quotas. addr and
                   uid are ignored.


RETURN VALUES
     This ioctl() returns:

     0        on success.


     -1       on failure and sets errno to indicate the error.


ERRORS
     EFAULT    addr is invalid.


     EINVAL    The kernel has not been compiled  with  the  QUOTA
               option. op is invalid.


     ENOENT    The quotas file specified by addr does not exist.


     EPERM     The call is privileged and the calling process did
               not  assert         {PRIV_SYS_MOUNT} in the effec-
               tive set.


     ESRCH     No disk quota is found  for  the  indicated  user.
               Quotas  have not been turned on for this file sys-
               tem.






SunOS 5.11          Last change: 14 June 2004                   2






Ioctl Requests                                       quotactl(7I)



     EUSERS    The quota table is full.



     If op is Q_QUOTAON, ioctl() may set errno to:

     EACCES    The quota file pointed to by addr  exists  but  is
               not  a  regular file. The quota file pointed to by
               addr exists but is not on the file system  pointed
               to by special.


     EIO       Internal I/O error while attempting  to  read  the
               quotas file pointed to by addr.


FILES
     /usr/include/sys/fs/ufs_quota.h

         quota-related structure/function definitions and defines


SEE ALSO
     quota(1M),   quotacheck(1M),   quotaon(1M),    getrlimit(2),
     mount(2)

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


     This call is incompatible with Melbourne quotas.






















SunOS 5.11          Last change: 14 June 2004                   3