|
|
1.1 root 1: .TH SETQUOTA 2 "7 July 1983"
2: .UC 4
3: .SH NAME
4: setquota \- enable/disable quotas on a file system
5: .SH SYNOPSIS
6: .nf
7: .B setquota(special, file)
8: .B char *special, *file;
9: .fi
10: .SH DESCRIPTION
11: Disc quotas are enabled or disabled with the
12: .I setquota
13: call.
14: .I Special
15: indicates a block special device on which a
16: mounted file system exists.
17: If
18: .I file
19: is nonzero, it specifies a file in that
20: file system from which to take the quotas. If
21: .I file
22: is 0, then quotas are disabled on the file system.
23: The quota file must exist; it is normally created
24: with the
25: .IR checkquota (8)
26: program.
27: .PP
28: Only the super-user may turn quotas on or off.
29: .SH "SEE ALSO"
30: quota(2), quotacheck(8), quotaon(8)
31: .SH "RETURN VALUE"
32: A 0 return value indicates a successful call. A value
33: of \-1 is returned when an error occurs and
34: .I errno
35: is set to indicate the reason for failure.
36: .SH ERRORS
37: .I Setquota
38: will fail when one of the following occurs:
39: .TP 15
40: [NODEV]
41: The caller is not the super-user.
42: .TP 15
43: [NODEV]
44: .I Special
45: does not exist.
46: .TP 15
47: [ENOTBLK]
48: .I Special
49: is not a block device.
50: .TP 15
51: [ENXIO]
52: The major device number of
53: .I special
54: is out of range (this indicates no device driver exists
55: for the associated hardware).
56: .TP 15
57: [EPERM]
58: The pathname contains a character with the high-order bit set.
59: .TP 15
60: [ENOTDIR]
61: A component of the path prefix in
62: .I file
63: is not a directory.
64: .TP 15
65: [EROFS]
66: .I File
67: resides on a read-only file system.
68: .TP 15
69: [EACCES]
70: .I File
71: resides on a file system different from
72: .IR special .
73: .TP 15
74: [EACCES]
75: .I File
76: is not a plain file.
77: .SH BUGS
78: The error codes are in a state of disarray; too many errors
79: 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.