setquota(2)setquota(2)Namesetquota - 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 indi‐
cates 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 reason
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 associ‐
ated 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 spe‐
cial.
[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 allo‐
cated address space.
See Alsoquota(2), edquota(8), quotacheck(8), quotaon(8),
"Disk Quotas in a UNIX Environment", Supplementary Documents, Vol.
III:System Manager
setquota(2)