setquota(2) [bsd man page]
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)
Check Out this Related Man Page
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)