fs/xfs/xfs_inode.h

   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 char           i_update_size;  /* di_size field is dirty */
 265         unsigned int            i_delayed_blks; /* count of delay alloc blks */
 266
 267         xfs_icdinode_t          i_d;            /* most of ondisk inode */
 268
 269         xfs_fsize_t             i_size;         /* in-memory size */
 270         xfs_fsize_t             i_new_size;     /* size when write completes */
 271         atomic_t                i_iocount;      /* outstanding I/O count */
 272
 273         /* VFS inode */
 274         struct inode            i_vnode;        /* embedded VFS inode */
 275
 276         /* Trace buffers per inode. */
 277 #ifdef XFS_INODE_TRACE
 278         struct ktrace           *i_trace;       /* general inode trace */
 279 #endif
 280 #ifdef XFS_BMAP_TRACE
 281         struct ktrace           *i_xtrace;      /* inode extent list trace */
 282 #endif
 283 #ifdef XFS_BTREE_TRACE
 284         struct ktrace           *i_btrace;      /* inode bmap btree trace */
 285 #endif
 286 #ifdef XFS_RW_TRACE
 287         struct ktrace           *i_rwtrace;     /* inode read/write trace */
 288 #endif
 289 #ifdef XFS_ILOCK_TRACE
 290         struct ktrace           *i_lock_trace;  /* inode lock/unlock trace */
 291 #endif
 292 #ifdef XFS_DIR2_TRACE
 293         struct ktrace           *i_dir_trace;   /* inode directory trace */
 294 #endif
 295 } xfs_inode_t;
 296
 297 #define XFS_ISIZE(ip)   (((ip)->i_d.di_mode & S_IFMT) == S_IFREG) ? \
 298                                 (ip)->i_size : (ip)->i_d.di_size;
 299
 300 /* Convert from vfs inode to xfs inode */
 301 static inline struct xfs_inode *XFS_I(struct inode *inode)
 302 {
 303         return container_of(inode, struct xfs_inode, i_vnode);
 304 }
 305
 306 /* convert from xfs inode to vfs inode */
 307 static inline struct inode *VFS_I(struct xfs_inode *ip)
 308 {
 309         return &ip->i_vnode;
 310 }
 311
 312 /*
 313  * Get rid of a partially initialized inode.
 314  *
 315  * We have to go through destroy_inode to make sure allocations
 316  * from init_inode_always like the security data are undone.
 317  *
 318  * We mark the inode bad so that it takes the short cut in
 319  * the reclaim path instead of going through the flush path
 320  * which doesn't make sense for an inode that has never seen the
 321  * light of day.
 322  */
 323 static inline void xfs_destroy_inode(struct xfs_inode *ip)
 324 {
 325         make_bad_inode(VFS_I(ip));
 326         return destroy_inode(VFS_I(ip));
 327 }
 328
 329 /*
 330  * i_flags helper functions
 331  */
 332 static inline void
 333 __xfs_iflags_set(xfs_inode_t *ip, unsigned short flags)
 334 {
 335         ip->i_flags |= flags;
 336 }
 337
 338 static inline void
 339 xfs_iflags_set(xfs_inode_t *ip, unsigned short flags)
 340 {
 341         spin_lock(&ip->i_flags_lock);
 342         __xfs_iflags_set(ip, flags);
 343         spin_unlock(&ip->i_flags_lock);
 344 }
 345
 346 static inline void
 347 xfs_iflags_clear(xfs_inode_t *ip, unsigned short flags)
 348 {
 349         spin_lock(&ip->i_flags_lock);
 350         ip->i_flags &= ~flags;
 351         spin_unlock(&ip->i_flags_lock);
 352 }
 353
 354 static inline int
 355 __xfs_iflags_test(xfs_inode_t *ip, unsigned short flags)
 356 {
 357         return (ip->i_flags & flags);
 358 }
 359
 360 static inline int
 361 xfs_iflags_test(xfs_inode_t *ip, unsigned short flags)
 362 {
 363         int ret;
 364         spin_lock(&ip->i_flags_lock);
 365         ret = __xfs_iflags_test(ip, flags);
 366         spin_unlock(&ip->i_flags_lock);
 367         return ret;
 368 }
 369
 370 static inline int
 371 xfs_iflags_test_and_clear(xfs_inode_t *ip, unsigned short flags)
 372 {
 373         int ret;
 374
 375         spin_lock(&ip->i_flags_lock);
 376         ret = ip->i_flags & flags;
 377         if (ret)
 378                 ip->i_flags &= ~flags;
 379         spin_unlock(&ip->i_flags_lock);
 380         return ret;
 381 }
 382
 383 /*
 384  * Manage the i_flush queue embedded in the inode.  This completion
 385  * queue synchronizes processes attempting to flush the in-core
 386  * inode back to disk.
 387  */
 388 static inline void xfs_iflock(xfs_inode_t *ip)
 389 {
 390         wait_for_completion(&ip->i_flush);
 391 }
 392
 393 static inline int xfs_iflock_nowait(xfs_inode_t *ip)
 394 {
 395         return try_wait_for_completion(&ip->i_flush);
 396 }
 397
 398 static inline void xfs_ifunlock(xfs_inode_t *ip)
 399 {
 400         complete(&ip->i_flush);
 401 }
 402
 403 /*
 404  * In-core inode flags.
 405  */
 406 #define XFS_IRECLAIM    0x0001  /* we have started reclaiming this inode    */
 407 #define XFS_ISTALE      0x0002  /* inode has been staled */
 408 #define XFS_IRECLAIMABLE 0x0004 /* inode can be reclaimed */
 409 #define XFS_INEW        0x0008  /* inode has just been allocated */
 410 #define XFS_IFILESTREAM 0x0010  /* inode is in a filestream directory */
 411 #define XFS_ITRUNCATED  0x0020  /* truncated down so flush-on-close */
 412
 413 /*
 414  * Flags for inode locking.
 415  * Bit ranges:  1<<1  - 1<<16-1 -- iolock/ilock modes (bitfield)
 416  *              1<<16 - 1<<32-1 -- lockdep annotation (integers)
 417  */
 418 #define XFS_IOLOCK_EXCL         (1<<0)
 419 #define XFS_IOLOCK_SHARED       (1<<1)
 420 #define XFS_ILOCK_EXCL          (1<<2)
 421 #define XFS_ILOCK_SHARED        (1<<3)
 422 #define XFS_IUNLOCK_NONOTIFY    (1<<4)
 423
 424 #define XFS_LOCK_MASK           (XFS_IOLOCK_EXCL | XFS_IOLOCK_SHARED \
 425                                 | XFS_ILOCK_EXCL | XFS_ILOCK_SHARED)
 426
 427 /*
 428  * Flags for lockdep annotations.
 429  *
 430  * XFS_I[O]LOCK_PARENT - for operations that require locking two inodes
 431  * (ie directory operations that require locking a directory inode and
 432  * an entry inode).  The first inode gets locked with this flag so it
 433  * gets a lockdep subclass of 1 and the second lock will have a lockdep
 434  * subclass of 0.
 435  *
 436  * XFS_LOCK_INUMORDER - for locking several inodes at the some time
 437  * with xfs_lock_inodes().  This flag is used as the starting subclass
 438  * and each subsequent lock acquired will increment the subclass by one.
 439  * So the first lock acquired will have a lockdep subclass of 2, the
 440  * second lock will have a lockdep subclass of 3, and so on. It is
 441  * the responsibility of the class builder to shift this to the correct
 442  * portion of the lock_mode lockdep mask.
 443  */
 444 #define XFS_LOCK_PARENT         1
 445 #define XFS_LOCK_INUMORDER      2
 446
 447 #define XFS_IOLOCK_SHIFT        16
 448 #define XFS_IOLOCK_PARENT       (XFS_LOCK_PARENT << XFS_IOLOCK_SHIFT)
 449
 450 #define XFS_ILOCK_SHIFT         24
 451 #define XFS_ILOCK_PARENT        (XFS_LOCK_PARENT << XFS_ILOCK_SHIFT)
 452
 453 #define XFS_IOLOCK_DEP_MASK     0x00ff0000
 454 #define XFS_ILOCK_DEP_MASK      0xff000000
 455 #define XFS_LOCK_DEP_MASK       (XFS_IOLOCK_DEP_MASK | XFS_ILOCK_DEP_MASK)
 456
 457 #define XFS_IOLOCK_DEP(flags)   (((flags) & XFS_IOLOCK_DEP_MASK) >> XFS_IOLOCK_SHIFT)
 458 #define XFS_ILOCK_DEP(flags)    (((flags) & XFS_ILOCK_DEP_MASK) >> XFS_ILOCK_SHIFT)
 459
 460 /*
 461  * Flags for xfs_iflush()
 462  */
 463 #define XFS_IFLUSH_DELWRI_ELSE_SYNC     1
 464 #define XFS_IFLUSH_DELWRI_ELSE_ASYNC    2
 465 #define XFS_IFLUSH_SYNC                 3
 466 #define XFS_IFLUSH_ASYNC                4
 467 #define XFS_IFLUSH_DELWRI               5
 468 #define XFS_IFLUSH_ASYNC_NOBLOCK        6
 469
 470 /*
 471  * Flags for xfs_itruncate_start().
 472  */
 473 #define XFS_ITRUNC_DEFINITE     0x1
 474 #define XFS_ITRUNC_MAYBE        0x2
 475
 476 /*
 477  * For multiple groups support: if S_ISGID bit is set in the parent
 478  * directory, group of new file is set to that of the parent, and
 479  * new subdirectory gets S_ISGID bit from parent.
 480  */
 481 #define XFS_INHERIT_GID(pip)    \
 482         (((pip)->i_mount->m_flags & XFS_MOUNT_GRPID) || \
 483          ((pip)->i_d.di_mode & S_ISGID))
 484
 485 /*
 486  * xfs_iget.c prototypes.
 487  */
 488 xfs_inode_t     *xfs_inode_incore(struct xfs_mount *, xfs_ino_t,
 489                                   struct xfs_trans *);
 490 int             xfs_iget(struct xfs_mount *, struct xfs_trans *, xfs_ino_t,
 491                          uint, uint, xfs_inode_t **, xfs_daddr_t);
 492 void            xfs_iput(xfs_inode_t *, uint);
 493 void            xfs_iput_new(xfs_inode_t *, uint);
 494 void            xfs_ilock(xfs_inode_t *, uint);
 495 int             xfs_ilock_nowait(xfs_inode_t *, uint);
 496 void            xfs_iunlock(xfs_inode_t *, uint);
 497 void            xfs_ilock_demote(xfs_inode_t *, uint);
 498 int             xfs_isilocked(xfs_inode_t *, uint);
 499 uint            xfs_ilock_map_shared(xfs_inode_t *);
 500 void            xfs_iunlock_map_shared(xfs_inode_t *, uint);
 501 void            xfs_ireclaim(xfs_inode_t *);
 502
 503 /*
 504  * xfs_inode.c prototypes.
 505  */
 506 int             xfs_ialloc(struct xfs_trans *, xfs_inode_t *, mode_t,
 507                            xfs_nlink_t, xfs_dev_t, cred_t *, xfs_prid_t,
 508                            int, struct xfs_buf **, boolean_t *, xfs_inode_t **);
 509
 510 uint            xfs_ip2xflags(struct xfs_inode *);
 511 uint            xfs_dic2xflags(struct xfs_dinode *);
 512 int             xfs_ifree(struct xfs_trans *, xfs_inode_t *,
 513                            struct xfs_bmap_free *);
 514 int             xfs_itruncate_start(xfs_inode_t *, uint, xfs_fsize_t);
 515 int             xfs_itruncate_finish(struct xfs_trans **, xfs_inode_t *,
 516                                      xfs_fsize_t, int, int);
 517 int             xfs_iunlink(struct xfs_trans *, xfs_inode_t *);
 518
 519 void            xfs_iext_realloc(xfs_inode_t *, int, int);
 520 void            xfs_ipin(xfs_inode_t *);
 521 void            xfs_iunpin(xfs_inode_t *);
 522 int             xfs_iflush(xfs_inode_t *, uint);
 523 void            xfs_ichgtime(xfs_inode_t *, int);
 524 xfs_fsize_t     xfs_file_last_byte(xfs_inode_t *);
 525 void            xfs_lock_inodes(xfs_inode_t **, int, uint);
 526 void            xfs_lock_two_inodes(xfs_inode_t *, xfs_inode_t *, uint);
 527
 528 void            xfs_synchronize_atime(xfs_inode_t *);
 529 void            xfs_mark_inode_dirty_sync(xfs_inode_t *);
 530
 531 #if defined(XFS_INODE_TRACE)
 532
 533 #define INODE_TRACE_SIZE        16              /* number of trace entries */
 534 #define INODE_KTRACE_ENTRY      1
 535 #define INODE_KTRACE_EXIT       2
 536 #define INODE_KTRACE_HOLD       3
 537 #define INODE_KTRACE_REF        4
 538 #define INODE_KTRACE_RELE       5
 539
 540 extern void _xfs_itrace_entry(struct xfs_inode *, const char *, inst_t *);
 541 extern void _xfs_itrace_exit(struct xfs_inode *, const char *, inst_t *);
 542 extern void xfs_itrace_hold(struct xfs_inode *, char *, int, inst_t *);
 543 extern void _xfs_itrace_ref(struct xfs_inode *, char *, int, inst_t *);
 544 extern void xfs_itrace_rele(struct xfs_inode *, char *, int, inst_t *);
 545 #define xfs_itrace_entry(ip)    \
 546         _xfs_itrace_entry(ip, __func__, (inst_t *)__return_address)
 547 #define xfs_itrace_exit(ip)     \
 548         _xfs_itrace_exit(ip, __func__, (inst_t *)__return_address)
 549 #define xfs_itrace_exit_tag(ip, tag)    \
 550         _xfs_itrace_exit(ip, tag, (inst_t *)__return_address)
 551 #define xfs_itrace_ref(ip)      \
 552         _xfs_itrace_ref(ip, __FILE__, __LINE__, (inst_t *)__return_address)
 553
 554 #else
 555 #define xfs_itrace_entry(a)
 556 #define xfs_itrace_exit(a)
 557 #define xfs_itrace_exit_tag(a, b)
 558 #define xfs_itrace_hold(a, b, c, d)
 559 #define xfs_itrace_ref(a)
 560 #define xfs_itrace_rele(a, b, c, d)
 561 #endif
 562
 563 #define IHOLD(ip) \
 564 do { \
 565         ASSERT(atomic_read(&VFS_I(ip)->i_count) > 0) ; \
 566         atomic_inc(&(VFS_I(ip)->i_count)); \
 567         xfs_itrace_hold((ip), __FILE__, __LINE__, (inst_t *)__return_address); \
 568 } while (0)
 569
 570 #define IRELE(ip) \
 571 do { \
 572         xfs_itrace_rele((ip), __FILE__, __LINE__, (inst_t *)__return_address); \
 573         iput(VFS_I(ip)); \
 574 } while (0)
 575
 576 #endif /* __KERNEL__ */
 577
 578 /*
 579  * Flags for xfs_iget()
 580  */
 581 #define XFS_IGET_CREATE         0x1
 582 #define XFS_IGET_BULKSTAT       0x2
 583
 584 int             xfs_inotobp(struct xfs_mount *, struct xfs_trans *,
 585                             xfs_ino_t, struct xfs_dinode **,
 586                             struct xfs_buf **, int *, uint);
 587 int             xfs_itobp(struct xfs_mount *, struct xfs_trans *,
 588                           struct xfs_inode *, struct xfs_dinode **,
 589                           struct xfs_buf **, uint);
 590 int             xfs_iread(struct xfs_mount *, struct xfs_trans *,
 591                           struct xfs_inode *, xfs_daddr_t, uint);
 592 void            xfs_dinode_from_disk(struct xfs_icdinode *,
 593                                      struct xfs_dinode *);
 594 void            xfs_dinode_to_disk(struct xfs_dinode *,
 595                                    struct xfs_icdinode *);
 596 void            xfs_idestroy_fork(struct xfs_inode *, int);
 597 void            xfs_idata_realloc(struct xfs_inode *, int, int);
 598 void            xfs_iroot_realloc(struct xfs_inode *, int, int);
 599 int             xfs_iread_extents(struct xfs_trans *, struct xfs_inode *, int);
 600 int             xfs_iextents_copy(struct xfs_inode *, xfs_bmbt_rec_t *, int);
 601
 602 xfs_bmbt_rec_host_t *xfs_iext_get_ext(xfs_ifork_t *, xfs_extnum_t);
 603 void            xfs_iext_insert(xfs_ifork_t *, xfs_extnum_t, xfs_extnum_t,
 604                                 xfs_bmbt_irec_t *);
 605 void            xfs_iext_add(xfs_ifork_t *, xfs_extnum_t, int);
 606 void            xfs_iext_add_indirect_multi(xfs_ifork_t *, int, xfs_extnum_t, int);
 607 void            xfs_iext_remove(xfs_ifork_t *, xfs_extnum_t, int);
 608 void            xfs_iext_remove_inline(xfs_ifork_t *, xfs_extnum_t, int);
 609 void            xfs_iext_remove_direct(xfs_ifork_t *, xfs_extnum_t, int);
 610 void            xfs_iext_remove_indirect(xfs_ifork_t *, xfs_extnum_t, int);
 611 void            xfs_iext_realloc_direct(xfs_ifork_t *, int);
 612 void            xfs_iext_realloc_indirect(xfs_ifork_t *, int);
 613 void            xfs_iext_indirect_to_direct(xfs_ifork_t *);
 614 void            xfs_iext_direct_to_inline(xfs_ifork_t *, xfs_extnum_t);
 615 void            xfs_iext_inline_to_direct(xfs_ifork_t *, int);
 616 void            xfs_iext_destroy(xfs_ifork_t *);
 617 xfs_bmbt_rec_host_t *xfs_iext_bno_to_ext(xfs_ifork_t *, xfs_fileoff_t, int *);
 618 xfs_ext_irec_t  *xfs_iext_bno_to_irec(xfs_ifork_t *, xfs_fileoff_t, int *);
 619 xfs_ext_irec_t  *xfs_iext_idx_to_irec(xfs_ifork_t *, xfs_extnum_t *, int *, int);
 620 void            xfs_iext_irec_init(xfs_ifork_t *);
 621 xfs_ext_irec_t *xfs_iext_irec_new(xfs_ifork_t *, int);
 622 void            xfs_iext_irec_remove(xfs_ifork_t *, int);
 623 void            xfs_iext_irec_compact(xfs_ifork_t *);
 624 void            xfs_iext_irec_compact_pages(xfs_ifork_t *);
 625 void            xfs_iext_irec_compact_full(xfs_ifork_t *);
 626 void            xfs_iext_irec_update_extoffs(xfs_ifork_t *, int, int);
 627
 628 #define xfs_ipincount(ip)       ((unsigned int) atomic_read(&ip->i_pincount))
 629
 630 #ifdef DEBUG
 631 void            xfs_isize_check(struct xfs_mount *, struct xfs_inode *,
 632                                 xfs_fsize_t);
 633 #else   /* DEBUG */
 634 #define xfs_isize_check(mp, ip, isize)
 635 #endif  /* DEBUG */
 636
 637 #if defined(DEBUG)
 638 void            xfs_inobp_check(struct xfs_mount *, struct xfs_buf *);
 639 #else
 640 #define xfs_inobp_check(mp, bp)
 641 #endif /* DEBUG */
 642
 643 extern struct kmem_zone *xfs_ifork_zone;
 644 extern struct kmem_zone *xfs_inode_zone;
 645 extern struct kmem_zone *xfs_ili_zone;
 646
 647 #endif  /* __XFS_INODE_H__ */