include/xqm.h

   1 /*
   2  * Copyright (c) 1995, 2001, 2004-2005 Silicon Graphics, Inc.
   3  * All Rights Reserved.
   4  *
   5  * This program is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU Lesser General Public License
   7  * as published by the Free Software Foundation.
   8  *
   9  * This program is distributed in the hope that it would be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  * GNU Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public License
  15  * along with this program; if not, write the Free Software Foundation,
  16  * Inc.,  51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  17  */
  18 #ifndef __XQM_H__
  19 #define __XQM_H__
  20
  21 #include <xfs/xfs.h>
  22
  23 /*
  24  * Disk quota - quotactl(2) commands for the XFS Quota Manager (XQM).
  25  */
  26
  27 #define XQM_CMD(x)      (('X'<<8)+(x))  /* note: forms first QCMD argument */
  28 #define Q_XQUOTAON      XQM_CMD(1)      /* enable accounting/enforcement */
  29 #define Q_XQUOTAOFF     XQM_CMD(2)      /* disable accounting/enforcement */
  30 #define Q_XGETQUOTA     XQM_CMD(3)      /* get disk limits and usage */
  31 #define Q_XSETQLIM      XQM_CMD(4)      /* set disk limits */
  32 #define Q_XGETQSTAT     XQM_CMD(5)      /* get quota subsystem status */
  33 #define Q_XQUOTARM      XQM_CMD(6)      /* free disk space used by dquots */
  34 #define Q_XQUOTASYNC    XQM_CMD(7)      /* delalloc flush, updates dquots */
  35 #define Q_XGETNEXTQUOTA XQM_CMD(9)      /* get disk limits and usage */
  36
  37 /*
  38  * fs_disk_quota structure:
  39  *
  40  * This contains the current quota information regarding a user/proj/group.
  41  * It is 64-bit aligned, and all the blk units are in BBs (Basic Blocks) of
  42  * 512 bytes.
  43  */
  44 #define FS_DQUOT_VERSION        1       /* fs_disk_quota.d_version */
  45 typedef struct fs_disk_quota {
  46         __s8            d_version;      /* version of this structure */
  47         __s8            d_flags;        /* XFS_{USER,PROJ,GROUP}_QUOTA */
  48         __u16           d_fieldmask;    /* field specifier */
  49         __u32           d_id;           /* user, project, or group ID */
  50         __u64           d_blk_hardlimit;/* absolute limit on disk blks */
  51         __u64           d_blk_softlimit;/* preferred limit on disk blks */
  52         __u64           d_ino_hardlimit;/* maximum # allocated inodes */
  53         __u64           d_ino_softlimit;/* preferred inode limit */
  54         __u64           d_bcount;       /* # disk blocks owned by the user */
  55         __u64           d_icount;       /* # inodes owned by the user */
  56         __s32           d_itimer;       /* zero if within inode limits */
  57                                         /* if not, we refuse service */
  58         __s32           d_btimer;       /* similar to above; for disk blocks */
  59         __u16           d_iwarns;       /* # warnings issued wrt num inodes */
  60         __u16           d_bwarns;       /* # warnings issued wrt disk blocks */
  61         __s32           d_padding2;     /* padding2 - for future use */
  62         __u64           d_rtb_hardlimit;/* absolute limit on realtime blks */
  63         __u64           d_rtb_softlimit;/* preferred limit on RT disk blks */
  64         __u64           d_rtbcount;     /* # realtime blocks owned */
  65         __s32           d_rtbtimer;     /* similar to above; for RT disk blks */
  66         __u16           d_rtbwarns;     /* # warnings issued wrt RT disk blks */
  67         __s16           d_padding3;     /* padding3 - for future use */
  68         char            d_padding4[8];  /* yet more padding */
  69 } fs_disk_quota_t;
  70
  71 /*
  72  * These fields are sent to Q_XSETQLIM to specify fields that need to change.
  73  */
  74 #define FS_DQ_ISOFT     (1<<0)
  75 #define FS_DQ_IHARD     (1<<1)
  76 #define FS_DQ_BSOFT     (1<<2)
  77 #define FS_DQ_BHARD     (1<<3)
  78 #define FS_DQ_RTBSOFT   (1<<4)
  79 #define FS_DQ_RTBHARD   (1<<5)
  80 #define FS_DQ_LIMIT_MASK        (FS_DQ_ISOFT | FS_DQ_IHARD | FS_DQ_BSOFT | \
  81                                  FS_DQ_BHARD | FS_DQ_RTBSOFT | FS_DQ_RTBHARD)
  82 /*
  83  * These timers can only be set in super user's dquot. For others, timers are
  84  * automatically started and stopped. Superusers timer values set the limits
  85  * for the rest.  In case these values are zero, the DQ_{F,B}TIMELIMIT values
  86  * defined below are used.
  87  * These values also apply only to the d_fieldmask field for Q_XSETQLIM.
  88  */
  89 #define FS_DQ_BTIMER    (1<<6)
  90 #define FS_DQ_ITIMER    (1<<7)
  91 #define FS_DQ_RTBTIMER  (1<<8)
  92 #define FS_DQ_TIMER_MASK        (FS_DQ_BTIMER | FS_DQ_ITIMER | FS_DQ_RTBTIMER)
  93
  94 /*
  95  * Warning counts are set in both super user's dquot and others. For others,
  96  * warnings are set/cleared by the administrators (or automatically by going
  97  * below the soft limit).  Superusers warning values set the warning limits
  98  * for the rest.  In case these values are zero, the DQ_{F,B}WARNLIMIT values
  99  * defined below are used.
 100  * These values also apply only to the d_fieldmask field for Q_XSETQLIM.
 101  */
 102 #define FS_DQ_BWARNS    (1<<9)
 103 #define FS_DQ_IWARNS    (1<<10)
 104 #define FS_DQ_RTBWARNS  (1<<11)
 105 #define FS_DQ_WARNS_MASK        (FS_DQ_BWARNS | FS_DQ_IWARNS | FS_DQ_RTBWARNS)
 106
 107 /*
 108  * Various flags related to quotactl(2).  Only relevant to XFS filesystems.
 109  */
 110 #define XFS_QUOTA_UDQ_ACCT      (1<<0)  /* user quota accounting */
 111 #define XFS_QUOTA_UDQ_ENFD      (1<<1)  /* user quota limits enforcement */
 112 #define XFS_QUOTA_GDQ_ACCT      (1<<2)  /* group quota accounting */
 113 #define XFS_QUOTA_GDQ_ENFD      (1<<3)  /* group quota limits enforcement */
 114 #define XFS_QUOTA_PDQ_ACCT      (1<<4)  /* project quota accounting */
 115 #define XFS_QUOTA_PDQ_ENFD      (1<<5)  /* project quota limits enforcement */
 116
 117 #define XFS_USER_QUOTA          (1<<0)  /* user quota type */
 118 #define XFS_PROJ_QUOTA          (1<<1)  /* project quota type */
 119 #define XFS_GROUP_QUOTA         (1<<2)  /* group quota type */
 120
 121 /*
 122  * fs_quota_stat is the struct returned in Q_XGETQSTAT for a given file system.
 123  * Provides a centralized way to get meta information about the quota subsystem.
 124  * eg. space taken up for user and group quotas, number of dquots currently
 125  * incore.
 126  */
 127 #define FS_QSTAT_VERSION        1       /* fs_quota_stat.qs_version */
 128
 129 /*
 130  * Some basic information about 'quota files'.
 131  */
 132 typedef struct fs_qfilestat {
 133         __u64           qfs_ino;        /* inode number */
 134         __u64           qfs_nblks;      /* number of BBs 512-byte-blks */
 135         __u32           qfs_nextents;   /* number of extents */
 136 } fs_qfilestat_t;
 137
 138 typedef struct fs_quota_stat {
 139         __s8            qs_version;     /* version number for future changes */
 140         __u16           qs_flags;       /* XFS_QUOTA_{U,P,G}DQ_{ACCT,ENFD} */
 141         __s8            qs_pad;         /* unused */
 142         fs_qfilestat_t  qs_uquota;      /* user quota storage information */
 143         fs_qfilestat_t  qs_gquota;      /* group quota storage information */
 144         __u32           qs_incoredqs;   /* number of dquots incore */
 145         __s32           qs_btimelimit;  /* limit for blks timer */
 146         __s32           qs_itimelimit;  /* limit for inodes timer */
 147         __s32           qs_rtbtimelimit;/* limit for rt blks timer */
 148         __u16           qs_bwarnlimit;  /* limit for num warnings */
 149         __u16           qs_iwarnlimit;  /* limit for num warnings */
 150 } fs_quota_stat_t;
 151
 152 #endif  /* __XQM_H__ */