![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to setquota.2 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDTahoe / man / man2|
Return to setquota.2 CVS log | Up to [CSRG BSD Unix] / 43BSDTahoe / man / man2 |
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.