Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   3690 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

setquota(2)							   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 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 Also
       quota(2), edquota(8), quotacheck(8), quotaon(8),
       "Disk Quotas in a  UNIX	Environment",  Supplementary  Documents,  Vol.
       III:System Manager

								   setquota(2)

Vote for polarhome