1 /*
2  * Copyright (c) 1982, 1986 Regents of the University of California.
3  * All rights reserved.
4  *
5  * This code is derived from software contributed to Berkeley by
6  * Robert Elz at The University of Melbourne.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  * 3. Neither the name of the University nor the names of its contributors
17  *    may be used to endorse or promote products derived from this software
18  *    without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30  * SUCH DAMAGE.
31  */
32 
33 #ifndef _UAPI_LINUX_QUOTA_
34 #define _UAPI_LINUX_QUOTA_
35 
36 #include <linux/types.h>
37 
38 #define __DQUOT_VERSION__	"dquot_6.6.0"
39 
40 #define MAXQUOTAS 3
41 #define USRQUOTA  0		/* element used for user quotas */
42 #define GRPQUOTA  1		/* element used for group quotas */
43 #define PRJQUOTA  2		/* element used for project quotas */
44 
45 /*
46  * Definitions for the default names of the quotas files.
47  */
48 #define INITQFNAMES { \
49 	"user",    /* USRQUOTA */ \
50 	"group",   /* GRPQUOTA */ \
51 	"project", /* PRJQUOTA */ \
52 	"undefined", \
53 };
54 
55 /*
56  * Command definitions for the 'quotactl' system call.
57  * The commands are broken into a main command defined below
58  * and a subcommand that is used to convey the type of
59  * quota that is being manipulated (see above).
60  */
61 #define SUBCMDMASK  0x00ff
62 #define SUBCMDSHIFT 8
63 #define QCMD(cmd, type)  (((cmd) << SUBCMDSHIFT) | ((type) & SUBCMDMASK))
64 
65 #define Q_SYNC     0x800001	/* sync disk copy of a filesystems quotas */
66 #define Q_QUOTAON  0x800002	/* turn quotas on */
67 #define Q_QUOTAOFF 0x800003	/* turn quotas off */
68 #define Q_GETFMT   0x800004	/* get quota format used on given filesystem */
69 #define Q_GETINFO  0x800005	/* get information about quota files */
70 #define Q_SETINFO  0x800006	/* set information about quota files */
71 #define Q_GETQUOTA 0x800007	/* get user quota structure */
72 #define Q_SETQUOTA 0x800008	/* set user quota structure */
73 #define Q_GETNEXTQUOTA 0x800009	/* get disk limits and usage >= ID */
74 
75 /* Quota format type IDs */
76 #define	QFMT_VFS_OLD 1
77 #define	QFMT_VFS_V0 2
78 #define QFMT_OCFS2 3
79 #define	QFMT_VFS_V1 4
80 
81 /* Size of block in which space limits are passed through the quota
82  * interface */
83 #define QIF_DQBLKSIZE_BITS 10
84 #define QIF_DQBLKSIZE (1 << QIF_DQBLKSIZE_BITS)
85 
86 /*
87  * Quota structure used for communication with userspace via quotactl
88  * Following flags are used to specify which fields are valid
89  */
90 enum {
91 	QIF_BLIMITS_B = 0,
92 	QIF_SPACE_B,
93 	QIF_ILIMITS_B,
94 	QIF_INODES_B,
95 	QIF_BTIME_B,
96 	QIF_ITIME_B,
97 };
98 
99 #define QIF_BLIMITS	(1 << QIF_BLIMITS_B)
100 #define QIF_SPACE	(1 << QIF_SPACE_B)
101 #define QIF_ILIMITS	(1 << QIF_ILIMITS_B)
102 #define QIF_INODES	(1 << QIF_INODES_B)
103 #define QIF_BTIME	(1 << QIF_BTIME_B)
104 #define QIF_ITIME	(1 << QIF_ITIME_B)
105 #define QIF_LIMITS	(QIF_BLIMITS | QIF_ILIMITS)
106 #define QIF_USAGE	(QIF_SPACE | QIF_INODES)
107 #define QIF_TIMES	(QIF_BTIME | QIF_ITIME)
108 #define QIF_ALL		(QIF_LIMITS | QIF_USAGE | QIF_TIMES)
109 
110 struct if_dqblk {
111 	__u64 dqb_bhardlimit;
112 	__u64 dqb_bsoftlimit;
113 	__u64 dqb_curspace;
114 	__u64 dqb_ihardlimit;
115 	__u64 dqb_isoftlimit;
116 	__u64 dqb_curinodes;
117 	__u64 dqb_btime;
118 	__u64 dqb_itime;
119 	__u32 dqb_valid;
120 };
121 
122 struct if_nextdqblk {
123 	__u64 dqb_bhardlimit;
124 	__u64 dqb_bsoftlimit;
125 	__u64 dqb_curspace;
126 	__u64 dqb_ihardlimit;
127 	__u64 dqb_isoftlimit;
128 	__u64 dqb_curinodes;
129 	__u64 dqb_btime;
130 	__u64 dqb_itime;
131 	__u32 dqb_valid;
132 	__u32 dqb_id;
133 };
134 
135 /*
136  * Structure used for setting quota information about file via quotactl
137  * Following flags are used to specify which fields are valid
138  */
139 #define IIF_BGRACE	1
140 #define IIF_IGRACE	2
141 #define IIF_FLAGS	4
142 #define IIF_ALL		(IIF_BGRACE | IIF_IGRACE | IIF_FLAGS)
143 
144 enum {
145 	DQF_ROOT_SQUASH_B = 0,
146 	DQF_SYS_FILE_B = 16,
147 	/* Kernel internal flags invisible to userspace */
148 	DQF_PRIVATE
149 };
150 
151 /* Root squash enabled (for v1 quota format) */
152 #define DQF_ROOT_SQUASH	(1 << DQF_ROOT_SQUASH_B)
153 /* Quota stored in a system file */
154 #define DQF_SYS_FILE	(1 << DQF_SYS_FILE_B)
155 
156 struct if_dqinfo {
157 	__u64 dqi_bgrace;
158 	__u64 dqi_igrace;
159 	__u32 dqi_flags;	/* DFQ_* */
160 	__u32 dqi_valid;
161 };
162 
163 /*
164  * Definitions for quota netlink interface
165  */
166 #define QUOTA_NL_NOWARN 0
167 #define QUOTA_NL_IHARDWARN 1		/* Inode hardlimit reached */
168 #define QUOTA_NL_ISOFTLONGWARN 2 	/* Inode grace time expired */
169 #define QUOTA_NL_ISOFTWARN 3		/* Inode softlimit reached */
170 #define QUOTA_NL_BHARDWARN 4		/* Block hardlimit reached */
171 #define QUOTA_NL_BSOFTLONGWARN 5	/* Block grace time expired */
172 #define QUOTA_NL_BSOFTWARN 6		/* Block softlimit reached */
173 #define QUOTA_NL_IHARDBELOW 7		/* Usage got below inode hardlimit */
174 #define QUOTA_NL_ISOFTBELOW 8		/* Usage got below inode softlimit */
175 #define QUOTA_NL_BHARDBELOW 9		/* Usage got below block hardlimit */
176 #define QUOTA_NL_BSOFTBELOW 10		/* Usage got below block softlimit */
177 
178 enum {
179 	QUOTA_NL_C_UNSPEC,
180 	QUOTA_NL_C_WARNING,
181 	__QUOTA_NL_C_MAX,
182 };
183 #define QUOTA_NL_C_MAX (__QUOTA_NL_C_MAX - 1)
184 
185 enum {
186 	QUOTA_NL_A_UNSPEC,
187 	QUOTA_NL_A_QTYPE,
188 	QUOTA_NL_A_EXCESS_ID,
189 	QUOTA_NL_A_WARNING,
190 	QUOTA_NL_A_DEV_MAJOR,
191 	QUOTA_NL_A_DEV_MINOR,
192 	QUOTA_NL_A_CAUSED_ID,
193 	QUOTA_NL_A_PAD,
194 	__QUOTA_NL_A_MAX,
195 };
196 #define QUOTA_NL_A_MAX (__QUOTA_NL_A_MAX - 1)
197 
198 
199 #endif /* _UAPI_LINUX_QUOTA_ */
200