Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

BSD 2.11 - man page for setquota (bsd section 2)

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)