xref: /linux/fs/xfs/xfs_inode.h (revision af901ca181d92aac3a7dc265144a9081a86d8f39)
1 /*
2  * Copyright (c) 2000-2003,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 General Public License as
7  * 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 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 the Free Software Foundation,
16  * Inc.,  51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
17  */
18 #ifndef	__XFS_INODE_H__
19 #define	__XFS_INODE_H__
20 
21 struct posix_acl;
22 struct xfs_dinode;
23 struct xfs_inode;
24 
25 /*
26  * Fork identifiers.
27  */
28 #define	XFS_DATA_FORK	0
29 #define	XFS_ATTR_FORK	1
30 
31 /*
32  * The following xfs_ext_irec_t struct introduces a second (top) level
33  * to the in-core extent allocation scheme. These structs are allocated
34  * in a contiguous block, creating an indirection array where each entry
35  * (irec) contains a pointer to a buffer of in-core extent records which
36  * it manages. Each extent buffer is 4k in size, since 4k is the system
37  * page size on Linux i386 and systems with larger page sizes don't seem
38  * to gain much, if anything, by using their native page size as the
39  * extent buffer size. Also, using 4k extent buffers everywhere provides
40  * a consistent interface for CXFS across different platforms.
41  *
42  * There is currently no limit on the number of irec's (extent lists)
43  * allowed, so heavily fragmented files may require an indirection array
44  * which spans multiple system pages of memory. The number of extents
45  * which would require this amount of contiguous memory is very large
46  * and should not cause problems in the foreseeable future. However,
47  * if the memory needed for the contiguous array ever becomes a problem,
48  * it is possible that a third level of indirection may be required.
49  */
50 typedef struct xfs_ext_irec {
51 	xfs_bmbt_rec_host_t *er_extbuf;	/* block of extent records */
52 	xfs_extnum_t	er_extoff;	/* extent offset in file */
53 	xfs_extnum_t	er_extcount;	/* number of extents in page/block */
54 } xfs_ext_irec_t;
55 
56 /*
57  * File incore extent information, present for each of data & attr forks.
58  */
59 #define	XFS_IEXT_BUFSZ		4096
60 #define	XFS_LINEAR_EXTS		(XFS_IEXT_BUFSZ / (uint)sizeof(xfs_bmbt_rec_t))
61 #define	XFS_INLINE_EXTS		2
62 #define	XFS_INLINE_DATA		32
63 typedef struct xfs_ifork {
64 	int			if_bytes;	/* bytes in if_u1 */
65 	int			if_real_bytes;	/* bytes allocated in if_u1 */
66 	struct xfs_btree_block	*if_broot;	/* file's incore btree root */
67 	short			if_broot_bytes;	/* bytes allocated for root */
68 	unsigned char		if_flags;	/* per-fork flags */
69 	unsigned char		if_ext_max;	/* max # of extent records */
70 	xfs_extnum_t		if_lastex;	/* last if_extents used */
71 	union {
72 		xfs_bmbt_rec_host_t *if_extents;/* linear map file exts */
73 		xfs_ext_irec_t	*if_ext_irec;	/* irec map file exts */
74 		char		*if_data;	/* inline file data */
75 	} if_u1;
76 	union {
77 		xfs_bmbt_rec_host_t if_inline_ext[XFS_INLINE_EXTS];
78 						/* very small file extents */
79 		char		if_inline_data[XFS_INLINE_DATA];
80 						/* very small file data */
81 		xfs_dev_t	if_rdev;	/* dev number if special */
82 		uuid_t		if_uuid;	/* mount point value */
83 	} if_u2;
84 } xfs_ifork_t;
85 
86 /*
87  * Inode location information.  Stored in the inode and passed to
88  * xfs_imap_to_bp() to get a buffer and dinode for a given inode.
89  */
90 struct xfs_imap {
91 	xfs_daddr_t	im_blkno;	/* starting BB of inode chunk */
92 	ushort		im_len;		/* length in BBs of inode chunk */
93 	ushort		im_boffset;	/* inode offset in block in bytes */
94 };
95 
96 /*
97  * This is the xfs in-core inode structure.
98  * Most of the on-disk inode is embedded in the i_d field.
99  *
100  * The extent pointers/inline file space, however, are managed
101  * separately.  The memory for this information is pointed to by
102  * the if_u1 unions depending on the type of the data.
103  * This is used to linearize the array of extents for fast in-core
104  * access.  This is used until the file's number of extents
105  * surpasses XFS_MAX_INCORE_EXTENTS, at which point all extent pointers
106  * are accessed through the buffer cache.
107  *
108  * Other state kept in the in-core inode is used for identification,
109  * locking, transactional updating, etc of the inode.
110  *
111  * Generally, we do not want to hold the i_rlock while holding the
112  * i_ilock. Hierarchy is i_iolock followed by i_rlock.
113  *
114  * xfs_iptr_t contains all the inode fields upto and including the
115  * i_mnext and i_mprev fields, it is used as a marker in the inode
116  * chain off the mount structure by xfs_sync calls.
117  */
118 
119 typedef struct xfs_ictimestamp {
120 	__int32_t	t_sec;		/* timestamp seconds */
121 	__int32_t	t_nsec;		/* timestamp nanoseconds */
122 } xfs_ictimestamp_t;
123 
124 /*
125  * NOTE:  This structure must be kept identical to struct xfs_dinode
126  * 	  in xfs_dinode.h except for the endianness annotations.
127  */
128 typedef struct xfs_icdinode {
129 	__uint16_t	di_magic;	/* inode magic # = XFS_DINODE_MAGIC */
130 	__uint16_t	di_mode;	/* mode and type of file */
131 	__int8_t	di_version;	/* inode version */
132 	__int8_t	di_format;	/* format of di_c data */
133 	__uint16_t	di_onlink;	/* old number of links to file */
134 	__uint32_t	di_uid;		/* owner's user id */
135 	__uint32_t	di_gid;		/* owner's group id */
136 	__uint32_t	di_nlink;	/* number of links to file */
137 	__uint16_t	di_projid;	/* owner's project id */
138 	__uint8_t	di_pad[8];	/* unused, zeroed space */
139 	__uint16_t	di_flushiter;	/* incremented on flush */
140 	xfs_ictimestamp_t di_atime;	/* time last accessed */
141 	xfs_ictimestamp_t di_mtime;	/* time last modified */
142 	xfs_ictimestamp_t di_ctime;	/* time created/inode modified */
143 	xfs_fsize_t	di_size;	/* number of bytes in file */
144 	xfs_drfsbno_t	di_nblocks;	/* # of direct & btree blocks used */
145 	xfs_extlen_t	di_extsize;	/* basic/minimum extent size for file */
146 	xfs_extnum_t	di_nextents;	/* number of extents in data fork */
147 	xfs_aextnum_t	di_anextents;	/* number of extents in attribute fork*/
148 	__uint8_t	di_forkoff;	/* attr fork offs, <<3 for 64b align */
149 	__int8_t	di_aformat;	/* format of attr fork's data */
150 	__uint32_t	di_dmevmask;	/* DMIG event mask */
151 	__uint16_t	di_dmstate;	/* DMIG state info */
152 	__uint16_t	di_flags;	/* random flags, XFS_DIFLAG_... */
153 	__uint32_t	di_gen;		/* generation number */
154 } xfs_icdinode_t;
155 
156 /*
157  * Flags for xfs_ichgtime().
158  */
159 #define	XFS_ICHGTIME_MOD	0x1	/* data fork modification timestamp */
160 #define	XFS_ICHGTIME_CHG	0x2	/* inode field change timestamp */
161 
162 /*
163  * Per-fork incore inode flags.
164  */
165 #define	XFS_IFINLINE	0x01	/* Inline data is read in */
166 #define	XFS_IFEXTENTS	0x02	/* All extent pointers are read in */
167 #define	XFS_IFBROOT	0x04	/* i_broot points to the bmap b-tree root */
168 #define	XFS_IFEXTIREC	0x08	/* Indirection array of extent blocks */
169 
170 /*
171  * Fork handling.
172  */
173 
174 #define XFS_IFORK_Q(ip)			((ip)->i_d.di_forkoff != 0)
175 #define XFS_IFORK_BOFF(ip)		((int)((ip)->i_d.di_forkoff << 3))
176 
177 #define XFS_IFORK_PTR(ip,w)		\
178 	((w) == XFS_DATA_FORK ? \
179 		&(ip)->i_df : \
180 		(ip)->i_afp)
181 #define XFS_IFORK_DSIZE(ip) \
182 	(XFS_IFORK_Q(ip) ? \
183 		XFS_IFORK_BOFF(ip) : \
184 		XFS_LITINO((ip)->i_mount))
185 #define XFS_IFORK_ASIZE(ip) \
186 	(XFS_IFORK_Q(ip) ? \
187 		XFS_LITINO((ip)->i_mount) - XFS_IFORK_BOFF(ip) : \
188 		0)
189 #define XFS_IFORK_SIZE(ip,w) \
190 	((w) == XFS_DATA_FORK ? \
191 		XFS_IFORK_DSIZE(ip) : \
192 		XFS_IFORK_ASIZE(ip))
193 #define XFS_IFORK_FORMAT(ip,w) \
194 	((w) == XFS_DATA_FORK ? \
195 		(ip)->i_d.di_format : \
196 		(ip)->i_d.di_aformat)
197 #define XFS_IFORK_FMT_SET(ip,w,n) \
198 	((w) == XFS_DATA_FORK ? \
199 		((ip)->i_d.di_format = (n)) : \
200 		((ip)->i_d.di_aformat = (n)))
201 #define XFS_IFORK_NEXTENTS(ip,w) \
202 	((w) == XFS_DATA_FORK ? \
203 		(ip)->i_d.di_nextents : \
204 		(ip)->i_d.di_anextents)
205 #define XFS_IFORK_NEXT_SET(ip,w,n) \
206 	((w) == XFS_DATA_FORK ? \
207 		((ip)->i_d.di_nextents = (n)) : \
208 		((ip)->i_d.di_anextents = (n)))
209 
210 
211 
212 #ifdef __KERNEL__
213 
214 struct bhv_desc;
215 struct cred;
216 struct ktrace;
217 struct xfs_buf;
218 struct xfs_bmap_free;
219 struct xfs_bmbt_irec;
220 struct xfs_inode_log_item;
221 struct xfs_mount;
222 struct xfs_trans;
223 struct xfs_dquot;
224 
225 #if defined(XFS_ILOCK_TRACE)
226 #define XFS_ILOCK_KTRACE_SIZE	32
227 extern void xfs_ilock_trace(struct xfs_inode *, int, unsigned int, inst_t *);
228 #else
229 #define	xfs_ilock_trace(i,n,f,ra)
230 #endif
231 
232 typedef struct dm_attrs_s {
233 	__uint32_t	da_dmevmask;	/* DMIG event mask */
234 	__uint16_t	da_dmstate;	/* DMIG state info */
235 	__uint16_t	da_pad;		/* DMIG extra padding */
236 } dm_attrs_t;
237 
238 typedef struct xfs_inode {
239 	/* Inode linking and identification information. */
240 	struct xfs_mount	*i_mount;	/* fs mount struct ptr */
241 	struct xfs_dquot	*i_udquot;	/* user dquot */
242 	struct xfs_dquot	*i_gdquot;	/* group dquot */
243 
244 	/* Inode location stuff */
245 	xfs_ino_t		i_ino;		/* inode number (agno/agino)*/
246 	struct xfs_imap		i_imap;		/* location for xfs_imap() */
247 
248 	/* Extent information. */
249 	xfs_ifork_t		*i_afp;		/* attribute fork pointer */
250 	xfs_ifork_t		i_df;		/* data fork */
251 
252 	/* Transaction and locking information. */
253 	struct xfs_trans	*i_transp;	/* ptr to owning transaction*/
254 	struct xfs_inode_log_item *i_itemp;	/* logging information */
255 	mrlock_t		i_lock;		/* inode lock */
256 	mrlock_t		i_iolock;	/* inode IO lock */
257 	struct completion	i_flush;	/* inode flush completion q */
258 	atomic_t		i_pincount;	/* inode pin count */
259 	wait_queue_head_t	i_ipin_wait;	/* inode pinning wait queue */
260 	spinlock_t		i_flags_lock;	/* inode i_flags lock */
261 	/* Miscellaneous state. */
262 	unsigned short		i_flags;	/* see defined flags below */
263 	unsigned char		i_update_core;	/* timestamps/size is dirty */
264 	unsigned int		i_delayed_blks;	/* count of delay alloc blks */
265 
266 	xfs_icdinode_t		i_d;		/* most of ondisk inode */
267 
268 	xfs_fsize_t		i_size;		/* in-memory size */
269 	xfs_fsize_t		i_new_size;	/* size when write completes */
270 	atomic_t		i_iocount;	/* outstanding I/O count */
271 
272 	/* VFS inode */
273 	struct inode		i_vnode;	/* embedded VFS inode */
274 
275 	/* Trace buffers per inode. */
276 #ifdef XFS_INODE_TRACE
277 	struct ktrace		*i_trace;	/* general inode trace */
278 #endif
279 #ifdef XFS_BMAP_TRACE
280 	struct ktrace		*i_xtrace;	/* inode extent list trace */
281 #endif
282 #ifdef XFS_BTREE_TRACE
283 	struct ktrace		*i_btrace;	/* inode bmap btree trace */
284 #endif
285 #ifdef XFS_RW_TRACE
286 	struct ktrace		*i_rwtrace;	/* inode read/write trace */
287 #endif
288 #ifdef XFS_ILOCK_TRACE
289 	struct ktrace		*i_lock_trace;	/* inode lock/unlock trace */
290 #endif
291 #ifdef XFS_DIR2_TRACE
292 	struct ktrace		*i_dir_trace;	/* inode directory trace */
293 #endif
294 } xfs_inode_t;
295 
296 #define XFS_ISIZE(ip)	(((ip)->i_d.di_mode & S_IFMT) == S_IFREG) ? \
297 				(ip)->i_size : (ip)->i_d.di_size;
298 
299 /* Convert from vfs inode to xfs inode */
300 static inline struct xfs_inode *XFS_I(struct inode *inode)
301 {
302 	return container_of(inode, struct xfs_inode, i_vnode);
303 }
304 
305 /* convert from xfs inode to vfs inode */
306 static inline struct inode *VFS_I(struct xfs_inode *ip)
307 {
308 	return &ip->i_vnode;
309 }
310 
311 /*
312  * i_flags helper functions
313  */
314 static inline void
315 __xfs_iflags_set(xfs_inode_t *ip, unsigned short flags)
316 {
317 	ip->i_flags |= flags;
318 }
319 
320 static inline void
321 xfs_iflags_set(xfs_inode_t *ip, unsigned short flags)
322 {
323 	spin_lock(&ip->i_flags_lock);
324 	__xfs_iflags_set(ip, flags);
325 	spin_unlock(&ip->i_flags_lock);
326 }
327 
328 static inline void
329 xfs_iflags_clear(xfs_inode_t *ip, unsigned short flags)
330 {
331 	spin_lock(&ip->i_flags_lock);
332 	ip->i_flags &= ~flags;
333 	spin_unlock(&ip->i_flags_lock);
334 }
335 
336 static inline int
337 __xfs_iflags_test(xfs_inode_t *ip, unsigned short flags)
338 {
339 	return (ip->i_flags & flags);
340 }
341 
342 static inline int
343 xfs_iflags_test(xfs_inode_t *ip, unsigned short flags)
344 {
345 	int ret;
346 	spin_lock(&ip->i_flags_lock);
347 	ret = __xfs_iflags_test(ip, flags);
348 	spin_unlock(&ip->i_flags_lock);
349 	return ret;
350 }
351 
352 static inline int
353 xfs_iflags_test_and_clear(xfs_inode_t *ip, unsigned short flags)
354 {
355 	int ret;
356 
357 	spin_lock(&ip->i_flags_lock);
358 	ret = ip->i_flags & flags;
359 	if (ret)
360 		ip->i_flags &= ~flags;
361 	spin_unlock(&ip->i_flags_lock);
362 	return ret;
363 }
364 
365 /*
366  * Manage the i_flush queue embedded in the inode.  This completion
367  * queue synchronizes processes attempting to flush the in-core
368  * inode back to disk.
369  */
370 static inline void xfs_iflock(xfs_inode_t *ip)
371 {
372 	wait_for_completion(&ip->i_flush);
373 }
374 
375 static inline int xfs_iflock_nowait(xfs_inode_t *ip)
376 {
377 	return try_wait_for_completion(&ip->i_flush);
378 }
379 
380 static inline void xfs_ifunlock(xfs_inode_t *ip)
381 {
382 	complete(&ip->i_flush);
383 }
384 
385 /*
386  * In-core inode flags.
387  */
388 #define XFS_IRECLAIM    0x0001  /* we have started reclaiming this inode    */
389 #define XFS_ISTALE	0x0002	/* inode has been staled */
390 #define XFS_IRECLAIMABLE 0x0004 /* inode can be reclaimed */
391 #define XFS_INEW	0x0008	/* inode has just been allocated */
392 #define XFS_IFILESTREAM	0x0010	/* inode is in a filestream directory */
393 #define XFS_ITRUNCATED	0x0020	/* truncated down so flush-on-close */
394 
395 /*
396  * Flags for inode locking.
397  * Bit ranges:	1<<1  - 1<<16-1 -- iolock/ilock modes (bitfield)
398  *		1<<16 - 1<<32-1 -- lockdep annotation (integers)
399  */
400 #define	XFS_IOLOCK_EXCL		(1<<0)
401 #define	XFS_IOLOCK_SHARED	(1<<1)
402 #define	XFS_ILOCK_EXCL		(1<<2)
403 #define	XFS_ILOCK_SHARED	(1<<3)
404 #define	XFS_IUNLOCK_NONOTIFY	(1<<4)
405 
406 #define XFS_LOCK_MASK		(XFS_IOLOCK_EXCL | XFS_IOLOCK_SHARED \
407 				| XFS_ILOCK_EXCL | XFS_ILOCK_SHARED)
408 
409 /*
410  * Flags for lockdep annotations.
411  *
412  * XFS_I[O]LOCK_PARENT - for operations that require locking two inodes
413  * (ie directory operations that require locking a directory inode and
414  * an entry inode).  The first inode gets locked with this flag so it
415  * gets a lockdep subclass of 1 and the second lock will have a lockdep
416  * subclass of 0.
417  *
418  * XFS_LOCK_INUMORDER - for locking several inodes at the some time
419  * with xfs_lock_inodes().  This flag is used as the starting subclass
420  * and each subsequent lock acquired will increment the subclass by one.
421  * So the first lock acquired will have a lockdep subclass of 2, the
422  * second lock will have a lockdep subclass of 3, and so on. It is
423  * the responsibility of the class builder to shift this to the correct
424  * portion of the lock_mode lockdep mask.
425  */
426 #define XFS_LOCK_PARENT		1
427 #define XFS_LOCK_INUMORDER	2
428 
429 #define XFS_IOLOCK_SHIFT	16
430 #define	XFS_IOLOCK_PARENT	(XFS_LOCK_PARENT << XFS_IOLOCK_SHIFT)
431 
432 #define XFS_ILOCK_SHIFT		24
433 #define	XFS_ILOCK_PARENT	(XFS_LOCK_PARENT << XFS_ILOCK_SHIFT)
434 
435 #define XFS_IOLOCK_DEP_MASK	0x00ff0000
436 #define XFS_ILOCK_DEP_MASK	0xff000000
437 #define XFS_LOCK_DEP_MASK	(XFS_IOLOCK_DEP_MASK | XFS_ILOCK_DEP_MASK)
438 
439 #define XFS_IOLOCK_DEP(flags)	(((flags) & XFS_IOLOCK_DEP_MASK) >> XFS_IOLOCK_SHIFT)
440 #define XFS_ILOCK_DEP(flags)	(((flags) & XFS_ILOCK_DEP_MASK) >> XFS_ILOCK_SHIFT)
441 
442 /*
443  * Flags for xfs_iflush()
444  */
445 #define	XFS_IFLUSH_DELWRI_ELSE_SYNC	1
446 #define	XFS_IFLUSH_DELWRI_ELSE_ASYNC	2
447 #define	XFS_IFLUSH_SYNC			3
448 #define	XFS_IFLUSH_ASYNC		4
449 #define	XFS_IFLUSH_DELWRI		5
450 #define	XFS_IFLUSH_ASYNC_NOBLOCK	6
451 
452 /*
453  * Flags for xfs_itruncate_start().
454  */
455 #define	XFS_ITRUNC_DEFINITE	0x1
456 #define	XFS_ITRUNC_MAYBE	0x2
457 
458 /*
459  * For multiple groups support: if S_ISGID bit is set in the parent
460  * directory, group of new file is set to that of the parent, and
461  * new subdirectory gets S_ISGID bit from parent.
462  */
463 #define XFS_INHERIT_GID(pip)	\
464 	(((pip)->i_mount->m_flags & XFS_MOUNT_GRPID) || \
465 	 ((pip)->i_d.di_mode & S_ISGID))
466 
467 /*
468  * xfs_iget.c prototypes.
469  */
470 int		xfs_iget(struct xfs_mount *, struct xfs_trans *, xfs_ino_t,
471 			 uint, uint, xfs_inode_t **, xfs_daddr_t);
472 void		xfs_iput(xfs_inode_t *, uint);
473 void		xfs_iput_new(xfs_inode_t *, uint);
474 void		xfs_ilock(xfs_inode_t *, uint);
475 int		xfs_ilock_nowait(xfs_inode_t *, uint);
476 void		xfs_iunlock(xfs_inode_t *, uint);
477 void		xfs_ilock_demote(xfs_inode_t *, uint);
478 int		xfs_isilocked(xfs_inode_t *, uint);
479 uint		xfs_ilock_map_shared(xfs_inode_t *);
480 void		xfs_iunlock_map_shared(xfs_inode_t *, uint);
481 void		xfs_ireclaim(xfs_inode_t *);
482 
483 /*
484  * xfs_inode.c prototypes.
485  */
486 int		xfs_ialloc(struct xfs_trans *, xfs_inode_t *, mode_t,
487 			   xfs_nlink_t, xfs_dev_t, cred_t *, xfs_prid_t,
488 			   int, struct xfs_buf **, boolean_t *, xfs_inode_t **);
489 
490 uint		xfs_ip2xflags(struct xfs_inode *);
491 uint		xfs_dic2xflags(struct xfs_dinode *);
492 int		xfs_ifree(struct xfs_trans *, xfs_inode_t *,
493 			   struct xfs_bmap_free *);
494 int		xfs_itruncate_start(xfs_inode_t *, uint, xfs_fsize_t);
495 int		xfs_itruncate_finish(struct xfs_trans **, xfs_inode_t *,
496 				     xfs_fsize_t, int, int);
497 int		xfs_iunlink(struct xfs_trans *, xfs_inode_t *);
498 
499 void		xfs_iext_realloc(xfs_inode_t *, int, int);
500 void		xfs_ipin(xfs_inode_t *);
501 void		xfs_iunpin(xfs_inode_t *);
502 int		xfs_iflush(xfs_inode_t *, uint);
503 void		xfs_ichgtime(xfs_inode_t *, int);
504 void		xfs_lock_inodes(xfs_inode_t **, int, uint);
505 void		xfs_lock_two_inodes(xfs_inode_t *, xfs_inode_t *, uint);
506 
507 void		xfs_synchronize_times(xfs_inode_t *);
508 void		xfs_mark_inode_dirty_sync(xfs_inode_t *);
509 
510 #if defined(XFS_INODE_TRACE)
511 
512 #define	INODE_TRACE_SIZE	16		/* number of trace entries */
513 #define	INODE_KTRACE_ENTRY	1
514 #define	INODE_KTRACE_EXIT	2
515 #define	INODE_KTRACE_HOLD	3
516 #define	INODE_KTRACE_REF	4
517 #define	INODE_KTRACE_RELE	5
518 
519 extern void _xfs_itrace_entry(struct xfs_inode *, const char *, inst_t *);
520 extern void _xfs_itrace_exit(struct xfs_inode *, const char *, inst_t *);
521 extern void xfs_itrace_hold(struct xfs_inode *, char *, int, inst_t *);
522 extern void _xfs_itrace_ref(struct xfs_inode *, char *, int, inst_t *);
523 extern void xfs_itrace_rele(struct xfs_inode *, char *, int, inst_t *);
524 #define xfs_itrace_entry(ip)	\
525 	_xfs_itrace_entry(ip, __func__, (inst_t *)__return_address)
526 #define xfs_itrace_exit(ip)	\
527 	_xfs_itrace_exit(ip, __func__, (inst_t *)__return_address)
528 #define xfs_itrace_exit_tag(ip, tag)	\
529 	_xfs_itrace_exit(ip, tag, (inst_t *)__return_address)
530 #define xfs_itrace_ref(ip)	\
531 	_xfs_itrace_ref(ip, __FILE__, __LINE__, (inst_t *)__return_address)
532 
533 #else
534 #define	xfs_itrace_entry(a)
535 #define	xfs_itrace_exit(a)
536 #define	xfs_itrace_exit_tag(a, b)
537 #define	xfs_itrace_hold(a, b, c, d)
538 #define	xfs_itrace_ref(a)
539 #define	xfs_itrace_rele(a, b, c, d)
540 #endif
541 
542 #define IHOLD(ip) \
543 do { \
544 	ASSERT(atomic_read(&VFS_I(ip)->i_count) > 0) ; \
545 	atomic_inc(&(VFS_I(ip)->i_count)); \
546 	xfs_itrace_hold((ip), __FILE__, __LINE__, (inst_t *)__return_address); \
547 } while (0)
548 
549 #define IRELE(ip) \
550 do { \
551 	xfs_itrace_rele((ip), __FILE__, __LINE__, (inst_t *)__return_address); \
552 	iput(VFS_I(ip)); \
553 } while (0)
554 
555 #endif /* __KERNEL__ */
556 
557 /*
558  * Flags for xfs_iget()
559  */
560 #define XFS_IGET_CREATE		0x1
561 #define XFS_IGET_BULKSTAT	0x2
562 
563 int		xfs_inotobp(struct xfs_mount *, struct xfs_trans *,
564 			    xfs_ino_t, struct xfs_dinode **,
565 			    struct xfs_buf **, int *, uint);
566 int		xfs_itobp(struct xfs_mount *, struct xfs_trans *,
567 			  struct xfs_inode *, struct xfs_dinode **,
568 			  struct xfs_buf **, uint);
569 int		xfs_iread(struct xfs_mount *, struct xfs_trans *,
570 			  struct xfs_inode *, xfs_daddr_t, uint);
571 void		xfs_dinode_to_disk(struct xfs_dinode *,
572 				   struct xfs_icdinode *);
573 void		xfs_idestroy_fork(struct xfs_inode *, int);
574 void		xfs_idata_realloc(struct xfs_inode *, int, int);
575 void		xfs_iroot_realloc(struct xfs_inode *, int, int);
576 int		xfs_iread_extents(struct xfs_trans *, struct xfs_inode *, int);
577 int		xfs_iextents_copy(struct xfs_inode *, xfs_bmbt_rec_t *, int);
578 
579 xfs_bmbt_rec_host_t *xfs_iext_get_ext(xfs_ifork_t *, xfs_extnum_t);
580 void		xfs_iext_insert(xfs_ifork_t *, xfs_extnum_t, xfs_extnum_t,
581 				xfs_bmbt_irec_t *);
582 void		xfs_iext_add(xfs_ifork_t *, xfs_extnum_t, int);
583 void		xfs_iext_add_indirect_multi(xfs_ifork_t *, int, xfs_extnum_t, int);
584 void		xfs_iext_remove(xfs_ifork_t *, xfs_extnum_t, int);
585 void		xfs_iext_remove_inline(xfs_ifork_t *, xfs_extnum_t, int);
586 void		xfs_iext_remove_direct(xfs_ifork_t *, xfs_extnum_t, int);
587 void		xfs_iext_remove_indirect(xfs_ifork_t *, xfs_extnum_t, int);
588 void		xfs_iext_realloc_direct(xfs_ifork_t *, int);
589 void		xfs_iext_direct_to_inline(xfs_ifork_t *, xfs_extnum_t);
590 void		xfs_iext_inline_to_direct(xfs_ifork_t *, int);
591 void		xfs_iext_destroy(xfs_ifork_t *);
592 xfs_bmbt_rec_host_t *xfs_iext_bno_to_ext(xfs_ifork_t *, xfs_fileoff_t, int *);
593 xfs_ext_irec_t	*xfs_iext_bno_to_irec(xfs_ifork_t *, xfs_fileoff_t, int *);
594 xfs_ext_irec_t	*xfs_iext_idx_to_irec(xfs_ifork_t *, xfs_extnum_t *, int *, int);
595 void		xfs_iext_irec_init(xfs_ifork_t *);
596 xfs_ext_irec_t *xfs_iext_irec_new(xfs_ifork_t *, int);
597 void		xfs_iext_irec_remove(xfs_ifork_t *, int);
598 void		xfs_iext_irec_compact(xfs_ifork_t *);
599 void		xfs_iext_irec_compact_pages(xfs_ifork_t *);
600 void		xfs_iext_irec_compact_full(xfs_ifork_t *);
601 void		xfs_iext_irec_update_extoffs(xfs_ifork_t *, int, int);
602 
603 #define xfs_ipincount(ip)	((unsigned int) atomic_read(&ip->i_pincount))
604 
605 #ifdef DEBUG
606 void		xfs_isize_check(struct xfs_mount *, struct xfs_inode *,
607 				xfs_fsize_t);
608 #else	/* DEBUG */
609 #define xfs_isize_check(mp, ip, isize)
610 #endif	/* DEBUG */
611 
612 #if defined(DEBUG)
613 void		xfs_inobp_check(struct xfs_mount *, struct xfs_buf *);
614 #else
615 #define	xfs_inobp_check(mp, bp)
616 #endif /* DEBUG */
617 
618 extern struct kmem_zone	*xfs_ifork_zone;
619 extern struct kmem_zone	*xfs_inode_zone;
620 extern struct kmem_zone	*xfs_ili_zone;
621 
622 #endif	/* __XFS_INODE_H__ */
623