libafs: afs_SetupVolSlot function
[openafs.git] / src / afs / afs_volume.c
index c50e0d8..827ff12 100644 (file)
@@ -1,7 +1,7 @@
 /*
  * Copyright 2000, International Business Machines Corporation and others.
  * All Rights Reserved.
- * 
+ *
  * This software has been released under the terms of the IBM Public
  * License.  For details, see the LICENSE file in the top-level source
  * directory or online at http://www.openafs.org/dl/license10.html
@@ -18,7 +18,6 @@
 #include <afsconfig.h>
 #include "afs/param.h"
 
-RCSID("$Header$");
 
 #include "afs/stds.h"
 #include "afs/sysincludes.h"   /* Standard vendor system headers */
@@ -32,20 +31,19 @@ RCSID("$Header$");
 #ifdef AFS_SGI62_ENV
 #include "h/hashing.h"
 #endif
-#if !defined(AFS_HPUX110_ENV) && !defined(AFS_LINUX20_ENV) && !defined(AFS_DARWIN60_ENV)
+#if !defined(AFS_HPUX110_ENV) && !defined(AFS_LINUX20_ENV) && !defined(AFS_DARWIN_ENV)
 #include <netinet/in_var.h>
 #endif /* ! AFS_HPUX110_ENV */
 #endif /* !defined(UKERNEL) */
 
 #include "afsincludes.h"       /* Afs-based standard headers */
-#include "afs/afs_stats.h"   /* afs statistics */
+#include "afs/afs_stats.h"     /* afs statistics */
+#include "afs/afs_dynroot.h"
 
-#if    defined(AFS_SUN56_ENV)
+#if    defined(AFS_SUN5_ENV)
 #include <inet/led.h>
 #include <inet/common.h>
-#if     defined(AFS_SUN58_ENV)
 #include <netinet/ip6.h>
-#endif
 #include <inet/ip.h>
 #endif
 
@@ -56,39 +54,47 @@ RCSID("$Header$");
 #endif /* vlserver error base define */
 
 /* Exported variables */
-ino_t volumeInode;                     /*Inode for VolumeItems file*/
-afs_rwlock_t afs_xvolume;               /* allocation lock for volumes */
+afs_dcache_id_t volumeInode;   /* Inode for VolumeItems file */
+afs_rwlock_t afs_xvolume;      /** allocation lock for volumes */
 struct volume *afs_freeVolList;
 struct volume *afs_volumes[NVOLS];
-afs_int32 afs_volCounter = 1; /* for allocating volume indices */
+afs_int32 afs_volCounter = 1;  /** for allocating volume indices */
 afs_int32 fvTable[NFENTRIES];
 
 /* Forward declarations */
-static struct volume *afs_NewVolumeByName(char *aname, afs_int32 acell, int agood,
-                                  struct vrequest *areq, afs_int32 locktype);
+static struct volume *afs_NewVolumeByName(char *aname, afs_int32 acell,
+                                         int agood, struct vrequest *areq,
+                                         afs_int32 locktype);
 static struct volume *afs_NewDynrootVolume(struct VenusFid *fid);
-static int inVolList(struct VenusFid *fid, afs_int32 nvols, afs_int32 *vID, afs_int32 *cID);
+static int inVolList(struct VenusFid *fid, afs_int32 nvols, afs_int32 * vID,
+                    afs_int32 * cID);
 
 
-/* Convert a volume name to a #; return 0 if can't parse as a number */
-static int afs_vtoi(register char *aname)
+
+/**
+ * Convert a volume name to a number;
+ * @param aname Volume name.
+ * @return return 0 if can't parse as a number.
+ */
+static int
+afs_vtoi(char *aname)
 {
-    register afs_int32 temp;
-    register int tc;
+    afs_int32 temp;
+    int tc;
     temp = 0;
     AFS_STATCNT(afs_vtoi);
-    while((tc = *aname++)) {
-       if (tc > '9' || tc < '0')
-           return 0; /* invalid name */
+    while ((tc = *aname++)) {
+       if (tc > '9' || tc < '0')
+           return 0;           /* invalid name */
        temp *= 10;
        temp += tc - '0';
     }
     return temp;
 
-} /*afs_vtoi*/
+}                              /*afs_vtoi */
 
 
-/*
+/**
  * All of the vol cache routines must be called with the afs_xvolume
  * lock held in exclusive mode, since they use static variables.
  * In addition, we don't want two people adding the same volume
@@ -98,15 +104,57 @@ static int afs_vtoi(register char *aname)
 static struct fvolume staticFVolume;
 afs_int32 afs_FVIndex = -1;
 
-/* UFS specific version of afs_GetVolSlot */
+/*!
+ * Initialize a newly gotten volume slot.
+ *
+ * \param tv volume slot to be initialized
+ * \param tf volume item data; null if none
+ * \param volid volume id for this volume slot
+ * \param cell cell for this volume slot
+ * \return none
+ */
+static void
+afs_InitVolSlot(struct volume *tv, struct fvolume *tf, afs_int32 volid,
+               struct cell *tcell)
+{
+    AFS_STATCNT(afs_InitVolSlot);
+    memset(tv, 0, sizeof(struct volume));
+    tv->cell = tcell->cellNum;
+    AFS_RWLOCK_INIT(&tv->lock, "volume lock");
+    tv->volume = volid;
+    if (tf) {
+       tv->vtix = afs_FVIndex;
+       tv->mtpoint = tf->mtpoint;
+       tv->dotdot = tf->dotdot;
+       tv->rootVnode = tf->rootVnode;
+       tv->rootUnique = tf->rootUnique;
+    } else {
+       tv->vtix = -1;
+       tv->rootVnode = tv->rootUnique = 0;
+       afs_GetDynrootMountFid(&tv->dotdot);
+       afs_GetDynrootMountFid(&tv->mtpoint);
+       tv->mtpoint.Fid.Vnode =
+           VNUM_FROM_TYPEID(VN_TYPE_MOUNT, tcell->cellIndex << 2);
+       tv->mtpoint.Fid.Unique = volid;
+    }
+}
 
-struct volume *afs_UFSGetVolSlot(void)
+/**
+ * UFS specific version of afs_GetVolSlot
+ * @return
+ */
+struct volume *
+afs_UFSGetVolSlot(afs_int32 volid, struct cell *tcell)
 {
-    register struct volume *tv, **lv;
+    struct volume *tv = NULL, **lv;
     struct osi_file *tfile;
-    register afs_int32 i, code;
+    afs_int32 i = -1, code;
     afs_int32 bestTime;
-    struct volume *bestVp, **bestLp;
+    struct volume *bestVp, *oldLp = NULL, **bestLp = NULL;
+    char *oldname = NULL;
+    afs_int32 oldvtix = -2; /* Initialize to a value that doesn't occur */
+    struct fvolume *tf = NULL;
+    int j = 0;
 
     AFS_STATCNT(afs_UFSGetVolSlot);
     if (!afs_freeVolList) {
@@ -114,11 +162,11 @@ struct volume *afs_UFSGetVolSlot(void)
        bestTime = 0x7fffffff;
        bestVp = 0;
        bestLp = 0;
-       for (i=0;i<NVOLS;i++) {
+       for (i = 0; i < NVOLS; i++) {
            lv = &afs_volumes[i];
            for (tv = *lv; tv; lv = &tv->next, tv = *lv) {
-               if (tv->refCount == 0) {    /* is this one available? */
-                   if (tv->accessTime < bestTime) { /* best one available? */
+               if (tv->refCount == 0) {        /* is this one available? */
+                   if (tv->accessTime < bestTime) {    /* best one available? */
                        bestTime = tv->accessTime;
                        bestLp = lv;
                        bestVp = tv;
@@ -126,33 +174,42 @@ struct volume *afs_UFSGetVolSlot(void)
                }
            }
        }
-       if (!bestVp)
-           osi_Panic("getvolslot none");
+       if (!bestVp) {
+           afs_warn("afs_UFSGetVolSlot: no vol slots available\n");
+           goto error;
+       }
        tv = bestVp;
+
+       oldLp = *bestLp;
        *bestLp = tv->next;
-       if (tv->name)
-           afs_osi_Free(tv->name, strlen(tv->name)+1);
+
+       oldname = tv->name;
        tv->name = NULL;
+
+       oldvtix = tv->vtix;
        /* now write out volume structure to file */
        if (tv->vtix < 0) {
            tv->vtix = afs_volCounter++;
            /* now put on hash chain */
            i = FVHash(tv->cell, tv->volume);
            staticFVolume.next = fvTable[i];
-           fvTable[i]=tv->vtix;
-       }
-       else {
+           fvTable[i] = tv->vtix;
+       } else {
            /*
             * Haul the guy in from disk so we don't overwrite hash table
             * next chain
             */
            if (afs_FVIndex != tv->vtix) {
-               tfile = osi_UFSOpen(volumeInode);
-               code = afs_osi_Read(tfile, sizeof(struct fvolume) * tv->vtix,
-                               &staticFVolume, sizeof(struct fvolume));
-               if (code != sizeof(struct fvolume))
-                   osi_Panic("read volumeinfo");
+               tfile = osi_UFSOpen(&volumeInode);
+               code =
+                   afs_osi_Read(tfile, sizeof(struct fvolume) * tv->vtix,
+                                &staticFVolume, sizeof(struct fvolume));
                osi_UFSClose(tfile);
+               if (code != sizeof(struct fvolume)) {
+                   afs_warn("afs_UFSGetVolSlot: error %d reading volumeinfo\n",
+                            (int)code);
+                   goto error;
+               }
                afs_FVIndex = tv->vtix;
            }
        }
@@ -163,109 +220,233 @@ struct volume *afs_UFSGetVolSlot(void)
        staticFVolume.dotdot = tv->dotdot;
        staticFVolume.rootVnode = tv->rootVnode;
        staticFVolume.rootUnique = tv->rootUnique;
-       tfile = osi_UFSOpen(volumeInode);
-       code = afs_osi_Write(tfile, sizeof(struct fvolume) * afs_FVIndex, 
-                        &staticFVolume, sizeof(struct fvolume));
-       if (code != sizeof(struct fvolume))
-           osi_Panic("write volumeinfo");
-       osi_UFSClose(tfile);    
-    }
-    else {
+       tfile = osi_UFSOpen(&volumeInode);
+       code =
+           afs_osi_Write(tfile, sizeof(struct fvolume) * afs_FVIndex,
+                         &staticFVolume, sizeof(struct fvolume));
+       osi_UFSClose(tfile);
+       if (code != sizeof(struct fvolume)) {
+           afs_warn("afs_UFSGetVolSlot: error %d writing volumeinfo\n",
+                    (int)code);
+           goto error;
+       }
+       if (oldname) {
+           afs_osi_Free(oldname, strlen(oldname) + 1);
+           oldname = NULL;
+       }
+    } else {
        tv = afs_freeVolList;
        afs_freeVolList = tv->next;
     }
+
+    /* read volume item data from disk for the gotten slot */
+    for (j = fvTable[FVHash(tcell->cellNum, volid)]; j != 0; j = tf->next) {
+       if (afs_FVIndex != j) {
+           tfile = osi_UFSOpen(&volumeInode);
+           code =
+               afs_osi_Read(tfile, sizeof(struct fvolume) * j,
+                            &staticFVolume, sizeof(struct fvolume));
+           osi_UFSClose(tfile);
+           if (code != sizeof(struct fvolume)) {
+               afs_warn("afs_SetupVolume: error %d reading volumeinfo\n",
+                        (int)code);
+               /* put tv back on the free list; the data in it is not valid */
+               tv->next = afs_freeVolList;
+               afs_freeVolList = tv;
+               /* staticFVolume contents are not valid */
+               afs_FVIndex = -1;
+               return NULL;
+           }
+           afs_FVIndex = j;
+       }
+       if (j != 0) {           /* volume items record 0 is not used */
+           tf = &staticFVolume;
+           if (tf->cell == tcell->cellNum && tf->volume == volid) {
+               break;
+           }
+       }
+    }
+
+    afs_InitVolSlot(tv, tf, volid, tcell);
     return tv;
 
-} /*afs_UFSGetVolSlot*/
+ error:
+    if (tv) {
+       if (oldvtix == -2) {
+           afs_warn("afs_UFSGetVolSlot: oldvtix is uninitialized\n");
+           return NULL;
+       }
+       if (oldname) {
+           tv->name = oldname;
+           oldname = NULL;
+       }
+       if (oldvtix < 0) {
+           afs_volCounter--;
+           fvTable[i] = staticFVolume.next;
+       }
+       if (bestLp) {
+           *bestLp = oldLp;
+       }
+       tv->vtix = oldvtix;
+       /* we messed with staticFVolume, so make sure someone else
+        * doesn't think it's fine to use */
+       afs_FVIndex = -1;
+    }
+    return NULL;
+}                              /*afs_UFSGetVolSlot */
 
 
-struct volume *afs_MemGetVolSlot(void)
+/**
+ *   Get an available volume list slot. If the list does not exist,
+ * create one containing a single element.
+ * @return
+ */
+struct volume *
+afs_MemGetVolSlot(afs_int32 volid, struct cell *tcell)
 {
-    register struct volume *tv;
+    struct volume *tv;
 
     AFS_STATCNT(afs_MemGetVolSlot);
     if (!afs_freeVolList) {
        struct volume *newVp;
 
-       newVp = (struct volume *) afs_osi_Alloc(sizeof(struct volume));
+       newVp = afs_osi_Alloc(sizeof(struct volume));
+       osi_Assert(newVp != NULL);
 
        newVp->next = NULL;
        afs_freeVolList = newVp;
     }
     tv = afs_freeVolList;
     afs_freeVolList = tv->next;
+
+    afs_InitVolSlot(tv, NULL, volid, tcell);
     return tv;
 
-} /*afs_MemGetVolSlot*/
+}                              /*afs_MemGetVolSlot */
 
-/* afs_ResetVolumes()
- * Reset volume inforamation for all volume structs that
- * point to a speicific server.
+/*!
+ * Setup a volume slot for cell:volume.
+ *
+ * Find the volume slot for the cell:volume, otherwise get
+ * and initialize a new slot.
+ *
+ * \param volid volume id
+ * \param cell  cell
+ * \return volume
  */
-void afs_ResetVolumes(struct server *srvp)
+static struct volume *
+afs_SetupVolSlot(afs_int32 volid, struct cell *tcell)
 {
-  int j, k;
-  struct volume *vp;
-
-  /* Find any volumes residing on this server and flush their state */
-  for (j=0; j<NVOLS; j++) {
-     for (vp=afs_volumes[j]; vp; vp=vp->next) {
-       for (k=0; k<MAXHOSTS; k++) {
-          if (!srvp || (vp->serverHost[k] == srvp)) {
-             vp->serverHost[k] = 0;
-             afs_ResetVolumeInfo(vp);
-             break;
-          }
+    struct volume *tv;
+    int i;
+
+    AFS_STATCNT(afs_SetupVolSlot);
+    ObtainWriteLock(&afs_xvolume, 108);
+    i = VHash(volid);
+    for (tv = afs_volumes[i]; tv; tv = tv->next) {
+       if (tv->volume == volid && tv->cell == tcell->cellNum) {
+           break;
+       }
+    }
+    if (!tv) {
+       tv = afs_GetVolSlot(volid, tcell);
+       if (!tv) {
+           ReleaseWriteLock(&afs_xvolume);
+           return NULL;
        }
-     }
-  }
+       tv->next = afs_volumes[i];      /* thread into list */
+       afs_volumes[i] = tv;
+    }
+    tv->refCount++;
+    tv->states &= ~VRecheck;   /* just checked it */
+    tv->accessTime = osi_Time();
+    ReleaseWriteLock(&afs_xvolume);
+    return tv;
 }
 
+/*!
+ * Reset volume information for all volume structs that
+ * point to a speicific server, skipping a given volume if provided.
+ *
+ * @param[in] srvp
+ *      The server to reset volume info about
+ * @param[in] tv
+ *      The volume to skip resetting info about
+ */
+void
+afs_ResetVolumes(struct server *srvp, struct volume *tv)
+{
+    int j, k;
+    struct volume *vp;
+
+    /* Find any volumes residing on this server and flush their state */
+    for (j = 0; j < NVOLS; j++) {
+       for (vp = afs_volumes[j]; vp; vp = vp->next) {
+           for (k = 0; k < AFS_MAXHOSTS; k++) {
+               if (!srvp || (vp->serverHost[k] == srvp)) {
+                   if (tv && tv != vp) {
+                       vp->serverHost[k] = 0;
+                       afs_ResetVolumeInfo(vp);
+                   }
+                   break;
+               }
+           }
+       }
+    }
+}
 
-/* reset volume name to volume id mapping  cache */
-void afs_CheckVolumeNames(int flags) 
+/**
+ *   Reset volume name to volume id mapping cache.
+ * @param flags
+ */
+void
+afs_CheckVolumeNames(int flags)
 {
-    afs_int32 i,j;
+    afs_int32 i, j;
     struct volume *tv;
     unsigned int now;
     struct vcache *tvc;
     afs_int32 *volumeID, *cellID, vsize, nvols;
+#ifdef AFS_DARWIN80_ENV
+    vnode_t tvp;
+#endif
     AFS_STATCNT(afs_CheckVolumeNames);
 
     nvols = 0;
     volumeID = cellID = NULL;
-    vsize=0;
+    vsize = 0;
     ObtainReadLock(&afs_xvolume);
     if (flags & AFS_VOLCHECK_EXPIRED) {
        /*
         * allocate space to hold the volumeIDs and cellIDs, only if
         * we will be invalidating the mountpoints later on
         */
-       for (i=0; i< NVOLS; i++)
-           for (tv = afs_volumes[i]; tv; tv=tv->next)
+       for (i = 0; i < NVOLS; i++)
+           for (tv = afs_volumes[i]; tv; tv = tv->next)
                ++vsize;
 
-       volumeID = (afs_int32 *) afs_osi_Alloc(2 * vsize * sizeof(*volumeID));
-       cellID   = (volumeID) ? volumeID + vsize : 0;
+       volumeID = afs_osi_Alloc(2 * vsize * sizeof(*volumeID));
+       cellID = (volumeID) ? volumeID + vsize : 0;
     }
 
     now = osi_Time();
-    for (i=0;i<NVOLS;i++) {
-       for (tv = afs_volumes[i]; tv; tv=tv->next) {
+    for (i = 0; i < NVOLS; i++) {
+       for (tv = afs_volumes[i]; tv; tv = tv->next) {
            if (flags & AFS_VOLCHECK_EXPIRED) {
-                   if ( ((tv->expireTime<(now+10)) && (tv->states & VRO)) ||
-                               (flags & AFS_VOLCHECK_FORCE)){
-                   afs_ResetVolumeInfo(tv);  /* also resets status */
+               if (((tv->expireTime < (now + 10)) && (tv->states & VRO))
+                   || (flags & AFS_VOLCHECK_FORCE)) {
+                   afs_ResetVolumeInfo(tv);    /* also resets status */
                    if (volumeID) {
                        volumeID[nvols] = tv->volume;
-                       cellID[nvols]   = tv->cell;
+                       cellID[nvols] = tv->cell;
                    }
                    ++nvols;
                    continue;
                }
            }
+           /* ??? */
            if (flags & (AFS_VOLCHECK_BUSY | AFS_VOLCHECK_FORCE)) {
-               for (j=0; j<MAXHOSTS; j++) 
+               for (j = 0; j < AFS_MAXHOSTS; j++)
                    tv->status[j] = not_busy;
            }
 
@@ -276,65 +457,106 @@ void afs_CheckVolumeNames(int flags)
 
     /* next ensure all mt points are re-evaluated */
     if (nvols || (flags & (AFS_VOLCHECK_FORCE | AFS_VOLCHECK_MTPTS))) {
+loop:
        ObtainReadLock(&afs_xvcache);
-       for(i=0;i<VCSIZE;i++) {
-           for(tvc = afs_vhashT[i]; tvc; tvc=tvc->hnext) {
+       for (i = 0; i < VCSIZE; i++) {
+           for (tvc = afs_vhashT[i]; tvc; tvc = tvc->hnext) {
 
                /* if the volume of "mvid" of the vcache entry is among the
-                 * ones we found earlier, then we re-evaluate it.  Also, if the
-                 * force bit is set or we explicitly asked to reevaluate the
-                 * mt-pts, we clean the cmvalid bit */
+                * ones we found earlier, then we re-evaluate it.  Also, if the
+                * force bit is set or we explicitly asked to reevaluate the
+                * mt-pts, we clean the cmvalid bit */
 
-               if ((flags & (AFS_VOLCHECK_FORCE | AFS_VOLCHECK_MTPTS)) ||
-                   (tvc->mvid &&
-                    inVolList(tvc->mvid, nvols, volumeID, cellID)))
-                   tvc->states &= ~CMValid;
+               if ((flags & (AFS_VOLCHECK_FORCE | AFS_VOLCHECK_MTPTS))
+                   || (tvc->mvid
+                       && inVolList(tvc->mvid, nvols, volumeID, cellID)))
+                   tvc->f.states &= ~CMValid;
 
                /* If the volume that this file belongs to was reset earlier,
                 * then we should remove its callback.
                 * Again, if forced, always do it.
                 */
-               if ((tvc->states & CRO) &&
-                   (inVolList(&tvc->fid, nvols, volumeID, cellID) ||
-                    (flags & AFS_VOLCHECK_FORCE))) {
-
+               if ((tvc->f.states & CRO)
+                   && (inVolList(&tvc->f.fid, nvols, volumeID, cellID)
+                       || (flags & AFS_VOLCHECK_FORCE))) {
+
+                    if (tvc->f.states & CVInit) {
+                        ReleaseReadLock(&afs_xvcache);
+                       afs_osi_Sleep(&tvc->f.states);
+                        goto loop;
+                    }
+#ifdef AFS_DARWIN80_ENV
+                    if (tvc->f.states & CDeadVnode) {
+                        ReleaseReadLock(&afs_xvcache);
+                       afs_osi_Sleep(&tvc->f.states);
+                        goto loop;
+                    }
+                   tvp = AFSTOV(tvc);
+                   if (vnode_get(tvp))
+                       continue;
+                   if (vnode_ref(tvp)) {
+                       AFS_GUNLOCK();
+                       /* AFSTOV(tvc) may be NULL */
+                       vnode_put(tvp);
+                       AFS_GLOCK();
+                       continue;
+                   }
+#else
                    AFS_FAST_HOLD(tvc);
+#endif
                    ReleaseReadLock(&afs_xvcache);
 
                    ObtainWriteLock(&afs_xcbhash, 485);
                    /* LOCKXXX: We aren't holding tvc write lock? */
                    afs_DequeueCallback(tvc);
-                   tvc->states &= ~CStatd;
+                   tvc->f.states &= ~CStatd;
                    ReleaseWriteLock(&afs_xcbhash);
-                   if (tvc->fid.Fid.Vnode & 1 || (vType(tvc) == VDIR))
+                   if (tvc->f.fid.Fid.Vnode & 1 || (vType(tvc) == VDIR))
                        osi_dnlc_purgedp(tvc);
 
+#ifdef AFS_DARWIN80_ENV
+                   vnode_put(AFSTOV(tvc));
+                   /* our tvc ptr is still good until now */
+                   AFS_FAST_RELE(tvc);
+                   ObtainReadLock(&afs_xvcache);
+#else
                    ObtainReadLock(&afs_xvcache);
 
                    /* our tvc ptr is still good until now */
                    AFS_FAST_RELE(tvc);
+#endif
                }
            }
        }
-       osi_dnlc_purge ();   /* definitely overkill, but it's safer this way. */
+       osi_dnlc_purge();       /* definitely overkill, but it's safer this way. */
        ReleaseReadLock(&afs_xvcache);
     }
 
     if (volumeID)
        afs_osi_Free(volumeID, 2 * vsize * sizeof(*volumeID));
 
-} /*afs_CheckVolumeNames*/
+}                              /*afs_CheckVolumeNames */
 
 
-static int inVolList(struct VenusFid *fid, afs_int32 nvols, afs_int32 *vID, afs_int32 *cID)
+/**
+ * Check if volume is in the specified list.
+ * @param fid File FID.
+ * @param nvols Nomber of volumes???
+ * @param vID Array of volume IDs.
+ * @param cID Array of cache IDs.
+ * @return 1 - true, 0 - false.
+ */
+static int
+inVolList(struct VenusFid *fid, afs_int32 nvols, afs_int32 * vID,
+         afs_int32 * cID)
 {
     afs_int32 i;
 
     /* if no arrays present, be conservative and return true */
-    if ( nvols && (!vID || !cID))
+    if (nvols && (!vID || !cID))
        return 1;
 
-    for (i=0; i< nvols; ++i) {
+    for (i = 0; i < nvols; ++i) {
        if (fid->Fid.Volume == vID[i] && fid->Cell == cID[i])
            return 1;
     }
@@ -345,12 +567,15 @@ static int inVolList(struct VenusFid *fid, afs_int32 nvols, afs_int32 *vID, afs_
 /* afs_PutVolume is now a macro in afs.h */
 
 
-/* afs_FindVolume()
- *  return volume struct if we have it cached and it's up-to-date
- *
- *  Environment:  Must be called with afs_xvolume unlocked.
+/**
+ *    Return volume struct if we have it cached and it's up-to-date.
+ *  Environment: Must be called with afs_xvolume unlocked.
+ *  @param afid Volume FID.
+ *  @param locktype
+ *  @return Volume or NULL if no result.
  */
-struct volume *afs_FindVolume(struct VenusFid *afid, afs_int32 locktype)
+struct volume *
+afs_FindVolume(struct VenusFid *afid, afs_int32 locktype)
 {
     struct volume *tv;
     afs_int32 i;
@@ -359,26 +584,31 @@ struct volume *afs_FindVolume(struct VenusFid *afid, afs_int32 locktype)
        return NULL;
 
     i = VHash(afid->Fid.Volume);
-    ObtainWriteLock(&afs_xvolume,106);
-    for (tv = afs_volumes[i]; tv; tv=tv->next) {
+    ObtainWriteLock(&afs_xvolume, 106);
+    for (tv = afs_volumes[i]; tv; tv = tv->next) {
        if (tv->volume == afid->Fid.Volume && tv->cell == afid->Cell
            && (tv->states & VRecheck) == 0) {
            tv->refCount++;
            break;
-         }
+       }
     }
     ReleaseWriteLock(&afs_xvolume);
-    return tv;      /* NULL if we didn't find it */
-} /*afs_FindVolume*/
+    return tv;                 /* NULL if we didn't find it */
+}                              /*afs_FindVolume */
 
 
 
-/*
- * Note that areq may be null, in which case we don't bother to set any
+/**
+ *   Note that areq may be null, in which case we don't bother to set any
  * request status information.
+ * @param afid Volume FID.
+ * @param areq Request type.
+ * @param locktype Lock to be used.
+ * @return Volume or NULL if no result.
  */
-struct volume *afs_GetVolume(struct VenusFid *afid, struct vrequest *areq, 
-       afs_int32 locktype)
+struct volume *
+afs_GetVolume(struct VenusFid *afid, struct vrequest *areq,
+             afs_int32 locktype)
 {
     struct volume *tv;
     char *bp, tbuf[CVBS];
@@ -386,38 +616,51 @@ struct volume *afs_GetVolume(struct VenusFid *afid, struct vrequest *areq,
 
     tv = afs_FindVolume(afid, locktype);
     if (!tv) {
-       if (afs_IsDynrootFid(afid)) {
-          tv = afs_NewDynrootVolume(afid);
-       } else {
-          bp = afs_cv2string(&tbuf[CVBS], afid->Fid.Volume);
-          tv = afs_NewVolumeByName(bp, afid->Cell, 0, areq, locktype);
-       }
+       /* Do a dynroot check and add dynroot volume if found. */
+       if (afs_IsDynrootAnyFid(afid)) {
+           tv = afs_NewDynrootVolume(afid);
+       } else {
+           bp = afs_cv2string(&tbuf[CVBS], afid->Fid.Volume);
+           tv = afs_NewVolumeByName(bp, afid->Cell, 0, areq, locktype);
+       }
     }
     return tv;
-} /*afs_GetVolume*/
+}                              /*afs_GetVolume */
 
 
 
-static struct volume *afs_SetupVolume(afs_int32 volid, char *aname, 
-       char *ve, struct cell *tcell, afs_int32 agood, afs_int32 type, struct vrequest *areq)
+/**
+ *
+ * @param volid Volume ID. If it's 0, get it from the name.
+ * @param aname Volume name.
+ * @param ve Volume entry.
+ * @param tcell The cell containing this volume.
+ * @param agood
+ * @param type Type of volume.
+ * @param areq Request.
+ * @return Volume or NULL if failure.
+ */
+static struct volume *
+afs_SetupVolume(afs_int32 volid, char *aname, void *ve, struct cell *tcell,
+               afs_int32 agood, afs_int32 type, struct vrequest *areq)
 {
     struct volume *tv;
     struct vldbentry *ove = (struct vldbentry *)ve;
     struct nvldbentry *nve = (struct nvldbentry *)ve;
     struct uvldbentry *uve = (struct uvldbentry *)ve;
 
-    int        whichType;  /* which type of volume to look for */
-    int i, j, err=0;
+    int whichType;             /* which type of volume to look for */
+    int i;
 
     if (!volid) {
-        int len;
+       int len;
        /* special hint from file server to use vlserver */
        len = strlen(aname);
-       if (len >= 8 && strcmp(aname+len-7, ".backup") == 0)
+       if (len >= 8 && strcmp(aname + len - 7, ".backup") == 0)
            whichType = BACKVOL;
-       else if (len >= 10 && strcmp(aname+len-9, ".readonly")==0)
+       else if (len >= 10 && strcmp(aname + len - 9, ".readonly") == 0)
            whichType = ROVOL;
-       else 
+       else
            whichType = RWVOL;
 
        /* figure out which one we're really interested in (a set is returned) */
@@ -425,97 +668,63 @@ static struct volume *afs_SetupVolume(afs_int32 volid, char *aname,
        if (volid == 0) {
            if (type == 2) {
                volid = uve->volumeId[whichType];
-           }
-           else if (type == 1) {
+           } else if (type == 1) {
                volid = nve->volumeId[whichType];
-           }
-           else {
+           } else {
                volid = ove->volumeId[whichType];
            }
-       }
-    }
+       } /* end of if (volid == 0) */
+    } /* end of if (!volid) */
 
-    
-    ObtainWriteLock(&afs_xvolume,108);
-    i = VHash(volid);
-    for (tv = afs_volumes[i]; tv; tv=tv->next) {
-       if (tv->volume == volid && tv->cell == tcell->cellNum) {
-           break;
-       }
-    }
+    tv = afs_SetupVolSlot(volid, tcell);
     if (!tv) {
-       struct fvolume *tf=0;
-
-       tv = afs_GetVolSlot();
-       memset((char *)tv, 0, sizeof(struct volume));
-       tv->cell = tcell->cellNum;
-       RWLOCK_INIT(&tv->lock, "volume lock");
-       tv->next = afs_volumes[i];      /* thread into list */
-       afs_volumes[i] = tv;
-       tv->volume = volid;
-       for (j=fvTable[FVHash(tv->cell,volid)]; j!=0; j=tf->next) {
-           if (afs_FVIndex != j) {
-               struct osi_file *tfile;
-               tfile = osi_UFSOpen(volumeInode);
-               err = afs_osi_Read(tfile, sizeof(struct fvolume) * j, &staticFVolume, sizeof(struct fvolume));
-               if (err != sizeof(struct fvolume))
-                   osi_Panic("read volumeinfo2");
-               osi_UFSClose(tfile);
-               afs_FVIndex = j;
-           }
-           tf = &staticFVolume;
-           if (tf->cell == tv->cell && tf->volume == volid)
-               break;
-       }
-       if (tf && (j != 0)) {
-           tv->vtix = afs_FVIndex;
-           tv->mtpoint = tf->mtpoint;
-           tv->dotdot = tf->dotdot;
-           tv->rootVnode = tf->rootVnode;          
-           tv->rootUnique = tf->rootUnique;        
-       } else {
-           tv->vtix = -1;
-           tv->rootVnode = tv->rootUnique = 0;
-       }
+       return NULL;
     }
-    tv->refCount++;
-    tv->states &= ~VRecheck;       /* just checked it */
-    tv->accessTime = osi_Time();
-    ReleaseWriteLock(&afs_xvolume);
-    ObtainWriteLock(&tv->lock,111);
+
     if (type == 2) {
-       InstallUVolumeEntry(tv, uve, tcell->cellNum, tcell, areq);
-    }
-    else if (type == 1)
-       InstallNVolumeEntry(tv, nve, tcell->cellNum);
+       LockAndInstallUVolumeEntry(tv, uve, tcell->cellNum, tcell, areq);
+    } else if (type == 1)
+       LockAndInstallNVolumeEntry(tv, nve, tcell->cellNum);
     else
-       InstallVolumeEntry(tv, ove, tcell->cellNum);
+       LockAndInstallVolumeEntry(tv, ove, tcell->cellNum);
     if (agood) {
        if (!tv->name) {
            tv->name = afs_osi_Alloc(strlen(aname) + 1);
+           osi_Assert(tv->name != NULL);
            strcpy(tv->name, aname);
        }
     }
-    for (i=0; i<NMAXNSERVERS; i++) {
-       tv->status[i] = not_busy;
+    for (i = 0; i < NMAXNSERVERS; i++) {
+       tv->status[i] = not_busy;
     }
     ReleaseWriteLock(&tv->lock);
     return tv;
 }
 
 
-struct volume *afs_GetVolumeByName(register char *aname, afs_int32 acell, 
-       int agood, struct vrequest *areq, afs_int32 locktype)
+/**
+ * Seek volume by it's name and attributes.
+ * If volume not found, try to add one.
+ * @param aname Volume name.
+ * @param acell Cell
+ * @param agood
+ * @param areq
+ * @param locktype Type of lock to be used.
+ * @return
+ */
+struct volume *
+afs_GetVolumeByName(char *aname, afs_int32 acell, int agood,
+                   struct vrequest *areq, afs_int32 locktype)
 {
-  afs_int32 i;
-  struct volume *tv;
+    afs_int32 i;
+    struct volume *tv;
 
     AFS_STATCNT(afs_GetVolumeByName);
-    ObtainWriteLock(&afs_xvolume,112);
-  for (i=0;i<NVOLS;i++) {
-       for (tv = afs_volumes[i]; tv; tv=tv->next) {
-           if (tv->name && !strcmp(aname,tv->name) && tv->cell == acell
-               && (tv->states&VRecheck) == 0) {
+    ObtainWriteLock(&afs_xvolume, 112);
+    for (i = 0; i < NVOLS; i++) {
+       for (tv = afs_volumes[i]; tv; tv = tv->next) {
+           if (tv->name && !strcmp(aname, tv->name) && tv->cell == acell
+               && (tv->states & VRecheck) == 0) {
                tv->refCount++;
                ReleaseWriteLock(&afs_xvolume);
                return tv;
@@ -525,11 +734,20 @@ struct volume *afs_GetVolumeByName(register char *aname, afs_int32 acell,
 
     ReleaseWriteLock(&afs_xvolume);
 
-  tv = afs_NewVolumeByName(aname, acell, agood, areq, locktype);
-  return(tv);
+    if (AFS_IS_DISCONNECTED)
+        return NULL;
+
+    tv = afs_NewVolumeByName(aname, acell, agood, areq, locktype);
+    return (tv);
 }
 
-static struct volume *afs_NewDynrootVolume(struct VenusFid *fid)
+/**
+ *   Init a new dynroot volume.
+ * @param Volume FID.
+ * @return Volume or NULL if not found.
+ */
+static struct volume *
+afs_NewDynrootVolume(struct VenusFid *fid)
 {
     struct cell *tcell;
     struct volume *tv;
@@ -540,6 +758,7 @@ static struct volume *afs_NewDynrootVolume(struct VenusFid *fid)
     if (!tcell)
        return NULL;
     tve = afs_osi_Alloc(sizeof(*tve));
+    osi_Assert(tve != NULL);
     if (!(tcell->states & CHasVolRef))
        tcell->states |= CHasVolRef;
 
@@ -556,18 +775,29 @@ static struct volume *afs_NewDynrootVolume(struct VenusFid *fid)
 }
 
 int lastnvcode;
-static struct volume *afs_NewVolumeByName(char *aname, afs_int32 acell, int agood,
-                                  struct vrequest *areq, afs_int32 locktype)
+
+/**
+ * @param aname Volume name.
+ * @param acell Cell id.
+ * @param agood
+ * @param areq Request type.
+ * @param locktype Type of lock to be used.
+ * @return Volume or NULL if failure.
+ */
+static struct volume *
+afs_NewVolumeByName(char *aname, afs_int32 acell, int agood,
+                   struct vrequest *areq, afs_int32 locktype)
 {
-    afs_int32 code, type=0;
+    afs_int32 code, type = 0;
     struct volume *tv, *tv1;
     struct vldbentry *tve;
     struct nvldbentry *ntve;
     struct uvldbentry *utve;
     struct cell *tcell;
     char *tbuffer, *ve;
-    struct conn *tconn;
+    struct afs_conn *tconn;
     struct vrequest treq;
+    struct rx_connection *rxconn;
 
     if (strlen(aname) > VL_MAXNAMELEN) /* Invalid volume name */
        return NULL;
@@ -578,60 +808,60 @@ static struct volume *afs_NewVolumeByName(char *aname, afs_int32 acell, int agoo
     }
 
     /* allow null request if we don't care about ENODEV/ETIMEDOUT distinction */
-    if (!areq)         areq = &treq;
+    if (!areq)
+       areq = &treq;
 
 
     afs_Trace2(afs_iclSetp, CM_TRACE_GETVOL, ICL_TYPE_STRING, aname,
-                          ICL_TYPE_POINTER, aname);
+              ICL_TYPE_POINTER, aname);
     tbuffer = osi_AllocLargeSpace(AFS_LRALLOCSIZ);
-    tve = (struct vldbentry *) (tbuffer+1024);
+    tve = (struct vldbentry *)(tbuffer + 1024);
     ntve = (struct nvldbentry *)tve;
     utve = (struct uvldbentry *)tve;
-    afs_InitReq(&treq, &afs_osi_cred); /* *must* be unauth for vldb */
+    afs_InitReq(&treq, afs_osi_credp); /* *must* be unauth for vldb */
     do {
-       tconn = afs_ConnByMHosts(tcell->cellHosts, tcell->vlport,
-                                tcell->cellNum, &treq, SHARED_LOCK);
+       tconn =
+           afs_ConnByMHosts(tcell->cellHosts, tcell->vlport, tcell->cellNum,
+                            &treq, SHARED_LOCK, 0, &rxconn);
        if (tconn) {
-           if (tconn->srvr->server->flags & SNO_LHOSTS) {
+           if (tconn->parent->srvr->server->flags & SNO_LHOSTS) {
                type = 0;
                RX_AFS_GUNLOCK();
-               code = VL_GetEntryByNameO(tconn->id, aname, tve);
+               code = VL_GetEntryByNameO(rxconn, aname, tve);
                RX_AFS_GLOCK();
-           } else if (tconn->srvr->server->flags & SYES_LHOSTS) {
+           } else if (tconn->parent->srvr->server->flags & SYES_LHOSTS) {
                type = 1;
                RX_AFS_GUNLOCK();
-               code = VL_GetEntryByNameN(tconn->id, aname, ntve);
+               code = VL_GetEntryByNameN(rxconn, aname, ntve);
                RX_AFS_GLOCK();
            } else {
                type = 2;
                RX_AFS_GUNLOCK();
-               code = VL_GetEntryByNameU(tconn->id, aname, utve);
+               code = VL_GetEntryByNameU(rxconn, aname, utve);
                RX_AFS_GLOCK();
-               if (!(tconn->srvr->server->flags & SVLSRV_UUID)) {
+               if (!(tconn->parent->srvr->server->flags & SVLSRV_UUID)) {
                    if (code == RXGEN_OPCODE) {
                        type = 1;
                        RX_AFS_GUNLOCK();
-                        code = VL_GetEntryByNameN(tconn->id, aname, ntve);
+                       code = VL_GetEntryByNameN(rxconn, aname, ntve);
                        RX_AFS_GLOCK();
                        if (code == RXGEN_OPCODE) {
                            type = 0;
-                           tconn->srvr->server->flags |= SNO_LHOSTS;
+                           tconn->parent->srvr->server->flags |= SNO_LHOSTS;
                            RX_AFS_GUNLOCK();
-                           code = VL_GetEntryByNameO(tconn->id, aname, tve);
+                           code = VL_GetEntryByNameO(rxconn, aname, tve);
                            RX_AFS_GLOCK();
                        } else if (!code)
-                           tconn->srvr->server->flags |= SYES_LHOSTS;
+                           tconn->parent->srvr->server->flags |= SYES_LHOSTS;
                    } else if (!code)
-                           tconn->srvr->server->flags |= SVLSRV_UUID;
+                       tconn->parent->srvr->server->flags |= SVLSRV_UUID;
                }
                lastnvcode = code;
            }
        } else
            code = -1;
-    } while
-      (afs_Analyze(tconn, code, NULL, &treq,
-                  -1, /* no op code for this */
-                  SHARED_LOCK, tcell));
+    } while (afs_Analyze(tconn, rxconn, code, NULL, &treq, -1, /* no op code for this */
+                        SHARED_LOCK, tcell));
 
     if (code) {
        /* If the client has yet to contact this cell and contact failed due
@@ -639,16 +869,20 @@ static struct volume *afs_NewVolumeByName(char *aname, afs_int32 acell, int agoo
         * That the client tried and failed can be determined from the
         * fact that there was a downtime incident, but CHasVolRef is not set.
         */
+    /* RT 48959 - unclear if this should really go */
+#if 0
        if (areq->networkError && !(tcell->states & CHasVolRef)) {
            int i;
            struct server *sp;
            struct srvAddr *sap;
-           for (i=0; i<MAXCELLHOSTS; i++) {
-               if ((sp = tcell->cellHosts[i]) == NULL) break;
+           for (i = 0; i < AFS_MAXCELLHOSTS; i++) {
+               if ((sp = tcell->cellHosts[i]) == NULL)
+                   break;
                for (sap = sp->addr; sap; sap = sap->next_sa)
                    afs_MarkServerUpOrDown(sap, 0);
            }
        }
+#endif
        afs_CopyError(&treq, areq);
        osi_FreeLargeSpace(tbuffer);
        afs_PutCell(tcell, READ_LOCK);
@@ -663,87 +897,94 @@ static struct volume *afs_NewVolumeByName(char *aname, afs_int32 acell, int agoo
     if (!(tcell->states & CHasVolRef)) {
        tcell->states |= CHasVolRef;
        afs_stats_cmperf.numCellsContacted++;
-    } /*First time a volume in this cell has been referenced*/
-
+    }
+    /*First time a volume in this cell has been referenced */
     if (type == 2)
        ve = (char *)utve;
     else if (type == 1)
        ve = (char *)ntve;
     else
        ve = (char *)tve;
-    tv = afs_SetupVolume(0, aname, ve, tcell, agood, type, areq);
-    if ((agood == 2) && tv->roVol) {
+    tv = afs_SetupVolume(0, aname, ve, tcell, agood, type, &treq);
+    if ((agood == 3) && tv && tv->backVol) {
+       /*
+        * This means that very soon we'll ask for the BK volume so
+        * we'll prefetch it (well we did already.)
+        */
+       tv1 =
+           afs_SetupVolume(tv->backVol, (char *)0, ve, tcell, 0, type, &treq);
+       if (tv1) {
+           tv1->refCount--;
+       }
+    }
+    if ((agood >= 2) && tv && tv->roVol) {
        /*
         * This means that very soon we'll ask for the RO volume so
         * we'll prefetch it (well we did already.)
         */
-       tv1 = afs_SetupVolume(tv->roVol, NULL, ve, tcell, 0, type, areq);
-       tv1->refCount--;
+       tv1 = afs_SetupVolume(tv->roVol, NULL, ve, tcell, 0, type, &treq);
+       if (tv1) {
+           tv1->refCount--;
+       }
     }
     osi_FreeLargeSpace(tbuffer);
     afs_PutCell(tcell, READ_LOCK);
     return tv;
 
-} /*afs_NewVolumeByName*/
+}                              /*afs_NewVolumeByName */
 
 
 
-/* call this with the volume structure locked; used for new-style vldb requests */
-void InstallVolumeEntry(struct volume *av, struct vldbentry *ve, int acell)
+/**
+ *   Call this with the volume structure locked; used for new-style vldb requests.
+ * @param av Volume
+ * @param ve
+ * @param acell
+ */
+void
+LockAndInstallVolumeEntry(struct volume *av, struct vldbentry *ve, int acell)
 {
-    register struct server *ts;
+    struct server *ts;
     struct cell *cellp;
-    register int i, j;
+    int i, j;
     afs_int32 mask;
     afs_uint32 temp;
+    char types = 0;
+    struct server *serverHost[AFS_MAXHOSTS];
 
     AFS_STATCNT(InstallVolumeEntry);
 
+    memset(serverHost, 0, sizeof(serverHost));
+
     /* Determine the type of volume we want */
     if ((ve->flags & VLF_RWEXISTS) && (av->volume == ve->volumeId[RWVOL])) {
-       mask = VLSF_RWVOL;
-    }
-    else if ((ve->flags & VLF_ROEXISTS) && (av->volume == ve->volumeId[ROVOL])) {
-       mask = VLSF_ROVOL;
-       av->states |= VRO;
-    }
-    else if ((ve->flags & VLF_BACKEXISTS) && (av->volume == ve->volumeId[BACKVOL])) {
-       /* backup always is on the same volume as parent */
-       mask = VLSF_RWVOL;
-       av->states |= (VRO|VBackup);
-    }
-    else {
-       mask = 0;  /* Can't find volume in vldb entry */
+       mask = VLSF_RWVOL;
+    } else if ((ve->flags & VLF_ROEXISTS)
+              && (av->volume == ve->volumeId[ROVOL])) {
+       mask = VLSF_ROVOL;
+       types |= VRO;
+    } else if ((ve->flags & VLF_BACKEXISTS)
+              && (av->volume == ve->volumeId[BACKVOL])) {
+       /* backup always is on the same volume as parent */
+       mask = VLSF_RWVOL;
+       types |= (VRO | VBackup);
+    } else {
+       mask = 0;               /* Can't find volume in vldb entry */
     }
 
-    /* fill in volume types */
-    av->rwVol   = ((ve->flags & VLF_RWEXISTS)   ? ve->volumeId[RWVOL]   : 0);
-    av->roVol   = ((ve->flags & VLF_ROEXISTS)   ? ve->volumeId[ROVOL]   : 0);
-    av->backVol = ((ve->flags & VLF_BACKEXISTS) ? ve->volumeId[BACKVOL] : 0);
-
-    if (ve->flags & VLF_DFSFILESET)
-       av->states |= VForeign;
-
     cellp = afs_GetCell(acell, 0);
 
-    /* This volume, av, is locked. Zero out the serverHosts[] array 
-     * so that if afs_GetServer() decides to replace the server 
-     * struct, we don't deadlock trying to afs_ResetVolumeInfo()
-     * this volume.
-     */
-    for (j=0; j<MAXHOSTS; j++) {
-       av->serverHost[j] = 0;
-    }
-
     /* Step through the VLDB entry making sure each server listed is there */
-    for (i=0,j=0; i<ve->nServers; i++) {
-       if ( ((ve->serverFlags[i] & mask) == 0) || (ve->serverFlags[i] & VLSF_DONTUSE) ) {
-          continue;      /* wrong volume or  don't use this volume */
+    for (i = 0, j = 0; i < ve->nServers; i++) {
+       if (((ve->serverFlags[i] & mask) == 0)
+           || (ve->serverFlags[i] & VLSF_DONTUSE)) {
+           continue;           /* wrong volume or  don't use this volume */
        }
 
        temp = htonl(ve->serverNumber[i]);
-       ts = afs_GetServer(&temp, 1, acell, cellp->fsport, WRITE_LOCK, (afsUUID *)0, 0);
-       av->serverHost[j] = ts;
+       ts = afs_GetServer(&temp, 1, acell, cellp->fsport, WRITE_LOCK,
+                          (afsUUID *) 0, 0, av);
+       serverHost[j] = ts;
 
        /*
         * The cell field could be 0 if the server entry was created
@@ -752,74 +993,76 @@ void InstallVolumeEntry(struct volume *av, struct vldbentry *ve, int acell)
         * follows later on it will find the server entry thus it will
         * simply return without setting any fields, so we set the
         * field ourselves below.
-         */
+        */
        if (!ts->cell)
            ts->cell = cellp;
        afs_PutServer(ts, WRITE_LOCK);
        j++;
     }
-    if (j < MAXHOSTS) {
-       av->serverHost[j++] = 0;
-    }
-    afs_SortServers(av->serverHost, MAXHOSTS);
-} /*InstallVolumeEntry*/
+
+    ObtainWriteLock(&av->lock, 109);
+
+    memcpy(av->serverHost, serverHost, sizeof(serverHost));
+
+    /* from above */
+    av->states |= types;
+
+    /* fill in volume types */
+    av->rwVol = ((ve->flags & VLF_RWEXISTS) ? ve->volumeId[RWVOL] : 0);
+    av->roVol = ((ve->flags & VLF_ROEXISTS) ? ve->volumeId[ROVOL] : 0);
+    av->backVol = ((ve->flags & VLF_BACKEXISTS) ? ve->volumeId[BACKVOL] : 0);
+
+    if (ve->flags & VLF_DFSFILESET)
+       av->states |= VForeign;
+
+    afs_SortServers(av->serverHost, AFS_MAXHOSTS);
+}                              /*InstallVolumeEntry */
 
 
-void InstallNVolumeEntry(struct volume *av, struct nvldbentry *ve, int acell)
+void
+LockAndInstallNVolumeEntry(struct volume *av, struct nvldbentry *ve, int acell)
 {
-    register struct server *ts;
+    struct server *ts;
     struct cell *cellp;
-    register int i, j;
+    int i, j;
     afs_int32 mask;
     afs_uint32 temp;
+    char types = 0;
+    struct server *serverHost[AFS_MAXHOSTS];
 
     AFS_STATCNT(InstallVolumeEntry);
 
+    memset(serverHost, 0, sizeof(serverHost));
+
     /* Determine type of volume we want */
     if ((ve->flags & VLF_RWEXISTS) && (av->volume == ve->volumeId[RWVOL])) {
-       mask = VLSF_RWVOL;
-    }
-    else if ((ve->flags & VLF_ROEXISTS) && (av->volume == ve->volumeId[ROVOL])) {
-       mask = VLSF_ROVOL;
-       av->states |= VRO;
-    }
-    else if ((ve->flags&VLF_BACKEXISTS) && (av->volume == ve->volumeId[BACKVOL])) {
-       /* backup always is on the same volume as parent */
-       mask = VLSF_RWVOL;
-       av->states |= (VRO|VBackup);
-    }
-    else {
-       mask = 0;     /* Can't find volume in vldb entry */
+       mask = VLSF_RWVOL;
+    } else if ((ve->flags & VLF_ROEXISTS)
+              && (av->volume == ve->volumeId[ROVOL])) {
+       mask = VLSF_ROVOL;
+       types |= VRO;
+    } else if ((ve->flags & VLF_BACKEXISTS)
+              && (av->volume == ve->volumeId[BACKVOL])) {
+       /* backup always is on the same volume as parent */
+       mask = VLSF_RWVOL;
+       types |= (VRO | VBackup);
+    } else {
+       mask = 0;               /* Can't find volume in vldb entry */
     }
 
-    /* fill in volume types */
-    av->rwVol   = ((ve->flags & VLF_RWEXISTS)   ? ve->volumeId[RWVOL]   : 0);
-    av->roVol   = ((ve->flags & VLF_ROEXISTS)   ? ve->volumeId[ROVOL]   : 0);
-    av->backVol = ((ve->flags & VLF_BACKEXISTS) ? ve->volumeId[BACKVOL] : 0);
-
-    if (ve->flags & VLF_DFSFILESET)
-       av->states |= VForeign;
-
     cellp = afs_GetCell(acell, 0);
 
-    /* This volume, av, is locked. Zero out the serverHosts[] array 
-     * so that if afs_GetServer() decides to replace the server 
-     * struct, we don't deadlock trying to afs_ResetVolumeInfo()
-     * this volume.
-     */
-    for (j=0; j<MAXHOSTS; j++) {
-       av->serverHost[j] = 0;
-    }
-
     /* Step through the VLDB entry making sure each server listed is there */
-    for (i=0,j=0; i<ve->nServers; i++) {
-        if ( ((ve->serverFlags[i] & mask) == 0) || (ve->serverFlags[i] & VLSF_DONTUSE) ) {
-          continue;      /* wrong volume or don't use this volume */
+    for (i = 0, j = 0; i < ve->nServers; i++) {
+       if (((ve->serverFlags[i] & mask) == 0)
+           || (ve->serverFlags[i] & VLSF_DONTUSE)) {
+           continue;           /* wrong volume or don't use this volume */
        }
 
        temp = htonl(ve->serverNumber[i]);
-       ts = afs_GetServer(&temp, 1, acell, cellp->fsport, WRITE_LOCK, (afsUUID *)0,0);
-       av->serverHost[j] = ts;
+       ts = afs_GetServer(&temp, 1, acell, cellp->fsport, WRITE_LOCK,
+                          (afsUUID *) 0, 0, av);
+       serverHost[j] = ts;
        /*
         * The cell field could be 0 if the server entry was created
         * first with the 'fs setserverprefs' call which doesn't set
@@ -827,103 +1070,112 @@ void InstallNVolumeEntry(struct volume *av, struct nvldbentry *ve, int acell)
         * follows later on it will find the server entry thus it will
         * simply return without setting any fields, so we set the
         * field ourselves below.
-         */
+        */
        if (!ts->cell)
            ts->cell = cellp;
        afs_PutServer(ts, WRITE_LOCK);
        j++;
     }
-    if (j < MAXHOSTS) {
-       av->serverHost[j++] = 0;
-    }
-    afs_SortServers(av->serverHost, MAXHOSTS);
-} /*InstallNVolumeEntry*/
 
+    ObtainWriteLock(&av->lock, 110);
+
+    memcpy(av->serverHost, serverHost, sizeof(serverHost));
 
-void InstallUVolumeEntry(struct volume *av, struct uvldbentry *ve,
-                        int acell, struct cell *tcell, struct vrequest *areq)
+    /* from above */
+    av->states |= types;
+
+    /* fill in volume types */
+    av->rwVol = ((ve->flags & VLF_RWEXISTS) ? ve->volumeId[RWVOL] : 0);
+    av->roVol = ((ve->flags & VLF_ROEXISTS) ? ve->volumeId[ROVOL] : 0);
+    av->backVol = ((ve->flags & VLF_BACKEXISTS) ? ve->volumeId[BACKVOL] : 0);
+
+    if (ve->flags & VLF_DFSFILESET)
+       av->states |= VForeign;
+
+    afs_SortServers(av->serverHost, AFS_MAXHOSTS);
+}                              /*InstallNVolumeEntry */
+
+
+void
+LockAndInstallUVolumeEntry(struct volume *av, struct uvldbentry *ve, int acell,
+                          struct cell *tcell, struct vrequest *areq)
 {
-    register struct server *ts;
-    struct conn *tconn;
+    struct server *ts;
+    struct afs_conn *tconn;
     struct cell *cellp;
-    register int i, j;
+    int i, j;
     afs_uint32 serverid;
     afs_int32 mask;
     int k;
+    char type = 0;
+    struct server *serverHost[AFS_MAXHOSTS];
 
     AFS_STATCNT(InstallVolumeEntry);
 
+    memset(serverHost, 0, sizeof(serverHost));
+
     /* Determine type of volume we want */
     if ((ve->flags & VLF_RWEXISTS) && (av->volume == ve->volumeId[RWVOL])) {
-       mask = VLSF_RWVOL;
-    }
-    else if ((ve->flags & VLF_ROEXISTS) && av->volume == ve->volumeId[ROVOL]) {
-       mask = VLSF_ROVOL;
-       av->states |= VRO;
-    }
-    else if ((ve->flags & VLF_BACKEXISTS) && (av->volume == ve->volumeId[BACKVOL])) {
-       /* backup always is on the same volume as parent */
-       mask = VLSF_RWVOL;
-       av->states |= (VRO|VBackup);
-    }
-    else {
-       mask = 0;      /* Can't find volume in vldb entry */
+       mask = VLSF_RWVOL;
+    } else if ((ve->flags & VLF_ROEXISTS)
+              && av->volume == ve->volumeId[ROVOL]) {
+       mask = VLSF_ROVOL;
+       type |= VRO;
+    } else if ((ve->flags & VLF_BACKEXISTS)
+              && (av->volume == ve->volumeId[BACKVOL])) {
+       /* backup always is on the same volume as parent */
+       mask = VLSF_RWVOL;
+       type |= (VRO | VBackup);
+    } else {
+       mask = 0;               /* Can't find volume in vldb entry */
     }
 
-    /* fill in volume types */
-    av->rwVol   = ((ve->flags & VLF_RWEXISTS)   ? ve->volumeId[RWVOL]   : 0);
-    av->roVol   = ((ve->flags & VLF_ROEXISTS)   ? ve->volumeId[ROVOL]   : 0);
-    av->backVol = ((ve->flags & VLF_BACKEXISTS) ? ve->volumeId[BACKVOL] : 0);
-
-    if (ve->flags & VLF_DFSFILESET)
-       av->states |= VForeign;
-
     cellp = afs_GetCell(acell, 0);
 
-    /* This volume, av, is locked. Zero out the serverHosts[] array 
-     * so that if afs_GetServer() decides to replace the server 
-     * struct, we don't deadlock trying to afs_ResetVolumeInfo()
-     * this volume.
-     */
-    for (j=0; j<MAXHOSTS; j++) {
-       av->serverHost[j] = 0;
-    }
-
     /* Gather the list of servers the VLDB says the volume is on
      * and initialize the ve->serverHost[] array. If a server struct
      * is not found, then get the list of addresses for the
      * server, VL_GetAddrsU(), and create a server struct, afs_GetServer().
      */
-    for (i=0,j=0; i<ve->nServers; i++) {
-        if ( ((ve->serverFlags[i] & mask) == 0) || (ve->serverFlags[i] & VLSF_DONTUSE) ) {
-          continue;       /* wrong volume don't use this volume */
+    for (i = 0, j = 0; i < ve->nServers; i++) {
+       if (((ve->serverFlags[i] & mask) == 0)
+           || (ve->serverFlags[i] & VLSF_DONTUSE)) {
+           continue;           /* wrong volume don't use this volume */
        }
 
-       if (!(ve->serverFlags[i] & VLSERVER_FLAG_UUID)) {
+       if (!(ve->serverFlags[i] & VLSF_UUID)) {
            /* The server has no uuid */
            serverid = htonl(ve->serverNumber[i].time_low);
-           ts = afs_GetServer(&serverid, 1, acell, cellp->fsport, WRITE_LOCK, (afsUUID *)0,0);
+           ts = afs_GetServer(&serverid, 1, acell, cellp->fsport,
+                              WRITE_LOCK, (afsUUID *) 0, 0, av);
        } else {
            ts = afs_FindServer(0, cellp->fsport, &ve->serverNumber[i], 0);
-           if (ts && (ts->sr_addr_uniquifier == ve->serverUnique[i]) && ts->addr) {
-              /* uuid, uniquifier, and portal are the same */
+           if (ts && (ts->sr_addr_uniquifier == ve->serverUnique[i])
+               && ts->addr) {
+               /* uuid, uniquifier, and portal are the same */
            } else {
-               afs_uint32 *addrp, nentries, code, unique;
+               afs_uint32 *addrp, code;
+               afs_int32 nentries, unique;
                bulkaddrs addrs;
                ListAddrByAttributes attrs;
                afsUUID uuid;
+               struct rx_connection *rxconn;
 
-               memset((char *)&attrs, 0, sizeof(attrs));
+               memset(&attrs, 0, sizeof(attrs));
                attrs.Mask = VLADDR_UUID;
                attrs.uuid = ve->serverNumber[i];
-               memset((char *)&uuid, 0, sizeof(uuid));
-               memset((char *)&addrs, 0, sizeof(addrs));
+               memset(&uuid, 0, sizeof(uuid));
+               memset(&addrs, 0, sizeof(addrs));
                do {
-                   tconn = afs_ConnByMHosts(tcell->cellHosts, tcell->vlport,
-                                            tcell->cellNum, areq, SHARED_LOCK);
+                   tconn =
+                       afs_ConnByMHosts(tcell->cellHosts, tcell->vlport,
+                                        tcell->cellNum, areq, SHARED_LOCK,
+                                        0, &rxconn);
                    if (tconn) {
                        RX_AFS_GUNLOCK();
-                       code = VL_GetAddrsU(tconn->id, &attrs, &uuid, &unique, &nentries, &addrs);
+                       code =
+                           VL_GetAddrsU(rxconn, &attrs, &uuid, &unique,
+                                        &nentries, &addrs);
                        RX_AFS_GLOCK();
                    } else {
                        code = -1;
@@ -933,8 +1185,8 @@ void InstallUVolumeEntry(struct volume *av, struct uvldbentry *ve,
                    if (code == 0 && nentries == 0)
                        code = VL_NOENT;
 
-               } while (afs_Analyze(tconn, code, NULL, areq,
-                                    -1, SHARED_LOCK, tcell));
+               } while (afs_Analyze
+                        (tconn, rxconn, code, NULL, areq, -1, SHARED_LOCK, tcell));
                if (code) {
                    /* Better handing of such failures; for now we'll simply retry this call */
                    areq->volumeError = 1;
@@ -943,15 +1195,16 @@ void InstallUVolumeEntry(struct volume *av, struct uvldbentry *ve,
 
                addrp = addrs.bulkaddrs_val;
                for (k = 0; k < nentries; k++) {
-                  addrp[k] = htonl(addrp[k]);
+                   addrp[k] = htonl(addrp[k]);
                }
-               ts = afs_GetServer(addrp, nentries, acell, cellp->fsport,
-                                  WRITE_LOCK, &ve->serverNumber[i],
-                                  ve->serverUnique[i]);
-               afs_osi_Free(addrs.bulkaddrs_val, addrs.bulkaddrs_len*sizeof(*addrp));
+               ts = afs_GetServer(addrp, nentries, acell,
+                                  cellp->fsport, WRITE_LOCK,
+                                  &ve->serverNumber[i],
+                                  ve->serverUnique[i], av);
+               xdr_free((xdrproc_t) xdr_bulkaddrs, &addrs);
            }
        }
-       av->serverHost[j] = ts;
+       serverHost[j] = ts;
 
        /* The cell field could be 0 if the server entry was created
         * first with the 'fs setserverprefs' call which doesn't set
@@ -959,29 +1212,55 @@ void InstallUVolumeEntry(struct volume *av, struct uvldbentry *ve,
         * follows later on it will find the server entry thus it will
         * simply return without setting any fields, so we set the
         * field ourselves below.
-         */
+        */
        if (!ts->cell)
            ts->cell = cellp;
        afs_PutServer(ts, WRITE_LOCK);
        j++;
     }
 
-    afs_SortServers(av->serverHost, MAXHOSTS);
-} /*InstallVolumeEntry*/
+    ObtainWriteLock(&av->lock, 111);
+
+    memcpy(av->serverHost, serverHost, sizeof(serverHost));
 
+    /* from above */
+    av->states |= type;
 
-void afs_ResetVolumeInfo(struct volume *tv)
+    /* fill in volume types */
+    av->rwVol = ((ve->flags & VLF_RWEXISTS) ? ve->volumeId[RWVOL] : 0);
+    av->roVol = ((ve->flags & VLF_ROEXISTS) ? ve->volumeId[ROVOL] : 0);
+    av->backVol = ((ve->flags & VLF_BACKEXISTS) ? ve->volumeId[BACKVOL] : 0);
+
+    if (ve->flags & VLF_DFSFILESET)
+       av->states |= VForeign;
+
+    afs_SortServers(av->serverHost, AFS_MAXHOSTS);
+}                              /*InstallVolumeEntry */
+
+
+/**
+ *   Reset volume info for the specified volume strecture. Mark volume
+ * to be rechecked next time.
+ * @param tv
+ */
+void
+afs_ResetVolumeInfo(struct volume *tv)
 {
     int i;
 
     AFS_STATCNT(afs_ResetVolumeInfo);
-    ObtainWriteLock(&tv->lock,117);
+    ObtainWriteLock(&tv->lock, 117);
     tv->states |= VRecheck;
-    for (i=0; i<MAXHOSTS; i++)
-      tv->status[i] = not_busy;
+
+    /* the hard-mount code in afs_Analyze may not be able to reset this flag
+     * when VRecheck is set, so clear it here to ensure it gets cleared. */
+    tv->states &= ~VHardMount;
+
+    for (i = 0; i < AFS_MAXHOSTS; i++)
+       tv->status[i] = not_busy;
     if (tv->name) {
-       afs_osi_Free(tv->name, strlen(tv->name)+1);
+       afs_osi_Free(tv->name, strlen(tv->name) + 1);
        tv->name = NULL;
-      }
+    }
     ReleaseWriteLock(&tv->lock);
 }