src/WINNT/afsd/cm_volume.c

   1 /*
   2  * Copyright 2000, International Business Machines Corporation and others.
   3  * All Rights Reserved.
   4  *
   5  * This software has been released under the terms of the IBM Public
   6  * License.  For details, see the LICENSE file in the top-level source
   7  * directory or online at http://www.openafs.org/dl/license10.html
   8  */
   9
  10 #include <afs/param.h>
  11 #include <afs/stds.h>
  12
  13 #include <windows.h>
  14 #include <winsock2.h>
  15 #include <nb30.h>
  16 #include <string.h>
  17 #include <malloc.h>
  18 #include "afsd.h"
  19 #include <osi.h>
  20 #include <rx/rx.h>
  21
  22 osi_rwlock_t cm_volumeLock;
  23
  24 long
  25 cm_ValidateVolume(void)
  26 {
  27     cm_volume_t * volp;
  28     afs_uint32 count;
  29
  30     for (volp = cm_data.allVolumesp, count = 0; volp; volp=volp->allNextp, count++) {
  31         if ( volp->magic != CM_VOLUME_MAGIC ) {
  32             afsi_log("cm_ValidateVolume failure: volp->magic != CM_VOLUME_MAGIC");
  33             fprintf(stderr, "cm_ValidateVolume failure: volp->magic != CM_VOLUME_MAGIC\n");
  34             return -1;
  35         }
  36         if ( volp->cellp && volp->cellp->magic != CM_CELL_MAGIC ) {
  37             afsi_log("cm_ValidateVolume failure: volp->cellp->magic != CM_CELL_MAGIC");
  38             fprintf(stderr, "cm_ValidateVolume failure: volp->cellp->magic != CM_CELL_MAGIC\n");
  39             return -2;
  40         }
  41         if ( volp->allNextp && volp->allNextp->magic != CM_VOLUME_MAGIC ) {
  42             afsi_log("cm_ValidateVolume failure: volp->allNextp->magic != CM_VOLUME_MAGIC");
  43             fprintf(stderr, "cm_ValidateVolume failure: volp->allNextp->magic != CM_VOLUME_MAGIC\n");
  44             return -3;
  45         }
  46         if ( count != 0 && volp == cm_data.allVolumesp ||
  47              count > cm_data.maxVolumes ) {
  48             afsi_log("cm_ValidateVolume failure: cm_data.allVolumep loop detected");
  49             fprintf(stderr, "cm_ValidateVolume failure: cm_data.allVolumep loop detected\n");
  50             return -4;
  51         }
  52     }
  53
  54     if ( count != cm_data.currentVolumes ) {
  55         afsi_log("cm_ValidateVolume failure: count != cm_data.currentVolumes");
  56         fprintf(stderr, "cm_ValidateVolume failure: count != cm_data.currentVolumes\n");
  57         return -5;
  58     }
  59
  60     return 0;
  61 }
  62
  63 long
  64 cm_ShutdownVolume(void)
  65 {
  66     cm_volume_t * volp;
  67
  68     for (volp = cm_data.allVolumesp; volp; volp=volp->allNextp) {
  69         afs_uint32 volType;
  70         for ( volType = RWVOL; volType < NUM_VOL_TYPES; volType++) {
  71             if (volp->vol[volType].ID)
  72                 cm_VolumeStatusNotification(volp, volp->vol[volType].ID, volp->vol[volType].state, vl_alldown);
  73         }
  74         volp->cbExpiresRO = 0;
  75         volp->cbServerpRO = NULL;
  76         lock_FinalizeRWLock(&volp->rw);
  77     }
  78
  79     return 0;
  80 }
  81
  82 void cm_InitVolume(int newFile, long maxVols)
  83 {
  84     static osi_once_t once;
  85
  86     if (osi_Once(&once)) {
  87         lock_InitializeRWLock(&cm_volumeLock, "cm global volume lock", LOCK_HIERARCHY_VOLUME_GLOBAL);
  88
  89         if ( newFile ) {
  90             cm_data.allVolumesp = NULL;
  91             cm_data.currentVolumes = 0;
  92             cm_data.maxVolumes = maxVols;
  93             memset(cm_data.volumeNameHashTablep, 0, sizeof(cm_volume_t *) * cm_data.volumeHashTableSize);
  94             memset(cm_data.volumeRWIDHashTablep, 0, sizeof(cm_volume_t *) * cm_data.volumeHashTableSize);
  95             memset(cm_data.volumeROIDHashTablep, 0, sizeof(cm_volume_t *) * cm_data.volumeHashTableSize);
  96             memset(cm_data.volumeBKIDHashTablep, 0, sizeof(cm_volume_t *) * cm_data.volumeHashTableSize);
  97             cm_data.volumeLRUFirstp = cm_data.volumeLRULastp = NULL;
  98         } else {
  99             cm_volume_t * volp;
 100
 101             for (volp = cm_data.allVolumesp; volp; volp=volp->allNextp) {
 102                 afs_uint32 volType;
 103
 104                 lock_InitializeRWLock(&volp->rw, "cm_volume_t rwlock", LOCK_HIERARCHY_VOLUME);
 105                 volp->flags |= CM_VOLUMEFLAG_RESET;
 106                 volp->flags &= ~CM_VOLUMEFLAG_UPDATING_VL;
 107                 for (volType = RWVOL; volType < NUM_VOL_TYPES; volType++) {
 108                     volp->vol[volType].state = vl_unknown;
 109                     volp->vol[volType].serversp = NULL;
 110                     if (volp->vol[volType].ID)
 111                         cm_VolumeStatusNotification(volp, volp->vol[volType].ID, vl_unknown, volp->vol[volType].state);
 112                 }
 113                 volp->cbExpiresRO = 0;
 114                 volp->cbServerpRO = NULL;
 115             }
 116         }
 117         osi_EndOnce(&once);
 118     }
 119 }
 120
 121
 122 /* returns true if the id is a decimal integer, in which case we interpret it
 123  * as an id.  make the cache manager much simpler.
 124  * Stolen from src/volser/vlprocs.c */
 125 int
 126 cm_VolNameIsID(char *aname)
 127 {
 128     int tc;
 129     while (tc = *aname++) {
 130         if (tc > '9' || tc < '0')
 131             return 0;
 132     }
 133     return 1;
 134 }
 135
 136
 137 /*
 138  * Update a volume.  Caller holds a write lock on the volume (volp->rw).
 139  *
 140  *
 141  *  shadow / openafs / jhutz@CS.CMU.EDU {ANDREW.CMU.EDU}  01:38    (JHutz)
 142  *    Yes, we support multihomed fileservers.
 143  *    Since before we got the code from IBM.
 144  *    But to find out about multiple addresses on a multihomed server, you need
 145  *    to use VL_GetEntryByNameU and VL_GetAddrsU.  If you use
 146  *    VL_GetEntryByNameO or VL_GetEntryByNameN, the vlserver just gives you one
 147  *    address per server.
 148  *  shadow / openafs / jhutz@CS.CMU.EDU {ANDREW.CMU.EDU}  01:39    (JHutz)
 149  *    see src/afs/afs_volume.c, paying particular attention to
 150  *    afs_NewVolumeByName, afs_SetupVolume, and InstallUVolumeEntry
 151  *  shadow / openafs / jaltman {ANDREW.CMU.EDU}  01:40    (Jeffrey Altman)
 152  *    thanks.  The windows client calls the 0 versions.
 153  *  shadow / openafs / jhutz@CS.CMU.EDU {ANDREW.CMU.EDU}  01:51    (JHutz)
 154  *    Oh.  Ew.
 155  *    By not using the N versions, you only get up to 8 sites instead of 13.
 156  *    By not using the U versions, you don't get to know about multihomed serve
 157  *  shadow / openafs / jhutz@CS.CMU.EDU {ANDREW.CMU.EDU}  01:52    (JHutz)
 158  *    Of course, you probably want to support the older versions for backward
 159  *    compatibility.  If you do that, you need to call the newest interface
 160  *    first, and fall back to successively older versions if you get
 161  *    RXGEN_OPCODE.
 162  */
 163 #define MULTIHOMED 1
 164 long cm_UpdateVolumeLocation(struct cm_cell *cellp, cm_user_t *userp, cm_req_t *reqp,
 165                      cm_volume_t *volp)
 166 {
 167     cm_conn_t *connp;
 168     int i;
 169     afs_uint32 j, k;
 170     cm_serverRef_t *tsrp;
 171     cm_server_t *tsp;
 172     struct sockaddr_in tsockAddr;
 173     long tflags;
 174     u_long tempAddr;
 175     struct vldbentry vldbEntry;
 176     struct nvldbentry nvldbEntry;
 177 #ifdef MULTIHOMED
 178     struct uvldbentry uvldbEntry;
 179 #endif
 180     int method = -1;
 181     int ROcount = 0;
 182     long code;
 183     enum volstatus rwNewstate = vl_online;
 184     enum volstatus roNewstate = vl_online;
 185     enum volstatus bkNewstate = vl_online;
 186 #ifdef AFS_FREELANCE_CLIENT
 187     int freelance = 0;
 188 #endif
 189     afs_uint32 volType;
 190
 191     lock_AssertWrite(&volp->rw);
 192
 193 #ifdef AFS_FREELANCE_CLIENT
 194     if ( cellp->cellID == AFS_FAKE_ROOT_CELL_ID && volp->vol[RWVOL].ID == AFS_FAKE_ROOT_VOL_ID )
 195     {
 196         freelance = 1;
 197         memset(&vldbEntry, 0, sizeof(vldbEntry));
 198         vldbEntry.flags |= VLF_RWEXISTS;
 199         vldbEntry.volumeId[0] = AFS_FAKE_ROOT_VOL_ID;
 200         code = 0;
 201         method = 0;
 202     } else
 203 #endif
 204     {
 205         while (volp->flags & CM_VOLUMEFLAG_UPDATING_VL) {
 206             osi_Log3(afsd_logp, "cm_UpdateVolumeLocation sleeping name %s:%s flags 0x%x",
 207                      volp->cellp->name, volp->namep, volp->flags);
 208             osi_SleepW((LONG_PTR) &volp->flags, &volp->rw);
 209             lock_ObtainWrite(&volp->rw);
 210             osi_Log3(afsd_logp, "cm_UpdateVolumeLocation awake name %s:%s flags 0x%x",
 211                      volp->cellp->name, volp->namep, volp->flags);
 212             if (!(volp->flags & CM_VOLUMEFLAG_RESET)) {
 213                 osi_Log3(afsd_logp, "cm_UpdateVolumeLocation nothing to do, waking others name %s:%s flags 0x%x",
 214                          volp->cellp->name, volp->namep, volp->flags);
 215                 osi_Wakeup((LONG_PTR) &volp->flags);
 216                 return 0;
 217             }
 218         }
 219
 220         /* clear out old bindings */
 221         for ( volType = RWVOL; volType < NUM_VOL_TYPES; volType++) {
 222             if (volp->vol[volType].serversp)
 223                 cm_FreeServerList(&volp->vol[volType].serversp, CM_FREESERVERLIST_DELETE);
 224         }
 225
 226         volp->flags |= CM_VOLUMEFLAG_UPDATING_VL;
 227         lock_ReleaseWrite(&volp->rw);
 228
 229         if (cellp->flags & CM_CELLFLAG_VLSERVER_INVALID)
 230             cm_UpdateCell(cellp, 0);
 231
 232         /* now we have volume structure locked and held; make RPC to fill it */
 233         osi_Log2(afsd_logp, "CALL VL_GetEntryByName{UNO} name %s:%s",
 234                   osi_LogSaveString(afsd_logp,volp->cellp->name),
 235                   osi_LogSaveString(afsd_logp,volp->namep));
 236         do {
 237             struct rx_connection * rxconnp;
 238
 239             code = cm_ConnByMServers(cellp->vlServersp, userp, reqp, &connp);
 240             if (code)
 241                 continue;
 242
 243             rxconnp = cm_GetRxConn(connp);
 244 #ifdef MULTIHOMED
 245             code = VL_GetEntryByNameU(rxconnp, volp->namep, &uvldbEntry);
 246             method = 2;
 247             if ( code == RXGEN_OPCODE )
 248 #endif
 249             {
 250                 code = VL_GetEntryByNameN(rxconnp, volp->namep, &nvldbEntry);
 251                 method = 1;
 252             }
 253             if ( code == RXGEN_OPCODE ) {
 254                 code = VL_GetEntryByNameO(rxconnp, volp->namep, &vldbEntry);
 255                 method = 0;
 256             }
 257             rx_PutConnection(rxconnp);
 258         } while (cm_Analyze(connp, userp, reqp, NULL, NULL, cellp->vlServersp, NULL, code));
 259         code = cm_MapVLRPCError(code, reqp);
 260         if ( code )
 261             osi_Log3(afsd_logp, "CALL VL_GetEntryByName{UNO} name %s:%s FAILURE, code 0x%x",
 262                       osi_LogSaveString(afsd_logp,volp->cellp->name),
 263                       osi_LogSaveString(afsd_logp,volp->namep), code);
 264         else
 265             osi_Log2(afsd_logp, "CALL VL_GetEntryByName{UNO} name %s:%s SUCCESS",
 266                       osi_LogSaveString(afsd_logp,volp->cellp->name),
 267                       osi_LogSaveString(afsd_logp,volp->namep));
 268     }
 269
 270     /* We can end up here with code == CM_ERROR_NOSUCHVOLUME if the base volume name
 271      * does not exist but there might exist a .readonly volume.  If the base name
 272      * doesn't exist we will not care about the .backup that might be left behind
 273      * since there should be no method to access it.
 274      */
 275     if (code == CM_ERROR_NOSUCHVOLUME && volp->vol[RWVOL].ID == 0 && strlen(volp->namep) < (VL_MAXNAMELEN - 9)) {
 276         char name[VL_MAXNAMELEN];
 277
 278         snprintf(name, VL_MAXNAMELEN, "%s.readonly", volp->namep);
 279
 280         /* now we have volume structure locked and held; make RPC to fill it */
 281         osi_Log2(afsd_logp, "CALL VL_GetEntryByName{UNO} name %s:%s",
 282                  osi_LogSaveString(afsd_logp,volp->cellp->name),
 283                  osi_LogSaveString(afsd_logp,name));
 284         do {
 285             struct rx_connection * rxconnp;
 286
 287             code = cm_ConnByMServers(cellp->vlServersp, userp, reqp, &connp);
 288             if (code)
 289                 continue;
 290
 291             rxconnp = cm_GetRxConn(connp);
 292 #ifdef MULTIHOMED
 293             code = VL_GetEntryByNameU(connp->rxconnp, name, &uvldbEntry);
 294             method = 2;
 295             if ( code == RXGEN_OPCODE )
 296 #endif
 297             {
 298                 code = VL_GetEntryByNameN(connp->rxconnp, name, &nvldbEntry);
 299                 method = 1;
 300             }
 301             if ( code == RXGEN_OPCODE ) {
 302                 code = VL_GetEntryByNameO(connp->rxconnp, name, &vldbEntry);
 303                 method = 0;
 304             }
 305             rx_PutConnection(rxconnp);
 306         } while (cm_Analyze(connp, userp, reqp, NULL, NULL, cellp->vlServersp, NULL, code));
 307         code = cm_MapVLRPCError(code, reqp);
 308         if ( code )
 309             osi_Log3(afsd_logp, "CALL VL_GetEntryByName{UNO} name %s:%s FAILURE, code 0x%x",
 310                      osi_LogSaveString(afsd_logp,volp->cellp->name),
 311                      osi_LogSaveString(afsd_logp,name), code);
 312         else
 313             osi_Log2(afsd_logp, "CALL VL_GetEntryByName{UNO} name %s:%s SUCCESS",
 314                      osi_LogSaveString(afsd_logp,volp->cellp->name),
 315                      osi_LogSaveString(afsd_logp,name));
 316     }
 317
 318     lock_ObtainWrite(&volp->rw);
 319     if (code == 0) {
 320         afs_int32 flags;
 321         afs_int32 nServers;
 322         afs_int32 rwID;
 323         afs_int32 roID;
 324         afs_int32 bkID;
 325         afs_int32 serverNumber[NMAXNSERVERS];
 326         afs_int32 serverFlags[NMAXNSERVERS];
 327         afsUUID   serverUUID[NMAXNSERVERS];
 328         afs_int32 rwServers_alldown = 1;
 329         afs_int32 roServers_alldown = 1;
 330         afs_int32 bkServers_alldown = 1;
 331         char      name[VL_MAXNAMELEN];
 332
 333 #ifdef AFS_FREELANCE_CLIENT
 334         if (freelance)
 335             rwServers_alldown = 0;
 336 #endif
 337
 338         memset(serverUUID, 0, sizeof(serverUUID));
 339
 340         switch ( method ) {
 341         case 0:
 342             flags = vldbEntry.flags;
 343             nServers = vldbEntry.nServers;
 344             rwID = vldbEntry.volumeId[0];
 345             roID = vldbEntry.volumeId[1];
 346             bkID = vldbEntry.volumeId[2];
 347             for ( i=0; i<nServers; i++ ) {
 348                 serverFlags[i] = vldbEntry.serverFlags[i];
 349                 serverNumber[i] = vldbEntry.serverNumber[i];
 350             }
 351             strncpy(name, vldbEntry.name, VL_MAXNAMELEN);
 352             name[VL_MAXNAMELEN - 1] = '\0';
 353             break;
 354         case 1:
 355             flags = nvldbEntry.flags;
 356             nServers = nvldbEntry.nServers;
 357             rwID = nvldbEntry.volumeId[0];
 358             roID = nvldbEntry.volumeId[1];
 359             bkID = nvldbEntry.volumeId[2];
 360             for ( i=0; i<nServers; i++ ) {
 361                 serverFlags[i] = nvldbEntry.serverFlags[i];
 362                 serverNumber[i] = nvldbEntry.serverNumber[i];
 363             }
 364             strncpy(name, nvldbEntry.name, VL_MAXNAMELEN);
 365             name[VL_MAXNAMELEN - 1] = '\0';
 366             break;
 367 #ifdef MULTIHOMED
 368         case 2:
 369             flags = uvldbEntry.flags;
 370             nServers = uvldbEntry.nServers;
 371             rwID = uvldbEntry.volumeId[0];
 372             roID = uvldbEntry.volumeId[1];
 373             bkID = uvldbEntry.volumeId[2];
 374             for ( i=0, j=0; code == 0 && i<nServers && j<NMAXNSERVERS; i++ ) {
 375                 if ( !(uvldbEntry.serverFlags[i] & VLSERVER_FLAG_UUID) ) {
 376                     serverFlags[j] = uvldbEntry.serverFlags[i];
 377                     serverNumber[j] = uvldbEntry.serverNumber[i].time_low;
 378                     j++;
 379                 } else {
 380                     afs_uint32 * addrp, nentries, code, unique;
 381                     bulkaddrs  addrs;
 382                     ListAddrByAttributes attrs;
 383                     afsUUID uuid;
 384
 385                     memset((char *)&attrs, 0, sizeof(attrs));
 386                     attrs.Mask = VLADDR_UUID;
 387                     attrs.uuid = uvldbEntry.serverNumber[i];
 388                     memset((char *)&uuid, 0, sizeof(uuid));
 389                     memset((char *)&addrs, 0, sizeof(addrs));
 390
 391                     do {
 392                         struct rx_connection *rxconnp;
 393
 394                         code = cm_ConnByMServers(cellp->vlServersp, userp, reqp, &connp);
 395                         if (code)
 396                             continue;
 397
 398                         rxconnp = cm_GetRxConn(connp);
 399                         code = VL_GetAddrsU(rxconnp, &attrs, &uuid, &unique, &nentries, &addrs);
 400                         rx_PutConnection(rxconnp);
 401                     } while (cm_Analyze(connp, userp, reqp, NULL, NULL, cellp->vlServersp, NULL, code));
 402
 403                     if ( code ) {
 404                         code = cm_MapVLRPCError(code, reqp);
 405                         osi_Log2(afsd_logp, "CALL VL_GetAddrsU serverNumber %u FAILURE, code 0x%x",
 406                                  i, code);
 407                         continue;
 408                     }
 409                     osi_Log1(afsd_logp, "CALL VL_GetAddrsU serverNumber %u SUCCESS", i);
 410
 411                     addrp = addrs.bulkaddrs_val;
 412                     for (k = 0; k < nentries && j < NMAXNSERVERS; j++, k++) {
 413                         serverFlags[j] = uvldbEntry.serverFlags[i];
 414                         serverNumber[j] = addrp[k];
 415                         serverUUID[j] = uuid;
 416                     }
 417
 418                     xdr_free(addrs.bulkaddrs_val, addrs.bulkaddrs_len * sizeof(*addrs.bulkaddrs_val));
 419
 420                     if (nentries == 0)
 421                         code = CM_ERROR_INVAL;
 422                 }
 423             }
 424             nServers = j;                                       /* update the server count */
 425             strncpy(name, uvldbEntry.name, VL_MAXNAMELEN);
 426             name[VL_MAXNAMELEN - 1] = '\0';
 427             break;
 428 #endif
 429         }
 430
 431         /* decode the response */
 432         lock_ObtainWrite(&cm_volumeLock);
 433         if (cm_VolNameIsID(volp->namep)) {
 434             size_t    len;
 435
 436             len = strlen(name);
 437
 438             if (len >= 8 && strcmp(name + len - 7, ".backup") == 0) {
 439                 name[len - 7] = '\0';
 440             } else if (len >= 10 && strcmp(name + len - 9, ".readonly") == 0) {
 441                 name[len - 9] = '\0';
 442             }
 443
 444             osi_Log2(afsd_logp, "cm_UpdateVolume name %s -> %s",
 445                      osi_LogSaveString(afsd_logp,volp->namep), osi_LogSaveString(afsd_logp,name));
 446
 447             if (volp->flags & CM_VOLUMEFLAG_IN_HASH)
 448                 cm_RemoveVolumeFromNameHashTable(volp);
 449
 450             strcpy(volp->namep, name);
 451
 452             cm_AddVolumeToNameHashTable(volp);
 453         }
 454
 455         if (flags & VLF_RWEXISTS) {
 456             if (volp->vol[RWVOL].ID != rwID) {
 457                 if (volp->vol[RWVOL].flags & CM_VOLUMEFLAG_IN_HASH)
 458                     cm_RemoveVolumeFromIDHashTable(volp, RWVOL);
 459                 volp->vol[RWVOL].ID = rwID;
 460                 cm_AddVolumeToIDHashTable(volp, RWVOL);
 461             }
 462         } else {
 463             if (volp->vol[RWVOL].flags & CM_VOLUMEFLAG_IN_HASH)
 464                 cm_RemoveVolumeFromIDHashTable(volp, RWVOL);
 465             volp->vol[RWVOL].ID = 0;
 466         }
 467         if (flags & VLF_ROEXISTS) {
 468             if (volp->vol[ROVOL].ID != roID) {
 469                 if (volp->vol[ROVOL].flags & CM_VOLUMEFLAG_IN_HASH)
 470                     cm_RemoveVolumeFromIDHashTable(volp, ROVOL);
 471                 volp->vol[ROVOL].ID = roID;
 472                 cm_AddVolumeToIDHashTable(volp, ROVOL);
 473             }
 474         } else {
 475             if (volp->vol[ROVOL].flags & CM_VOLUMEFLAG_IN_HASH)
 476                 cm_RemoveVolumeFromIDHashTable(volp, ROVOL);
 477             volp->vol[ROVOL].ID = 0;
 478         }
 479         if (flags & VLF_BACKEXISTS) {
 480             if (volp->vol[BACKVOL].ID != bkID) {
 481                 if (volp->vol[BACKVOL].flags & CM_VOLUMEFLAG_IN_HASH)
 482                     cm_RemoveVolumeFromIDHashTable(volp, BACKVOL);
 483                 volp->vol[BACKVOL].ID = bkID;
 484                 cm_AddVolumeToIDHashTable(volp, BACKVOL);
 485             }
 486         } else {
 487             if (volp->vol[BACKVOL].flags & CM_VOLUMEFLAG_IN_HASH)
 488                 cm_RemoveVolumeFromIDHashTable(volp, BACKVOL);
 489             volp->vol[BACKVOL].ID = 0;
 490         }
 491         lock_ReleaseWrite(&cm_volumeLock);
 492         for (i=0; i<nServers; i++) {
 493             /* create a server entry */
 494             tflags = serverFlags[i];
 495             if (tflags & VLSF_DONTUSE)
 496                 continue;
 497             tsockAddr.sin_family = AF_INET;
 498             tempAddr = htonl(serverNumber[i]);
 499             tsockAddr.sin_addr.s_addr = tempAddr;
 500             tsp = cm_FindServer(&tsockAddr, CM_SERVER_FILE);
 501             if (tsp && (method == 2) && (tsp->flags & CM_SERVERFLAG_UUID)) {
 502                 /*
 503                  * Check to see if the uuid of the server we know at this address
 504                  * matches the uuid of the server we are being told about by the
 505                  * vlserver.  If not, ...?
 506                  */
 507                 if (!afs_uuid_equal(&serverUUID[i], &tsp->uuid)) {
 508                     char uuid1[128], uuid2[128];
 509                     char hoststr[16];
 510
 511                     afsUUID_to_string(&serverUUID[i], uuid1, sizeof(uuid1));
 512                     afsUUID_to_string(&tsp->uuid, uuid2, sizeof(uuid2));
 513                     afs_inet_ntoa_r(serverNumber[i], hoststr);
 514
 515                     osi_Log3(afsd_logp, "cm_UpdateVolumeLocation UUIDs do not match! %s != %s (%s)",
 516                               osi_LogSaveString(afsd_logp, uuid1),
 517                               osi_LogSaveString(afsd_logp, uuid2),
 518                               osi_LogSaveString(afsd_logp, hoststr));
 519                 }
 520             }
 521             if (!tsp) {
 522                 /* cm_NewServer will probe the server which in turn will
 523                  * update the state on the volume group object */
 524                 lock_ReleaseWrite(&volp->rw);
 525                 tsp = cm_NewServer(&tsockAddr, CM_SERVER_FILE, cellp, &serverUUID[i], 0);
 526                 lock_ObtainWrite(&volp->rw);
 527             }
 528             osi_assertx(tsp != NULL, "null cm_server_t");
 529
 530             /*
 531              * if this server was created by fs setserverprefs
 532              * then it won't have either a cell assignment or
 533              * a server uuid.
 534              */
 535             if ( !tsp->cellp )
 536                 tsp->cellp = cellp;
 537             if ( (method == 2) && !(tsp->flags & CM_SERVERFLAG_UUID) &&
 538                  !afs_uuid_is_nil(&serverUUID[i])) {
 539                 tsp->uuid = serverUUID[i];
 540                 tsp->flags |= CM_SERVERFLAG_UUID;
 541             }
 542
 543             /* and add it to the list(s). */
 544             /*
 545              * Each call to cm_NewServerRef() increments the
 546              * ref count of tsp.  These reference will be dropped,
 547              * if and when the volume is reset; see reset code
 548              * earlier in this function.
 549              */
 550             if ((tflags & VLSF_RWVOL) && (flags & VLF_RWEXISTS)) {
 551                 tsrp = cm_NewServerRef(tsp, rwID);
 552                 cm_InsertServerList(&volp->vol[RWVOL].serversp, tsrp);
 553
 554                 lock_ObtainWrite(&cm_serverLock);
 555                 tsrp->refCount--;       /* drop allocation reference */
 556                 lock_ReleaseWrite(&cm_serverLock);
 557
 558                 if (!(tsp->flags & CM_SERVERFLAG_DOWN))
 559                     rwServers_alldown = 0;
 560             }
 561             if ((tflags & VLSF_ROVOL) && (flags & VLF_ROEXISTS)) {
 562                 tsrp = cm_NewServerRef(tsp, roID);
 563                 cm_InsertServerList(&volp->vol[ROVOL].serversp, tsrp);
 564                 lock_ObtainWrite(&cm_serverLock);
 565                 tsrp->refCount--;       /* drop allocation reference */
 566                 lock_ReleaseWrite(&cm_serverLock);
 567                 ROcount++;
 568
 569                 if (!(tsp->flags & CM_SERVERFLAG_DOWN))
 570                     roServers_alldown = 0;
 571             }
 572             /* We don't use VLSF_BACKVOL !?! */
 573             /* Because only the backup on the server holding the RW
 574              * volume can be valid.  This check prevents errors if a
 575              * RW is moved but the old backup is not removed.
 576              */
 577             if ((tflags & VLSF_RWVOL) && (flags & VLF_BACKEXISTS)) {
 578                 tsrp = cm_NewServerRef(tsp, bkID);
 579                 cm_InsertServerList(&volp->vol[BACKVOL].serversp, tsrp);
 580                 lock_ObtainWrite(&cm_serverLock);
 581                 tsrp->refCount--;       /* drop allocation reference */
 582                 lock_ReleaseWrite(&cm_serverLock);
 583
 584                 if (!(tsp->flags & CM_SERVERFLAG_DOWN))
 585                     bkServers_alldown = 0;
 586             }
 587             /* Drop the reference obtained by cm_FindServer() */
 588             cm_PutServer(tsp);
 589         }
 590
 591         /*
 592          * Randomize RO list
 593          *
 594          * If the first n servers have the same ipRank, then we
 595          * randomly pick one among them and move it to the beginning.
 596          * We don't bother to re-order the whole list because
 597          * the rest of the list is used only if the first server is
 598          * down.  We only do this for the RO list; we assume the other
 599          * lists are length 1.
 600          */
 601         if (ROcount > 1) {
 602             cm_RandomizeServer(&volp->vol[ROVOL].serversp);
 603         }
 604
 605
 606         rwNewstate = rwServers_alldown ? vl_alldown : vl_online;
 607         roNewstate = roServers_alldown ? vl_alldown : vl_online;
 608         bkNewstate = bkServers_alldown ? vl_alldown : vl_online;
 609     } else if (code == CM_ERROR_NOSUCHVOLUME || code == VL_NOENT || code == VL_BADNAME) {
 610         /* this volume does not exist - we should discard it */
 611         if (volp->flags & CM_VOLUMEFLAG_IN_HASH)
 612             cm_RemoveVolumeFromNameHashTable(volp);
 613         for ( volType = RWVOL; volType < NUM_VOL_TYPES; volType++) {
 614             if (volp->vol[volType].flags & CM_VOLUMEFLAG_IN_HASH)
 615                 cm_RemoveVolumeFromIDHashTable(volp, volType);
 616             if (volp->vol[volType].ID) {
 617                 cm_VolumeStatusNotification(volp, volp->vol[volType].ID, volp->vol[volType].state, vl_alldown);
 618                 volp->vol[volType].ID = 0;
 619             }
 620             cm_SetFid(&volp->vol[volType].dotdotFid, 0, 0, 0, 0);
 621         }
 622
 623         /* Move to the end so it will be recycled first */
 624         cm_MoveVolumeToLRULast(volp);
 625
 626         volp->namep[0] ='\0';
 627     } else {
 628         rwNewstate = roNewstate = bkNewstate = vl_alldown;
 629     }
 630
 631     if (volp->vol[RWVOL].state != rwNewstate) {
 632         if (volp->vol[RWVOL].ID)
 633             cm_VolumeStatusNotification(volp, volp->vol[RWVOL].ID, volp->vol[RWVOL].state, rwNewstate);
 634         volp->vol[RWVOL].state = rwNewstate;
 635     }
 636     if (volp->vol[ROVOL].state != roNewstate) {
 637         if (volp->vol[ROVOL].ID)
 638             cm_VolumeStatusNotification(volp, volp->vol[ROVOL].ID, volp->vol[ROVOL].state, roNewstate);
 639         volp->vol[ROVOL].state = roNewstate;
 640     }
 641     if (volp->vol[BACKVOL].state != bkNewstate) {
 642         if (volp->vol[BACKVOL].ID)
 643             cm_VolumeStatusNotification(volp, volp->vol[BACKVOL].ID, volp->vol[BACKVOL].state, bkNewstate);
 644         volp->vol[BACKVOL].state = bkNewstate;
 645     }
 646
 647     if (code == 0)
 648         volp->flags &= ~CM_VOLUMEFLAG_RESET;
 649
 650     volp->flags &= ~CM_VOLUMEFLAG_UPDATING_VL;
 651     osi_Log4(afsd_logp, "cm_UpdateVolumeLocation done, waking others name %s:%s flags 0x%x code 0x%x",
 652              osi_LogSaveString(afsd_logp,volp->cellp->name),
 653              osi_LogSaveString(afsd_logp,volp->namep), volp->flags, code);
 654     osi_Wakeup((LONG_PTR) &volp->flags);
 655
 656     return code;
 657 }
 658
 659 /* Requires read or write lock on cm_volumeLock */
 660 void cm_GetVolume(cm_volume_t *volp)
 661 {
 662     InterlockedIncrement(&volp->refCount);
 663 }
 664
 665 cm_volume_t *cm_GetVolumeByFID(cm_fid_t *fidp)
 666 {
 667     cm_volume_t *volp;
 668     afs_uint32 hash;
 669
 670     lock_ObtainRead(&cm_volumeLock);
 671     hash = CM_VOLUME_ID_HASH(fidp->volume);
 672     /* The volumeID can be any one of the three types.  So we must
 673      * search the hash table for all three types until we find it.
 674      * We will search in the order of RO, RW, BK.
 675      */
 676     for ( volp = cm_data.volumeROIDHashTablep[hash]; volp; volp = volp->vol[ROVOL].nextp) {
 677         if ( fidp->cell == volp->cellp->cellID && fidp->volume == volp->vol[ROVOL].ID )
 678             break;
 679     }
 680     if (!volp) {
 681         /* try RW volumes */
 682         for ( volp = cm_data.volumeRWIDHashTablep[hash]; volp; volp = volp->vol[RWVOL].nextp) {
 683             if ( fidp->cell == volp->cellp->cellID && fidp->volume == volp->vol[RWVOL].ID )
 684                 break;
 685         }
 686     }
 687     if (!volp) {
 688         /* try BK volumes */
 689         for ( volp = cm_data.volumeBKIDHashTablep[hash]; volp; volp = volp->vol[BACKVOL].nextp) {
 690             if ( fidp->cell == volp->cellp->cellID && fidp->volume == volp->vol[BACKVOL].ID )
 691                 break;
 692         }
 693     }
 694
 695     /* hold the volume if we found it */
 696     if (volp)
 697         cm_GetVolume(volp);
 698
 699     lock_ReleaseRead(&cm_volumeLock);
 700     return volp;
 701 }
 702
 703 long cm_FindVolumeByID(cm_cell_t *cellp, afs_uint32 volumeID, cm_user_t *userp,
 704                       cm_req_t *reqp, afs_uint32 flags, cm_volume_t **outVolpp)
 705 {
 706     cm_volume_t *volp;
 707 #ifdef SEARCH_ALL_VOLUMES
 708     cm_volume_t *volp2;
 709 #endif
 710     char volNameString[VL_MAXNAMELEN];
 711     afs_uint32 hash;
 712     long code = 0;
 713
 714     lock_ObtainRead(&cm_volumeLock);
 715 #ifdef SEARCH_ALL_VOLUMES
 716     for(volp = cm_data.allVolumesp; volp; volp=volp->allNextp) {
 717         if (cellp == volp->cellp &&
 718              ((unsigned) volumeID == volp->vol[RWVOL].ID ||
 719                (unsigned) volumeID == volp->vol[ROVOL].ID ||
 720                (unsigned) volumeID == volp->vol[BACKVOL].ID))
 721             break;
 722     }
 723
 724     volp2 = volp;
 725 #endif /* SEARCH_ALL_VOLUMES */
 726
 727     hash = CM_VOLUME_ID_HASH(volumeID);
 728     /* The volumeID can be any one of the three types.  So we must
 729      * search the hash table for all three types until we find it.
 730      * We will search in the order of RO, RW, BK.
 731      */
 732     for ( volp = cm_data.volumeROIDHashTablep[hash]; volp; volp = volp->vol[ROVOL].nextp) {
 733         if ( cellp == volp->cellp && volumeID == volp->vol[ROVOL].ID )
 734             break;
 735     }
 736     if (!volp) {
 737         /* try RW volumes */
 738         for ( volp = cm_data.volumeRWIDHashTablep[hash]; volp; volp = volp->vol[RWVOL].nextp) {
 739             if ( cellp == volp->cellp && volumeID == volp->vol[RWVOL].ID )
 740                 break;
 741         }
 742     }
 743     if (!volp) {
 744         /* try BK volumes */
 745         for ( volp = cm_data.volumeBKIDHashTablep[hash]; volp; volp = volp->vol[BACKVOL].nextp) {
 746             if ( cellp == volp->cellp && volumeID == volp->vol[BACKVOL].ID )
 747                 break;
 748         }
 749     }
 750
 751 #ifdef SEARCH_ALL_VOLUMES
 752     osi_assertx(volp == volp2, "unexpected cm_vol_t");
 753 #endif
 754
 755     /* hold the volume if we found it */
 756     if (volp)
 757         cm_GetVolume(volp);
 758
 759     lock_ReleaseRead(&cm_volumeLock);
 760
 761     /* return it held */
 762     if (volp) {
 763         lock_ObtainWrite(&volp->rw);
 764
 765         code = 0;
 766         if ((volp->flags & CM_VOLUMEFLAG_RESET) && !(flags & CM_GETVOL_FLAG_NO_RESET)) {
 767             code = cm_UpdateVolumeLocation(cellp, userp, reqp, volp);
 768         }
 769         lock_ReleaseWrite(&volp->rw);
 770         if (code == 0) {
 771             *outVolpp = volp;
 772
 773             if (!(flags & CM_GETVOL_FLAG_NO_LRU_UPDATE)) {
 774                 lock_ObtainWrite(&cm_volumeLock);
 775                 cm_AdjustVolumeLRU(volp);
 776                 lock_ReleaseWrite(&cm_volumeLock);
 777             }
 778         } else {
 779             lock_ObtainRead(&cm_volumeLock);
 780             cm_PutVolume(volp);
 781             lock_ReleaseRead(&cm_volumeLock);
 782         }
 783         return code;
 784     }
 785
 786     /* otherwise, we didn't find it so consult the VLDB */
 787     sprintf(volNameString, "%u", volumeID);
 788     code = cm_FindVolumeByName(cellp, volNameString, userp, reqp,
 789                               flags | CM_GETVOL_FLAG_IGNORE_LINKED_CELL, outVolpp);
 790
 791     if (code == CM_ERROR_NOSUCHVOLUME && cellp->linkedName[0] &&
 792         !(flags & CM_GETVOL_FLAG_IGNORE_LINKED_CELL)) {
 793         cm_cell_t *linkedCellp = cm_GetCell(cellp->linkedName, flags);
 794
 795         if (linkedCellp)
 796             code = cm_FindVolumeByID(linkedCellp, volumeID, userp, reqp,
 797                                      flags | CM_GETVOL_FLAG_IGNORE_LINKED_CELL,
 798                                      outVolpp);
 799     }
 800     return code;
 801 }
 802
 803
 804 long cm_FindVolumeByName(struct cm_cell *cellp, char *volumeNamep,
 805                         struct cm_user *userp, struct cm_req *reqp,
 806                         afs_uint32 flags, cm_volume_t **outVolpp)
 807 {
 808     cm_volume_t *volp;
 809 #ifdef SEARCH_ALL_VOLUMES
 810     cm_volume_t *volp2;
 811 #endif
 812     long        code = 0;
 813     char        name[VL_MAXNAMELEN];
 814     size_t      len;
 815     int         type;
 816     afs_uint32  hash;
 817
 818     strncpy(name, volumeNamep, VL_MAXNAMELEN);
 819     name[VL_MAXNAMELEN-1] = '\0';
 820     len = strlen(name);
 821
 822     if (len >= 8 && strcmp(name + len - 7, ".backup") == 0) {
 823         type = BACKVOL;
 824         name[len - 7] = '\0';
 825     } else if (len >= 10 && strcmp(name + len - 9, ".readonly") == 0) {
 826         type = ROVOL;
 827         name[len - 9] = '\0';
 828     } else {
 829         type = RWVOL;
 830     }
 831
 832     lock_ObtainRead(&cm_volumeLock);
 833 #ifdef SEARCH_ALL_VOLUMES
 834     for (volp = cm_data.allVolumesp; volp; volp=volp->allNextp) {
 835         if (cellp == volp->cellp && strcmp(name, volp->namep) == 0) {
 836             break;
 837         }
 838     }
 839     volp2 = volp;
 840 #endif /* SEARCH_ALL_VOLUMES */
 841
 842     hash = CM_VOLUME_NAME_HASH(name);
 843     for (volp = cm_data.volumeNameHashTablep[hash]; volp; volp = volp->nameNextp) {
 844         if (cellp == volp->cellp && strcmp(name, volp->namep) == 0)
 845             break;
 846     }
 847
 848 #ifdef SEARCH_ALL_VOLUMES
 849     osi_assertx(volp2 == volp, "unexpected cm_vol_t");
 850 #endif
 851
 852     if (!volp && (flags & CM_GETVOL_FLAG_CREATE)) {
 853         afs_uint32 volType;
 854         /* otherwise, get from VLDB */
 855
 856         /*
 857          * Change to a write lock so that we have exclusive use of
 858          * the first cm_volume_t with a refCount of 0 so that we
 859          * have time to increment it.
 860          */
 861         lock_ConvertRToW(&cm_volumeLock);
 862
 863         if ( cm_data.currentVolumes >= cm_data.maxVolumes ) {
 864 #ifdef RECYCLE_FROM_ALL_VOLUMES_LIST
 865             for (volp = cm_data.allVolumesp; volp; volp=volp->allNextp) {
 866                 if ( volp->refCount == 0 ) {
 867                     /* There is one we can re-use */
 868                     break;
 869                 }
 870             }
 871 #else
 872             for ( volp = cm_data.volumeLRULastp;
 873                   volp;
 874                   volp = (cm_volume_t *) osi_QPrev(&volp->q))
 875             {
 876                 if ( volp->refCount == 0 ) {
 877                     /* There is one we can re-use */
 878                     break;
 879                 }
 880             }
 881 #endif
 882             if (!volp)
 883                 osi_panic("Exceeded Max Volumes", __FILE__, __LINE__);
 884
 885             InterlockedIncrement(&volp->refCount);
 886             lock_ReleaseWrite(&cm_volumeLock);
 887             lock_ObtainWrite(&volp->rw);
 888             lock_ObtainWrite(&cm_volumeLock);
 889
 890             osi_Log2(afsd_logp, "Recycling Volume %s:%s",
 891                      volp->cellp->name, volp->namep);
 892
 893             if (volp->flags & CM_VOLUMEFLAG_IN_LRU_QUEUE)
 894                 cm_RemoveVolumeFromLRU(volp);
 895             if (volp->flags & CM_VOLUMEFLAG_IN_HASH)
 896                 cm_RemoveVolumeFromNameHashTable(volp);
 897
 898             for ( volType = RWVOL; volType < NUM_VOL_TYPES; volType++) {
 899                 if (volp->vol[volType].flags & CM_VOLUMEFLAG_IN_HASH)
 900                     cm_RemoveVolumeFromIDHashTable(volp, volType);
 901                 if (volp->vol[volType].ID)
 902                     cm_VolumeStatusNotification(volp, volp->vol[volType].ID, volp->vol[volType].state, vl_unknown);
 903                 volp->vol[volType].ID = 0;
 904                 cm_SetFid(&volp->vol[volType].dotdotFid, 0, 0, 0, 0);
 905                 lock_ReleaseWrite(&cm_volumeLock);
 906                 cm_FreeServerList(&volp->vol[volType].serversp, CM_FREESERVERLIST_DELETE);
 907                 lock_ObtainWrite(&cm_volumeLock);
 908             }
 909         } else {
 910             volp = &cm_data.volumeBaseAddress[cm_data.currentVolumes++];
 911             memset(volp, 0, sizeof(cm_volume_t));
 912             volp->magic = CM_VOLUME_MAGIC;
 913             volp->allNextp = cm_data.allVolumesp;
 914             cm_data.allVolumesp = volp;
 915             lock_InitializeRWLock(&volp->rw, "cm_volume_t rwlock", LOCK_HIERARCHY_VOLUME);
 916             lock_ReleaseWrite(&cm_volumeLock);
 917             lock_ObtainWrite(&volp->rw);
 918             lock_ObtainWrite(&cm_volumeLock);
 919             volp->refCount = 1; /* starts off held */
 920         }
 921         volp->cellp = cellp;
 922         strncpy(volp->namep, name, VL_MAXNAMELEN);
 923         volp->namep[VL_MAXNAMELEN-1] = '\0';
 924         volp->flags = CM_VOLUMEFLAG_RESET;
 925
 926         for ( volType = RWVOL; volType < NUM_VOL_TYPES; volType++) {
 927             volp->vol[volType].state = vl_unknown;
 928             volp->vol[volType].nextp = NULL;
 929             volp->vol[volType].flags = 0;
 930         }
 931         volp->cbExpiresRO = 0;
 932         volp->cbServerpRO = NULL;
 933         cm_AddVolumeToNameHashTable(volp);
 934         lock_ReleaseWrite(&cm_volumeLock);
 935     }
 936     else {
 937         if (volp)
 938             cm_GetVolume(volp);
 939         lock_ReleaseRead(&cm_volumeLock);
 940
 941         if (!volp)
 942             return CM_ERROR_NOSUCHVOLUME;
 943
 944         lock_ObtainWrite(&volp->rw);
 945     }
 946
 947     /* if we get here we are holding the mutex */
 948     if ((volp->flags & CM_VOLUMEFLAG_RESET) && !(flags & CM_GETVOL_FLAG_NO_RESET)) {
 949         code = cm_UpdateVolumeLocation(cellp, userp, reqp, volp);
 950     }
 951     lock_ReleaseWrite(&volp->rw);
 952
 953     if (code == 0 && (type == BACKVOL && volp->vol[BACKVOL].ID == 0 ||
 954                       type == ROVOL && volp->vol[ROVOL].ID == 0))
 955         code = CM_ERROR_NOSUCHVOLUME;
 956
 957     if (code == 0) {
 958         *outVolpp = volp;
 959
 960         if (!(flags & CM_GETVOL_FLAG_NO_LRU_UPDATE)) {
 961             lock_ObtainWrite(&cm_volumeLock);
 962             cm_AdjustVolumeLRU(volp);
 963             lock_ReleaseWrite(&cm_volumeLock);
 964         }
 965     } else {
 966         lock_ObtainRead(&cm_volumeLock);
 967         cm_PutVolume(volp);
 968         lock_ReleaseRead(&cm_volumeLock);
 969     }
 970
 971     if (code == CM_ERROR_NOSUCHVOLUME && cellp->linkedName[0] &&
 972         !(flags & CM_GETVOL_FLAG_IGNORE_LINKED_CELL)) {
 973         cm_cell_t *linkedCellp = cm_GetCell(cellp->linkedName, flags);
 974
 975         if (linkedCellp)
 976             code = cm_FindVolumeByName(linkedCellp, volumeNamep, userp, reqp,
 977                                        flags | CM_GETVOL_FLAG_IGNORE_LINKED_CELL,
 978                                        outVolpp);
 979     }
 980     return code;
 981 }
 982
 983 /*
 984  * Only call this function in response to a VNOVOL or VMOVED error
 985  * from a file server.  Do not call it in response to CM_ERROR_NOSUCHVOLUME
 986  * as that can lead to recursive calls.
 987  */
 988 long cm_ForceUpdateVolume(cm_fid_t *fidp, cm_user_t *userp, cm_req_t *reqp)
 989 {
 990     cm_cell_t *cellp;
 991     cm_volume_t *volp;
 992 #ifdef SEARCH_ALL_VOLUMES
 993     cm_volume_t *volp2;
 994 #endif
 995     afs_uint32  hash;
 996     long code;
 997
 998     if (!fidp)
 999         return CM_ERROR_INVAL;
1000
1001     cellp = cm_FindCellByID(fidp->cell, 0);
1002     if (!cellp)
1003         return CM_ERROR_NOSUCHCELL;
1004
1005     /* search for the volume */
1006     lock_ObtainRead(&cm_volumeLock);
1007 #ifdef SEARCH_ALL_VOLUMES
1008     for(volp = cm_data.allVolumesp; volp; volp=volp->allNextp) {
1009         if (cellp == volp->cellp &&
1010              (fidp->volume == volp->vol[RWVOL].ID ||
1011                fidp->volume == volp->vol[ROVOL].ID ||
1012                fidp->volume == volp->vol[BACKVOL].ID))
1013             break;
1014     }
1015 #endif /* SEARCH_ALL_VOLUMES */
1016
1017     hash = CM_VOLUME_ID_HASH(fidp->volume);
1018     /* The volumeID can be any one of the three types.  So we must
1019      * search the hash table for all three types until we find it.
1020      * We will search in the order of RO, RW, BK.
1021      */
1022     for ( volp = cm_data.volumeROIDHashTablep[hash]; volp; volp = volp->vol[ROVOL].nextp) {
1023         if ( cellp == volp->cellp && fidp->volume == volp->vol[ROVOL].ID )
1024             break;
1025     }
1026     if (!volp) {
1027         /* try RW volumes */
1028         for ( volp = cm_data.volumeRWIDHashTablep[hash]; volp; volp = volp->vol[RWVOL].nextp) {
1029             if ( cellp == volp->cellp && fidp->volume == volp->vol[RWVOL].ID )
1030                 break;
1031         }
1032     }
1033     if (!volp) {
1034         /* try BK volumes */
1035         for ( volp = cm_data.volumeBKIDHashTablep[hash]; volp; volp = volp->vol[BACKVOL].nextp) {
1036             if ( cellp == volp->cellp && fidp->volume == volp->vol[BACKVOL].ID )
1037                 break;
1038         }
1039     }
1040
1041 #ifdef SEARCH_ALL_VOLUMES
1042     osi_assertx(volp == volp2, "unexpected cm_vol_t");
1043 #endif
1044     /* hold the volume if we found it */
1045     if (volp)
1046         cm_GetVolume(volp);
1047
1048     lock_ReleaseRead(&cm_volumeLock);
1049
1050     if (!volp)
1051         return CM_ERROR_NOSUCHVOLUME;
1052
1053     /* update it */
1054     cm_data.mountRootGen = time(NULL);
1055     lock_ObtainWrite(&volp->rw);
1056     volp->flags |= CM_VOLUMEFLAG_RESET;
1057
1058     code = cm_UpdateVolumeLocation(cellp, userp, reqp, volp);
1059     lock_ReleaseWrite(&volp->rw);
1060
1061     lock_ObtainRead(&cm_volumeLock);
1062     cm_PutVolume(volp);
1063     lock_ReleaseRead(&cm_volumeLock);
1064
1065     return code;
1066 }
1067
1068 /* find the appropriate servers from a volume */
1069 cm_serverRef_t **cm_GetVolServers(cm_volume_t *volp, afs_uint32 volume, cm_user_t *userp, cm_req_t *reqp)
1070 {
1071     cm_serverRef_t **serverspp;
1072     cm_serverRef_t *current;
1073     int firstTry = 1;
1074
1075   start:
1076     lock_ObtainWrite(&cm_serverLock);
1077
1078     if (volume == volp->vol[RWVOL].ID)
1079         serverspp = &volp->vol[RWVOL].serversp;
1080     else if (volume == volp->vol[ROVOL].ID)
1081         serverspp = &volp->vol[ROVOL].serversp;
1082     else if (volume == volp->vol[BACKVOL].ID)
1083         serverspp = &volp->vol[BACKVOL].serversp;
1084     else {
1085         lock_ReleaseWrite(&cm_serverLock);
1086         if (firstTry) {
1087             afs_int32 code;
1088             firstTry = 0;
1089             lock_ObtainWrite(&volp->rw);
1090             volp->flags |= CM_VOLUMEFLAG_RESET;
1091             code = cm_UpdateVolumeLocation(volp->cellp, userp, reqp, volp);
1092             lock_ReleaseWrite(&volp->rw);
1093             if (code == 0)
1094                 goto start;
1095         }
1096         return NULL;
1097     }
1098
1099     /*
1100      * Increment the refCount on deleted items as well.
1101      * They will be freed by cm_FreeServerList when they get to zero
1102      */
1103     for (current = *serverspp; current; current = current->next)
1104         current->refCount++;
1105
1106     lock_ReleaseWrite(&cm_serverLock);
1107
1108     return serverspp;
1109 }
1110
1111 void cm_PutVolume(cm_volume_t *volp)
1112 {
1113     afs_int32 refCount = InterlockedDecrement(&volp->refCount);
1114     osi_assertx(refCount >= 0, "cm_volume_t refCount underflow has occurred");
1115 }
1116
1117 /* return the read-only volume, if there is one, or the read-write volume if
1118  * not.
1119  */
1120 long cm_GetROVolumeID(cm_volume_t *volp)
1121 {
1122     long id;
1123
1124     lock_ObtainRead(&volp->rw);
1125     if (volp->vol[ROVOL].ID && volp->vol[ROVOL].serversp)
1126         id = volp->vol[ROVOL].ID;
1127     else
1128         id = volp->vol[RWVOL].ID;
1129     lock_ReleaseRead(&volp->rw);
1130
1131     return id;
1132 }
1133
1134 void cm_RefreshVolumes(void)
1135 {
1136     cm_volume_t *volp;
1137     cm_scache_t *scp;
1138     afs_int32 refCount;
1139
1140     cm_data.mountRootGen = time(NULL);
1141
1142     /* force a re-loading of volume data from the vldb */
1143     lock_ObtainRead(&cm_volumeLock);
1144     for (volp = cm_data.allVolumesp; volp; volp=volp->allNextp) {
1145         InterlockedIncrement(&volp->refCount);
1146         lock_ReleaseRead(&cm_volumeLock);
1147
1148         lock_ObtainWrite(&volp->rw);
1149         volp->flags |= CM_VOLUMEFLAG_RESET;
1150         lock_ReleaseWrite(&volp->rw);
1151
1152         lock_ObtainRead(&cm_volumeLock);
1153         refCount = InterlockedDecrement(&volp->refCount);
1154         osi_assertx(refCount >= 0, "cm_volume_t refCount underflow");
1155     }
1156     lock_ReleaseRead(&cm_volumeLock);
1157
1158     /* force mount points to be re-evaluated so that
1159      * if the volume location has changed we will pick
1160      * that up
1161      */
1162     for ( scp = cm_data.scacheLRUFirstp;
1163           scp;
1164           scp = (cm_scache_t *) osi_QNext(&scp->q)) {
1165         if ( scp->fileType == CM_SCACHETYPE_MOUNTPOINT
1166 #ifdef AFS_FREELANCE_CLIENT
1167              && !(scp->fid.cell == AFS_FAKE_ROOT_CELL_ID && scp->fid.volume == AFS_FAKE_ROOT_VOL_ID)
1168 #endif
1169              ) {
1170             lock_ObtainWrite(&scp->rw);
1171             scp->mountPointStringp[0] = '\0';
1172             lock_ReleaseWrite(&scp->rw);
1173         }
1174     }
1175
1176 }
1177
1178 void
1179 cm_CheckOfflineVolumeState(cm_volume_t *volp, cm_vol_state_t *statep, afs_uint32 volID,
1180                            afs_uint32 *onlinep, afs_uint32 *volumeUpdatedp)
1181 {
1182     cm_conn_t *connp;
1183     long code;
1184     AFSFetchVolumeStatus volStat;
1185     char *Name;
1186     char *OfflineMsg;
1187     char *MOTD;
1188     cm_req_t req;
1189     struct rx_connection * rxconnp;
1190     char volName[32];
1191     char offLineMsg[256];
1192     char motd[256];
1193     long alldown, alldeleted;
1194     cm_serverRef_t *serversp;
1195
1196     Name = volName;
1197     OfflineMsg = offLineMsg;
1198     MOTD = motd;
1199
1200     if (statep->ID != 0 && (!volID || volID == statep->ID)) {
1201         if (!statep->serversp && !(*volumeUpdatedp)) {
1202             cm_InitReq(&req);
1203             code = cm_UpdateVolumeLocation(volp->cellp, cm_rootUserp, &req, volp);
1204             *volumeUpdatedp = 1;
1205         }
1206
1207         if (statep->serversp) {
1208             alldown = 1;
1209             alldeleted = 1;
1210             for (serversp = statep->serversp; serversp; serversp = serversp->next) {
1211                 if (serversp->status == srv_deleted)
1212                     continue;
1213
1214                 alldeleted = 0;
1215                 *onlinep = 1;
1216                 alldown = 0;
1217
1218                 if (serversp->status == srv_busy || serversp->status == srv_offline)
1219                     serversp->status = srv_not_busy;
1220             }
1221
1222             if (alldeleted && !(*volumeUpdatedp)) {
1223                 cm_InitReq(&req);
1224                 code = cm_UpdateVolumeLocation(volp->cellp, cm_rootUserp, &req, volp);
1225                 *volumeUpdatedp = 1;
1226             }
1227
1228             if (statep->state == vl_busy || statep->state == vl_offline || statep->state == vl_unknown ||
1229                 (!alldown && statep->state == vl_alldown)) {
1230                 cm_InitReq(&req);
1231
1232                 lock_ReleaseWrite(&volp->rw);
1233                 do {
1234                     code = cm_ConnFromVolume(volp, statep->ID, cm_rootUserp, &req, &connp);
1235                     if (code)
1236                         continue;
1237
1238                     rxconnp = cm_GetRxConn(connp);
1239                     code = RXAFS_GetVolumeStatus(rxconnp, statep->ID,
1240                                                  &volStat, &Name, &OfflineMsg, &MOTD);
1241                     rx_PutConnection(rxconnp);
1242
1243                 } while (cm_Analyze(connp, cm_rootUserp, &req, NULL, NULL, NULL, NULL, code));
1244                 code = cm_MapRPCError(code, &req);
1245
1246                 lock_ObtainWrite(&volp->rw);
1247                 if (code == 0 && volStat.Online) {
1248                     cm_VolumeStatusNotification(volp, statep->ID, statep->state, vl_online);
1249                     statep->state = vl_online;
1250                     *onlinep = 1;
1251                 } else if (code == CM_ERROR_NOACCESS) {
1252                     cm_VolumeStatusNotification(volp, statep->ID, statep->state, vl_unknown);
1253                     statep->state = vl_unknown;
1254                     *onlinep = 1;
1255                 }
1256             } else if (alldown && statep->state != vl_alldown) {
1257                 cm_VolumeStatusNotification(volp, statep->ID, statep->state, vl_alldown);
1258                 statep->state = vl_alldown;
1259             }
1260         } else if (statep->state != vl_alldown) {
1261             cm_VolumeStatusNotification(volp, statep->ID, statep->state, vl_alldown);
1262             statep->state = vl_alldown;
1263         }
1264     }
1265 }
1266
1267 /* The return code is 0 if the volume is not online and
1268  * 1 if the volume is online
1269  */
1270 long
1271 cm_CheckOfflineVolume(cm_volume_t *volp, afs_uint32 volID)
1272 {
1273     long code;
1274     cm_req_t req;
1275     afs_uint32 online = 0;
1276     afs_uint32 volumeUpdated = 0;
1277
1278     lock_ObtainWrite(&volp->rw);
1279
1280     if (volp->flags & CM_VOLUMEFLAG_RESET) {
1281         cm_InitReq(&req);
1282         code = cm_UpdateVolumeLocation(volp->cellp, cm_rootUserp, &req, volp);
1283         volumeUpdated = 1;
1284     }
1285
1286     cm_CheckOfflineVolumeState(volp, &volp->vol[RWVOL], volID, &online, &volumeUpdated);
1287     cm_CheckOfflineVolumeState(volp, &volp->vol[ROVOL], volID, &online, &volumeUpdated);
1288     cm_CheckOfflineVolumeState(volp, &volp->vol[BACKVOL], volID, &online, &volumeUpdated);
1289
1290     lock_ReleaseWrite(&volp->rw);
1291     return online;
1292 }
1293
1294
1295 /* called from the Daemon thread */
1296 void cm_CheckOfflineVolumes(void)
1297 {
1298     cm_volume_t *volp;
1299     afs_int32 refCount;
1300     extern int daemon_ShutdownFlag;
1301
1302     lock_ObtainRead(&cm_volumeLock);
1303     for (volp = cm_data.allVolumesp; volp && !daemon_ShutdownFlag; volp=volp->allNextp) {
1304         if (volp->flags & CM_VOLUMEFLAG_IN_HASH) {
1305             InterlockedIncrement(&volp->refCount);
1306             lock_ReleaseRead(&cm_volumeLock);
1307             cm_CheckOfflineVolume(volp, 0);
1308             lock_ObtainRead(&cm_volumeLock);
1309             refCount = InterlockedDecrement(&volp->refCount);
1310             osi_assertx(refCount >= 0, "cm_volume_t refCount underflow");
1311         }
1312     }
1313     lock_ReleaseRead(&cm_volumeLock);
1314 }
1315
1316
1317 static void
1318 cm_UpdateVolumeStatusInt(cm_volume_t *volp, struct cm_vol_state *statep)
1319 {
1320     enum volstatus newStatus;
1321     cm_serverRef_t *tsrp;
1322     cm_server_t *tsp;
1323     int someBusy = 0, someOffline = 0, allOffline = 1, allBusy = 1, allDown = 1;
1324     char addr[16];
1325
1326     if (!volp || !statep) {
1327 #ifdef DEBUG
1328         DebugBreak();
1329 #endif
1330         return;
1331     }
1332
1333     lock_ObtainWrite(&cm_serverLock);
1334     for (tsrp = statep->serversp; tsrp; tsrp=tsrp->next) {
1335         tsp = tsrp->server;
1336         sprintf(addr, "%d.%d.%d.%d",
1337                  ((tsp->addr.sin_addr.s_addr & 0xff)),
1338                  ((tsp->addr.sin_addr.s_addr & 0xff00)>> 8),
1339                  ((tsp->addr.sin_addr.s_addr & 0xff0000)>> 16),
1340                  ((tsp->addr.sin_addr.s_addr & 0xff000000)>> 24));
1341
1342         if (tsrp->status == srv_deleted) {
1343             osi_Log2(afsd_logp, "cm_UpdateVolumeStatusInt volume %d server reference %s deleted",
1344                      statep->ID, osi_LogSaveString(afsd_logp,addr));
1345             continue;
1346         }
1347         if (tsp) {
1348             cm_GetServerNoLock(tsp);
1349             if (!(tsp->flags & CM_SERVERFLAG_DOWN)) {
1350                 allDown = 0;
1351                 if (tsrp->status == srv_busy) {
1352                     osi_Log2(afsd_logp, "cm_UpdateVolumeStatusInt volume %d server reference %s busy",
1353                               statep->ID, osi_LogSaveString(afsd_logp,addr));
1354                     allOffline = 0;
1355                     someBusy = 1;
1356                 } else if (tsrp->status == srv_offline) {
1357                     osi_Log2(afsd_logp, "cm_UpdateVolumeStatusInt volume %d server reference %s offline",
1358                               statep->ID, osi_LogSaveString(afsd_logp,addr));
1359                     allBusy = 0;
1360                     someOffline = 1;
1361                 } else {
1362                     osi_Log2(afsd_logp, "cm_UpdateVolumeStatusInt volume %d server reference %s online",
1363                               statep->ID, osi_LogSaveString(afsd_logp,addr));
1364                     allOffline = 0;
1365                     allBusy = 0;
1366                 }
1367             } else {
1368                 osi_Log2(afsd_logp, "cm_UpdateVolumeStatusInt volume %d server reference %s online",
1369                           statep->ID, osi_LogSaveString(afsd_logp,addr));
1370             }
1371             cm_PutServerNoLock(tsp);
1372         }
1373     }
1374     lock_ReleaseWrite(&cm_serverLock);
1375
1376     osi_Log5(afsd_logp, "cm_UpdateVolumeStatusInt allDown %d allBusy %d someBusy %d someOffline %d allOffline %d",
1377              allDown, allBusy, someBusy, someOffline, allOffline);
1378
1379     if (allDown)
1380         newStatus = vl_alldown;
1381     else if (allBusy || (someBusy && someOffline))
1382         newStatus = vl_busy;
1383     else if (allOffline)
1384         newStatus = vl_offline;
1385     else
1386         newStatus = vl_online;
1387
1388     if (statep->ID && statep->state != newStatus)
1389         cm_VolumeStatusNotification(volp, statep->ID, statep->state, newStatus);
1390
1391     statep->state = newStatus;
1392 }
1393
1394 void
1395 cm_UpdateVolumeStatus(cm_volume_t *volp, afs_uint32 volID)
1396 {
1397
1398     if (volp->vol[RWVOL].ID == volID) {
1399         cm_UpdateVolumeStatusInt(volp, &volp->vol[RWVOL]);
1400     } else if (volp->vol[ROVOL].ID == volID) {
1401         cm_UpdateVolumeStatusInt(volp, &volp->vol[ROVOL]);
1402     } else if (volp->vol[BACKVOL].ID == volID) {
1403         cm_UpdateVolumeStatusInt(volp, &volp->vol[BACKVOL]);
1404     } else {
1405         /*
1406          * If we are called with volID == 0 then something has gone wrong.
1407          * Most likely a race occurred in the server volume list maintenance.
1408          * Since we don't know which volume's status should be updated,
1409          * just update all of them that are known to exist.  Better to be
1410          * correct than fast.
1411          */
1412         afs_uint32 volType;
1413         for ( volType = RWVOL; volType < NUM_VOL_TYPES; volType++) {
1414             if (volp->vol[volType].ID != 0)
1415                 cm_UpdateVolumeStatusInt(volp, &volp->vol[volType]);
1416         }
1417     }
1418 }
1419
1420 /*
1421 ** Finds all volumes that reside on this server and reorders their
1422 ** RO list according to the changed rank of server.
1423 */
1424 void cm_ChangeRankVolume(cm_server_t *tsp)
1425 {
1426     int                 code;
1427     cm_volume_t*        volp;
1428     afs_int32 refCount;
1429
1430     /* find volumes which might have RO copy on server*/
1431     lock_ObtainRead(&cm_volumeLock);
1432     for(volp = cm_data.allVolumesp; volp; volp=volp->allNextp)
1433     {
1434         code = 1 ;      /* assume that list is unchanged */
1435         InterlockedIncrement(&volp->refCount);
1436         lock_ReleaseRead(&cm_volumeLock);
1437         lock_ObtainWrite(&volp->rw);
1438
1439         if ((tsp->cellp==volp->cellp) && (volp->vol[ROVOL].serversp))
1440             code =cm_ChangeRankServer(&volp->vol[ROVOL].serversp, tsp);
1441
1442         /* this volume list was changed */
1443         if ( !code )
1444             cm_RandomizeServer(&volp->vol[ROVOL].serversp);
1445
1446         lock_ReleaseWrite(&volp->rw);
1447         lock_ObtainRead(&cm_volumeLock);
1448         refCount = InterlockedDecrement(&volp->refCount);
1449         osi_assertx(refCount >= 0, "cm_volume_t refCount underflow");
1450     }
1451     lock_ReleaseRead(&cm_volumeLock);
1452 }
1453
1454 /* dump all volumes that have reference count > 0 to a file.
1455  * cookie is used to identify this batch for easy parsing,
1456  * and it a string provided by a caller
1457  */
1458 int cm_DumpVolumes(FILE *outputFile, char *cookie, int lock)
1459 {
1460     int zilch;
1461     cm_volume_t *volp;
1462     char output[1024];
1463
1464     if (lock) {
1465         lock_ObtainRead(&cm_scacheLock);
1466         lock_ObtainRead(&cm_volumeLock);
1467     }
1468
1469     sprintf(output, "%s - dumping volumes - cm_data.currentVolumes=%d, cm_data.maxVolumes=%d\r\n", cookie, cm_data.currentVolumes, cm_data.maxVolumes);
1470     WriteFile(outputFile, output, (DWORD)strlen(output), &zilch, NULL);
1471
1472     for (volp = cm_data.allVolumesp; volp; volp=volp->allNextp)
1473     {
1474         sprintf(output, "%s - volp=0x%p cell=%s name=%s rwID=%u roID=%u bkID=%u flags=0x%x refCount=%u\r\n",
1475                  cookie, volp, volp->cellp->name, volp->namep, volp->vol[RWVOL].ID, volp->vol[ROVOL].ID, volp->vol[BACKVOL].ID, volp->flags,
1476                  volp->refCount);
1477         WriteFile(outputFile, output, (DWORD)strlen(output), &zilch, NULL);
1478     }
1479     sprintf(output, "%s - Done dumping volumes.\r\n", cookie);
1480     WriteFile(outputFile, output, (DWORD)strlen(output), &zilch, NULL);
1481
1482     if (lock) {
1483         lock_ReleaseRead(&cm_volumeLock);
1484         lock_ReleaseRead(&cm_scacheLock);
1485     }
1486     return (0);
1487 }
1488
1489
1490 /*
1491  * String hash function used by SDBM project.
1492  * It was chosen because it is fast and provides
1493  * decent coverage.
1494  */
1495 afs_uint32 SDBMHash(const char * str)
1496 {
1497     afs_uint32 hash = 0;
1498     size_t i, len;
1499
1500     if (str == NULL)
1501         return 0;
1502
1503     for(i = 0, len = strlen(str); i < len; i++)
1504     {
1505         hash = str[i] + (hash << 6) + (hash << 16) - hash;
1506     }
1507
1508     return (hash & 0x7FFFFFFF);
1509 }
1510
1511 /* call with volume write-locked and mutex held */
1512 void cm_AddVolumeToNameHashTable(cm_volume_t *volp)
1513 {
1514     int i;
1515
1516     if (volp->flags & CM_VOLUMEFLAG_IN_HASH)
1517         return;
1518
1519     i = CM_VOLUME_NAME_HASH(volp->namep);
1520
1521     volp->nameNextp = cm_data.volumeNameHashTablep[i];
1522     cm_data.volumeNameHashTablep[i] = volp;
1523     volp->flags |= CM_VOLUMEFLAG_IN_HASH;
1524 }
1525
1526 /* call with volume write-locked and mutex held */
1527 void cm_RemoveVolumeFromNameHashTable(cm_volume_t *volp)
1528 {
1529     cm_volume_t **lvolpp;
1530     cm_volume_t *tvolp;
1531     int i;
1532
1533     if (volp->flags & CM_VOLUMEFLAG_IN_HASH) {
1534         /* hash it out first */
1535         i = CM_VOLUME_NAME_HASH(volp->namep);
1536         for (lvolpp = &cm_data.volumeNameHashTablep[i], tvolp = cm_data.volumeNameHashTablep[i];
1537              tvolp;
1538              lvolpp = &tvolp->nameNextp, tvolp = tvolp->nameNextp) {
1539             if (tvolp == volp) {
1540                 *lvolpp = volp->nameNextp;
1541                 volp->flags &= ~CM_VOLUMEFLAG_IN_HASH;
1542                 volp->nameNextp = NULL;
1543                 break;
1544             }
1545         }
1546     }
1547 }
1548
1549 /* call with volume write-locked and mutex held */
1550 void cm_AddVolumeToIDHashTable(cm_volume_t *volp, afs_uint32 volType)
1551 {
1552     int i;
1553     struct cm_vol_state * statep;
1554
1555     statep = cm_VolumeStateByType(volp, volType);
1556
1557     if (statep->flags & CM_VOLUMEFLAG_IN_HASH)
1558         return;
1559
1560     i = CM_VOLUME_ID_HASH(statep->ID);
1561
1562     switch (volType) {
1563     case RWVOL:
1564         statep->nextp = cm_data.volumeRWIDHashTablep[i];
1565         cm_data.volumeRWIDHashTablep[i] = volp;
1566         break;
1567     case ROVOL:
1568         statep->nextp = cm_data.volumeROIDHashTablep[i];
1569         cm_data.volumeROIDHashTablep[i] = volp;
1570         break;
1571     case BACKVOL:
1572         statep->nextp = cm_data.volumeBKIDHashTablep[i];
1573         cm_data.volumeBKIDHashTablep[i] = volp;
1574         break;
1575     }
1576     statep->flags |= CM_VOLUMEFLAG_IN_HASH;
1577 }
1578
1579
1580 /* call with volume write-locked and mutex held */
1581 void cm_RemoveVolumeFromIDHashTable(cm_volume_t *volp, afs_uint32 volType)
1582 {
1583     cm_volume_t **lvolpp;
1584     cm_volume_t *tvolp;
1585     struct cm_vol_state * statep;
1586     int i;
1587
1588     statep = cm_VolumeStateByType(volp, volType);
1589
1590     if (statep->flags & CM_VOLUMEFLAG_IN_HASH) {
1591         /* hash it out first */
1592         i = CM_VOLUME_ID_HASH(statep->ID);
1593
1594         switch (volType) {
1595         case RWVOL:
1596             lvolpp = &cm_data.volumeRWIDHashTablep[i];
1597             tvolp = cm_data.volumeRWIDHashTablep[i];
1598             break;
1599         case ROVOL:
1600             lvolpp = &cm_data.volumeROIDHashTablep[i];
1601             tvolp = cm_data.volumeROIDHashTablep[i];
1602             break;
1603         case BACKVOL:
1604             lvolpp = &cm_data.volumeBKIDHashTablep[i];
1605             tvolp = cm_data.volumeBKIDHashTablep[i];
1606             break;
1607         default:
1608             osi_assertx(0, "invalid volume type");
1609         }
1610         do {
1611             if (tvolp == volp) {
1612                 *lvolpp = statep->nextp;
1613                 statep->flags &= ~CM_VOLUMEFLAG_IN_HASH;
1614                 statep->nextp = NULL;
1615                 break;
1616             }
1617
1618             lvolpp = &tvolp->vol[volType].nextp;
1619             tvolp = tvolp->vol[volType].nextp;
1620         } while(tvolp);
1621     }
1622 }
1623
1624 /* must be called with cm_volumeLock write-locked! */
1625 void cm_AdjustVolumeLRU(cm_volume_t *volp)
1626 {
1627     if (volp == cm_data.volumeLRULastp)
1628         cm_data.volumeLRULastp = (cm_volume_t *) osi_QPrev(&volp->q);
1629     if (volp->flags & CM_VOLUMEFLAG_IN_LRU_QUEUE)
1630         osi_QRemoveHT((osi_queue_t **) &cm_data.volumeLRUFirstp, (osi_queue_t **) &cm_data.volumeLRULastp, &volp->q);
1631     osi_QAdd((osi_queue_t **) &cm_data.volumeLRUFirstp, &volp->q);
1632     volp->flags |= CM_VOLUMEFLAG_IN_LRU_QUEUE;
1633     if (!cm_data.volumeLRULastp)
1634         cm_data.volumeLRULastp = volp;
1635 }
1636
1637 /* must be called with cm_volumeLock write-locked! */
1638 void cm_MoveVolumeToLRULast(cm_volume_t *volp)
1639 {
1640     if (volp == cm_data.volumeLRULastp)
1641         return;
1642
1643     if (volp == cm_data.volumeLRUFirstp)
1644         cm_data.volumeLRUFirstp = (cm_volume_t *) osi_QNext(&volp->q);
1645     if (volp->flags & CM_VOLUMEFLAG_IN_LRU_QUEUE)
1646         osi_QRemoveHT((osi_queue_t **) &cm_data.volumeLRUFirstp, (osi_queue_t **) &cm_data.volumeLRULastp, &volp->q);
1647     osi_QAddT((osi_queue_t **) &cm_data.volumeLRUFirstp, (osi_queue_t **) &cm_data.volumeLRULastp, &volp->q);
1648     volp->flags |= CM_VOLUMEFLAG_IN_LRU_QUEUE;
1649     if (!cm_data.volumeLRULastp)
1650         cm_data.volumeLRULastp = volp;
1651 }
1652
1653 /* must be called with cm_volumeLock write-locked! */
1654 void cm_RemoveVolumeFromLRU(cm_volume_t *volp)
1655 {
1656     if (volp->flags & CM_VOLUMEFLAG_IN_LRU_QUEUE) {
1657         if (volp == cm_data.volumeLRULastp)
1658             cm_data.volumeLRULastp = (cm_volume_t *) osi_QPrev(&volp->q);
1659         osi_QRemoveHT((osi_queue_t **) &cm_data.volumeLRUFirstp, (osi_queue_t **) &cm_data.volumeLRULastp, &volp->q);
1660         volp->flags &= ~CM_VOLUMEFLAG_IN_LRU_QUEUE;
1661     }
1662 }
1663
1664 static char * volstatus_str(enum volstatus vs)
1665 {
1666     switch (vs) {
1667     case vl_online:
1668         return "online";
1669     case vl_busy:
1670         return "busy";
1671     case vl_offline:
1672         return "offline";
1673     case vl_alldown:
1674         return "alldown";
1675     default:
1676         return "unknown";
1677     }
1678 }
1679
1680 void cm_VolumeStatusNotification(cm_volume_t * volp, afs_uint32 volID, enum volstatus old, enum volstatus new)
1681 {
1682     char volstr[CELL_MAXNAMELEN + VL_MAXNAMELEN]="";
1683     char *ext = "";
1684
1685     if (volID == volp->vol[RWVOL].ID)
1686         ext = "";
1687     else if (volID == volp->vol[ROVOL].ID)
1688         ext = ".readonly";
1689     else if (volID == volp->vol[BACKVOL].ID)
1690         ext = ".backup";
1691     else
1692         ext = ".nomatch";
1693     snprintf(volstr, sizeof(volstr), "%s:%s%s", volp->cellp->name, volp->namep, ext);
1694
1695     osi_Log4(afsd_logp, "VolumeStatusNotification: %-48s [%10u] (%s -> %s)",
1696              osi_LogSaveString(afsd_logp, volstr), volID, volstatus_str(old), volstatus_str(new));
1697
1698     cm_VolStatus_Change_Notification(volp->cellp->cellID, volID, new);
1699 }
1700
1701 enum volstatus cm_GetVolumeStatus(cm_volume_t *volp, afs_uint32 volID)
1702 {
1703     cm_vol_state_t * statep = cm_VolumeStateByID(volp, volID);
1704     if (statep)
1705         return statep->state;
1706     else
1707         return vl_unknown;
1708 }
1709
1710 /* Renew .readonly volume callbacks that are more than
1711  * 30 minutes old.  (A volume callback is issued for 2 hours.)
1712  */
1713 void
1714 cm_VolumeRenewROCallbacks(void)
1715 {
1716     cm_volume_t * volp;
1717     time_t minexp = time(NULL) + 90 * 60;
1718
1719     lock_ObtainRead(&cm_volumeLock);
1720     for (volp = cm_data.allVolumesp; volp; volp=volp->allNextp) {
1721         if ( volp->cbExpiresRO > 0 && volp->cbExpiresRO < minexp) {
1722             cm_req_t      req;
1723             cm_fid_t      fid;
1724             cm_scache_t * scp;
1725
1726             cm_SetFid(&fid, volp->cellp->cellID, volp->vol[ROVOL].ID, 1, 1);
1727
1728             cm_InitReq(&req);
1729
1730             lock_ReleaseRead(&cm_volumeLock);
1731             if (cm_GetSCache(&fid, &scp, cm_rootUserp, &req) == 0) {
1732                 lock_ObtainWrite(&scp->rw);
1733                 cm_GetCallback(scp, cm_rootUserp, &req, 1);
1734                 lock_ReleaseWrite(&scp->rw);
1735                 cm_ReleaseSCache(scp);
1736             }
1737             lock_ObtainRead(&cm_volumeLock);
1738         }
1739     }
1740     lock_ReleaseRead(&cm_volumeLock);
1741 }
1742
1743 cm_vol_state_t *
1744 cm_VolumeStateByType(cm_volume_t *volp, afs_uint32 volType)
1745 {
1746     return &volp->vol[volType];
1747 }
1748
1749 cm_vol_state_t *
1750 cm_VolumeStateByID(cm_volume_t *volp, afs_uint32 id)
1751 {
1752     cm_vol_state_t * statep = NULL;
1753
1754     if (id == volp->vol[RWVOL].ID)
1755         statep = &volp->vol[RWVOL];
1756     else if (id == volp->vol[ROVOL].ID)
1757         statep = &volp->vol[ROVOL];
1758     else if (id == volp->vol[BACKVOL].ID)
1759         statep = &volp->vol[BACKVOL];
1760
1761     return(statep);
1762 }
1763
1764 cm_vol_state_t *
1765 cm_VolumeStateByName(cm_volume_t *volp, char *volname)
1766 {
1767     size_t len = strlen(volname);
1768     cm_vol_state_t *statep;
1769
1770     if (cm_stricmp_utf8N(".readonly", &volname[len-9]) == 0)
1771         statep = &volp->vol[ROVOL];
1772     else if (cm_stricmp_utf8N(".backup", &volname[len-7]) == 0)
1773         statep = &volp->vol[BACKVOL];
1774     else
1775         statep = &volp->vol[RWVOL];
1776
1777     return statep;
1778 }
1779