Print this page
10531 Convert quotactl(7I) to mandoc
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man7i/quotactl.7i.man.txt
+++ new/usr/src/man/man7i/quotactl.7i.man.txt
1 1 QUOTACTL(7I) Ioctl Requests QUOTACTL(7I)
2 2
3 -
4 -
5 3 NAME
6 - quotactl - manipulate disk quotas
4 + quotactl - manipulate disk quotas
7 5
8 6 SYNOPSIS
9 - #include <sys/fs/ufs_quota.h>
10 - int ioctl(int fd, Q_QUOTACTL, struct quotcl *qp)
7 + #include <sys/fs/ufs_quota.h>
11 8
9 + int ioctl(int fd, Q_QUOTACTL, struct quotctl *qp);
12 10
13 11 DESCRIPTION
14 - This ioctl() call manipulates disk quotas. fd is the file descriptor
15 - returned by the open() system call after opening the quotas file
16 - (located in the root directory of the filesystem running quotas.)
17 - Q_QUOTACTL is defined in /usr/include/sys/fs/ufs_quota.h. qp is the
18 - address of the quotctl structure which is defined as
12 + This ioctl() call manipulates disk quotas. fd is the file descriptor
13 + returned by the open(2) system call after opening the quotas file
14 + (located in the root directory of the filesystem running quotas).
15 + Q_QUOTACTL is defined in /usr/include/sys/fs/ufs_quota.h. qp is the
16 + address of the quotctl structure which is defined as
19 17
20 - struct quotctl {
21 - int op;
22 - uid_t uid;
23 - caddr_t addr;
24 - };
18 + struct quotctl {
19 + int op;
20 + uid_t uid;
21 + caddr_t addr;
22 + };
25 23
24 + op indicates an operation to be applied to the user ID uid. (See below.)
25 + addr is the address of an optional, command specific, data structure
26 + which is copied in or out of the system. The interpretation of addr is
27 + given with each value of op below.
26 28
29 + Q_QUOTAON Turn on quotas for a file system. addr points to the full
30 + pathname of the quotas file. uid is ignored. It is
31 + recommended that uid have the value of 0. This call is
32 + restricted to the super-user.
27 33
28 - op indicates an operation to be applied to the user ID uid. (See
29 - below.) addr is the address of an optional, command specific, data
30 - structure which is copied in or out of the system. The interpretation
31 - of addr is given with each value of op below.
34 + Q_QUOTAOFF Turn off quotas for a file system. addr and uid are ignored.
35 + It is recommended that addr have the value of NULL and uid
36 + have the value of 0. This call is restricted to the super-
37 + user.
32 38
33 - Q_QUOTAON
34 - Turn on quotas for a file system. addr points to the full
35 - pathname of the quotas file. uid is ignored. It is
36 - recommended that uid have the value of 0. This call is
37 - restricted to the super-user.
39 + Q_GETQUOTA Get disk quota limits and current usage for user uid. addr
40 + is a pointer to a dqblk structure (defined in
41 + <sys/fs/ufs_quota.h>). Only the super-user may get the
42 + quotas of a user other than himself.
38 43
44 + Q_SETQUOTA Set disk quota limits and current usage for user uid. addr
45 + is a pointer to a dqblk structure (defined in
46 + <sys/fs/ufs_quota.h>). This call is restricted to the super-
47 + user.
39 48
40 - Q_QUOTAOFF
41 - Turn off quotas for a file system. addr and uid are
42 - ignored. It is recommended that addr have the value of
43 - NULL and uid have the value of 0. This call is restricted
44 - to the super-user.
49 + Q_SETQLIM Set disk quota limits for user uid. addr is a pointer to a
50 + dqblk structure (defined in <sys/fs/ufs_quota.h>). This call
51 + is restricted to the super-user.
45 52
53 + Q_SYNC Update the on-disk copy of quota usages for this file system.
54 + addr and uid are ignored.
46 55
47 - Q_GETQUOTA
48 - Get disk quota limits and current usage for user uid.
49 - addr is a pointer to a dqblk structure (defined in
50 - <sys/fs/ufs_quota.h>). Only the super-user may get the
51 - quotas of a user other than himself.
56 + Q_ALLSYNC Update the on-disk copy of quota usages for all file systems
57 + with active quotas. addr and uid are ignored.
52 58
53 -
54 - Q_SETQUOTA
55 - Set disk quota limits and current usage for user uid.
56 - addr is a pointer to a dqblk structure (defined in
57 - sys/fs/ufs_quota.h). This call is restricted to the
58 - super-user.
59 -
60 -
61 - Q_SETQLIM
62 - Set disk quota limits for user uid. addr is a pointer to
63 - a dqblk structure (defined in sys/fs/ufs_quota.h). This
64 - call is restricted to the super-user.
65 -
66 -
67 - Q_SYNC
68 - Update the on-disk copy of quota usages for this file
69 - system. addr and uid are ignored.
70 -
71 -
72 - Q_ALLSYNC
73 - Update the on-disk copy of quota usages for all file
74 - systems with active quotas. addr and uid are ignored.
75 -
76 -
77 59 RETURN VALUES
78 - This ioctl() returns:
60 + This Fn ioctl returns:
79 61
80 - 0
81 - on success.
62 + 0 on success.
82 63
64 + -1 on failure and sets errno to indicate the error.
83 65
84 - -1
85 - on failure and sets errno to indicate the error.
66 +FILES
67 + /usr/include/sys/fs/ufs_quota.h
68 + quota-related structure/function definitions and defines
86 69
87 -
88 70 ERRORS
89 - EFAULT
90 - addr is invalid.
71 + EFAULT addr is invalid.
91 72
73 + EINVAL The kernel has not been compiled with the QUOTA option. op is
74 + invalid.
92 75
93 - EINVAL
94 - The kernel has not been compiled with the QUOTA option. op is
95 - invalid.
76 + ENOENT The quotas file specified by addr does not exist.
96 77
78 + EPERM The call is privileged and the calling process did not assert
79 + {PRIV_SYS_MOUNT} in the effective set.
97 80
98 - ENOENT
99 - The quotas file specified by addr does not exist.
81 + ESRCH No disk quota is found for the indicated user. Quotas have not
82 + been turned on for this file system.
100 83
84 + EUSERS The quota table is full.
101 85
102 - EPERM
103 - The call is privileged and the calling process did not assert
104 - {PRIV_SYS_MOUNT} in the effective set.
86 + If op is Q_QUOTAON, ioctl() may set errno to:
105 87
88 + EACCES The quota file pointed to by addr exists but is not a regular
89 + file. The quota file pointed to by addr exists but is not on the
90 + file system pointed to by special.
106 91
107 - ESRCH
108 - No disk quota is found for the indicated user. Quotas have
109 - not been turned on for this file system.
92 + EIO Internal I/O error while attempting to read the quotas file
93 + pointed to by addr.
110 94
111 -
112 - EUSERS
113 - The quota table is full.
114 -
115 -
116 -
117 - If op is Q_QUOTAON, ioctl() may set errno to:
118 -
119 - EACCES
120 - The quota file pointed to by addr exists but is not a regular
121 - file. The quota file pointed to by addr exists but is not on
122 - the file system pointed to by special.
123 -
124 -
125 - EIO
126 - Internal I/O error while attempting to read the quotas file
127 - pointed to by addr.
128 -
129 -
130 -FILES
131 - /usr/include/sys/fs/ufs_quota.h
132 -
133 - quota-related structure/function definitions and defines
134 -
135 -
136 95 SEE ALSO
137 - quota(1M), quotacheck(1M), quotaon(1M), getrlimit(2), mount(2)
96 + quota(1M), quotacheck(1M), quotaon(1M), getrlimit(2), mount(2)
138 97
139 98 BUGS
140 - There should be some way to integrate this call with the resource limit
141 - interface provided by setrlimit() and getrlimit(2).
99 + There should be some way to integrate this call with the resource limit
100 + interface provided by setrlimit(2) and getrlimit(2).
142 101
102 + This call is incompatible with Melbourne quotas.
143 103
144 - This call is incompatible with Melbourne quotas.
145 -
146 -
147 -
148 - June 14, 2004 QUOTACTL(7I)
104 +illumos October 28, 2017 illumos
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX