SETQUOTA(2-BSD)     RISC/os Reference Manual      SETQUOTA(2-BSD)



NAME
     setquota - enable/disable quotas on a file system

SYNOPSIS
     setquota(special, file)
     char *special, *file;

DESCRIPTION
     Disc quotas are enabled or disabled with the setquota call.
     special indicates a block special device on which a mounted
     file system exists.  If file is nonzero, it specifies a file
     in that file system from which to take the quotas.  If file
     is 0, then quotas are disabled on the file system.  The
     quota file must exist; it is normally created with the
     quotacheck(1M) program.

     Only the super-user may turn quotas on or off.

SEE ALSO
     quota(2).
     quotacheck(1M), quotaon(1M) in the System Administrator's
     Reference Manual.

RETURN VALUE
     A 0 return value indicates a successful call.  A value of -1
     is returned when an error occurs and errno is set to indi-
     cate the reason for failure.

ERRORS
     setquota will fail when one of the following occurs:

     [EPERM]             The caller is not the super-user.

     [ENOENT]            special does not exist.

     [ENOTBLK]           special is not a block device.

     [ENXIO]             The major device number of special is
                         out of range (this indicates no device
                         driver exists for the associated
                         hardware).

     [EPERM]             The pathname contains a character with
                         the high-order bit set.

     [ENOTDIR]           A component of the path prefix in file
                         is not a directory.

     [EACCES]            file resides on a file system different
                         from special.

     [EACCES]            file is not a plain file.



                        Printed 11/19/92                   Page 1

SETQUOTA(2-BSD)     RISC/os Reference Manual      SETQUOTA(2-BSD)



     [ENAMETOOLONG]      The pathname was too long.

     [EFAULT]            special or file points outside the
                         process's allocated address space.

     [EIO]               An I/O error occurred while reading from
                         or writing to the file system.

BUGS
     The error codes are in a state of disarray; too many errors
     appear to the caller as one value.












































 Page 2                 Printed 11/19/92