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 setquota 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 0, then quotas are disabled on the file system. The quota file must exist; it is normally created with the quotacheck() program.

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

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.

DIAGNOSTICS

The setquota system call will fail 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 super-user.

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

Museum