DEVEL15-windows-hold-server-mutex-for-vol-list-20071223
[openafs.git] / src / WINNT / afsd / cm_server.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 #ifndef DJGPP
14 #include <windows.h>
15 #include <winsock2.h>
16 #include <nb30.h>
17 #else
18 #include <sys/socket.h>
19 #endif /* !DJGPP */
20 #include <stdlib.h>
21 #include <malloc.h>
22 #include <string.h>
23
24 #include "afsd.h"
25 #include <WINNT\syscfg.h>
26 #include <osi.h>
27 #include <rx/rx.h>
28
29 osi_rwlock_t cm_serverLock;
30
31 cm_server_t *cm_allServersp;
32
33 void
34 cm_ForceNewConnectionsAllServers(void)
35 {
36     cm_server_t *tsp;
37
38     lock_ObtainWrite(&cm_serverLock);
39     for (tsp = cm_allServersp; tsp; tsp = tsp->allNextp) {
40         cm_GetServerNoLock(tsp);
41         cm_ForceNewConnections(tsp);
42         cm_PutServerNoLock(tsp);
43     }
44     lock_ReleaseWrite(&cm_serverLock);
45 }
46
47 void 
48 cm_PingServer(cm_server_t *tsp)
49 {
50     long code;
51     int wasDown = 0;
52     cm_conn_t *connp;
53     struct rx_connection * rxconnp;
54     long secs;
55     long usecs;
56     Capabilities caps = {0, 0};
57     char hoststr[16];
58     cm_req_t req;
59
60     lock_ObtainMutex(&tsp->mx);
61     if (tsp->flags & CM_SERVERFLAG_PINGING) {
62         tsp->waitCount++;
63         osi_SleepM((LONG_PTR)tsp, &tsp->mx);
64         lock_ObtainMutex(&tsp->mx);
65         tsp->waitCount--;
66         if (tsp->waitCount == 0)
67             tsp->flags &= ~CM_SERVERFLAG_PINGING;
68         else 
69             osi_Wakeup((LONG_PTR)tsp);
70         lock_ReleaseMutex(&tsp->mx);
71         return;
72     }
73     tsp->flags |= CM_SERVERFLAG_PINGING;
74     wasDown = tsp->flags & CM_SERVERFLAG_DOWN;
75     afs_inet_ntoa_r(tsp->addr.sin_addr.S_un.S_addr, hoststr);
76     lock_ReleaseMutex(&tsp->mx);
77
78     code = cm_ConnByServer(tsp, cm_rootUserp, &connp);
79     if (code == 0) {
80         /* now call the appropriate ping call.  Drop the timeout if
81         * the server is known to be down, so that we don't waste a
82         * lot of time retiming out down servers.
83         */
84
85         osi_Log4(afsd_logp, "cm_PingServer server %s (%s) was %s with caps 0x%x",
86                   osi_LogSaveString(afsd_logp, hoststr), 
87                   tsp->type == CM_SERVER_VLDB ? "vldb" : "file",
88                   wasDown ? "down" : "up",
89                   tsp->capabilities);
90
91         rxconnp = cm_GetRxConn(connp);
92         if (wasDown)
93             rx_SetConnDeadTime(rxconnp, 10);
94         if (tsp->type == CM_SERVER_VLDB) {
95             code = VL_ProbeServer(rxconnp);
96         }
97         else {
98             /* file server */
99             code = RXAFS_GetCapabilities(rxconnp, &caps);
100             if (code == RXGEN_OPCODE)
101                 code = RXAFS_GetTime(rxconnp, &secs, &usecs);
102         }
103         if (wasDown)
104             rx_SetConnDeadTime(rxconnp, ConnDeadtimeout);
105         rx_PutConnection(rxconnp);
106         cm_PutConn(connp);
107     }   /* got an unauthenticated connection to this server */
108
109     lock_ObtainMutex(&tsp->mx);
110     if (code >= 0) {
111         /* mark server as up */
112         tsp->flags &= ~CM_SERVERFLAG_DOWN;
113         tsp->downTime = 0;
114
115         /* we currently handle 32-bits of capabilities */
116         if (caps.Capabilities_len > 0) {
117             tsp->capabilities = caps.Capabilities_val[0];
118             free(caps.Capabilities_val);
119             caps.Capabilities_len = 0;
120             caps.Capabilities_val = 0;
121         } else {
122             tsp->capabilities = 0;
123         }
124
125         osi_Log3(afsd_logp, "cm_PingServer server %s (%s) is up with caps 0x%x",
126                   osi_LogSaveString(afsd_logp, hoststr), 
127                   tsp->type == CM_SERVER_VLDB ? "vldb" : "file",
128                   tsp->capabilities);
129
130         /* Now update the volume status if necessary */
131         if (wasDown) {
132             cm_server_vols_t * tsrvp;
133             cm_volume_t * volp;
134             int i;
135
136             for (tsrvp = tsp->vols; tsrvp; tsrvp = tsrvp->nextp) {
137                 for (i=0; i<NUM_SERVER_VOLS; i++) {
138                     if (tsrvp->ids[i] != 0) {
139                         cm_InitReq(&req);
140
141                         code = cm_GetVolumeByID(tsp->cellp, tsrvp->ids[i], cm_rootUserp,
142                                                 &req, CM_GETVOL_FLAG_NO_LRU_UPDATE, &volp);
143                         if (code == 0) {
144                             cm_UpdateVolumeStatus(volp, tsrvp->ids[i]);
145                             cm_PutVolume(volp);
146                         }
147                     }
148                 }
149             }
150         }
151     } else {
152         /* mark server as down */
153         if (!(tsp->flags & CM_SERVERFLAG_DOWN)) {
154             tsp->flags |= CM_SERVERFLAG_DOWN;
155             tsp->downTime = osi_Time();
156         }
157         if (code != VRESTARTING)
158             cm_ForceNewConnections(tsp);
159
160         osi_Log3(afsd_logp, "cm_PingServer server %s (%s) is down with caps 0x%x",
161                   osi_LogSaveString(afsd_logp, hoststr), 
162                   tsp->type == CM_SERVER_VLDB ? "vldb" : "file",
163                   tsp->capabilities);
164
165         /* Now update the volume status if necessary */
166         if (!wasDown) {
167             cm_server_vols_t * tsrvp;
168             cm_volume_t * volp;
169             int i;
170
171             for (tsrvp = tsp->vols; tsrvp; tsrvp = tsrvp->nextp) {
172                 for (i=0; i<NUM_SERVER_VOLS; i++) {
173                     if (tsrvp->ids[i] != 0) {
174                         cm_InitReq(&req);
175
176                         code = cm_GetVolumeByID(tsp->cellp, tsrvp->ids[i], cm_rootUserp,
177                                                 &req, CM_GETVOL_FLAG_NO_LRU_UPDATE, &volp);
178                         if (code == 0) {
179                             cm_UpdateVolumeStatus(volp, tsrvp->ids[i]);
180                             cm_PutVolume(volp);
181                         }
182                     }
183                 }
184             }
185         }
186     }
187
188     if (tsp->waitCount == 0)
189         tsp->flags &= ~CM_SERVERFLAG_PINGING;
190     else 
191         osi_Wakeup((LONG_PTR)tsp);
192     lock_ReleaseMutex(&tsp->mx);
193 }
194
195
196 void cm_CheckServers(long flags, cm_cell_t *cellp)
197 {
198     /* ping all file servers, up or down, with unauthenticated connection,
199      * to find out whether we have all our callbacks from the server still.
200      * Also, ping down VLDBs.
201      */
202     cm_server_t *tsp;
203     int doPing;
204     int isDown;
205     int isFS;
206
207     lock_ObtainWrite(&cm_serverLock);
208     for (tsp = cm_allServersp; tsp; tsp = tsp->allNextp) {
209         cm_GetServerNoLock(tsp);
210         lock_ReleaseWrite(&cm_serverLock);
211
212         /* now process the server */
213         lock_ObtainMutex(&tsp->mx);
214
215         doPing = 0;
216         isDown = tsp->flags & CM_SERVERFLAG_DOWN;
217         isFS   = tsp->type == CM_SERVER_FILE;
218
219         /* only do the ping if the cell matches the requested cell, or we're
220          * matching all cells (cellp == NULL), and if we've requested to ping
221          * this type of {up, down} servers.
222          */
223         if ((cellp == NULL || cellp == tsp->cellp) &&
224              ((isDown && (flags & CM_FLAG_CHECKDOWNSERVERS)) ||
225                (!isDown && (flags & CM_FLAG_CHECKUPSERVERS))) &&
226              ((!(flags & CM_FLAG_CHECKVLDBSERVERS) || 
227                !isFS && (flags & CM_FLAG_CHECKVLDBSERVERS)) &&
228               (!(flags & CM_FLAG_CHECKFILESERVERS) || 
229                  isFS && (flags & CM_FLAG_CHECKFILESERVERS)))) {
230             doPing = 1;
231         }       /* we're supposed to check this up/down server */
232         lock_ReleaseMutex(&tsp->mx);
233
234         /* at this point, we've adjusted the server state, so do the ping and
235          * adjust things.
236          */
237         if (doPing) 
238             cm_PingServer(tsp);
239
240         /* also, run the GC function for connections on all of the
241          * server's connections.
242          */
243         cm_GCConnections(tsp);
244
245         lock_ObtainWrite(&cm_serverLock);
246         cm_PutServerNoLock(tsp);
247     }
248     lock_ReleaseWrite(&cm_serverLock);
249 }       
250
251 void cm_InitServer(void)
252 {
253     static osi_once_t once;
254         
255     if (osi_Once(&once)) {
256         lock_InitializeRWLock(&cm_serverLock, "cm_serverLock");
257         osi_EndOnce(&once);
258     }
259 }
260
261 void cm_GetServer(cm_server_t *serverp)
262 {
263     lock_ObtainWrite(&cm_serverLock);
264     serverp->refCount++;
265     lock_ReleaseWrite(&cm_serverLock);
266 }
267
268 void cm_GetServerNoLock(cm_server_t *serverp)
269 {
270     serverp->refCount++;
271 }
272
273 void cm_PutServer(cm_server_t *serverp)
274 {
275     lock_ObtainWrite(&cm_serverLock);
276     osi_assertx(serverp->refCount-- > 0, "cm_server_t refCount 0");
277     lock_ReleaseWrite(&cm_serverLock);
278 }
279
280 void cm_PutServerNoLock(cm_server_t *serverp)
281 {
282     osi_assertx(serverp->refCount-- > 0, "cm_server_t refCount 0");
283 }
284
285 void cm_SetServerNo64Bit(cm_server_t * serverp, int no64bit)
286 {
287     lock_ObtainMutex(&serverp->mx);
288     if (no64bit)
289         serverp->flags |= CM_SERVERFLAG_NO64BIT;
290     else
291         serverp->flags &= ~CM_SERVERFLAG_NO64BIT;
292     lock_ReleaseMutex(&serverp->mx);
293 }
294
295 void cm_SetServerNoInlineBulk(cm_server_t * serverp, int no)
296 {
297     lock_ObtainMutex(&serverp->mx);
298     if (no)
299         serverp->flags |= CM_SERVERFLAG_NOINLINEBULK;
300     else
301         serverp->flags &= ~CM_SERVERFLAG_NOINLINEBULK;
302     lock_ReleaseMutex(&serverp->mx);
303 }
304
305 void cm_SetServerPrefs(cm_server_t * serverp)
306 {
307     unsigned long       serverAddr;     /* in host byte order */
308     unsigned long       myAddr, myNet, mySubnet;/* in host byte order */
309     unsigned long       netMask;
310     int                 i;
311
312     int cm_noIPAddr;         /* number of client network interfaces */
313     int cm_IPAddr[CM_MAXINTERFACE_ADDR];    /* client's IP address in host order */
314     int cm_SubnetMask[CM_MAXINTERFACE_ADDR];/* client's subnet mask in host order*/
315     int cm_NetMtu[CM_MAXINTERFACE_ADDR];    /* client's MTU sizes */
316     int cm_NetFlags[CM_MAXINTERFACE_ADDR];  /* network flags */
317     long code;
318
319     /* get network related info */
320     cm_noIPAddr = CM_MAXINTERFACE_ADDR;
321     code = syscfg_GetIFInfo(&cm_noIPAddr,
322                             cm_IPAddr, cm_SubnetMask,
323                             cm_NetMtu, cm_NetFlags);
324
325     serverAddr = ntohl(serverp->addr.sin_addr.s_addr);
326     serverp->ipRank  = CM_IPRANK_LOW;   /* default setings */
327
328     for ( i=0; i < cm_noIPAddr; i++)
329     {
330         /* loop through all the client's IP address and compare
331         ** each of them against the server's IP address */
332
333         myAddr = cm_IPAddr[i];
334         if ( IN_CLASSA(myAddr) )
335             netMask = IN_CLASSA_NET;
336         else if ( IN_CLASSB(myAddr) )
337             netMask = IN_CLASSB_NET;
338         else if ( IN_CLASSC(myAddr) )
339             netMask = IN_CLASSC_NET;
340         else
341             netMask = 0;
342
343         myNet    =  myAddr & netMask;
344         mySubnet =  myAddr & cm_SubnetMask[i];
345
346         if ( (serverAddr & netMask) == myNet ) 
347         {
348             if ( (serverAddr & cm_SubnetMask[i]) == mySubnet)
349             {
350                 if ( serverAddr == myAddr ) 
351                     serverp->ipRank = min(serverp->ipRank,
352                                            CM_IPRANK_TOP);/* same machine */
353                 else serverp->ipRank = min(serverp->ipRank,
354                                             CM_IPRANK_HI); /* same subnet */
355             }
356             else serverp->ipRank = min(serverp->ipRank,CM_IPRANK_MED);
357             /* same net */
358         }       
359         /* random between 0..15*/
360         serverp->ipRank += min(serverp->ipRank, rand() % 0x000f);
361     } /* and of for loop */
362 }
363
364 cm_server_t *cm_NewServer(struct sockaddr_in *socketp, int type, cm_cell_t *cellp) {
365     cm_server_t *tsp;
366
367     osi_assertx(socketp->sin_family == AF_INET, "unexpected socket family");
368
369     tsp = malloc(sizeof(*tsp));
370     if (tsp) {
371         memset(tsp, 0, sizeof(*tsp));
372         tsp->type = type;
373         tsp->cellp = cellp;
374         tsp->refCount = 1;
375         lock_InitializeMutex(&tsp->mx, "cm_server_t mutex");
376         tsp->addr = *socketp;
377         tsp->flags = CM_SERVERFLAG_DOWN;        /* assume down; ping will mark up if available */
378
379         cm_SetServerPrefs(tsp); 
380
381         lock_ObtainWrite(&cm_serverLock);       /* get server lock */
382         tsp->allNextp = cm_allServersp;
383         cm_allServersp = tsp;
384         lock_ReleaseWrite(&cm_serverLock);      /* release server lock */
385
386         cm_PingServer(tsp);                     /* Obtain Capabilities and check up/down state */
387     }
388     return tsp;
389 }
390
391 cm_server_t *
392 cm_FindServerByIP(afs_uint32 ipaddr, int type)
393 {
394     cm_server_t *tsp;
395
396     lock_ObtainRead(&cm_serverLock);
397     for (tsp = cm_allServersp; tsp; tsp = tsp->allNextp) {
398         if (tsp->type == type &&
399             tsp->addr.sin_addr.S_un.S_addr == ipaddr)
400             break;
401     }
402     lock_ReleaseRead(&cm_serverLock);
403
404     return tsp;
405 }
406
407 /* find a server based on its properties */
408 cm_server_t *cm_FindServer(struct sockaddr_in *addrp, int type)
409 {
410     cm_server_t *tsp;
411
412     osi_assertx(addrp->sin_family == AF_INET, "unexpected socket value");
413         
414     lock_ObtainWrite(&cm_serverLock);
415     for (tsp = cm_allServersp; tsp; tsp=tsp->allNextp) {
416         if (tsp->type == type &&
417             tsp->addr.sin_addr.s_addr == addrp->sin_addr.s_addr) 
418             break;
419     }       
420
421     /* bump ref count if we found the server */
422     if (tsp) 
423         cm_GetServerNoLock(tsp);
424
425     /* drop big table lock */
426     lock_ReleaseWrite(&cm_serverLock);
427         
428     /* return what we found */
429     return tsp;
430 }       
431
432 cm_server_vols_t *cm_NewServerVols(void) {
433     cm_server_vols_t *tsvp;
434
435     tsvp = malloc(sizeof(*tsvp));
436     if (tsvp)
437         memset(tsvp, 0, sizeof(*tsvp));
438
439     return tsvp;
440 }
441
442 cm_serverRef_t *cm_NewServerRef(cm_server_t *serverp, afs_uint32 volID)
443 {
444     cm_serverRef_t *tsrp;
445     cm_server_vols_t **tsrvpp = NULL;
446     afs_uint32 *slotp = NULL;
447     int found = 0;
448
449     cm_GetServer(serverp);
450     tsrp = malloc(sizeof(*tsrp));
451     tsrp->server = serverp;
452     tsrp->status = srv_not_busy;
453     tsrp->next = NULL;
454     tsrp->volID = volID;
455     tsrp->refCount = 1;
456
457     /* if we have a non-zero volID, we need to add it to the list
458      * of volumes maintained by the server.  There are two phases:
459      * (1) see if the volID is already in the list and (2) insert
460      * it into the first empty slot if it is not.
461      */
462     if (volID) {
463         lock_ObtainMutex(&serverp->mx);
464
465         tsrvpp = &serverp->vols;
466         while (*tsrvpp) {
467             int i;
468
469             for (i=0; i<NUM_SERVER_VOLS; i++) {
470                 if ((*tsrvpp)->ids[i] == volID) {
471                     found = 1;
472                     break;
473                 } else if (!slotp && (*tsrvpp)->ids[i] == 0) {
474                     slotp = &(*tsrvpp)->ids[i];
475                 }
476             }
477
478             if (found)
479                 break;
480
481             tsrvpp = &(*tsrvpp)->nextp;
482         }
483
484         if (!found) {
485             if (slotp) {
486                 *slotp = volID;
487             } else {
488                 /* if we didn't find an empty slot in a current
489                  * page we must need a new page */
490                 *tsrvpp = cm_NewServerVols();
491                 if (*tsrvpp)
492                     (*tsrvpp)->ids[0] = volID;
493             }
494         }
495
496         lock_ReleaseMutex(&serverp->mx);
497     }
498
499     return tsrp;
500 }
501
502 LONG_PTR cm_ChecksumServerList(cm_serverRef_t *serversp)
503 {
504     LONG_PTR sum = 0;
505     int first = 1;
506     cm_serverRef_t *tsrp;
507
508     lock_ObtainWrite(&cm_serverLock);
509     for (tsrp = serversp; tsrp; tsrp=tsrp->next) {
510         if (first)
511             first = 0;
512         else
513             sum <<= 1;
514         sum ^= (LONG_PTR) tsrp->server;
515     }
516
517     lock_ReleaseWrite(&cm_serverLock);
518     return sum;
519 }
520
521 /*
522 ** Insert a server into the server list keeping the list sorted in 
523 ** asending order of ipRank. 
524 ** 
525 ** The refCount of the cm_serverRef_t is increased
526 */
527 void cm_InsertServerList(cm_serverRef_t** list, cm_serverRef_t* element)
528 {
529     cm_serverRef_t      *current=*list;
530     unsigned short ipRank = element->server->ipRank;
531
532     lock_ObtainWrite(&cm_serverLock);
533     element->refCount++;                /* increase refCount */
534
535     /* insertion into empty list  or at the beginning of the list */
536     if ( !current || (current->server->ipRank > ipRank) )
537     {
538         element->next = *list;
539         *list = element;
540         lock_ReleaseWrite(&cm_serverLock);
541         return ;        
542     }
543         
544     while ( current->next ) /* find appropriate place to insert */
545     {
546         if ( current->next->server->ipRank > ipRank )
547             break;
548         else current = current->next;
549     }
550     element->next = current->next;
551     current->next = element;
552     lock_ReleaseWrite(&cm_serverLock);
553 }       
554 /*
555 ** Re-sort the server list with the modified rank
556 ** returns 0 if element was changed successfully. 
557 ** returns 1 if  list remained unchanged.
558 */
559 long cm_ChangeRankServer(cm_serverRef_t** list, cm_server_t*    server)
560 {
561     cm_serverRef_t  **current=list;
562     cm_serverRef_t      *element=0;
563
564     /* if there is max of one element in the list, nothing to sort */
565     if ( (!*current) || !((*current)->next)  )
566         return 1;               /* list unchanged: return success */
567
568     lock_ObtainWrite(&cm_serverLock);
569     /* if the server is on the list, delete it from list */
570     while ( *current )
571     {
572         if ( (*current)->server == server)
573         {
574             element = (*current);
575             *current = (*current)->next; /* delete it */
576             break;
577         }
578         current = & ( (*current)->next);        
579     }
580     lock_ReleaseWrite(&cm_serverLock);
581
582     /* if this volume is not replicated on this server  */
583     if (!element)
584         return 1;       /* server is not on list */
585
586     /* re-insert deleted element into the list with modified rank*/
587     cm_InsertServerList(list, element);
588
589     /* reduce refCount which was increased by cm_InsertServerList */
590     lock_ObtainWrite(&cm_serverLock);
591     element->refCount--;
592     lock_ReleaseWrite(&cm_serverLock);
593     return 0;
594 }
595 /*
596 ** If there are more than one server on the list and the first n servers on 
597 ** the list have the same rank( n>1), then randomise among the first n servers.
598 */
599 void cm_RandomizeServer(cm_serverRef_t** list)
600 {
601     int                 count, picked;
602     cm_serverRef_t*     tsrp = *list, *lastTsrp;
603     unsigned short      lowestRank;
604
605     /* an empty list or a list with only one element */
606     if ( !tsrp || ! tsrp->next )
607         return ; 
608
609     lock_ObtainWrite(&cm_serverLock);
610
611     /* count the number of servers with the lowest rank */
612     lowestRank = tsrp->server->ipRank;
613     for ( count=1, tsrp=tsrp->next; tsrp; tsrp=tsrp->next)
614     {
615         if ( tsrp->server->ipRank != lowestRank)
616             break;
617         else
618             count++;
619     }           
620
621     /* if there is only one server with the lowest rank, we are done */
622     if ( count <= 1 ) {
623         lock_ReleaseWrite(&cm_serverLock);
624         return ;
625     }   
626
627     picked = rand() % count;
628     if ( !picked ) {
629         lock_ReleaseWrite(&cm_serverLock);
630         return ;
631     }   
632
633     tsrp = *list;
634     while (--picked >= 0)
635     {
636         lastTsrp = tsrp;
637         tsrp = tsrp->next;
638     }
639     lastTsrp->next = tsrp->next;  /* delete random element from list*/
640     tsrp->next     = *list; /* insert element at the beginning of list */
641     *list          = tsrp;
642     lock_ReleaseWrite(&cm_serverLock);
643 }       
644
645 /* call cm_FreeServer while holding a write lock on cm_serverLock */
646 void cm_FreeServer(cm_server_t* serverp)
647 {
648     cm_server_vols_t * tsrvp, *nextp;
649
650     cm_PutServerNoLock(serverp);
651     if (serverp->refCount == 0)
652     {
653         /* we need to check to ensure that all of the connections
654          * for this server have a 0 refCount; otherwise, they will
655          * not be garbage collected 
656          */
657         cm_GCConnections(serverp);  /* connsp */
658
659         if (!(serverp->flags & CM_SERVERFLAG_PREF_SET)) {
660             lock_FinalizeMutex(&serverp->mx);
661             if ( cm_allServersp == serverp )
662                 cm_allServersp = serverp->allNextp;
663             else {
664                 cm_server_t *tsp;
665
666                 for(tsp = cm_allServersp; tsp->allNextp; tsp=tsp->allNextp) {
667                     if ( tsp->allNextp == serverp ) {
668                         tsp->allNextp = serverp->allNextp;
669                         break;
670                     }
671                 }
672             }
673
674             /* free the volid list */
675             for ( tsrvp = serverp->vols; tsrvp; tsrvp = nextp) {
676                 nextp = tsrvp->nextp;
677                 free(tsrvp);
678             }
679
680             free(serverp);
681         }
682     }
683 }
684
685 void cm_RemoveVolumeFromServer(cm_server_t * serverp, afs_uint32 volID)
686 {
687     cm_server_vols_t * tsrvp;
688     int i;
689
690     if (volID == 0)
691         return;
692
693     for (tsrvp = serverp->vols; tsrvp; tsrvp = tsrvp->nextp) {
694         for (i=0; i<NUM_SERVER_VOLS; i++) {
695             if (tsrvp->ids[i] == volID) {
696                 tsrvp->ids[i] = 0;;
697                 break;
698             }
699         }
700     }
701 }
702
703 void cm_FreeServerList(cm_serverRef_t** list, afs_uint32 flags)
704 {
705     cm_serverRef_t  **current = list;
706     cm_serverRef_t  **nextp = 0;
707     cm_serverRef_t  * next = 0;
708
709     lock_ObtainWrite(&cm_serverLock);
710
711     while (*current)
712     {
713         nextp = &(*current)->next;
714         if (--((*current)->refCount) == 0) {
715             next = *nextp;
716
717             if ((*current)->volID)
718                 cm_RemoveVolumeFromServer((*current)->server, (*current)->volID);
719             cm_FreeServer((*current)->server);
720             free(*current);
721             *current = next;
722         } else {
723             if (flags & CM_FREESERVERLIST_DELETE) {
724                 (*current)->status = srv_deleted;
725                 if ((*current)->volID)
726                     cm_RemoveVolumeFromServer((*current)->server, (*current)->volID);
727             }
728             current = nextp;
729         }
730     }
731   
732     lock_ReleaseWrite(&cm_serverLock);
733 }