1 // SPDX-License-Identifier: GPL-2.0
2 /*
3 * Copyright (c) 2000-2005 Silicon Graphics, Inc.
4 * All Rights Reserved.
5 */
6 #ifndef __XFS_QUOTA_DEFS_H__
7 #define __XFS_QUOTA_DEFS_H__
8
9 /*
10 * Quota definitions shared between user and kernel source trees.
11 */
12
13 /*
14 * Even though users may not have quota limits occupying all 64-bits,
15 * they may need 64-bit accounting. Hence, 64-bit quota-counters,
16 * and quota-limits. This is a waste in the common case, but hey ...
17 */
18 typedef uint64_t xfs_qcnt_t;
19
20 typedef uint8_t xfs_dqtype_t;
21
22 #define XFS_DQTYPE_STRINGS \
23 { XFS_DQTYPE_USER, "USER" }, \
24 { XFS_DQTYPE_PROJ, "PROJ" }, \
25 { XFS_DQTYPE_GROUP, "GROUP" }, \
26 { XFS_DQTYPE_BIGTIME, "BIGTIME" }
27
28 /*
29 * flags for q_flags field in the dquot.
30 */
31 #define XFS_DQFLAG_DIRTY (1u << 0) /* dquot is dirty */
32 #define XFS_DQFLAG_FREEING (1u << 1) /* dquot is being torn down */
33
34 #define XFS_DQFLAG_STRINGS \
35 { XFS_DQFLAG_DIRTY, "DIRTY" }, \
36 { XFS_DQFLAG_FREEING, "FREEING" }
37
38 /*
39 * We have the possibility of all three quota types being active at once, and
40 * hence free space modification requires modification of all three current
41 * dquots in a single transaction. For this case we need to have a reservation
42 * of at least 3 dquots.
43 *
44 * However, a chmod operation can change both UID and GID in a single
45 * transaction, resulting in requiring {old, new} x {uid, gid} dquots to be
46 * modified. Hence for this case we need to reserve space for at least 4 dquots.
47 *
48 * And in the worst case, there's a rename operation that can be modifying up to
49 * 4 inodes with dquots attached to them. In reality, the only inodes that can
50 * have their dquots modified are the source and destination directory inodes
51 * due to directory name creation and removal. That can require space allocation
52 * and/or freeing on both directory inodes, and hence all three dquots on each
53 * inode can be modified. And if the directories are world writeable, all the
54 * dquots can be unique and so 6 dquots can be modified....
55 *
56 * And, of course, we also need to take into account the dquot log format item
57 * used to describe each dquot.
58 */
59 #define XFS_DQUOT_LOGRES \
60 ((sizeof(struct xfs_dq_logformat) + sizeof(struct xfs_disk_dquot)) * 6)
61
62 #define XFS_IS_QUOTA_ON(mp) ((mp)->m_qflags & XFS_ALL_QUOTA_ACCT)
63 #define XFS_IS_UQUOTA_ON(mp) ((mp)->m_qflags & XFS_UQUOTA_ACCT)
64 #define XFS_IS_PQUOTA_ON(mp) ((mp)->m_qflags & XFS_PQUOTA_ACCT)
65 #define XFS_IS_GQUOTA_ON(mp) ((mp)->m_qflags & XFS_GQUOTA_ACCT)
66 #define XFS_IS_UQUOTA_ENFORCED(mp) ((mp)->m_qflags & XFS_UQUOTA_ENFD)
67 #define XFS_IS_GQUOTA_ENFORCED(mp) ((mp)->m_qflags & XFS_GQUOTA_ENFD)
68 #define XFS_IS_PQUOTA_ENFORCED(mp) ((mp)->m_qflags & XFS_PQUOTA_ENFD)
69
70 /*
71 * Flags to tell various functions what to do. Not all of these are meaningful
72 * to a single function. None of these XFS_QMOPT_* flags are meant to have
73 * persistent values (ie. their values can and will change between versions)
74 */
75 #define XFS_QMOPT_UQUOTA (1u << 0) /* user dquot requested */
76 #define XFS_QMOPT_GQUOTA (1u << 1) /* group dquot requested */
77 #define XFS_QMOPT_PQUOTA (1u << 2) /* project dquot requested */
78 #define XFS_QMOPT_FORCE_RES (1u << 3) /* ignore quota limits */
79 #define XFS_QMOPT_SBVERSION (1u << 4) /* change superblock version num */
80
81 /*
82 * flags to xfs_trans_mod_dquot to indicate which field needs to be
83 * modified.
84 */
85 #define XFS_QMOPT_RES_REGBLKS (1u << 7)
86 #define XFS_QMOPT_RES_RTBLKS (1u << 8)
87 #define XFS_QMOPT_BCOUNT (1u << 9)
88 #define XFS_QMOPT_ICOUNT (1u << 10)
89 #define XFS_QMOPT_RTBCOUNT (1u << 11)
90 #define XFS_QMOPT_DELBCOUNT (1u << 12)
91 #define XFS_QMOPT_DELRTBCOUNT (1u << 13)
92 #define XFS_QMOPT_RES_INOS (1u << 14)
93
94 /*
95 * flags for dqalloc.
96 */
97 #define XFS_QMOPT_INHERIT (1u << 31)
98
99 #define XFS_QMOPT_FLAGS \
100 { XFS_QMOPT_UQUOTA, "UQUOTA" }, \
101 { XFS_QMOPT_PQUOTA, "PQUOTA" }, \
102 { XFS_QMOPT_FORCE_RES, "FORCE_RES" }, \
103 { XFS_QMOPT_SBVERSION, "SBVERSION" }, \
104 { XFS_QMOPT_GQUOTA, "GQUOTA" }, \
105 { XFS_QMOPT_INHERIT, "INHERIT" }, \
106 { XFS_QMOPT_RES_REGBLKS, "RES_REGBLKS" }, \
107 { XFS_QMOPT_RES_RTBLKS, "RES_RTBLKS" }, \
108 { XFS_QMOPT_BCOUNT, "BCOUNT" }, \
109 { XFS_QMOPT_ICOUNT, "ICOUNT" }, \
110 { XFS_QMOPT_RTBCOUNT, "RTBCOUNT" }, \
111 { XFS_QMOPT_DELBCOUNT, "DELBCOUNT" }, \
112 { XFS_QMOPT_DELRTBCOUNT, "DELRTBCOUNT" }, \
113 { XFS_QMOPT_RES_INOS, "RES_INOS" }
114
115 /*
116 * flags to xfs_trans_mod_dquot.
117 */
118 #define XFS_TRANS_DQ_RES_BLKS XFS_QMOPT_RES_REGBLKS
119 #define XFS_TRANS_DQ_RES_RTBLKS XFS_QMOPT_RES_RTBLKS
120 #define XFS_TRANS_DQ_RES_INOS XFS_QMOPT_RES_INOS
121 #define XFS_TRANS_DQ_BCOUNT XFS_QMOPT_BCOUNT
122 #define XFS_TRANS_DQ_DELBCOUNT XFS_QMOPT_DELBCOUNT
123 #define XFS_TRANS_DQ_ICOUNT XFS_QMOPT_ICOUNT
124 #define XFS_TRANS_DQ_RTBCOUNT XFS_QMOPT_RTBCOUNT
125 #define XFS_TRANS_DQ_DELRTBCOUNT XFS_QMOPT_DELRTBCOUNT
126
127
128 #define XFS_QMOPT_QUOTALL \
129 (XFS_QMOPT_UQUOTA | XFS_QMOPT_PQUOTA | XFS_QMOPT_GQUOTA)
130 #define XFS_QMOPT_RESBLK_MASK (XFS_QMOPT_RES_REGBLKS | XFS_QMOPT_RES_RTBLKS)
131
132
133 extern xfs_failaddr_t xfs_dquot_verify(struct xfs_mount *mp,
134 struct xfs_disk_dquot *ddq, xfs_dqid_t id);
135 extern xfs_failaddr_t xfs_dqblk_verify(struct xfs_mount *mp,
136 struct xfs_dqblk *dqb, xfs_dqid_t id);
137 extern int xfs_calc_dquots_per_chunk(unsigned int nbblks);
138 extern void xfs_dqblk_repair(struct xfs_mount *mp, struct xfs_dqblk *dqb,
139 xfs_dqid_t id, xfs_dqtype_t type);
140
141 struct xfs_dquot;
142 time64_t xfs_dquot_from_disk_ts(struct xfs_disk_dquot *ddq,
143 __be32 dtimer);
144 __be32 xfs_dquot_to_disk_ts(struct xfs_dquot *ddq, time64_t timer);
145
146 static inline const char *
xfs_dqinode_path(xfs_dqtype_t type)147 xfs_dqinode_path(xfs_dqtype_t type)
148 {
149 switch (type) {
150 case XFS_DQTYPE_USER:
151 return "user";
152 case XFS_DQTYPE_GROUP:
153 return "group";
154 case XFS_DQTYPE_PROJ:
155 return "project";
156 }
157
158 ASSERT(0);
159 return NULL;
160 }
161
162 static inline enum xfs_metafile_type
xfs_dqinode_metafile_type(xfs_dqtype_t type)163 xfs_dqinode_metafile_type(xfs_dqtype_t type)
164 {
165 switch (type) {
166 case XFS_DQTYPE_USER:
167 return XFS_METAFILE_USRQUOTA;
168 case XFS_DQTYPE_GROUP:
169 return XFS_METAFILE_GRPQUOTA;
170 case XFS_DQTYPE_PROJ:
171 return XFS_METAFILE_PRJQUOTA;
172 }
173
174 ASSERT(0);
175 return XFS_METAFILE_UNKNOWN;
176 }
177
178 unsigned int xfs_dqinode_sick_mask(xfs_dqtype_t type);
179
180 int xfs_dqinode_load(struct xfs_trans *tp, struct xfs_inode *dp,
181 xfs_dqtype_t type, struct xfs_inode **ipp);
182 int xfs_dqinode_metadir_create(struct xfs_inode *dp, xfs_dqtype_t type,
183 struct xfs_inode **ipp);
184 int xfs_dqinode_metadir_link(struct xfs_inode *dp, xfs_dqtype_t type,
185 struct xfs_inode *ip);
186 int xfs_dqinode_mkdir_parent(struct xfs_mount *mp, struct xfs_inode **dpp);
187 int xfs_dqinode_load_parent(struct xfs_trans *tp, struct xfs_inode **dpp);
188
189 #endif /* __XFS_QUOTA_H__ */
190