locking/lockdep: Provide a type check for lock_is_held
[linux-block.git] / fs / xfs / xfs_inode.h
CommitLineData
1da177e4 1/*
7b718769
NS
2 * Copyright (c) 2000-2003,2005 Silicon Graphics, Inc.
3 * All Rights Reserved.
1da177e4 4 *
7b718769
NS
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
1da177e4
LT
7 * published by the Free Software Foundation.
8 *
7b718769
NS
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.
1da177e4 13 *
7b718769
NS
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
1da177e4
LT
17 */
18#ifndef __XFS_INODE_H__
19#define __XFS_INODE_H__
20
1fd7115e 21#include "xfs_inode_buf.h"
5c4d97d0 22#include "xfs_inode_fork.h"
1da177e4 23
92bfc6e7 24/*
1fd7115e 25 * Kernel only inode definitions
92bfc6e7 26 */
1fd7115e
DC
27struct xfs_dinode;
28struct xfs_inode;
847fff5c 29struct xfs_buf;
310a75a3 30struct xfs_defer_ops;
847fff5c 31struct xfs_bmbt_irec;
847fff5c
BN
32struct xfs_inode_log_item;
33struct xfs_mount;
34struct xfs_trans;
35struct xfs_dquot;
36
1da177e4
LT
37typedef struct xfs_inode {
38 /* Inode linking and identification information. */
1da177e4 39 struct xfs_mount *i_mount; /* fs mount struct ptr */
1da177e4
LT
40 struct xfs_dquot *i_udquot; /* user dquot */
41 struct xfs_dquot *i_gdquot; /* group dquot */
92f8ff73 42 struct xfs_dquot *i_pdquot; /* project dquot */
1da177e4
LT
43
44 /* Inode location stuff */
45 xfs_ino_t i_ino; /* inode number (agno/agino)*/
92bfc6e7 46 struct xfs_imap i_imap; /* location for xfs_imap() */
1da177e4
LT
47
48 /* Extent information. */
49 xfs_ifork_t *i_afp; /* attribute fork pointer */
3993baeb 50 xfs_ifork_t *i_cowfp; /* copy on write extents */
1da177e4
LT
51 xfs_ifork_t i_df; /* data fork */
52
32c5483a
DC
53 /* operations vectors */
54 const struct xfs_dir_ops *d_ops; /* directory ops vector */
55
1da177e4 56 /* Transaction and locking information. */
1da177e4
LT
57 struct xfs_inode_log_item *i_itemp; /* logging information */
58 mrlock_t i_lock; /* inode lock */
59 mrlock_t i_iolock; /* inode IO lock */
653c60b6 60 mrlock_t i_mmaplock; /* inode mmap IO lock */
1da177e4 61 atomic_t i_pincount; /* inode pin count */
f273ab84 62 spinlock_t i_flags_lock; /* inode i_flags lock */
1da177e4 63 /* Miscellaneous state. */
49e4c70e 64 unsigned long i_flags; /* see defined flags below */
1da177e4
LT
65 unsigned int i_delayed_blks; /* count of delay alloc blks */
66
f8d55aa0 67 struct xfs_icdinode i_d; /* most of ondisk inode */
1da177e4 68
3993baeb
DW
69 xfs_extnum_t i_cnextents; /* # of extents in cow fork */
70 unsigned int i_cformat; /* format of cow fork */
71
bf904248
DC
72 /* VFS inode */
73 struct inode i_vnode; /* embedded VFS inode */
1da177e4
LT
74} xfs_inode_t;
75
01651646
DC
76/* Convert from vfs inode to xfs inode */
77static inline struct xfs_inode *XFS_I(struct inode *inode)
78{
bf904248 79 return container_of(inode, struct xfs_inode, i_vnode);
01651646
DC
80}
81
01651646
DC
82/* convert from xfs inode to vfs inode */
83static inline struct inode *VFS_I(struct xfs_inode *ip)
84{
bf904248 85 return &ip->i_vnode;
01651646 86}
01651646 87
ce7ae151
CH
88/*
89 * For regular files we only update the on-disk filesize when actually
90 * writing data back to disk. Until then only the copy in the VFS inode
91 * is uptodate.
92 */
93static inline xfs_fsize_t XFS_ISIZE(struct xfs_inode *ip)
94{
c19b3b05 95 if (S_ISREG(VFS_I(ip)->i_mode))
ce7ae151
CH
96 return i_size_read(VFS_I(ip));
97 return ip->i_d.di_size;
98}
99
6923e686
CH
100/*
101 * If this I/O goes past the on-disk inode size update it unless it would
102 * be past the current in-core inode size.
103 */
104static inline xfs_fsize_t
105xfs_new_eof(struct xfs_inode *ip, xfs_fsize_t new_size)
106{
107 xfs_fsize_t i_size = i_size_read(VFS_I(ip));
108
ce57bcf6 109 if (new_size > i_size || new_size < 0)
6923e686
CH
110 new_size = i_size;
111 return new_size > ip->i_d.di_size ? new_size : 0;
112}
113
7a18c386
DC
114/*
115 * i_flags helper functions
116 */
117static inline void
118__xfs_iflags_set(xfs_inode_t *ip, unsigned short flags)
119{
120 ip->i_flags |= flags;
121}
122
123static inline void
124xfs_iflags_set(xfs_inode_t *ip, unsigned short flags)
125{
126 spin_lock(&ip->i_flags_lock);
127 __xfs_iflags_set(ip, flags);
128 spin_unlock(&ip->i_flags_lock);
129}
130
131static inline void
132xfs_iflags_clear(xfs_inode_t *ip, unsigned short flags)
133{
134 spin_lock(&ip->i_flags_lock);
135 ip->i_flags &= ~flags;
136 spin_unlock(&ip->i_flags_lock);
137}
138
139static inline int
140__xfs_iflags_test(xfs_inode_t *ip, unsigned short flags)
141{
142 return (ip->i_flags & flags);
143}
144
145static inline int
146xfs_iflags_test(xfs_inode_t *ip, unsigned short flags)
147{
148 int ret;
149 spin_lock(&ip->i_flags_lock);
150 ret = __xfs_iflags_test(ip, flags);
151 spin_unlock(&ip->i_flags_lock);
152 return ret;
153}
09262b43
CH
154
155static inline int
156xfs_iflags_test_and_clear(xfs_inode_t *ip, unsigned short flags)
157{
158 int ret;
159
160 spin_lock(&ip->i_flags_lock);
161 ret = ip->i_flags & flags;
162 if (ret)
163 ip->i_flags &= ~flags;
164 spin_unlock(&ip->i_flags_lock);
165 return ret;
166}
1da177e4 167
474fce06
CH
168static inline int
169xfs_iflags_test_and_set(xfs_inode_t *ip, unsigned short flags)
170{
171 int ret;
172
173 spin_lock(&ip->i_flags_lock);
174 ret = ip->i_flags & flags;
175 if (!ret)
176 ip->i_flags |= flags;
177 spin_unlock(&ip->i_flags_lock);
178 return ret;
179}
180
6743099c
AM
181/*
182 * Project quota id helpers (previously projid was 16bit only
25985edc 183 * and using two 16bit values to hold new 32bit projid was chosen
6743099c
AM
184 * to retain compatibility with "old" filesystems).
185 */
186static inline prid_t
187xfs_get_projid(struct xfs_inode *ip)
188{
189 return (prid_t)ip->i_d.di_projid_hi << 16 | ip->i_d.di_projid_lo;
190}
191
192static inline void
193xfs_set_projid(struct xfs_inode *ip,
194 prid_t projid)
195{
196 ip->i_d.di_projid_hi = (__uint16_t) (projid >> 16);
197 ip->i_d.di_projid_lo = (__uint16_t) (projid & 0xffff);
198}
199
163467d3
ZYW
200static inline prid_t
201xfs_get_initial_prid(struct xfs_inode *dp)
202{
203 if (dp->i_d.di_flags & XFS_DIFLAG_PROJINHERIT)
204 return xfs_get_projid(dp);
205
206 return XFS_PROJID_DEFAULT;
207}
208
46eeb521
DW
209static inline bool xfs_is_reflink_inode(struct xfs_inode *ip)
210{
211 return ip->i_d.di_flags2 & XFS_DIFLAG2_REFLINK;
212}
213
1da177e4
LT
214/*
215 * In-core inode flags.
216 */
474fce06
CH
217#define XFS_IRECLAIM (1 << 0) /* started reclaiming this inode */
218#define XFS_ISTALE (1 << 1) /* inode has been staled */
219#define XFS_IRECLAIMABLE (1 << 2) /* inode can be reclaimed */
220#define XFS_INEW (1 << 3) /* inode has just been allocated */
474fce06
CH
221#define XFS_ITRUNCATED (1 << 5) /* truncated down so flush-on-close */
222#define XFS_IDIRTY_RELEASE (1 << 6) /* dirty release already seen */
223#define __XFS_IFLOCK_BIT 7 /* inode is being flushed right now */
224#define XFS_IFLOCK (1 << __XFS_IFLOCK_BIT)
f392e631
CH
225#define __XFS_IPINNED_BIT 8 /* wakeup key for zero pin count */
226#define XFS_IPINNED (1 << __XFS_IPINNED_BIT)
5132ba8f 227#define XFS_IDONTCACHE (1 << 9) /* don't cache the inode long term */
85a6e764 228#define XFS_IEOFBLOCKS (1 << 10)/* has the preallocblocks tag set */
17c12bcd
DW
229/*
230 * If this unlinked inode is in the middle of recovery, don't let drop_inode
231 * truncate and free the inode. This can happen if we iget the inode during
232 * log recovery to replay a bmap operation on the inode.
233 */
234#define XFS_IRECOVERY (1 << 11)
1da177e4 235
778e24bb
DC
236/*
237 * Per-lifetime flags need to be reset when re-using a reclaimable inode during
5132ba8f 238 * inode lookup. This prevents unintended behaviour on the new inode from
778e24bb
DC
239 * ocurring.
240 */
241#define XFS_IRECLAIM_RESET_FLAGS \
242 (XFS_IRECLAIMABLE | XFS_IRECLAIM | \
f37211c3 243 XFS_IDIRTY_RELEASE | XFS_ITRUNCATED)
778e24bb 244
474fce06
CH
245/*
246 * Synchronize processes attempting to flush the in-core inode back to disk.
247 */
248
98efe8af
BF
249static inline int xfs_isiflocked(struct xfs_inode *ip)
250{
251 return xfs_iflags_test(ip, XFS_IFLOCK);
252}
253
474fce06
CH
254extern void __xfs_iflock(struct xfs_inode *ip);
255
256static inline int xfs_iflock_nowait(struct xfs_inode *ip)
257{
258 return !xfs_iflags_test_and_set(ip, XFS_IFLOCK);
259}
260
261static inline void xfs_iflock(struct xfs_inode *ip)
262{
263 if (!xfs_iflock_nowait(ip))
264 __xfs_iflock(ip);
265}
266
267static inline void xfs_ifunlock(struct xfs_inode *ip)
268{
98efe8af 269 ASSERT(xfs_isiflocked(ip));
474fce06 270 xfs_iflags_clear(ip, XFS_IFLOCK);
311f08ac 271 smp_mb();
474fce06
CH
272 wake_up_bit(&ip->i_flags, __XFS_IFLOCK_BIT);
273}
274
1da177e4
LT
275/*
276 * Flags for inode locking.
f7c66ce3
LM
277 * Bit ranges: 1<<1 - 1<<16-1 -- iolock/ilock modes (bitfield)
278 * 1<<16 - 1<<32-1 -- lockdep annotation (integers)
1da177e4 279 */
f7c66ce3
LM
280#define XFS_IOLOCK_EXCL (1<<0)
281#define XFS_IOLOCK_SHARED (1<<1)
282#define XFS_ILOCK_EXCL (1<<2)
283#define XFS_ILOCK_SHARED (1<<3)
653c60b6
DC
284#define XFS_MMAPLOCK_EXCL (1<<4)
285#define XFS_MMAPLOCK_SHARED (1<<5)
1da177e4 286
f7c66ce3 287#define XFS_LOCK_MASK (XFS_IOLOCK_EXCL | XFS_IOLOCK_SHARED \
653c60b6
DC
288 | XFS_ILOCK_EXCL | XFS_ILOCK_SHARED \
289 | XFS_MMAPLOCK_EXCL | XFS_MMAPLOCK_SHARED)
f7c66ce3 290
0b1b213f
CH
291#define XFS_LOCK_FLAGS \
292 { XFS_IOLOCK_EXCL, "IOLOCK_EXCL" }, \
293 { XFS_IOLOCK_SHARED, "IOLOCK_SHARED" }, \
294 { XFS_ILOCK_EXCL, "ILOCK_EXCL" }, \
653c60b6
DC
295 { XFS_ILOCK_SHARED, "ILOCK_SHARED" }, \
296 { XFS_MMAPLOCK_EXCL, "MMAPLOCK_EXCL" }, \
297 { XFS_MMAPLOCK_SHARED, "MMAPLOCK_SHARED" }
0b1b213f
CH
298
299
f7c66ce3
LM
300/*
301 * Flags for lockdep annotations.
302 *
9681153b 303 * XFS_LOCK_PARENT - for directory operations that require locking a
0952c818
DC
304 * parent directory inode and a child entry inode. IOLOCK requires nesting,
305 * MMAPLOCK does not support this class, ILOCK requires a single subclass
306 * to differentiate parent from child.
9681153b
CH
307 *
308 * XFS_LOCK_RTBITMAP/XFS_LOCK_RTSUM - the realtime device bitmap and summary
309 * inodes do not participate in the normal lock order, and thus have their
310 * own subclasses.
f7c66ce3 311 *
0f1145cc 312 * XFS_LOCK_INUMORDER - for locking several inodes at the some time
f7c66ce3
LM
313 * with xfs_lock_inodes(). This flag is used as the starting subclass
314 * and each subsequent lock acquired will increment the subclass by one.
0952c818
DC
315 * However, MAX_LOCKDEP_SUBCLASSES == 8, which means we are greatly
316 * limited to the subclasses we can represent via nesting. We need at least
317 * 5 inodes nest depth for the ILOCK through rename, and we also have to support
318 * XFS_ILOCK_PARENT, which gives 6 subclasses. Then we have XFS_ILOCK_RTBITMAP
319 * and XFS_ILOCK_RTSUM, which are another 2 unique subclasses, so that's all
320 * 8 subclasses supported by lockdep.
321 *
322 * This also means we have to number the sub-classes in the lowest bits of
323 * the mask we keep, and we have to ensure we never exceed 3 bits of lockdep
324 * mask and we can't use bit-masking to build the subclasses. What a mess.
325 *
326 * Bit layout:
327 *
328 * Bit Lock Region
329 * 16-19 XFS_IOLOCK_SHIFT dependencies
330 * 20-23 XFS_MMAPLOCK_SHIFT dependencies
331 * 24-31 XFS_ILOCK_SHIFT dependencies
332 *
333 * IOLOCK values
334 *
335 * 0-3 subclass value
336 * 4-7 PARENT subclass values
337 *
338 * MMAPLOCK values
339 *
340 * 0-3 subclass value
341 * 4-7 unused
342 *
343 * ILOCK values
344 * 0-4 subclass values
345 * 5 PARENT subclass (not nestable)
346 * 6 RTBITMAP subclass (not nestable)
347 * 7 RTSUM subclass (not nestable)
348 *
f7c66ce3 349 */
0952c818
DC
350#define XFS_IOLOCK_SHIFT 16
351#define XFS_IOLOCK_PARENT_VAL 4
352#define XFS_IOLOCK_MAX_SUBCLASS (XFS_IOLOCK_PARENT_VAL - 1)
353#define XFS_IOLOCK_DEP_MASK 0x000f0000
354#define XFS_IOLOCK_PARENT (XFS_IOLOCK_PARENT_VAL << XFS_IOLOCK_SHIFT)
355
356#define XFS_MMAPLOCK_SHIFT 20
357#define XFS_MMAPLOCK_NUMORDER 0
358#define XFS_MMAPLOCK_MAX_SUBCLASS 3
359#define XFS_MMAPLOCK_DEP_MASK 0x00f00000
360
361#define XFS_ILOCK_SHIFT 24
362#define XFS_ILOCK_PARENT_VAL 5
363#define XFS_ILOCK_MAX_SUBCLASS (XFS_ILOCK_PARENT_VAL - 1)
364#define XFS_ILOCK_RTBITMAP_VAL 6
365#define XFS_ILOCK_RTSUM_VAL 7
366#define XFS_ILOCK_DEP_MASK 0xff000000
367#define XFS_ILOCK_PARENT (XFS_ILOCK_PARENT_VAL << XFS_ILOCK_SHIFT)
368#define XFS_ILOCK_RTBITMAP (XFS_ILOCK_RTBITMAP_VAL << XFS_ILOCK_SHIFT)
369#define XFS_ILOCK_RTSUM (XFS_ILOCK_RTSUM_VAL << XFS_ILOCK_SHIFT)
370
371#define XFS_LOCK_SUBCLASS_MASK (XFS_IOLOCK_DEP_MASK | \
653c60b6
DC
372 XFS_MMAPLOCK_DEP_MASK | \
373 XFS_ILOCK_DEP_MASK)
374
375#define XFS_IOLOCK_DEP(flags) (((flags) & XFS_IOLOCK_DEP_MASK) \
376 >> XFS_IOLOCK_SHIFT)
377#define XFS_MMAPLOCK_DEP(flags) (((flags) & XFS_MMAPLOCK_DEP_MASK) \
378 >> XFS_MMAPLOCK_SHIFT)
379#define XFS_ILOCK_DEP(flags) (((flags) & XFS_ILOCK_DEP_MASK) \
380 >> XFS_ILOCK_SHIFT)
1da177e4 381
1da177e4
LT
382/*
383 * For multiple groups support: if S_ISGID bit is set in the parent
384 * directory, group of new file is set to that of the parent, and
385 * new subdirectory gets S_ISGID bit from parent.
386 */
bd186aa9
CH
387#define XFS_INHERIT_GID(pip) \
388 (((pip)->i_mount->m_flags & XFS_MOUNT_GRPID) || \
c19b3b05 389 (VFS_I(pip)->i_mode & S_ISGID))
1da177e4 390
c24b5dfa 391int xfs_release(struct xfs_inode *ip);
74564fb4 392void xfs_inactive(struct xfs_inode *ip);
c24b5dfa
DC
393int xfs_lookup(struct xfs_inode *dp, struct xfs_name *name,
394 struct xfs_inode **ipp, struct xfs_name *ci_name);
395int xfs_create(struct xfs_inode *dp, struct xfs_name *name,
396 umode_t mode, xfs_dev_t rdev, struct xfs_inode **ipp);
99b6436b 397int xfs_create_tmpfile(struct xfs_inode *dp, struct dentry *dentry,
330033d6 398 umode_t mode, struct xfs_inode **ipp);
c24b5dfa
DC
399int xfs_remove(struct xfs_inode *dp, struct xfs_name *name,
400 struct xfs_inode *ip);
401int xfs_link(struct xfs_inode *tdp, struct xfs_inode *sip,
402 struct xfs_name *target_name);
403int xfs_rename(struct xfs_inode *src_dp, struct xfs_name *src_name,
404 struct xfs_inode *src_ip, struct xfs_inode *target_dp,
405 struct xfs_name *target_name,
d31a1825 406 struct xfs_inode *target_ip, unsigned int flags);
c24b5dfa 407
1da177e4
LT
408void xfs_ilock(xfs_inode_t *, uint);
409int xfs_ilock_nowait(xfs_inode_t *, uint);
410void xfs_iunlock(xfs_inode_t *, uint);
411void xfs_ilock_demote(xfs_inode_t *, uint);
579aa9ca 412int xfs_isilocked(xfs_inode_t *, uint);
309ecac8 413uint xfs_ilock_data_map_shared(struct xfs_inode *);
efa70be1 414uint xfs_ilock_attr_map_shared(struct xfs_inode *);
347d1c01 415
1da177e4 416uint xfs_ip2xflags(struct xfs_inode *);
1da177e4 417int xfs_ifree(struct xfs_trans *, xfs_inode_t *,
310a75a3 418 struct xfs_defer_ops *);
8f04c47a
CH
419int xfs_itruncate_extents(struct xfs_trans **, struct xfs_inode *,
420 int, xfs_fsize_t);
1da177e4 421void xfs_iext_realloc(xfs_inode_t *, int, int);
1fd7115e 422
777df5af 423void xfs_iunpin_wait(xfs_inode_t *);
1fd7115e
DC
424#define xfs_ipincount(ip) ((unsigned int) atomic_read(&ip->i_pincount))
425
4c46819a 426int xfs_iflush(struct xfs_inode *, struct xfs_buf **);
e1cccd91 427void xfs_lock_two_inodes(xfs_inode_t *, xfs_inode_t *, uint);
1da177e4 428
2a0ec1d9 429xfs_extlen_t xfs_get_extsz_hint(struct xfs_inode *ip);
f7ca3522 430xfs_extlen_t xfs_get_cowextsz_hint(struct xfs_inode *ip);
2a0ec1d9 431
e546cb79
DC
432int xfs_dir_ialloc(struct xfs_trans **, struct xfs_inode *, umode_t,
433 xfs_nlink_t, xfs_dev_t, prid_t, int,
434 struct xfs_inode **, int *);
e546cb79 435
c24b5dfa 436/* from xfs_file.c */
8add71ca
CH
437enum xfs_prealloc_flags {
438 XFS_PREALLOC_SET = (1 << 1),
439 XFS_PREALLOC_CLEAR = (1 << 2),
440 XFS_PREALLOC_SYNC = (1 << 3),
441 XFS_PREALLOC_INVISIBLE = (1 << 4),
442};
443
5885ebda
DC
444int xfs_update_prealloc_flags(struct xfs_inode *ip,
445 enum xfs_prealloc_flags flags);
446int xfs_zero_eof(struct xfs_inode *ip, xfs_off_t offset,
447 xfs_fsize_t isize, bool *did_zeroing);
7bb41db3
CH
448int xfs_zero_range(struct xfs_inode *ip, xfs_off_t pos, xfs_off_t count,
449 bool *did_zero);
8aa7d37e
ES
450loff_t __xfs_seek_hole_data(struct inode *inode, loff_t start,
451 loff_t eof, int whence);
c24b5dfa
DC
452
453
58c90473 454/* from xfs_iops.c */
2b3d1d41
CH
455extern void xfs_setup_inode(struct xfs_inode *ip);
456extern void xfs_setup_iops(struct xfs_inode *ip);
457
58c90473
DC
458/*
459 * When setting up a newly allocated inode, we need to call
460 * xfs_finish_inode_setup() once the inode is fully instantiated at
461 * the VFS level to prevent the rest of the world seeing the inode
462 * before we've completed instantiation. Otherwise we can do it
463 * the moment the inode lookup is complete.
464 */
58c90473
DC
465static inline void xfs_finish_inode_setup(struct xfs_inode *ip)
466{
467 xfs_iflags_clear(ip, XFS_INEW);
468 barrier();
469 unlock_new_inode(VFS_I(ip));
470}
471
472static inline void xfs_setup_existing_inode(struct xfs_inode *ip)
473{
474 xfs_setup_inode(ip);
2b3d1d41 475 xfs_setup_iops(ip);
58c90473
DC
476 xfs_finish_inode_setup(ip);
477}
478
5a8d0f3c
CH
479#define IHOLD(ip) \
480do { \
481 ASSERT(atomic_read(&VFS_I(ip)->i_count) > 0) ; \
7de9c6ee 482 ihold(VFS_I(ip)); \
0b1b213f 483 trace_xfs_ihold(ip, _THIS_IP_); \
5a8d0f3c
CH
484} while (0)
485
486#define IRELE(ip) \
487do { \
0b1b213f 488 trace_xfs_irele(ip, _THIS_IP_); \
5a8d0f3c
CH
489 iput(VFS_I(ip)); \
490} while (0)
491
1da177e4 492extern struct kmem_zone *xfs_inode_zone;
1da177e4 493
e153aa79
DW
494/* The default CoW extent size hint. */
495#define XFS_DEFAULT_COWEXTSZ_HINT 32
496
1da177e4 497#endif /* __XFS_INODE_H__ */