xref: /linux/fs/jfs/jfs_txnmgr.h (revision e58e871becec2d3b04ed91c0c16fe8deac9c9dfa)
1 /*
2  *   Copyright (C) International Business Machines Corp., 2000-2004
3  *
4  *   This program is free software;  you can redistribute it and/or modify
5  *   it under the terms of the GNU General Public License as published by
6  *   the Free Software Foundation; either version 2 of the License, or
7  *   (at your option) any later version.
8  *
9  *   This program is distributed in the hope that it will be useful,
10  *   but WITHOUT ANY WARRANTY;  without even the implied warranty of
11  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See
12  *   the GNU General Public License for more details.
13  *
14  *   You should have received a copy of the GNU General Public License
15  *   along with this program;  if not, write to the Free Software
16  *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17  */
18 #ifndef _H_JFS_TXNMGR
19 #define _H_JFS_TXNMGR
20 
21 #include "jfs_logmgr.h"
22 
23 /*
24  * Hide implementation of TxBlock and TxLock
25  */
26 #define tid_to_tblock(tid) (&TxBlock[tid])
27 
28 #define lid_to_tlock(lid) (&TxLock[lid])
29 
30 /*
31  *	transaction block
32  */
33 struct tblock {
34 	/*
35 	 * tblock and jbuf_t common area: struct logsyncblk
36 	 *
37 	 * the following 5 fields are the same as struct logsyncblk
38 	 * which is common to tblock and jbuf to form logsynclist
39 	 */
40 	u16 xflag;		/* tx commit type */
41 	u16 flag;		/* tx commit state */
42 	lid_t dummy;		/* Must keep structures common */
43 	s32 lsn;		/* recovery lsn */
44 	struct list_head synclist;	/* logsynclist link */
45 
46 	/* lock management */
47 	struct super_block *sb;	/* super block */
48 	lid_t next;		/* index of first tlock of tid */
49 	lid_t last;		/* index of last tlock of tid */
50 	wait_queue_head_t waitor;	/* tids waiting on this tid */
51 
52 	/* log management */
53 	u32 logtid;		/* log transaction id */
54 
55 	/* commit management */
56 	struct list_head cqueue;	/* commit queue list */
57 	s32 clsn;		/* commit lsn */
58 	struct lbuf *bp;
59 	s32 pn;			/* commit record log page number */
60 	s32 eor;		/* commit record eor */
61 	wait_queue_head_t gcwait;	/* group commit event list:
62 					 * ready transactions wait on this
63 					 * event for group commit completion.
64 					 */
65 	union {
66 		struct inode *ip; /* inode being deleted */
67 		pxd_t ixpxd;	/* pxd of inode extent for created inode */
68 	} u;
69 	u32 ino;		/* inode number being created */
70 };
71 
72 extern struct tblock *TxBlock;	/* transaction block table */
73 
74 /* commit flags: tblk->xflag */
75 #define	COMMIT_SYNC	0x0001	/* synchronous commit */
76 #define	COMMIT_FORCE	0x0002	/* force pageout at end of commit */
77 #define	COMMIT_FLUSH	0x0004	/* init flush at end of commit */
78 #define COMMIT_MAP	0x00f0
79 #define	COMMIT_PMAP	0x0010	/* update pmap */
80 #define	COMMIT_WMAP	0x0020	/* update wmap */
81 #define	COMMIT_PWMAP	0x0040	/* update pwmap */
82 #define	COMMIT_FREE	0x0f00
83 #define	COMMIT_DELETE	0x0100	/* inode delete */
84 #define	COMMIT_TRUNCATE	0x0200	/* file truncation */
85 #define	COMMIT_CREATE	0x0400	/* inode create */
86 #define	COMMIT_LAZY	0x0800	/* lazy commit */
87 #define COMMIT_PAGE	0x1000	/* Identifies element as metapage */
88 #define COMMIT_INODE	0x2000	/* Identifies element as inode */
89 
90 /* group commit flags tblk->flag: see jfs_logmgr.h */
91 
92 /*
93  *	transaction lock
94  */
95 struct tlock {
96 	lid_t next;		/* 2: index next lockword on tid locklist
97 				 *	    next lockword on freelist
98 				 */
99 	tid_t tid;		/* 2: transaction id holding lock */
100 
101 	u16 flag;		/* 2: lock control */
102 	u16 type;		/* 2: log type */
103 
104 	struct metapage *mp;	/* 4/8: object page buffer locked */
105 	struct inode *ip;	/* 4/8: object */
106 	/* (16) */
107 
108 	s16 lock[24];		/* 48: overlay area */
109 };				/* (64) */
110 
111 extern struct tlock *TxLock;	/* transaction lock table */
112 
113 /*
114  * tlock flag
115  */
116 /* txLock state */
117 #define tlckPAGELOCK		0x8000
118 #define tlckINODELOCK		0x4000
119 #define tlckLINELOCK		0x2000
120 #define tlckINLINELOCK		0x1000
121 /* lmLog state */
122 #define tlckLOG			0x0800
123 /* updateMap state */
124 #define	tlckUPDATEMAP		0x0080
125 #define	tlckDIRECTORY		0x0040
126 /* freeLock state */
127 #define tlckFREELOCK		0x0008
128 #define tlckWRITEPAGE		0x0004
129 #define tlckFREEPAGE		0x0002
130 
131 /*
132  * tlock type
133  */
134 #define	tlckTYPE		0xfe00
135 #define	tlckINODE		0x8000
136 #define	tlckXTREE		0x4000
137 #define	tlckDTREE		0x2000
138 #define	tlckMAP			0x1000
139 #define	tlckEA			0x0800
140 #define	tlckACL			0x0400
141 #define	tlckDATA		0x0200
142 #define	tlckBTROOT		0x0100
143 
144 #define	tlckOPERATION		0x00ff
145 #define tlckGROW		0x0001	/* file grow */
146 #define tlckREMOVE		0x0002	/* file delete */
147 #define tlckTRUNCATE		0x0004	/* file truncate */
148 #define tlckRELOCATE		0x0008	/* file/directory relocate */
149 #define tlckENTRY		0x0001	/* directory insert/delete */
150 #define tlckEXTEND		0x0002	/* directory extend in-line */
151 #define tlckSPLIT		0x0010	/* splited page */
152 #define tlckNEW			0x0020	/* new page from split */
153 #define tlckFREE		0x0040	/* free page */
154 #define tlckRELINK		0x0080	/* update sibling pointer */
155 
156 /*
157  *	linelock for lmLog()
158  *
159  * note: linelock and its variations are overlaid
160  * at tlock.lock: watch for alignment;
161  */
162 struct lv {
163 	u8 offset;		/* 1: */
164 	u8 length;		/* 1: */
165 };				/* (2) */
166 
167 #define	TLOCKSHORT	20
168 #define	TLOCKLONG	28
169 
170 struct linelock {
171 	lid_t next;		/* 2: next linelock */
172 
173 	s8 maxcnt;		/* 1: */
174 	s8 index;		/* 1: */
175 
176 	u16 flag;		/* 2: */
177 	u8 type;		/* 1: */
178 	u8 l2linesize;		/* 1: log2 of linesize */
179 	/* (8) */
180 
181 	struct lv lv[20];	/* 40: */
182 };				/* (48) */
183 
184 #define dt_lock	linelock
185 
186 struct xtlock {
187 	lid_t next;		/* 2: */
188 
189 	s8 maxcnt;		/* 1: */
190 	s8 index;		/* 1: */
191 
192 	u16 flag;		/* 2: */
193 	u8 type;		/* 1: */
194 	u8 l2linesize;		/* 1: log2 of linesize */
195 				/* (8) */
196 
197 	struct lv header;	/* 2: */
198 	struct lv lwm;		/* 2: low water mark */
199 	struct lv hwm;		/* 2: high water mark */
200 	struct lv twm;		/* 2: */
201 				/* (16) */
202 
203 	s32 pxdlock[8];		/* 32: */
204 };				/* (48) */
205 
206 
207 /*
208  *	maplock for txUpdateMap()
209  *
210  * note: maplock and its variations are overlaid
211  * at tlock.lock/linelock: watch for alignment;
212  * N.B. next field may be set by linelock, and should not
213  * be modified by maplock;
214  * N.B. index of the first pxdlock specifies index of next
215  * free maplock (i.e., number of maplock) in the tlock;
216  */
217 struct maplock {
218 	lid_t next;		/* 2: */
219 
220 	u8 maxcnt;		/* 2: */
221 	u8 index;		/* 2: next free maplock index */
222 
223 	u16 flag;		/* 2: */
224 	u8 type;		/* 1: */
225 	u8 count;		/* 1: number of pxd/xad */
226 				/* (8) */
227 
228 	pxd_t pxd;		/* 8: */
229 };				/* (16): */
230 
231 /* maplock flag */
232 #define	mlckALLOC		0x00f0
233 #define	mlckALLOCXADLIST	0x0080
234 #define	mlckALLOCPXDLIST	0x0040
235 #define	mlckALLOCXAD		0x0020
236 #define	mlckALLOCPXD		0x0010
237 #define	mlckFREE		0x000f
238 #define	mlckFREEXADLIST		0x0008
239 #define	mlckFREEPXDLIST		0x0004
240 #define	mlckFREEXAD		0x0002
241 #define	mlckFREEPXD		0x0001
242 
243 #define	pxd_lock	maplock
244 
245 struct xdlistlock {
246 	lid_t next;		/* 2: */
247 
248 	u8 maxcnt;		/* 2: */
249 	u8 index;		/* 2: */
250 
251 	u16 flag;		/* 2: */
252 	u8 type;		/* 1: */
253 	u8 count;		/* 1: number of pxd/xad */
254 				/* (8) */
255 
256 	/*
257 	 * We need xdlist to be 64 bits (8 bytes), regardless of
258 	 * whether void * is 32 or 64 bits
259 	 */
260 	union {
261 		void *_xdlist;	/* pxd/xad list */
262 		s64 pad;	/* 8: Force 64-bit xdlist size */
263 	} union64;
264 };				/* (16): */
265 
266 #define xdlist union64._xdlist
267 
268 /*
269  *	commit
270  *
271  * parameter to the commit manager routines
272  */
273 struct commit {
274 	tid_t tid;		/* tid = index of tblock */
275 	int flag;		/* flags */
276 	struct jfs_log *log;	/* log */
277 	struct super_block *sb;	/* superblock */
278 
279 	int nip;		/* number of entries in iplist */
280 	struct inode **iplist;	/* list of pointers to inodes */
281 
282 	/* log record descriptor on 64-bit boundary */
283 	struct lrd lrd;		/* : log record descriptor */
284 };
285 
286 /*
287  * external declarations
288  */
289 extern int jfs_tlocks_low;
290 
291 extern int txInit(void);
292 extern void txExit(void);
293 extern struct tlock *txLock(tid_t, struct inode *, struct metapage *, int);
294 extern struct tlock *txMaplock(tid_t, struct inode *, int);
295 extern int txCommit(tid_t, int, struct inode **, int);
296 extern tid_t txBegin(struct super_block *, int);
297 extern void txBeginAnon(struct super_block *);
298 extern void txEnd(tid_t);
299 extern void txAbort(tid_t, int);
300 extern struct linelock *txLinelock(struct linelock *);
301 extern void txFreeMap(struct inode *, struct maplock *, struct tblock *, int);
302 extern void txEA(tid_t, struct inode *, dxd_t *, dxd_t *);
303 extern void txFreelock(struct inode *);
304 extern int lmLog(struct jfs_log *, struct tblock *, struct lrd *,
305 		 struct tlock *);
306 extern void txQuiesce(struct super_block *);
307 extern void txResume(struct super_block *);
308 extern void txLazyUnlock(struct tblock *);
309 extern int jfs_lazycommit(void *);
310 extern int jfs_sync(void *);
311 #endif				/* _H_JFS_TXNMGR */
312