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/errno.h>
37 #include <linux/types.h>
38 
39 #define __DQUOT_VERSION__	"dquot_6.6.0"
40 
41 #define MAXQUOTAS 3
42 #define USRQUOTA  0		/* element used for user quotas */
43 #define GRPQUOTA  1		/* element used for group quotas */
44 #define PRJQUOTA  2		/* element used for project quotas */
45 
46 /*
47  * Definitions for the default names of the quotas files.
48  */
49 #define INITQFNAMES { \
50 	"user",    /* USRQUOTA */ \
51 	"group",   /* GRPQUOTA */ \
52 	"project", /* PRJQUOTA */ \
53 	"undefined", \
54 };
55 
56 /*
57  * Command definitions for the 'quotactl' system call.
58  * The commands are broken into a main command defined below
59  * and a subcommand that is used to convey the type of
60  * quota that is being manipulated (see above).
61  */
62 #define SUBCMDMASK  0x00ff
63 #define SUBCMDSHIFT 8
64 #define QCMD(cmd, type)  (((cmd) << SUBCMDSHIFT) | ((type) & SUBCMDMASK))
65 
66 #define Q_SYNC     0x800001	/* sync disk copy of a filesystems quotas */
67 #define Q_QUOTAON  0x800002	/* turn quotas on */
68 #define Q_QUOTAOFF 0x800003	/* turn quotas off */
69 #define Q_GETFMT   0x800004	/* get quota format used on given filesystem */
70 #define Q_GETINFO  0x800005	/* get information about quota files */
71 #define Q_SETINFO  0x800006	/* set information about quota files */
72 #define Q_GETQUOTA 0x800007	/* get user quota structure */
73 #define Q_SETQUOTA 0x800008	/* set user quota structure */
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 /*
123  * Structure used for setting quota information about file via quotactl
124  * Following flags are used to specify which fields are valid
125  */
126 #define IIF_BGRACE	1
127 #define IIF_IGRACE	2
128 #define IIF_FLAGS	4
129 #define IIF_ALL		(IIF_BGRACE | IIF_IGRACE | IIF_FLAGS)
130 
131 enum {
132 	DQF_ROOT_SQUASH_B = 0,
133 	DQF_SYS_FILE_B = 16,
134 	/* Kernel internal flags invisible to userspace */
135 	DQF_PRIVATE
136 };
137 
138 /* Root squash enabled (for v1 quota format) */
139 #define DQF_ROOT_SQUASH	(1 << DQF_ROOT_SQUASH_B)
140 /* Quota stored in a system file */
141 #define DQF_SYS_FILE	(1 << DQF_SYS_FILE_B)
142 
143 struct if_dqinfo {
144 	__u64 dqi_bgrace;
145 	__u64 dqi_igrace;
146 	__u32 dqi_flags;	/* DFQ_* */
147 	__u32 dqi_valid;
148 };
149 
150 /*
151  * Definitions for quota netlink interface
152  */
153 #define QUOTA_NL_NOWARN 0
154 #define QUOTA_NL_IHARDWARN 1		/* Inode hardlimit reached */
155 #define QUOTA_NL_ISOFTLONGWARN 2 	/* Inode grace time expired */
156 #define QUOTA_NL_ISOFTWARN 3		/* Inode softlimit reached */
157 #define QUOTA_NL_BHARDWARN 4		/* Block hardlimit reached */
158 #define QUOTA_NL_BSOFTLONGWARN 5	/* Block grace time expired */
159 #define QUOTA_NL_BSOFTWARN 6		/* Block softlimit reached */
160 #define QUOTA_NL_IHARDBELOW 7		/* Usage got below inode hardlimit */
161 #define QUOTA_NL_ISOFTBELOW 8		/* Usage got below inode softlimit */
162 #define QUOTA_NL_BHARDBELOW 9		/* Usage got below block hardlimit */
163 #define QUOTA_NL_BSOFTBELOW 10		/* Usage got below block softlimit */
164 
165 enum {
166 	QUOTA_NL_C_UNSPEC,
167 	QUOTA_NL_C_WARNING,
168 	__QUOTA_NL_C_MAX,
169 };
170 #define QUOTA_NL_C_MAX (__QUOTA_NL_C_MAX - 1)
171 
172 enum {
173 	QUOTA_NL_A_UNSPEC,
174 	QUOTA_NL_A_QTYPE,
175 	QUOTA_NL_A_EXCESS_ID,
176 	QUOTA_NL_A_WARNING,
177 	QUOTA_NL_A_DEV_MAJOR,
178 	QUOTA_NL_A_DEV_MINOR,
179 	QUOTA_NL_A_CAUSED_ID,
180 	__QUOTA_NL_A_MAX,
181 };
182 #define QUOTA_NL_A_MAX (__QUOTA_NL_A_MAX - 1)
183 
184 
185 #endif /* _UAPI_LINUX_QUOTA_ */
186