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