include/xfs_quota.h

   1 /*
   2  * Copyright (c) 2000-2001 Silicon Graphics, Inc.  All Rights Reserved.
   3  *
   4  * This program is free software; you can redistribute it and/or modify it
   5  * under the terms of version 2 of the GNU General Public License as
   6  * published by the Free Software Foundation.
   7  *
   8  * This program is distributed in the hope that it would be useful, but
   9  * WITHOUT ANY WARRANTY; without even the implied warranty of
  10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  11  *
  12  * Further, this software is distributed without any warranty that it is
  13  * free of the rightful claim of any third person regarding infringement
  14  * or the like.  Any license provided herein, whether implied or
  15  * otherwise, applies only to this software file.  Patent licenses, if
  16  * any, provided herein do not apply to combinations of this program with
  17  * other software, or any other product whatsoever.
  18  *
  19  * You should have received a copy of the GNU General Public License along
  20  * with this program; if not, write the Free Software Foundation, Inc., 59
  21  * Temple Place - Suite 330, Boston MA 02111-1307, USA.
  22  *
  23  * Contact information: Silicon Graphics, Inc., 1600 Amphitheatre Pkwy,
  24  * Mountain View, CA  94043, or:
  25  *
  26  * http://www.sgi.com
  27  *
  28  * For further information regarding this notice, see:
  29  *
  30  * http://oss.sgi.com/projects/GenInfo/SGIGPLNoticeExplan/
  31  */
  32 #ifndef __XFS_QUOTA_H__
  33 #define __XFS_QUOTA_H__
  34
  35 /*
  36  * uid_t and gid_t are hard-coded to 32 bits in the inode.
  37  * Hence, an 'id' in a dquot is 32 bits..
  38  */
  39 typedef __int32_t       xfs_dqid_t;
  40
  41 /*
  42  * Eventhough users may not have quota limits occupying all 64-bits,
  43  * they may need 64-bit accounting. Hence, 64-bit quota-counters,
  44  * and quota-limits. This is a waste in the common case, but hey ...
  45  */
  46 typedef __uint64_t      xfs_qcnt_t;
  47 typedef __uint16_t      xfs_qwarncnt_t;
  48
  49 /*
  50  * Disk quotas status in m_qflags, and also sb_qflags. 16 bits.
  51  */
  52 #define XFS_UQUOTA_ACCT 0x0001  /* user quota accounting ON */
  53 #define XFS_UQUOTA_ENFD 0x0002  /* user quota limits enforced */
  54 #define XFS_UQUOTA_CHKD 0x0004  /* quotacheck run on usr quotas */
  55 #define XFS_PQUOTA_ACCT 0x0008  /* (IRIX) project quota accounting ON */
  56 #define XFS_GQUOTA_ENFD 0x0010  /* group quota limits enforced */
  57 #define XFS_GQUOTA_CHKD 0x0020  /* quotacheck run on grp quotas */
  58 #define XFS_GQUOTA_ACCT 0x0040  /* group quota accounting ON */
  59
  60 /*
  61  * Incore only flags for quotaoff - these bits get cleared when quota(s)
  62  * are in the process of getting turned off. These flags are in m_qflags but
  63  * never in sb_qflags.
  64  */
  65 #define XFS_UQUOTA_ACTIVE       0x0080  /* uquotas are being turned off */
  66 #define XFS_GQUOTA_ACTIVE       0x0100  /* gquotas are being turned off */
  67
  68 /*
  69  * Typically, we turn quotas off if we weren't explicitly asked to
  70  * mount quotas. This is the mount option not to do that.
  71  * This option is handy in the miniroot, when trying to mount /root.
  72  * We can't really know what's in /etc/fstab until /root is already mounted!
  73  * This stops quotas getting turned off in the root filesystem everytime
  74  * the system boots up a miniroot.
  75  */
  76 #define XFS_QUOTA_MAYBE         0x0200 /* Turn quotas on if SB has quotas on */
  77
  78 /*
  79  * Checking XFS_IS_*QUOTA_ON() while holding any inode lock guarantees
  80  * quota will be not be switched off as long as that inode lock is held.
  81  */
  82 #define XFS_IS_QUOTA_ON(mp)     ((mp)->m_qflags & (XFS_UQUOTA_ACTIVE | \
  83                                                    XFS_GQUOTA_ACTIVE))
  84 #define XFS_IS_UQUOTA_ON(mp)    ((mp)->m_qflags & XFS_UQUOTA_ACTIVE)
  85 #define XFS_IS_GQUOTA_ON(mp)    ((mp)->m_qflags & XFS_GQUOTA_ACTIVE)
  86
  87 /*
  88  * Flags to tell various functions what to do. Not all of these are meaningful
  89  * to a single function. None of these XFS_QMOPT_* flags are meant to have
  90  * persistent values (ie. their values can and will change between versions)
  91  */
  92 #define XFS_QMOPT_DQLOCK        0x0000001 /* dqlock */
  93 #define XFS_QMOPT_DQALLOC       0x0000002 /* alloc dquot ondisk if needed */
  94 #define XFS_QMOPT_UQUOTA        0x0000004 /* user dquot requested */
  95 #define XFS_QMOPT_GQUOTA        0x0000008 /* group dquot requested */
  96 #define XFS_QMOPT_FORCE_RES     0x0000010 /* ignore quota limits */
  97 #define XFS_QMOPT_DQSUSER       0x0000020 /* don't cache super users dquot */
  98 #define XFS_QMOPT_SBVERSION     0x0000040 /* change superblock version num */
  99 #define XFS_QMOPT_QUOTAOFF      0x0000080 /* quotas are being turned off */
 100 #define XFS_QMOPT_UMOUNTING     0x0000100 /* filesys is being unmounted */
 101 #define XFS_QMOPT_DOLOG         0x0000200 /* log buf changes (in quotacheck) */
 102 #define XFS_QMOPT_DOWARN        0x0000400 /* increase warning cnt if necessary */
 103 #define XFS_QMOPT_ILOCKED       0x0000800 /* inode is already locked (excl) */
 104 #define XFS_QMOPT_DQREPAIR      0x0001000 /* repair dquot, if damaged. */
 105
 106 /*
 107  * flags to xfs_trans_mod_dquot to indicate which field needs to be
 108  * modified.
 109  */
 110 #define XFS_QMOPT_RES_REGBLKS   0x0010000
 111 #define XFS_QMOPT_RES_RTBLKS    0x0020000
 112 #define XFS_QMOPT_BCOUNT        0x0040000
 113 #define XFS_QMOPT_ICOUNT        0x0080000
 114 #define XFS_QMOPT_RTBCOUNT      0x0100000
 115 #define XFS_QMOPT_DELBCOUNT     0x0200000
 116 #define XFS_QMOPT_DELRTBCOUNT   0x0400000
 117 #define XFS_QMOPT_RES_INOS      0x0800000
 118
 119 /*
 120  * flags for dqflush and dqflush_all.
 121  */
 122 #define XFS_QMOPT_SYNC          0x1000000
 123 #define XFS_QMOPT_ASYNC         0x2000000
 124 #define XFS_QMOPT_DELWRI        0x4000000
 125
 126 /*
 127  * flags for dqalloc.
 128  */
 129 #define XFS_QMOPT_INHERIT       0x8000000
 130
 131 /*
 132  * flags to xfs_trans_mod_dquot.
 133  */
 134 #define XFS_TRANS_DQ_RES_BLKS   XFS_QMOPT_RES_REGBLKS
 135 #define XFS_TRANS_DQ_RES_RTBLKS XFS_QMOPT_RES_RTBLKS
 136 #define XFS_TRANS_DQ_RES_INOS   XFS_QMOPT_RES_INOS
 137 #define XFS_TRANS_DQ_BCOUNT     XFS_QMOPT_BCOUNT
 138 #define XFS_TRANS_DQ_DELBCOUNT  XFS_QMOPT_DELBCOUNT
 139 #define XFS_TRANS_DQ_ICOUNT     XFS_QMOPT_ICOUNT
 140 #define XFS_TRANS_DQ_RTBCOUNT   XFS_QMOPT_RTBCOUNT
 141 #define XFS_TRANS_DQ_DELRTBCOUNT XFS_QMOPT_DELRTBCOUNT
 142
 143
 144 #define XFS_QMOPT_QUOTALL       (XFS_QMOPT_UQUOTA|XFS_QMOPT_GQUOTA)
 145 #define XFS_QMOPT_RESBLK_MASK   (XFS_QMOPT_RES_REGBLKS | XFS_QMOPT_RES_RTBLKS)
 146
 147 /*
 148  * This check is done typically without holding the inode lock;
 149  * that may seem racey, but it is harmless in the context that it is used.
 150  * The inode cannot go inactive as long a reference is kept, and
 151  * therefore if dquot(s) were attached, they'll stay consistent.
 152  * If, for example, the ownership of the inode changes while
 153  * we didnt have the inode locked, the appropriate dquot(s) will be
 154  * attached atomically.
 155  */
 156 #define XFS_NOT_DQATTACHED(mp, ip) ((XFS_IS_UQUOTA_ON(mp) &&\
 157                                      (ip)->i_udquot == NULL) || \
 158                                     (XFS_IS_GQUOTA_ON(mp) && \
 159                                      (ip)->i_gdquot == NULL))
 160
 161 #define XFS_QM_NEED_QUOTACHECK(mp) ((XFS_IS_UQUOTA_ON(mp) && \
 162                                      (mp->m_sb.sb_qflags & \
 163                                       XFS_UQUOTA_CHKD) == 0) || \
 164                                     (XFS_IS_GQUOTA_ON(mp) && \
 165                                      (mp->m_sb.sb_qflags & \
 166                                       XFS_GQUOTA_CHKD) == 0))
 167
 168 #define XFS_MOUNT_QUOTA_ALL     (XFS_UQUOTA_ACCT|XFS_UQUOTA_ENFD|\
 169                                  XFS_UQUOTA_CHKD|XFS_GQUOTA_ACCT|\
 170                                  XFS_GQUOTA_ENFD|XFS_GQUOTA_CHKD)
 171 #define XFS_MOUNT_QUOTA_MASK    (XFS_MOUNT_QUOTA_ALL | XFS_UQUOTA_ACTIVE | \
 172                                  XFS_GQUOTA_ACTIVE)
 173
 174 #define XFS_IS_REALTIME_INODE(ip) ((ip)->i_d.di_flags & XFS_DIFLAG_REALTIME)
 175
 176
 177 #ifdef __KERNEL__
 178
 179 #ifdef CONFIG_XFS_QUOTA
 180 /*
 181  * External Interface to the XFS disk quota subsystem.
 182  */
 183 struct  xfs_disk_dquot;
 184 struct  xfs_dqhash;
 185 struct  xfs_dquot;
 186 struct  xfs_inode;
 187 struct  xfs_mount;
 188 struct  xfs_trans;
 189
 190 /*
 191  * Quota Manager Interface.
 192  */
 193 extern struct xfs_qm   *xfs_qm_init(void);
 194 extern void             xfs_qm_destroy(struct xfs_qm *);
 195 extern int              xfs_qm_dqflush_all(struct xfs_mount *, int);
 196 extern int              xfs_qm_dqattach(struct xfs_inode *, uint);
 197 extern int              xfs_qm_dqpurge_all(struct xfs_mount *, uint);
 198 extern void             xfs_qm_mount_quotainit(struct xfs_mount *, uint);
 199 extern void             xfs_qm_unmount_quotadestroy(struct xfs_mount *);
 200 extern int              xfs_qm_mount_quotas(struct xfs_mount *);
 201 extern int              xfs_qm_unmount_quotas(struct xfs_mount *);
 202 extern void             xfs_qm_dqdettach_inode(struct xfs_inode *);
 203 extern int              xfs_qm_sync(struct xfs_mount *, short);
 204
 205 /*
 206  * Dquot interface.
 207  */
 208 extern void             xfs_dqlock(struct xfs_dquot *);
 209 extern void             xfs_dqunlock(struct xfs_dquot *);
 210 extern void             xfs_dqunlock_nonotify(struct xfs_dquot *);
 211 extern void             xfs_dqlock2(struct xfs_dquot *, struct xfs_dquot *);
 212 extern void             xfs_qm_dqput(struct xfs_dquot *);
 213 extern void             xfs_qm_dqrele(struct xfs_dquot *);
 214 extern xfs_dqid_t       xfs_qm_dqid(struct xfs_dquot *);
 215 extern int              xfs_qm_dqget(struct xfs_mount *,
 216                                      struct xfs_inode *, xfs_dqid_t,
 217                                       uint, uint, struct xfs_dquot **);
 218 extern int              xfs_qm_dqcheck(struct xfs_disk_dquot *,
 219                                        xfs_dqid_t, uint, uint, char *);
 220
 221 /*
 222  * Vnodeops specific code that should actually be _in_ xfs_vnodeops.c, but
 223  * is here because it's nicer to keep vnodeops (therefore, XFS) lean
 224  * and clean.
 225  */
 226 extern struct xfs_dquot *       xfs_qm_vop_chown(struct xfs_trans *,
 227                                                  struct xfs_inode *,
 228                                                  struct xfs_dquot **,
 229                                                  struct xfs_dquot *);
 230 extern int              xfs_qm_vop_dqalloc(struct xfs_mount *,
 231                                            struct xfs_inode *,
 232                                            uid_t, gid_t, uint,
 233                                            struct xfs_dquot     **,
 234                                            struct xfs_dquot     **);
 235
 236 extern int              xfs_qm_vop_chown_reserve(struct xfs_trans *,
 237                                                  struct xfs_inode *,
 238                                                  struct xfs_dquot *,
 239                                                  struct xfs_dquot *,
 240                                                  uint);
 241
 242 extern int              xfs_qm_vop_rename_dqattach(struct xfs_inode **);
 243 extern void             xfs_qm_vop_dqattach_and_dqmod_newinode(
 244                                                 struct xfs_trans *,
 245                                                 struct xfs_inode *,
 246                                                 struct xfs_dquot *,
 247                                                 struct xfs_dquot *);
 248
 249
 250 /*
 251  * Dquot Transaction interface
 252  */
 253 extern void             xfs_trans_alloc_dqinfo(struct xfs_trans *);
 254 extern void             xfs_trans_free_dqinfo(struct xfs_trans *);
 255 extern void             xfs_trans_dup_dqinfo(struct xfs_trans *,
 256                                              struct xfs_trans *);
 257 extern void             xfs_trans_mod_dquot(struct xfs_trans *,
 258                                             struct xfs_dquot *,
 259                                             uint, long);
 260 extern void             xfs_trans_mod_dquot_byino(struct xfs_trans *,
 261                                                   struct xfs_inode *,
 262                                                   uint, long);
 263 extern void             xfs_trans_apply_dquot_deltas(struct xfs_trans *);
 264 extern void             xfs_trans_unreserve_and_mod_dquots(struct xfs_trans *);
 265
 266 extern int              xfs_trans_reserve_quota_nblks(struct xfs_trans *,
 267                                                       struct xfs_inode *,
 268                                                       long, long, uint);
 269
 270
 271 extern int              xfs_trans_reserve_quota_bydquots(struct xfs_trans *,
 272                                                          struct xfs_dquot *,
 273                                                          struct xfs_dquot *,
 274                                                          long, long, uint);
 275 extern void             xfs_trans_log_dquot(struct xfs_trans *,
 276                                             struct xfs_dquot *);
 277 extern void             xfs_trans_dqjoin(struct xfs_trans *,
 278                                          struct xfs_dquot *);
 279 extern void             xfs_qm_dqrele_all_inodes(struct xfs_mount *, uint);
 280
 281 # define _XQM_ZONE_DESTROY(z)   ((z)? kmem_cache_destroy(z) : (void)0)
 282
 283 #else
 284 # define xfs_qm_init()                                  (NULL)
 285 # define xfs_qm_destroy(xqm)                            do { } while (0)
 286 # define xfs_qm_dqflush_all(m,t)                        (ENOSYS)
 287 # define xfs_qm_dqattach(i,t)                           (ENOSYS)
 288 # define xfs_qm_dqpurge_all(m,t)                        (ENOSYS)
 289 # define xfs_qm_mount_quotainit(m,t)                    do { } while (0)
 290 # define xfs_qm_unmount_quotadestroy(m)                 do { } while (0)
 291 # define xfs_qm_mount_quotas(m)                         (ENOSYS)
 292 # define xfs_qm_unmount_quotas(m)                       (ENOSYS)
 293 # define xfs_qm_dqdettach_inode(i)                      do { } while (0)
 294 # define xfs_qm_sync(m,t)                               (ENOSYS)
 295 # define xfs_dqlock(d)                                  do { } while (0)
 296 # define xfs_dqunlock(d)                                do { } while (0)
 297 # define xfs_dqunlock_nonotify(d)                       do { } while (0)
 298 # define xfs_dqlock2(d1,d2)                             do { } while (0)
 299 # define xfs_qm_dqput(d)                                do { } while (0)
 300 # define xfs_qm_dqrele(d)                               do { } while (0)
 301 # define xfs_qm_dqid(d)                                 (-1)
 302 # define xfs_qm_dqget(m,i,di,t,f,d)                     (ENOSYS)
 303 # define xfs_qm_dqcheck(dd,di,t,f,s)                    (ENOSYS)
 304 # define xfs_trans_alloc_dqinfo(t)                      do { } while (0)
 305 # define xfs_trans_free_dqinfo(t)                       do { } while (0)
 306 # define xfs_trans_dup_dqinfo(t1,t2)                    do { } while (0)
 307 # define xfs_trans_mod_dquot(t,d,f,x)                   do { } while (0)
 308 # define xfs_trans_mod_dquot_byino(t,i,f,x)             do { } while (0)
 309 # define xfs_trans_apply_dquot_deltas(t)                do { } while (0)
 310 # define xfs_trans_unreserve_and_mod_dquots(t)          do { } while (0)
 311 # define xfs_trans_reserve_quota_nblks(t,i,nb,ni,f)     (ENOSYS)
 312 # define xfs_trans_reserve_quota_bydquots(t,x,y,b,i,f)  (ENOSYS)
 313 # define xfs_trans_log_dquot(t,d)                       do { } while (0)
 314 # define xfs_trans_dqjoin(t,d)                          do { } while (0)
 315 # define xfs_qm_dqrele_all_inodes(m,t)                  do { } while (0)
 316 # define xfs_qm_vop_chown(t,i,d1,d2)                    (NULL)
 317 # define xfs_qm_vop_dqalloc(m,i,u,g,f,d1,d2)            (ENOSYS)
 318 # define xfs_qm_vop_chown_reserve(t,i,d1,d2,f)          (ENOSYS)
 319 # define xfs_qm_vop_rename_dqattach(i)                  (ENOSYS)
 320 # define xfs_qm_vop_dqattach_and_dqmod_newinode(t,i,x,y) do { } while (0)
 321 # define _XQM_ZONE_DESTROY(z)                           do { } while (0)
 322 #endif  /* CONFIG_XFS_QUOTA */
 323
 324 /*
 325  * Regular disk block quota reservations
 326  */
 327 #define         xfs_trans_reserve_blkquota(tp, ip, nblks) \
 328 xfs_trans_reserve_quota_nblks(tp, ip, nblks, 0, XFS_QMOPT_RES_REGBLKS)
 329
 330 #define         xfs_trans_reserve_blkquota_force(tp, ip, nblks) \
 331 xfs_trans_reserve_quota_nblks(tp, ip, nblks, 0, \
 332                 XFS_QMOPT_RES_REGBLKS|XFS_QMOPT_FORCE_RES)
 333
 334 #define         xfs_trans_unreserve_blkquota(tp, ip, nblks) \
 335 (void)xfs_trans_reserve_quota_nblks(tp, ip, -(nblks), 0, XFS_QMOPT_RES_REGBLKS)
 336
 337 #define         xfs_trans_reserve_quota(tp, udq, gdq, nb, ni, f) \
 338 xfs_trans_reserve_quota_bydquots(tp, udq, gdq, nb, ni, f|XFS_QMOPT_RES_REGBLKS)
 339
 340 #define         xfs_trans_unreserve_quota(tp, ud, gd, b, i, f) \
 341 xfs_trans_reserve_quota_bydquots(tp, ud, gd, -(b), -(i), f|XFS_QMOPT_RES_REGBLKS)
 342
 343 /*
 344  * Realtime disk block quota reservations
 345  */
 346 #define         xfs_trans_reserve_rtblkquota(mp, tp, ip, nblks) \
 347 xfs_trans_reserve_quota_nblks(tp, ip, nblks, 0, XFS_QMOPT_RES_RTBLKS)
 348
 349 #define         xfs_trans_unreserve_rtblkquota(tp, ip, nblks) \
 350 (void)xfs_trans_reserve_quota_nblks(tp, ip, -(nblks), 0, XFS_QMOPT_RES_RTBLKS)
 351
 352 #define         xfs_trans_reserve_rtquota(mp, tp, uq, pq, blks, f) \
 353 xfs_trans_reserve_quota_bydquots(mp, tp, uq, pq, blks, 0, f|XFS_QMOPT_RES_RTBLKS)
 354
 355 #define         xfs_trans_unreserve_rtquota(tp, uq, pq, blks) \
 356 xfs_trans_reserve_quota_bydquots(tp, uq, pq, -(blks), XFS_QMOPT_RES_RTBLKS)
 357
 358
 359 #endif  /* __KERNEL__ */
 360
 361 #endif  /* __XFS_QUOTA_H__ */