|
|
1.1 ! root 1: .\" Copyright (c) 1983 Regents of the University of California. ! 2: .\" All rights reserved. ! 3: .\" ! 4: .\" Redistribution and use in source and binary forms are permitted ! 5: .\" provided that the above copyright notice and this paragraph are ! 6: .\" duplicated in all such forms and that any documentation, ! 7: .\" advertising materials, and other materials related to such ! 8: .\" distribution and use acknowledge that the software was developed ! 9: .\" by the University of California, Berkeley. The name of the ! 10: .\" University may not be used to endorse or promote products derived ! 11: .\" from this software without specific prior written permission. ! 12: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR ! 13: .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED ! 14: .\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. ! 15: .\" ! 16: .\" @(#)setquota.2 6.6 (Berkeley) 7/9/88 ! 17: .\" ! 18: .TH SETQUOTA 2 "July 9, 1988" ! 19: .UC 5 ! 20: .SH NAME ! 21: setquota \- enable/disable quotas on a file system ! 22: .SH SYNOPSIS ! 23: .nf ! 24: .B setquota(special, file) ! 25: .B char *special, *file; ! 26: .fi ! 27: .SH DESCRIPTION ! 28: Disc quotas are enabled or disabled with the ! 29: .I setquota ! 30: call. ! 31: .I Special ! 32: indicates a block special device on which a ! 33: mounted file system exists. ! 34: If ! 35: .I file ! 36: is nonzero, it specifies a file in that ! 37: file system from which to take the quotas. If ! 38: .I file ! 39: is 0, then quotas are disabled on the file system. ! 40: The quota file must exist; it is normally created ! 41: with the ! 42: .IR quotacheck (8) ! 43: program. ! 44: .PP ! 45: Only the super-user may turn quotas on or off. ! 46: .SH "SEE ALSO" ! 47: quota(2), quotacheck(8), quotaon(8) ! 48: .SH "RETURN VALUE" ! 49: A 0 return value indicates a successful call. A value ! 50: of \-1 is returned when an error occurs and ! 51: .I errno ! 52: is set to indicate the reason for failure. ! 53: .SH ERRORS ! 54: .I Setquota ! 55: will fail when one of the following occurs: ! 56: .TP 15 ! 57: [ENOTDIR] ! 58: A component of either path prefix is not a directory. ! 59: .TP 15 ! 60: [EINVAL] ! 61: Either pathname contains a character with the high-order bit set. ! 62: .TP 15 ! 63: [EINVAL] ! 64: The kernel has not been compiled with the QUOTA option. ! 65: .TP 15 ! 66: [ENAMETOOLONG] ! 67: A component of either pathname exceeded 255 characters, ! 68: or the entire length of either path name exceeded 1023 characters. ! 69: .TP 15 ! 70: [ENODEV] ! 71: .I Special ! 72: does not exist. ! 73: .TP 15 ! 74: [ENOENT] ! 75: .I File ! 76: does not exist. ! 77: .TP 15 ! 78: [ELOOP] ! 79: Too many symbolic links were encountered in translating either pathname. ! 80: .TP 15 ! 81: [EPERM] ! 82: The caller is not the super-user. ! 83: .TP 15 ! 84: [ENOTBLK] ! 85: .I Special ! 86: is not a block device. ! 87: .TP 15 ! 88: [ENXIO] ! 89: The major device number of ! 90: .I special ! 91: is out of range (this indicates no device driver exists ! 92: for the associated hardware). ! 93: .TP 15 ! 94: [EROFS] ! 95: .I File ! 96: resides on a read-only file system. ! 97: .TP 15 ! 98: [EACCES] ! 99: Search permission is denied for a component of either path prefix. ! 100: .TP 15 ! 101: [EACCES] ! 102: .I File ! 103: resides on a file system different from ! 104: .IR special . ! 105: .TP 15 ! 106: [EACCES] ! 107: .I File ! 108: is not a plain file. ! 109: .TP 15 ! 110: [EIO] ! 111: An I/O error occurred while reading from or writing to the file containing ! 112: the quotas. ! 113: .TP 15 ! 114: [EFAULT] ! 115: .I Special ! 116: or \fIpath\fP points outside the process's allocated address space. ! 117: .SH BUGS ! 118: The error codes are in a state of disarray; too many errors ! 119: appear to the caller as one value.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.