setquota(2) System Calls Manual setquota(2)
Name
setquota - enable/disable quotas on a file system
Syntax
setquota(special, file)
char *special, *file;
Description
Disk quotas are enabled or disabled with the call. The 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 zero, then quotas are disabled on the
file system. The quota file must exist; it is normally created with the program.
Only the superuser can turn quotas on or off.
Return Values
A zero (0) return value indicates a successful call. A value of -1 is returned when an error occurs, and errno is set to indicate the rea-
son for failure.
Diagnostics
The system call fails when one of the following occurs:
[ENODEV] The special does not exist.
[ENOTBLK] The 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.)
[ENOTDIR] A component of either path prefix is not a directory.
[EROFS] The file resides on a read-only file system.
[EACCES] The file resides on a file system different from special.
[EACCES] The file is not a plain file.
[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.
[ENOENT] The file does not exist.
[ELOOP] Too many symbolic links were encountered in translating either pathname.
[EPERM] The caller is not the superuser.
[EACCES] Search permission is denied for a component of either path prefix.
[EIO] An I/O error occurred while reading from or writing to the file containing the quotas.
[EFAULT] The special or path points outside the process's allocated address space.
See Also
quota(2), edquota(8), quotacheck(8), quotaon(8),
"Disk Quotas in a UNIX Environment", Supplementary Documents, Vol. III:System Manager
setquota(2)