Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
setquota(2)							   setquota(2)

       setquota	- enable/disable quotas	on a file system

       setquota(special, file)
       char *special, *file;

       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

       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.

       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-

       [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

       [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


Name | Syntax | Description | Return Values | Diagnostics | See Also

Want to link to this manual page? Use this URL:

home | help