SETQUOTA(2)							System Calls Manual						       SETQUOTA(2)

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(8) program.

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

SEE ALSO

       quota(2), quotacheck(8), quotaon(8)

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 indicate the reason for
       failure.

ERRORS

       Setquota will fail when one of the following occurs:

       [ENOTDIR]      A component of either path prefix is not a directory.

       [EINVAL]       Either pathname contains a character with the high-order bit set.

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

       [ENAMETOOLONG] A component of either pathname exceeded 255 characters, or the entire length of either path name exceeded 1023 characters.

       [ENODEV]       Special does not exist.

       [ENOENT]       File does not exist.

       [ELOOP]	      Too many symbolic links were encountered in translating either pathname.

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

       [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).

       [EROFS]	      File resides on a read-only file system.

       [EACCES]       Search permission is denied for a component of either path prefix.

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

       [EACCES]       File is not a plain file.

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

       [EFAULT]       Special or path points outside the process's allocated address space.

BUGS

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

4.2 Berkeley Distribution					  August 26, 1985						       SETQUOTA(2)