fs/xfs/xfs_iget.c

   1 /*
   2  * Copyright (c) 2000-2003 Silicon Graphics, Inc.  All Rights Reserved.
   3  *
   4  * This program is free software; you can redistribute it and/or modify it
   5  * under the terms of version 2 of the GNU General Public License as
   6  * published by the Free Software Foundation.
   7  *
   8  * This program is distributed in the hope that it would be useful, but
   9  * WITHOUT ANY WARRANTY; without even the implied warranty of
  10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  11  *
  12  * Further, this software is distributed without any warranty that it is
  13  * free of the rightful claim of any third person regarding infringement
  14  * or the like.  Any license provided herein, whether implied or
  15  * otherwise, applies only to this software file.  Patent licenses, if
  16  * any, provided herein do not apply to combinations of this program with
  17  * other software, or any other product whatsoever.
  18  *
  19  * You should have received a copy of the GNU General Public License along
  20  * with this program; if not, write the Free Software Foundation, Inc., 59
  21  * Temple Place - Suite 330, Boston MA 02111-1307, USA.
  22  *
  23  * Contact information: Silicon Graphics, Inc., 1600 Amphitheatre Pkwy,
  24  * Mountain View, CA  94043, or:
  25  *
  26  * http://www.sgi.com
  27  *
  28  * For further information regarding this notice, see:
  29  *
  30  * http://oss.sgi.com/projects/GenInfo/SGIGPLNoticeExplan/
  31  */
  32
  33 #include "xfs.h"
  34
  35 #include "xfs_macros.h"
  36 #include "xfs_types.h"
  37 #include "xfs_inum.h"
  38 #include "xfs_log.h"
  39 #include "xfs_trans.h"
  40 #include "xfs_sb.h"
  41 #include "xfs_ag.h"
  42 #include "xfs_dir.h"
  43 #include "xfs_dir2.h"
  44 #include "xfs_dmapi.h"
  45 #include "xfs_mount.h"
  46 #include "xfs_alloc_btree.h"
  47 #include "xfs_bmap_btree.h"
  48 #include "xfs_ialloc_btree.h"
  49 #include "xfs_btree.h"
  50 #include "xfs_ialloc.h"
  51 #include "xfs_attr_sf.h"
  52 #include "xfs_dir_sf.h"
  53 #include "xfs_dir2_sf.h"
  54 #include "xfs_dinode.h"
  55 #include "xfs_inode.h"
  56 #include "xfs_quota.h"
  57 #include "xfs_utils.h"
  58
  59 /*
  60  * Initialize the inode hash table for the newly mounted file system.
  61  *
  62  * mp -- this is the mount point structure for the file system being
  63  *       initialized
  64  */
  65 void
  66 xfs_ihash_init(xfs_mount_t *mp)
  67 {
  68         int     i;
  69
  70         mp->m_ihsize = XFS_BUCKETS(mp);
  71         mp->m_ihash = (xfs_ihash_t *)kmem_zalloc(mp->m_ihsize
  72                                       * sizeof(xfs_ihash_t), KM_SLEEP);
  73         ASSERT(mp->m_ihash != NULL);
  74         for (i = 0; i < mp->m_ihsize; i++) {
  75                 rwlock_init(&(mp->m_ihash[i].ih_lock));
  76         }
  77 }
  78
  79 /*
  80  * Free up structures allocated by xfs_ihash_init, at unmount time.
  81  */
  82 void
  83 xfs_ihash_free(xfs_mount_t *mp)
  84 {
  85         kmem_free(mp->m_ihash, mp->m_ihsize*sizeof(xfs_ihash_t));
  86         mp->m_ihash = NULL;
  87 }
  88
  89 /*
  90  * Initialize the inode cluster hash table for the newly mounted file system.
  91  *
  92  * mp -- this is the mount point structure for the file system being
  93  *       initialized
  94  */
  95 void
  96 xfs_chash_init(xfs_mount_t *mp)
  97 {
  98         int     i;
  99
 100         /*
 101          * m_chash size is based on m_ihash
 102          * with a minimum of 37 entries
 103          */
 104         mp->m_chsize = (XFS_BUCKETS(mp)) /
 105                          (XFS_INODE_CLUSTER_SIZE(mp) >> mp->m_sb.sb_inodelog);
 106         if (mp->m_chsize < 37) {
 107                 mp->m_chsize = 37;
 108         }
 109         mp->m_chash = (xfs_chash_t *)kmem_zalloc(mp->m_chsize
 110                                                  * sizeof(xfs_chash_t),
 111                                                  KM_SLEEP);
 112         ASSERT(mp->m_chash != NULL);
 113
 114         for (i = 0; i < mp->m_chsize; i++) {
 115                 spinlock_init(&mp->m_chash[i].ch_lock,"xfshash");
 116         }
 117 }
 118
 119 /*
 120  * Free up structures allocated by xfs_chash_init, at unmount time.
 121  */
 122 void
 123 xfs_chash_free(xfs_mount_t *mp)
 124 {
 125         int     i;
 126
 127         for (i = 0; i < mp->m_chsize; i++) {
 128                 spinlock_destroy(&mp->m_chash[i].ch_lock);
 129         }
 130
 131         kmem_free(mp->m_chash, mp->m_chsize*sizeof(xfs_chash_t));
 132         mp->m_chash = NULL;
 133 }
 134
 135 /*
 136  * Look up an inode by number in the given file system.
 137  * The inode is looked up in the hash table for the file system
 138  * represented by the mount point parameter mp.  Each bucket of
 139  * the hash table is guarded by an individual semaphore.
 140  *
 141  * If the inode is found in the hash table, its corresponding vnode
 142  * is obtained with a call to vn_get().  This call takes care of
 143  * coordination with the reclamation of the inode and vnode.  Note
 144  * that the vmap structure is filled in while holding the hash lock.
 145  * This gives us the state of the inode/vnode when we found it and
 146  * is used for coordination in vn_get().
 147  *
 148  * If it is not in core, read it in from the file system's device and
 149  * add the inode into the hash table.
 150  *
 151  * The inode is locked according to the value of the lock_flags parameter.
 152  * This flag parameter indicates how and if the inode's IO lock and inode lock
 153  * should be taken.
 154  *
 155  * mp -- the mount point structure for the current file system.  It points
 156  *       to the inode hash table.
 157  * tp -- a pointer to the current transaction if there is one.  This is
 158  *       simply passed through to the xfs_iread() call.
 159  * ino -- the number of the inode desired.  This is the unique identifier
 160  *        within the file system for the inode being requested.
 161  * lock_flags -- flags indicating how to lock the inode.  See the comment
 162  *               for xfs_ilock() for a list of valid values.
 163  * bno -- the block number starting the buffer containing the inode,
 164  *        if known (as by bulkstat), else 0.
 165  */
 166 STATIC int
 167 xfs_iget_core(
 168         vnode_t         *vp,
 169         xfs_mount_t     *mp,
 170         xfs_trans_t     *tp,
 171         xfs_ino_t       ino,
 172         uint            lock_flags,
 173         xfs_inode_t     **ipp,
 174         xfs_daddr_t     bno)
 175 {
 176         xfs_ihash_t     *ih;
 177         xfs_inode_t     *ip;
 178         xfs_inode_t     *iq;
 179         vnode_t         *inode_vp;
 180         ulong           version;
 181         int             error;
 182         /* REFERENCED */
 183         int             newnode;
 184         xfs_chash_t     *ch;
 185         xfs_chashlist_t *chl, *chlnew;
 186         SPLDECL(s);
 187
 188
 189         ih = XFS_IHASH(mp, ino);
 190
 191 again:
 192         read_lock(&ih->ih_lock);
 193
 194         for (ip = ih->ih_next; ip != NULL; ip = ip->i_next) {
 195                 if (ip->i_ino == ino) {
 196
 197                         inode_vp = XFS_ITOV_NULL(ip);
 198
 199                         if (inode_vp == NULL) {
 200                                 /* If IRECLAIM is set this inode is
 201                                  * on its way out of the system,
 202                                  * we need to pause and try again.
 203                                  */
 204                                 if (ip->i_flags & XFS_IRECLAIM) {
 205                                         read_unlock(&ih->ih_lock);
 206                                         delay(1);
 207                                         XFS_STATS_INC(xs_ig_frecycle);
 208
 209                                         goto again;
 210                                 }
 211
 212                                 vn_trace_exit(vp, "xfs_iget.alloc",
 213                                         (inst_t *)__return_address);
 214
 215                                 XFS_STATS_INC(xs_ig_found);
 216
 217                                 ip->i_flags &= ~XFS_IRECLAIMABLE;
 218                                 read_unlock(&ih->ih_lock);
 219
 220                                 XFS_MOUNT_ILOCK(mp);
 221                                 list_del_init(&ip->i_reclaim);
 222                                 XFS_MOUNT_IUNLOCK(mp);
 223
 224                                 goto finish_inode;
 225
 226                         } else if (vp != inode_vp) {
 227                                 struct inode *inode = LINVFS_GET_IP(inode_vp);
 228
 229                                 /* The inode is being torn down, pause and
 230                                  * try again.
 231                                  */
 232                                 if (inode->i_state & (I_FREEING | I_CLEAR)) {
 233                                         read_unlock(&ih->ih_lock);
 234                                         delay(1);
 235                                         XFS_STATS_INC(xs_ig_frecycle);
 236
 237                                         goto again;
 238                                 }
 239 /* Chances are the other vnode (the one in the inode) is being torn
 240  * down right now, and we landed on top of it. Question is, what do
 241  * we do? Unhook the old inode and hook up the new one?
 242  */
 243                                 cmn_err(CE_PANIC,
 244                         "xfs_iget_core: ambiguous vns: vp/0x%p, invp/0x%p",
 245                                                 inode_vp, vp);
 246                         }
 247
 248                         read_unlock(&ih->ih_lock);
 249
 250                         XFS_STATS_INC(xs_ig_found);
 251
 252 finish_inode:
 253                         if (lock_flags != 0) {
 254                                 xfs_ilock(ip, lock_flags);
 255                         }
 256
 257                         newnode = (ip->i_d.di_mode == 0);
 258                         if (newnode) {
 259                                 xfs_iocore_inode_reinit(ip);
 260                         }
 261                         ip->i_flags &= ~XFS_ISTALE;
 262
 263                         vn_trace_exit(vp, "xfs_iget.found",
 264                                                 (inst_t *)__return_address);
 265                         goto return_ip;
 266                 }
 267         }
 268
 269         /*
 270          * Inode cache miss: save the hash chain version stamp and unlock
 271          * the chain, so we don't deadlock in vn_alloc.
 272          */
 273         XFS_STATS_INC(xs_ig_missed);
 274
 275         version = ih->ih_version;
 276
 277         read_unlock(&ih->ih_lock);
 278
 279         /*
 280          * Read the disk inode attributes into a new inode structure and get
 281          * a new vnode for it. This should also initialize i_ino and i_mount.
 282          */
 283         error = xfs_iread(mp, tp, ino, &ip, bno);
 284         if (error) {
 285                 return error;
 286         }
 287
 288         vn_trace_exit(vp, "xfs_iget.alloc", (inst_t *)__return_address);
 289
 290         xfs_inode_lock_init(ip, vp);
 291         xfs_iocore_inode_init(ip);
 292
 293         if (lock_flags != 0) {
 294                 xfs_ilock(ip, lock_flags);
 295         }
 296
 297         /*
 298          * Put ip on its hash chain, unless someone else hashed a duplicate
 299          * after we released the hash lock.
 300          */
 301         write_lock(&ih->ih_lock);
 302
 303         if (ih->ih_version != version) {
 304                 for (iq = ih->ih_next; iq != NULL; iq = iq->i_next) {
 305                         if (iq->i_ino == ino) {
 306                                 write_unlock(&ih->ih_lock);
 307                                 xfs_idestroy(ip);
 308
 309                                 XFS_STATS_INC(xs_ig_dup);
 310                                 goto again;
 311                         }
 312                 }
 313         }
 314
 315         /*
 316          * These values _must_ be set before releasing ihlock!
 317          */
 318         ip->i_hash = ih;
 319         if ((iq = ih->ih_next)) {
 320                 iq->i_prevp = &ip->i_next;
 321         }
 322         ip->i_next = iq;
 323         ip->i_prevp = &ih->ih_next;
 324         ih->ih_next = ip;
 325         ip->i_udquot = ip->i_gdquot = NULL;
 326         ih->ih_version++;
 327
 328         write_unlock(&ih->ih_lock);
 329
 330         /*
 331          * put ip on its cluster's hash chain
 332          */
 333         ASSERT(ip->i_chash == NULL && ip->i_cprev == NULL &&
 334                ip->i_cnext == NULL);
 335
 336         chlnew = NULL;
 337         ch = XFS_CHASH(mp, ip->i_blkno);
 338  chlredo:
 339         s = mutex_spinlock(&ch->ch_lock);
 340         for (chl = ch->ch_list; chl != NULL; chl = chl->chl_next) {
 341                 if (chl->chl_blkno == ip->i_blkno) {
 342
 343                         /* insert this inode into the doubly-linked list
 344                          * where chl points */
 345                         if ((iq = chl->chl_ip)) {
 346                                 ip->i_cprev = iq->i_cprev;
 347                                 iq->i_cprev->i_cnext = ip;
 348                                 iq->i_cprev = ip;
 349                                 ip->i_cnext = iq;
 350                         } else {
 351                                 ip->i_cnext = ip;
 352                                 ip->i_cprev = ip;
 353                         }
 354                         chl->chl_ip = ip;
 355                         ip->i_chash = chl;
 356                         break;
 357                 }
 358         }
 359
 360         /* no hash list found for this block; add a new hash list */
 361         if (chl == NULL)  {
 362                 if (chlnew == NULL) {
 363                         mutex_spinunlock(&ch->ch_lock, s);
 364                         ASSERT(xfs_chashlist_zone != NULL);
 365                         chlnew = (xfs_chashlist_t *)
 366                                         kmem_zone_alloc(xfs_chashlist_zone,
 367                                                 KM_SLEEP);
 368                         ASSERT(chlnew != NULL);
 369                         goto chlredo;
 370                 } else {
 371                         ip->i_cnext = ip;
 372                         ip->i_cprev = ip;
 373                         ip->i_chash = chlnew;
 374                         chlnew->chl_ip = ip;
 375                         chlnew->chl_blkno = ip->i_blkno;
 376                         chlnew->chl_next = ch->ch_list;
 377                         ch->ch_list = chlnew;
 378                         chlnew = NULL;
 379                 }
 380         } else {
 381                 if (chlnew != NULL) {
 382                         kmem_zone_free(xfs_chashlist_zone, chlnew);
 383                 }
 384         }
 385
 386         mutex_spinunlock(&ch->ch_lock, s);
 387
 388
 389         /*
 390          * Link ip to its mount and thread it on the mount's inode list.
 391          */
 392         XFS_MOUNT_ILOCK(mp);
 393         if ((iq = mp->m_inodes)) {
 394                 ASSERT(iq->i_mprev->i_mnext == iq);
 395                 ip->i_mprev = iq->i_mprev;
 396                 iq->i_mprev->i_mnext = ip;
 397                 iq->i_mprev = ip;
 398                 ip->i_mnext = iq;
 399         } else {
 400                 ip->i_mnext = ip;
 401                 ip->i_mprev = ip;
 402         }
 403         mp->m_inodes = ip;
 404
 405         XFS_MOUNT_IUNLOCK(mp);
 406
 407         newnode = 1;
 408
 409  return_ip:
 410         ASSERT(ip->i_df.if_ext_max ==
 411                XFS_IFORK_DSIZE(ip) / sizeof(xfs_bmbt_rec_t));
 412
 413         ASSERT(((ip->i_d.di_flags & XFS_DIFLAG_REALTIME) != 0) ==
 414                ((ip->i_iocore.io_flags & XFS_IOCORE_RT) != 0));
 415
 416         *ipp = ip;
 417
 418         /*
 419          * If we have a real type for an on-disk inode, we can set ops(&unlock)
 420          * now.  If it's a new inode being created, xfs_ialloc will handle it.
 421          */
 422         VFS_INIT_VNODE(XFS_MTOVFS(mp), vp, XFS_ITOBHV(ip), 1);
 423
 424         return 0;
 425 }
 426
 427
 428 /*
 429  * The 'normal' internal xfs_iget, if needed it will
 430  * 'allocate', or 'get', the vnode.
 431  */
 432 int
 433 xfs_iget(
 434         xfs_mount_t     *mp,
 435         xfs_trans_t     *tp,
 436         xfs_ino_t       ino,
 437         uint            lock_flags,
 438         xfs_inode_t     **ipp,
 439         xfs_daddr_t     bno)
 440 {
 441         struct inode    *inode;
 442         vnode_t         *vp = NULL;
 443         int             error;
 444
 445 retry:
 446         XFS_STATS_INC(xs_ig_attempts);
 447
 448         if ((inode = iget_locked(XFS_MTOVFS(mp)->vfs_super, ino))) {
 449                 bhv_desc_t      *bdp;
 450                 xfs_inode_t     *ip;
 451                 int             newnode;
 452
 453                 vp = LINVFS_GET_VP(inode);
 454                 if (inode->i_state & I_NEW) {
 455 inode_allocate:
 456                         vn_initialize(inode);
 457                         error = xfs_iget_core(vp, mp, tp, ino,
 458                                                 lock_flags, ipp, bno);
 459                         if (error) {
 460                                 make_bad_inode(inode);
 461                                 if (inode->i_state & I_NEW)
 462                                         unlock_new_inode(inode);
 463                                 iput(inode);
 464                         }
 465                 } else {
 466                         /* These are true if the inode is in inactive or
 467                          * reclaim. The linux inode is about to go away,
 468                          * wait for that path to finish, and try again.
 469                          */
 470                         if (vp->v_flag & (VINACT | VRECLM)) {
 471                                 vn_wait(vp);
 472                                 iput(inode);
 473                                 goto retry;
 474                         }
 475
 476                         bdp = vn_bhv_lookup(VN_BHV_HEAD(vp), &xfs_vnodeops);
 477                         if (bdp == NULL) {
 478                                 XFS_STATS_INC(xs_ig_dup);
 479                                 goto inode_allocate;
 480                         }
 481                         ip = XFS_BHVTOI(bdp);
 482                         if (lock_flags != 0)
 483                                 xfs_ilock(ip, lock_flags);
 484                         newnode = (ip->i_d.di_mode == 0);
 485                         if (newnode)
 486                                 xfs_iocore_inode_reinit(ip);
 487                         XFS_STATS_INC(xs_ig_found);
 488                         *ipp = ip;
 489                         error = 0;
 490                 }
 491         } else
 492                 error = ENOMEM; /* If we got no inode we are out of memory */
 493
 494         return error;
 495 }
 496
 497 /*
 498  * Do the setup for the various locks within the incore inode.
 499  */
 500 void
 501 xfs_inode_lock_init(
 502         xfs_inode_t     *ip,
 503         vnode_t         *vp)
 504 {
 505         mrlock_init(&ip->i_lock, MRLOCK_ALLOW_EQUAL_PRI|MRLOCK_BARRIER,
 506                      "xfsino", (long)vp->v_number);
 507         mrlock_init(&ip->i_iolock, MRLOCK_BARRIER, "xfsio", vp->v_number);
 508         init_waitqueue_head(&ip->i_ipin_wait);
 509         atomic_set(&ip->i_pincount, 0);
 510         init_sema(&ip->i_flock, 1, "xfsfino", vp->v_number);
 511 }
 512
 513 /*
 514  * Look for the inode corresponding to the given ino in the hash table.
 515  * If it is there and its i_transp pointer matches tp, return it.
 516  * Otherwise, return NULL.
 517  */
 518 xfs_inode_t *
 519 xfs_inode_incore(xfs_mount_t    *mp,
 520                  xfs_ino_t      ino,
 521                  xfs_trans_t    *tp)
 522 {
 523         xfs_ihash_t     *ih;
 524         xfs_inode_t     *ip;
 525
 526         ih = XFS_IHASH(mp, ino);
 527         read_lock(&ih->ih_lock);
 528         for (ip = ih->ih_next; ip != NULL; ip = ip->i_next) {
 529                 if (ip->i_ino == ino) {
 530                         /*
 531                          * If we find it and tp matches, return it.
 532                          * Otherwise break from the loop and return
 533                          * NULL.
 534                          */
 535                         if (ip->i_transp == tp) {
 536                                 read_unlock(&ih->ih_lock);
 537                                 return (ip);
 538                         }
 539                         break;
 540                 }
 541         }
 542         read_unlock(&ih->ih_lock);
 543         return (NULL);
 544 }
 545
 546 /*
 547  * Decrement reference count of an inode structure and unlock it.
 548  *
 549  * ip -- the inode being released
 550  * lock_flags -- this parameter indicates the inode's locks to be
 551  *       to be released.  See the comment on xfs_iunlock() for a list
 552  *       of valid values.
 553  */
 554 void
 555 xfs_iput(xfs_inode_t    *ip,
 556          uint           lock_flags)
 557 {
 558         vnode_t *vp = XFS_ITOV(ip);
 559
 560         vn_trace_entry(vp, "xfs_iput", (inst_t *)__return_address);
 561
 562         xfs_iunlock(ip, lock_flags);
 563
 564         VN_RELE(vp);
 565 }
 566
 567 /*
 568  * Special iput for brand-new inodes that are still locked
 569  */
 570 void
 571 xfs_iput_new(xfs_inode_t        *ip,
 572              uint               lock_flags)
 573 {
 574         vnode_t         *vp = XFS_ITOV(ip);
 575         struct inode    *inode = LINVFS_GET_IP(vp);
 576
 577         vn_trace_entry(vp, "xfs_iput_new", (inst_t *)__return_address);
 578
 579         /* We shouldn't get here without this being true, but just in case */
 580         if (inode->i_state & I_NEW) {
 581                 make_bad_inode(inode);
 582                 unlock_new_inode(inode);
 583         }
 584         if (lock_flags)
 585                 xfs_iunlock(ip, lock_flags);
 586         VN_RELE(vp);
 587 }
 588
 589
 590 /*
 591  * This routine embodies the part of the reclaim code that pulls
 592  * the inode from the inode hash table and the mount structure's
 593  * inode list.
 594  * This should only be called from xfs_reclaim().
 595  */
 596 void
 597 xfs_ireclaim(xfs_inode_t *ip)
 598 {
 599         vnode_t         *vp;
 600
 601         /*
 602          * Remove from old hash list and mount list.
 603          */
 604         XFS_STATS_INC(xs_ig_reclaims);
 605
 606         xfs_iextract(ip);
 607
 608         /*
 609          * Here we do a spurious inode lock in order to coordinate with
 610          * xfs_sync().  This is because xfs_sync() references the inodes
 611          * in the mount list without taking references on the corresponding
 612          * vnodes.  We make that OK here by ensuring that we wait until
 613          * the inode is unlocked in xfs_sync() before we go ahead and
 614          * free it.  We get both the regular lock and the io lock because
 615          * the xfs_sync() code may need to drop the regular one but will
 616          * still hold the io lock.
 617          */
 618         xfs_ilock(ip, XFS_ILOCK_EXCL | XFS_IOLOCK_EXCL);
 619
 620         /*
 621          * Release dquots (and their references) if any. An inode may escape
 622          * xfs_inactive and get here via vn_alloc->vn_reclaim path.
 623          */
 624         XFS_QM_DQDETACH(ip->i_mount, ip);
 625
 626         /*
 627          * Pull our behavior descriptor from the vnode chain.
 628          */
 629         vp = XFS_ITOV_NULL(ip);
 630         if (vp) {
 631                 vn_bhv_remove(VN_BHV_HEAD(vp), XFS_ITOBHV(ip));
 632         }
 633
 634         /*
 635          * Free all memory associated with the inode.
 636          */
 637         xfs_idestroy(ip);
 638 }
 639
 640 /*
 641  * This routine removes an about-to-be-destroyed inode from
 642  * all of the lists in which it is located with the exception
 643  * of the behavior chain.
 644  */
 645 void
 646 xfs_iextract(
 647         xfs_inode_t     *ip)
 648 {
 649         xfs_ihash_t     *ih;
 650         xfs_inode_t     *iq;
 651         xfs_mount_t     *mp;
 652         xfs_chash_t     *ch;
 653         xfs_chashlist_t *chl, *chm;
 654         SPLDECL(s);
 655
 656         ih = ip->i_hash;
 657         write_lock(&ih->ih_lock);
 658         if ((iq = ip->i_next)) {
 659                 iq->i_prevp = ip->i_prevp;
 660         }
 661         *ip->i_prevp = iq;
 662         write_unlock(&ih->ih_lock);
 663
 664         /*
 665          * Remove from cluster hash list
 666          *   1) delete the chashlist if this is the last inode on the chashlist
 667          *   2) unchain from list of inodes
 668          *   3) point chashlist->chl_ip to 'chl_next' if to this inode.
 669          */
 670         mp = ip->i_mount;
 671         ch = XFS_CHASH(mp, ip->i_blkno);
 672         s = mutex_spinlock(&ch->ch_lock);
 673
 674         if (ip->i_cnext == ip) {
 675                 /* Last inode on chashlist */
 676                 ASSERT(ip->i_cnext == ip && ip->i_cprev == ip);
 677                 ASSERT(ip->i_chash != NULL);
 678                 chm=NULL;
 679                 for (chl = ch->ch_list; chl != NULL; chl = chl->chl_next) {
 680                         if (chl->chl_blkno == ip->i_blkno) {
 681                                 if (chm == NULL) {
 682                                         /* first item on the list */
 683                                         ch->ch_list = chl->chl_next;
 684                                 } else {
 685                                         chm->chl_next = chl->chl_next;
 686                                 }
 687                                 kmem_zone_free(xfs_chashlist_zone, chl);
 688                                 break;
 689                         } else {
 690                                 ASSERT(chl->chl_ip != ip);
 691                                 chm = chl;
 692                         }
 693                 }
 694                 ASSERT_ALWAYS(chl != NULL);
 695        } else {
 696                 /* delete one inode from a non-empty list */
 697                 iq = ip->i_cnext;
 698                 iq->i_cprev = ip->i_cprev;
 699                 ip->i_cprev->i_cnext = iq;
 700                 if (ip->i_chash->chl_ip == ip) {
 701                         ip->i_chash->chl_ip = iq;
 702                 }
 703                 ip->i_chash = __return_address;
 704                 ip->i_cprev = __return_address;
 705                 ip->i_cnext = __return_address;
 706         }
 707         mutex_spinunlock(&ch->ch_lock, s);
 708
 709         /*
 710          * Remove from mount's inode list.
 711          */
 712         XFS_MOUNT_ILOCK(mp);
 713         ASSERT((ip->i_mnext != NULL) && (ip->i_mprev != NULL));
 714         iq = ip->i_mnext;
 715         iq->i_mprev = ip->i_mprev;
 716         ip->i_mprev->i_mnext = iq;
 717
 718         /*
 719          * Fix up the head pointer if it points to the inode being deleted.
 720          */
 721         if (mp->m_inodes == ip) {
 722                 if (ip == iq) {
 723                         mp->m_inodes = NULL;
 724                 } else {
 725                         mp->m_inodes = iq;
 726                 }
 727         }
 728
 729         /* Deal with the deleted inodes list */
 730         list_del_init(&ip->i_reclaim);
 731
 732         mp->m_ireclaims++;
 733         XFS_MOUNT_IUNLOCK(mp);
 734 }
 735
 736 /*
 737  * This is a wrapper routine around the xfs_ilock() routine
 738  * used to centralize some grungy code.  It is used in places
 739  * that wish to lock the inode solely for reading the extents.
 740  * The reason these places can't just call xfs_ilock(SHARED)
 741  * is that the inode lock also guards to bringing in of the
 742  * extents from disk for a file in b-tree format.  If the inode
 743  * is in b-tree format, then we need to lock the inode exclusively
 744  * until the extents are read in.  Locking it exclusively all
 745  * the time would limit our parallelism unnecessarily, though.
 746  * What we do instead is check to see if the extents have been
 747  * read in yet, and only lock the inode exclusively if they
 748  * have not.
 749  *
 750  * The function returns a value which should be given to the
 751  * corresponding xfs_iunlock_map_shared().  This value is
 752  * the mode in which the lock was actually taken.
 753  */
 754 uint
 755 xfs_ilock_map_shared(
 756         xfs_inode_t     *ip)
 757 {
 758         uint    lock_mode;
 759
 760         if ((ip->i_d.di_format == XFS_DINODE_FMT_BTREE) &&
 761             ((ip->i_df.if_flags & XFS_IFEXTENTS) == 0)) {
 762                 lock_mode = XFS_ILOCK_EXCL;
 763         } else {
 764                 lock_mode = XFS_ILOCK_SHARED;
 765         }
 766
 767         xfs_ilock(ip, lock_mode);
 768
 769         return lock_mode;
 770 }
 771
 772 /*
 773  * This is simply the unlock routine to go with xfs_ilock_map_shared().
 774  * All it does is call xfs_iunlock() with the given lock_mode.
 775  */
 776 void
 777 xfs_iunlock_map_shared(
 778         xfs_inode_t     *ip,
 779         unsigned int    lock_mode)
 780 {
 781         xfs_iunlock(ip, lock_mode);
 782 }
 783
 784 /*
 785  * The xfs inode contains 2 locks: a multi-reader lock called the
 786  * i_iolock and a multi-reader lock called the i_lock.  This routine
 787  * allows either or both of the locks to be obtained.
 788  *
 789  * The 2 locks should always be ordered so that the IO lock is
 790  * obtained first in order to prevent deadlock.
 791  *
 792  * ip -- the inode being locked
 793  * lock_flags -- this parameter indicates the inode's locks
 794  *       to be locked.  It can be:
 795  *              XFS_IOLOCK_SHARED,
 796  *              XFS_IOLOCK_EXCL,
 797  *              XFS_ILOCK_SHARED,
 798  *              XFS_ILOCK_EXCL,
 799  *              XFS_IOLOCK_SHARED | XFS_ILOCK_SHARED,
 800  *              XFS_IOLOCK_SHARED | XFS_ILOCK_EXCL,
 801  *              XFS_IOLOCK_EXCL | XFS_ILOCK_SHARED,
 802  *              XFS_IOLOCK_EXCL | XFS_ILOCK_EXCL
 803  */
 804 void
 805 xfs_ilock(xfs_inode_t   *ip,
 806           uint          lock_flags)
 807 {
 808         /*
 809          * You can't set both SHARED and EXCL for the same lock,
 810          * and only XFS_IOLOCK_SHARED, XFS_IOLOCK_EXCL, XFS_ILOCK_SHARED,
 811          * and XFS_ILOCK_EXCL are valid values to set in lock_flags.
 812          */
 813         ASSERT((lock_flags & (XFS_IOLOCK_SHARED | XFS_IOLOCK_EXCL)) !=
 814                (XFS_IOLOCK_SHARED | XFS_IOLOCK_EXCL));
 815         ASSERT((lock_flags & (XFS_ILOCK_SHARED | XFS_ILOCK_EXCL)) !=
 816                (XFS_ILOCK_SHARED | XFS_ILOCK_EXCL));
 817         ASSERT((lock_flags & ~XFS_LOCK_MASK) == 0);
 818
 819         if (lock_flags & XFS_IOLOCK_EXCL) {
 820                 mrupdate(&ip->i_iolock);
 821         } else if (lock_flags & XFS_IOLOCK_SHARED) {
 822                 mraccess(&ip->i_iolock);
 823         }
 824         if (lock_flags & XFS_ILOCK_EXCL) {
 825                 mrupdate(&ip->i_lock);
 826         } else if (lock_flags & XFS_ILOCK_SHARED) {
 827                 mraccess(&ip->i_lock);
 828         }
 829         xfs_ilock_trace(ip, 1, lock_flags, (inst_t *)__return_address);
 830 }
 831
 832 /*
 833  * This is just like xfs_ilock(), except that the caller
 834  * is guaranteed not to sleep.  It returns 1 if it gets
 835  * the requested locks and 0 otherwise.  If the IO lock is
 836  * obtained but the inode lock cannot be, then the IO lock
 837  * is dropped before returning.
 838  *
 839  * ip -- the inode being locked
 840  * lock_flags -- this parameter indicates the inode's locks to be
 841  *       to be locked.  See the comment for xfs_ilock() for a list
 842  *       of valid values.
 843  *
 844  */
 845 int
 846 xfs_ilock_nowait(xfs_inode_t    *ip,
 847                  uint           lock_flags)
 848 {
 849         int     iolocked;
 850         int     ilocked;
 851
 852         /*
 853          * You can't set both SHARED and EXCL for the same lock,
 854          * and only XFS_IOLOCK_SHARED, XFS_IOLOCK_EXCL, XFS_ILOCK_SHARED,
 855          * and XFS_ILOCK_EXCL are valid values to set in lock_flags.
 856          */
 857         ASSERT((lock_flags & (XFS_IOLOCK_SHARED | XFS_IOLOCK_EXCL)) !=
 858                (XFS_IOLOCK_SHARED | XFS_IOLOCK_EXCL));
 859         ASSERT((lock_flags & (XFS_ILOCK_SHARED | XFS_ILOCK_EXCL)) !=
 860                (XFS_ILOCK_SHARED | XFS_ILOCK_EXCL));
 861         ASSERT((lock_flags & ~XFS_LOCK_MASK) == 0);
 862
 863         iolocked = 0;
 864         if (lock_flags & XFS_IOLOCK_EXCL) {
 865                 iolocked = mrtryupdate(&ip->i_iolock);
 866                 if (!iolocked) {
 867                         return 0;
 868                 }
 869         } else if (lock_flags & XFS_IOLOCK_SHARED) {
 870                 iolocked = mrtryaccess(&ip->i_iolock);
 871                 if (!iolocked) {
 872                         return 0;
 873                 }
 874         }
 875         if (lock_flags & XFS_ILOCK_EXCL) {
 876                 ilocked = mrtryupdate(&ip->i_lock);
 877                 if (!ilocked) {
 878                         if (iolocked) {
 879                                 mrunlock(&ip->i_iolock);
 880                         }
 881                         return 0;
 882                 }
 883         } else if (lock_flags & XFS_ILOCK_SHARED) {
 884                 ilocked = mrtryaccess(&ip->i_lock);
 885                 if (!ilocked) {
 886                         if (iolocked) {
 887                                 mrunlock(&ip->i_iolock);
 888                         }
 889                         return 0;
 890                 }
 891         }
 892         xfs_ilock_trace(ip, 2, lock_flags, (inst_t *)__return_address);
 893         return 1;
 894 }
 895
 896 /*
 897  * xfs_iunlock() is used to drop the inode locks acquired with
 898  * xfs_ilock() and xfs_ilock_nowait().  The caller must pass
 899  * in the flags given to xfs_ilock() or xfs_ilock_nowait() so
 900  * that we know which locks to drop.
 901  *
 902  * ip -- the inode being unlocked
 903  * lock_flags -- this parameter indicates the inode's locks to be
 904  *       to be unlocked.  See the comment for xfs_ilock() for a list
 905  *       of valid values for this parameter.
 906  *
 907  */
 908 void
 909 xfs_iunlock(xfs_inode_t *ip,
 910             uint        lock_flags)
 911 {
 912         /*
 913          * You can't set both SHARED and EXCL for the same lock,
 914          * and only XFS_IOLOCK_SHARED, XFS_IOLOCK_EXCL, XFS_ILOCK_SHARED,
 915          * and XFS_ILOCK_EXCL are valid values to set in lock_flags.
 916          */
 917         ASSERT((lock_flags & (XFS_IOLOCK_SHARED | XFS_IOLOCK_EXCL)) !=
 918                (XFS_IOLOCK_SHARED | XFS_IOLOCK_EXCL));
 919         ASSERT((lock_flags & (XFS_ILOCK_SHARED | XFS_ILOCK_EXCL)) !=
 920                (XFS_ILOCK_SHARED | XFS_ILOCK_EXCL));
 921         ASSERT((lock_flags & ~(XFS_LOCK_MASK | XFS_IUNLOCK_NONOTIFY)) == 0);
 922         ASSERT(lock_flags != 0);
 923
 924         if (lock_flags & (XFS_IOLOCK_SHARED | XFS_IOLOCK_EXCL)) {
 925                 ASSERT(!(lock_flags & XFS_IOLOCK_SHARED) ||
 926                        (ismrlocked(&ip->i_iolock, MR_ACCESS)));
 927                 ASSERT(!(lock_flags & XFS_IOLOCK_EXCL) ||
 928                        (ismrlocked(&ip->i_iolock, MR_UPDATE)));
 929                 mrunlock(&ip->i_iolock);
 930         }
 931
 932         if (lock_flags & (XFS_ILOCK_SHARED | XFS_ILOCK_EXCL)) {
 933                 ASSERT(!(lock_flags & XFS_ILOCK_SHARED) ||
 934                        (ismrlocked(&ip->i_lock, MR_ACCESS)));
 935                 ASSERT(!(lock_flags & XFS_ILOCK_EXCL) ||
 936                        (ismrlocked(&ip->i_lock, MR_UPDATE)));
 937                 mrunlock(&ip->i_lock);
 938
 939                 /*
 940                  * Let the AIL know that this item has been unlocked in case
 941                  * it is in the AIL and anyone is waiting on it.  Don't do
 942                  * this if the caller has asked us not to.
 943                  */
 944                 if (!(lock_flags & XFS_IUNLOCK_NONOTIFY) &&
 945                      ip->i_itemp != NULL) {
 946                         xfs_trans_unlocked_item(ip->i_mount,
 947                                                 (xfs_log_item_t*)(ip->i_itemp));
 948                 }
 949         }
 950         xfs_ilock_trace(ip, 3, lock_flags, (inst_t *)__return_address);
 951 }
 952
 953 /*
 954  * give up write locks.  the i/o lock cannot be held nested
 955  * if it is being demoted.
 956  */
 957 void
 958 xfs_ilock_demote(xfs_inode_t    *ip,
 959                  uint           lock_flags)
 960 {
 961         ASSERT(lock_flags & (XFS_IOLOCK_EXCL|XFS_ILOCK_EXCL));
 962         ASSERT((lock_flags & ~(XFS_IOLOCK_EXCL|XFS_ILOCK_EXCL)) == 0);
 963
 964         if (lock_flags & XFS_ILOCK_EXCL) {
 965                 ASSERT(ismrlocked(&ip->i_lock, MR_UPDATE));
 966                 mrdemote(&ip->i_lock);
 967         }
 968         if (lock_flags & XFS_IOLOCK_EXCL) {
 969                 ASSERT(ismrlocked(&ip->i_iolock, MR_UPDATE));
 970                 mrdemote(&ip->i_iolock);
 971         }
 972 }
 973
 974 /*
 975  * The following three routines simply manage the i_flock
 976  * semaphore embedded in the inode.  This semaphore synchronizes
 977  * processes attempting to flush the in-core inode back to disk.
 978  */
 979 void
 980 xfs_iflock(xfs_inode_t *ip)
 981 {
 982         psema(&(ip->i_flock), PINOD|PLTWAIT);
 983 }
 984
 985 int
 986 xfs_iflock_nowait(xfs_inode_t *ip)
 987 {
 988         return (cpsema(&(ip->i_flock)));
 989 }
 990
 991 void
 992 xfs_ifunlock(xfs_inode_t *ip)
 993 {
 994         ASSERT(valusema(&(ip->i_flock)) <= 0);
 995         vsema(&(ip->i_flock));
 996 }