cleanups and bug fixes from John
[unix-history] / usr / src / sys / ufs / ffs / quota.h
... / ...
CommitLineData
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 * %sccs.include.redist.c%
9 *
10 * @(#)quota.h 7.10 (Berkeley) %G%
11 */
12
13#ifndef _QUOTA_
14#define _QUOTA_
15
16/*
17 * Definitions for disk quotas imposed on the average user
18 * (big brother finally hits UNIX).
19 *
20 * The following constants define the amount of time given a user before the
21 * soft limits are treated as hard limits (usually resulting in an allocation
22 * failure). The timer is started when the user crosses their soft limit, it
23 * is reset when they go below their soft limit.
24 */
25#define MAX_IQ_TIME (7*24*60*60) /* 1 week */
26#define MAX_DQ_TIME (7*24*60*60) /* 1 week */
27
28/*
29 * The following constants define the usage of the quota file array in the
30 * ufsmount structure and dquot array in the inode structure. The semantics
31 * of the elements of these arrays are defined in the routine getinoquota;
32 * the remainder of the quota code treats them generically and need not be
33 * inspected when changing the size of the array.
34 */
35#define MAXQUOTAS 2
36#define USRQUOTA 0 /* element used for user quotas */
37#define GRPQUOTA 1 /* element used for group quotas */
38
39/*
40 * Definitions for the default names of the quotas files.
41 */
42#define INITQFNAMES { \
43 "user", /* USRQUOTA */ \
44 "group", /* GRPQUOTA */ \
45 "undefined", \
46};
47#define QUOTAFILENAME "quota"
48#define QUOTAGROUP "operator"
49
50/*
51 * Command definitions for the 'quotactl' system call. The commands are
52 * broken into a main command defined below and a subcommand that is used
53 * to convey the type of quota that is being manipulated (see above).
54 */
55#define SUBCMDMASK 0x00ff
56#define SUBCMDSHIFT 8
57#define QCMD(cmd, type) (((cmd) << SUBCMDSHIFT) | ((type) & SUBCMDMASK))
58
59#define Q_QUOTAON 0x0100 /* enable quotas */
60#define Q_QUOTAOFF 0x0200 /* disable quotas */
61#define Q_GETQUOTA 0x0300 /* get limits and usage */
62#define Q_SETQUOTA 0x0400 /* set limits and usage */
63#define Q_SETUSE 0x0500 /* set usage */
64#define Q_SYNC 0x0600 /* sync disk copy of a filesystems quotas */
65
66/*
67 * The following structure defines the format of the disk quota file
68 * (as it appears on disk) - the file is an array of these structures
69 * indexed by user or group number. The setquota system call establishes
70 * the vnode for each quota file (a pointer is retained in the ufsmount
71 * structure).
72 */
73struct dqblk {
74 u_long dqb_bhardlimit; /* absolute limit on disk blks alloc */
75 u_long dqb_bsoftlimit; /* preferred limit on disk blks */
76 u_long dqb_curblocks; /* current block count */
77 u_long dqb_ihardlimit; /* maximum # allocated inodes + 1 */
78 u_long dqb_isoftlimit; /* preferred inode limit */
79 u_long dqb_curinodes; /* current # allocated inodes */
80 time_t dqb_btime; /* time limit for excessive disk use */
81 time_t dqb_itime; /* time limit for excessive files */
82};
83
84/*
85 * The following structure records disk usage for a user or group on a
86 * filesystem. There is one allocated for each quota that exists on any
87 * filesystem for the current user or group. A cache is kept of recently
88 * used entries.
89 */
90struct dquot {
91 struct dquot *dq_forw, *dq_back;/* MUST be first entry */
92 struct dquot *dq_freef, **dq_freeb; /* free list */
93 short dq_flags; /* flags, see below */
94 short dq_cnt; /* count of active references */
95 short dq_spare; /* unused spare padding */
96 short dq_type; /* quota type of this dquot */
97 u_long dq_id; /* identifier this applies to */
98 struct ufsmount *dq_ump; /* filesystem that this is taken from */
99 struct dqblk dq_dqb; /* actual usage & quotas */
100};
101/*
102 * Flag values.
103 */
104#define DQ_LOCK 0x01 /* this quota locked (no MODS) */
105#define DQ_WANT 0x02 /* wakeup on unlock */
106#define DQ_MOD 0x04 /* this quota modified since read */
107#define DQ_FAKE 0x08 /* no limits here, just usage */
108#define DQ_BLKS 0x10 /* has been warned about blk limit */
109#define DQ_INODS 0x20 /* has been warned about inode limit */
110/*
111 * Shorthand notation.
112 */
113#define dq_bhardlimit dq_dqb.dqb_bhardlimit
114#define dq_bsoftlimit dq_dqb.dqb_bsoftlimit
115#define dq_curblocks dq_dqb.dqb_curblocks
116#define dq_ihardlimit dq_dqb.dqb_ihardlimit
117#define dq_isoftlimit dq_dqb.dqb_isoftlimit
118#define dq_curinodes dq_dqb.dqb_curinodes
119#define dq_btime dq_dqb.dqb_btime
120#define dq_itime dq_dqb.dqb_itime
121
122/*
123 * If the system has never checked for a quota for this file, then it is set
124 * to NODQUOT. Once a write attempt is made the inode pointer is set to
125 * reference a dquot structure.
126 */
127#define NODQUOT ((struct dquot *) 0)
128
129/*
130 * Flags to chkdq() and chkiq()
131 */
132#define FORCE 0x01 /* force usage changes independent of limits */
133#define CHOWN 0x02 /* (advisory) change initiated by chown */
134
135/*
136 * Macros to avoid subroutine calls to trivial functions.
137 */
138#ifdef DIAGNOSTIC
139#define DQREF(dq) dqref(dq)
140#else
141#define DQREF(dq) (dq)->dq_cnt++
142#endif
143
144#include <sys/cdefs.h>
145
146struct dquot;
147struct inode;
148struct mount;
149struct proc;
150struct ucred;
151struct ufsmount;
152struct vnode;
153__BEGIN_DECLS
154int chkdq __P((struct inode *, long, struct ucred *, int));
155int chkdqchg __P((struct inode *, long, struct ucred *, int));
156int chkiq __P((struct inode *, long, struct ucred *, int));
157int chkiqchg __P((struct inode *, long, struct ucred *, int));
158void dqflush __P((struct vnode *));
159int dqget __P((struct vnode *,
160 u_long, struct ufsmount *, int, struct dquot **));
161void dqinit __P((void));
162void dqref __P((struct dquot *));
163void dqrele __P((struct vnode *, struct dquot *));
164int dqsync __P((struct vnode *, struct dquot *));
165int getinoquota __P((struct inode *));
166int getquota __P((struct mount *, u_long, int, caddr_t));
167int qsync __P((struct mount *mp));
168int quotaoff __P((struct proc *, struct mount *, int));
169int quotaon __P((struct proc *, struct mount *, int, caddr_t));
170int setquota __P((struct mount *, u_long, int, caddr_t));
171int setuse __P((struct mount *, u_long, int, caddr_t));
172int ufs_quotactl __P((struct mount *, int, u_int, caddr_t, struct proc *));
173__END_DECLS
174
175#ifdef DIAGNOSTIC
176__BEGIN_DECLS
177void chkdquot __P((struct inode *));
178__END_DECLS
179#endif
180
181#endif /* _QUOTA_ */