windows-server-retry-20080502
[openafs.git] / src / WINNT / afsd / cm_conn.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 <string.h>
15 #include <malloc.h>
16 #include <osi.h>
17 #include "afsd.h"
18 #include <rx/rx.h>
19 #include <rx/rxkad.h>
20 #include <afs/unified_afs.h>
21 #include <afs/vlserver.h>
22 #include <WINNT/afsreg.h>
23
24 osi_rwlock_t cm_connLock;
25
26 DWORD RDRtimeout = CM_CONN_DEFAULTRDRTIMEOUT;
27 unsigned short ConnDeadtimeout = CM_CONN_CONNDEADTIME;
28 unsigned short HardDeadtimeout = CM_CONN_HARDDEADTIME;
29 unsigned short IdleDeadtimeout = CM_CONN_IDLEDEADTIME;
30
31 #define LANMAN_WKS_PARAM_KEY "SYSTEM\\CurrentControlSet\\Services\\lanmanworkstation\\parameters"
32 #define LANMAN_WKS_SESSION_TIMEOUT "SessTimeout"
33
34 afs_uint32 cryptall = 0;
35 afs_uint32 cm_anonvldb = 0;
36
37 void cm_PutConn(cm_conn_t *connp)
38 {
39     afs_int32 refCount = InterlockedDecrement(&connp->refCount);
40     osi_assertx(refCount >= 0, "cm_conn_t refcount underflow");
41 }
42
43 void cm_InitConn(void)
44 {
45     static osi_once_t once;
46     long code;
47     DWORD dwValue;
48     DWORD dummyLen;
49     HKEY parmKey;
50         
51     if (osi_Once(&once)) {
52         lock_InitializeRWLock(&cm_connLock, "connection global lock");
53
54         /* keisa - read timeout value for lanmanworkstation  service.
55          * jaltman - as per 
56          *   http://support.microsoft.com:80/support/kb/articles/Q102/0/67.asp&NoWebContent=1
57          * the SessTimeout is a minimum timeout not a maximum timeout.  Therefore, 
58          * I believe that the default should not be short.  Instead, we should wait until
59          * RX times out before reporting a timeout to the SMB client.
60          */
61         code = RegOpenKeyEx(HKEY_LOCAL_MACHINE, LANMAN_WKS_PARAM_KEY,
62                             0, KEY_QUERY_VALUE, &parmKey);
63         if (code == ERROR_SUCCESS)
64         {
65             dummyLen = sizeof(DWORD);
66             code = RegQueryValueEx(parmKey, LANMAN_WKS_SESSION_TIMEOUT, NULL, NULL, 
67                                    (BYTE *) &dwValue, &dummyLen);
68             if (code == ERROR_SUCCESS)
69                 RDRtimeout = dwValue;
70             RegCloseKey(parmKey);
71         }
72
73         code = RegOpenKeyEx(HKEY_LOCAL_MACHINE, AFSREG_CLT_SVC_PARAM_SUBKEY,
74                              0, KEY_QUERY_VALUE, &parmKey);
75         if (code == ERROR_SUCCESS) {
76             dummyLen = sizeof(DWORD);
77             code = RegQueryValueEx(parmKey, "ConnDeadTimeout", NULL, NULL,
78                                     (BYTE *) &dwValue, &dummyLen);
79             if (code == ERROR_SUCCESS)
80                 ConnDeadtimeout = (unsigned short)dwValue;
81
82             dummyLen = sizeof(DWORD);
83             code = RegQueryValueEx(parmKey, "HardDeadTimeout", NULL, NULL,
84                                     (BYTE *) &dwValue, &dummyLen);
85             if (code == ERROR_SUCCESS)
86                 HardDeadtimeout = (unsigned short)dwValue;
87             afsi_log("HardDeadTimeout is %d", HardDeadtimeout);
88
89             dummyLen = sizeof(DWORD);
90             code = RegQueryValueEx(parmKey, "IdleDeadTimeout", NULL, NULL,
91                                     (BYTE *) &dwValue, &dummyLen);
92             if (code == ERROR_SUCCESS)
93                 IdleDeadtimeout = (unsigned short)dwValue;
94             afsi_log("IdleDeadTimeout is %d", IdleDeadtimeout);
95
96             RegCloseKey(parmKey);
97         }
98
99         afsi_log("lanmanworkstation : SessTimeout %u", RDRtimeout);
100         if (ConnDeadtimeout == 0)
101             ConnDeadtimeout = (unsigned short) (RDRtimeout / 2);
102         afsi_log("ConnDeadTimeout is %d", ConnDeadtimeout);
103         if (HardDeadtimeout == 0)
104             HardDeadtimeout = (unsigned short) RDRtimeout;
105         afsi_log("HardDeadTimeout is %d", HardDeadtimeout);
106
107         osi_EndOnce(&once);
108     }
109 }
110
111 void cm_InitReq(cm_req_t *reqp)
112 {
113         memset((char *)reqp, 0, sizeof(cm_req_t));
114         reqp->startTime = GetTickCount();
115 }
116
117 static long cm_GetServerList(struct cm_fid *fidp, struct cm_user *userp,
118         struct cm_req *reqp, cm_serverRef_t ***serversppp)
119 {
120     long code;
121     cm_volume_t *volp = NULL;
122     cm_cell_t *cellp = NULL;
123
124     if (!fidp) {
125         *serversppp = NULL;
126         return CM_ERROR_INVAL;
127     }
128
129     cellp = cm_FindCellByID(fidp->cell, 0);
130     if (!cellp) 
131         return CM_ERROR_NOSUCHCELL;
132
133     code = cm_FindVolumeByID(cellp, fidp->volume, userp, reqp, CM_GETVOL_FLAG_CREATE, &volp);
134     if (code) 
135         return code;
136     
137     *serversppp = cm_GetVolServers(volp, fidp->volume);
138
139     lock_ObtainRead(&cm_volumeLock);
140     cm_PutVolume(volp);
141     lock_ReleaseRead(&cm_volumeLock);
142     return 0;
143 }
144
145 /*
146  * Analyze the error return from an RPC.  Determine whether or not to retry,
147  * and if we're going to retry, determine whether failover is appropriate,
148  * and whether timed backoff is appropriate.
149  *
150  * If the error code is from cm_ConnFromFID() or friends, it will be a CM_ERROR code.
151  * Otherwise it will be an RPC code.  This may be a UNIX code (e.g. EDQUOT), or
152  * it may be an RX code, or it may be a special code (e.g. VNOVOL), or it may
153  * be a security code (e.g. RXKADEXPIRED).
154  *
155  * If the error code is from cm_ConnFromFID() or friends, connp will be NULL.
156  *
157  * For VLDB calls, fidp will be NULL.
158  *
159  * volSyncp and/or cbrp may also be NULL.
160  */
161 int
162 cm_Analyze(cm_conn_t *connp, cm_user_t *userp, cm_req_t *reqp,
163            struct cm_fid *fidp, 
164            AFSVolSync *volSyncp, 
165            cm_serverRef_t * serversp,
166            cm_callbackRequest_t *cbrp, long errorCode)
167 {
168     cm_server_t *serverp = NULL;
169     cm_serverRef_t **serverspp = NULL;
170     cm_serverRef_t *tsrp;
171     cm_cell_t  *cellp = NULL;
172     cm_ucell_t *ucellp;
173     cm_volume_t * volp = NULL;
174     cm_vol_state_t *statep = NULL;
175     int retry = 0;
176     int free_svr_list = 0;
177     int dead_session;
178     long timeUsed, timeLeft;
179     long code;
180     char addr[16]="unknown";
181     int forcing_new = 0;
182
183     osi_Log2(afsd_logp, "cm_Analyze connp 0x%p, code 0x%x",
184              connp, errorCode);
185
186     /* no locking required, since connp->serverp never changes after
187      * creation */
188     dead_session = (userp->cellInfop == NULL);
189     if (connp)
190         serverp = connp->serverp;
191
192     /* Update callback pointer */
193     if (cbrp && serverp && errorCode == 0) {
194         if (cbrp->serverp) {
195             if ( cbrp->serverp != serverp ) {
196                 lock_ObtainWrite(&cm_serverLock);
197                 cm_PutServerNoLock(cbrp->serverp);
198                 cm_GetServerNoLock(serverp);
199                 lock_ReleaseWrite(&cm_serverLock);
200             }
201         } else {
202             cm_GetServer(serverp);
203         }
204         lock_ObtainWrite(&cm_callbackLock);
205         cbrp->serverp = serverp;
206         lock_ReleaseWrite(&cm_callbackLock);
207     }
208
209     /* if timeout - check that it did not exceed the HardDead timeout
210      * and retry */
211     
212     /* timeleft - get if from reqp the same way as cmXonnByMServers does */
213     timeUsed = (GetTickCount() - reqp->startTime) / 1000;
214             
215     /* leave 5 seconds margin for sleep */
216     if (reqp->flags & CM_REQ_NORETRY)
217         timeLeft = 0;
218     else
219         timeLeft = HardDeadtimeout - timeUsed;
220
221     /* get a pointer to the cell */
222     if (errorCode) {
223         if (cellp == NULL && serverp)
224             cellp = serverp->cellp;
225         if (cellp == NULL && serversp) {
226             struct cm_serverRef * refp;
227             for ( refp=serversp ; cellp == NULL && refp != NULL; refp=refp->next) {
228                 if ( refp->server )
229                     cellp = refp->server->cellp;
230             }
231         } 
232         if (cellp == NULL && fidp) {
233             cellp = cm_FindCellByID(fidp->cell, 0);
234         }
235     }
236
237     if (errorCode == CM_ERROR_TIMEDOUT) {
238         if ( timeLeft > 5 ) {
239             thrd_Sleep(3000);
240             cm_CheckServers(CM_FLAG_CHECKDOWNSERVERS, cellp);
241             retry = 1;
242         }
243     }
244
245     else if (errorCode == UAEWOULDBLOCK || errorCode == EWOULDBLOCK ||
246               errorCode == UAEAGAIN || errorCode == EAGAIN) {
247         osi_Log0(afsd_logp, "cm_Analyze passed EWOULDBLOCK or EAGAIN.");
248         if ( timeLeft > 5 ) {
249             thrd_Sleep(1000);
250             retry = 1;
251         }
252     }
253
254     /* if there is nosuchvolume, then we have a situation in which a 
255      * previously known volume no longer has a set of servers 
256      * associated with it.  Either the volume has moved or
257      * the volume has been deleted.  Try to find a new server list
258      * until the timeout period expires.
259      */
260     else if (errorCode == CM_ERROR_NOSUCHVOLUME) {
261         osi_Log0(afsd_logp, "cm_Analyze passed CM_ERROR_NOSUCHVOLUME.");
262         if (timeLeft > 7) {
263             thrd_Sleep(5000);
264             
265             retry = 1;
266
267             if (fidp != NULL)   /* Not a VLDB call */
268                 cm_ForceUpdateVolume(fidp, userp, reqp);
269         }
270     }
271
272     else if (errorCode == CM_ERROR_ALLDOWN) {
273         osi_Log0(afsd_logp, "cm_Analyze passed CM_ERROR_ALLDOWN.");
274         /* Servers marked DOWN will be restored by the background daemon
275          * thread as they become available.  The volume status is 
276          * updated as the server state changes.
277          */
278     }
279
280     else if (errorCode == CM_ERROR_ALLOFFLINE) {
281         osi_Log0(afsd_logp, "cm_Analyze passed CM_ERROR_ALLOFFLINE.");
282         /* Volume instances marked offline will be restored by the 
283          * background daemon thread as they become available 
284          */
285         if (fidp) {
286             code = cm_FindVolumeByID(cellp, fidp->volume, userp, reqp, 
287                                       CM_GETVOL_FLAG_NO_LRU_UPDATE, 
288                                       &volp);
289             if (code == 0) {
290                 if (timeLeft > 7) {
291                     thrd_Sleep(5000);
292
293                     /* cm_CheckOfflineVolume() resets the serverRef state */
294                     if (cm_CheckOfflineVolume(volp, fidp->volume))
295                         retry = 1;
296                 } else {
297                     cm_UpdateVolumeStatus(volp, fidp->volume);
298                 }
299                 lock_ObtainRead(&cm_volumeLock);
300                 cm_PutVolume(volp);
301                 lock_ReleaseRead(&cm_volumeLock);
302                 volp = NULL;
303             }
304         } 
305     }
306     else if (errorCode == CM_ERROR_ALLBUSY) {
307         /* Volumes that are busy cannot be determined to be non-busy 
308          * without actually attempting to access them.
309          */
310         osi_Log0(afsd_logp, "cm_Analyze passed CM_ERROR_ALLBUSY.");
311
312         if (fidp) { /* File Server query */
313             code = cm_FindVolumeByID(cellp, fidp->volume, userp, reqp, 
314                                      CM_GETVOL_FLAG_NO_LRU_UPDATE, 
315                                      &volp);
316             if (code == 0) {
317                 if (timeLeft > 7) {
318                     thrd_Sleep(5000);
319                     
320                     statep = cm_VolumeStateByID(volp, fidp->volume);
321                     if (statep->state != vl_offline && 
322                          statep->state != vl_busy &&
323                          statep->state != vl_unknown) {
324                         retry = 1;
325                     } else {
326                         if (!serversp) {
327                             code = cm_GetServerList(fidp, userp, reqp, &serverspp);
328                             if (code == 0) {
329                                 serversp = *serverspp;
330                                 free_svr_list = 1;
331                             }
332                         }
333                         lock_ObtainWrite(&cm_serverLock);
334                         for (tsrp = serversp; tsrp; tsrp=tsrp->next) {
335                             if (tsrp->status == srv_busy) {
336                                 tsrp->status = srv_not_busy;
337                             }       
338                         }
339                         lock_ReleaseWrite(&cm_serverLock);
340                         if (free_svr_list) {
341                             cm_FreeServerList(&serversp, 0);
342                             *serverspp = serversp;
343                         }
344
345                         cm_UpdateVolumeStatus(volp, fidp->volume);
346                         retry = 1;
347                     }
348                 } else {
349                     cm_UpdateVolumeStatus(volp, fidp->volume);
350                 }
351
352                 lock_ObtainRead(&cm_volumeLock);
353                 cm_PutVolume(volp);
354                 lock_ReleaseRead(&cm_volumeLock);
355                 volp = NULL;
356             }
357         } else {    /* VL Server query */
358             if (timeLeft > 7) {
359                 thrd_Sleep(5000);
360
361                 if (serversp) {
362                     lock_ObtainWrite(&cm_serverLock);
363                     for (tsrp = serversp; tsrp; tsrp=tsrp->next) {
364                         if (tsrp->status == srv_busy) {
365                             tsrp->status = srv_not_busy;
366                         }
367                     }
368                     lock_ReleaseWrite(&cm_serverLock);
369                     retry = 1;
370                 }
371             }
372         }
373     }
374
375     /* special codes:  VBUSY and VRESTARTING */
376     else if (errorCode == VBUSY || errorCode == VRESTARTING) {
377         if (!serversp && fidp) {
378             code = cm_GetServerList(fidp, userp, reqp, &serverspp);
379             if (code == 0) {
380                 serversp = *serverspp;
381                 free_svr_list = 1;
382             }
383         }
384         lock_ObtainWrite(&cm_serverLock);
385         for (tsrp = serversp; tsrp; tsrp=tsrp->next) {
386             if (tsrp->server == serverp && tsrp->status == srv_not_busy) {
387                 tsrp->status = srv_busy;
388                 if (fidp) { /* File Server query */
389                     code = cm_FindVolumeByID(cellp, fidp->volume, userp, reqp, 
390                                              CM_GETVOL_FLAG_NO_LRU_UPDATE, 
391                                              &volp);
392                     if (code == 0)
393                         statep = cm_VolumeStateByID(volp, fidp->volume);
394                 }
395                 break;
396             }
397         }
398         lock_ReleaseWrite(&cm_serverLock);
399         
400         if (statep) {
401             cm_UpdateVolumeStatus(volp, statep->ID);
402             lock_ObtainRead(&cm_volumeLock);
403             cm_PutVolume(volp);
404             lock_ReleaseRead(&cm_volumeLock);
405             volp = NULL;
406         }
407
408         if (free_svr_list) {
409             cm_FreeServerList(&serversp, 0);
410             *serverspp = serversp;
411         }
412         retry = 1;
413     }
414
415     /* special codes:  missing volumes */
416     else if (errorCode == VNOVOL || errorCode == VMOVED || errorCode == VOFFLINE ||
417              errorCode == VSALVAGE || errorCode == VNOSERVICE || errorCode == VIO) 
418     {       
419         char addr[16];
420         char *format;
421         DWORD msgID;
422         switch ( errorCode ) {
423         case VNOVOL:
424             msgID = MSG_SERVER_REPORTS_VNOVOL;
425             format = "Server %s reported volume %d as not attached.";
426             break;
427         case VMOVED:
428             msgID = MSG_SERVER_REPORTS_VMOVED;
429             format = "Server %s reported volume %d as moved.";
430             break;
431         case VOFFLINE:
432             msgID = MSG_SERVER_REPORTS_VOFFLINE;
433             format = "Server %s reported volume %d as offline.";
434             break;
435         case VSALVAGE:
436             msgID = MSG_SERVER_REPORTS_VSALVAGE;
437             format = "Server %s reported volume %d as needs salvage.";
438             break;
439         case VNOSERVICE:
440             msgID = MSG_SERVER_REPORTS_VNOSERVICE;
441             format = "Server %s reported volume %d as not in service.";
442             break;
443         case VIO:
444             msgID = MSG_SERVER_REPORTS_VIO;
445             format = "Server %s reported volume %d as temporarily unaccessible.";
446             break;
447         }
448
449         if (serverp && fidp) {
450             /* Log server being offline for this volume */
451             sprintf(addr, "%d.%d.%d.%d", 
452                    ((serverp->addr.sin_addr.s_addr & 0xff)),
453                    ((serverp->addr.sin_addr.s_addr & 0xff00)>> 8),
454                    ((serverp->addr.sin_addr.s_addr & 0xff0000)>> 16),
455                    ((serverp->addr.sin_addr.s_addr & 0xff000000)>> 24)); 
456
457             osi_Log2(afsd_logp, format, osi_LogSaveString(afsd_logp,addr), fidp->volume);
458             LogEvent(EVENTLOG_WARNING_TYPE, msgID, addr, fidp->volume);
459         }
460
461         /* Mark server offline for this volume */
462         if (!serversp && fidp) {
463             code = cm_GetServerList(fidp, userp, reqp, &serverspp);
464             if (code == 0) {
465                 serversp = *serverspp;
466                 free_svr_list = 1;
467             }
468         }
469
470         lock_ObtainWrite(&cm_serverLock);
471         for (tsrp = serversp; tsrp; tsrp=tsrp->next) {
472             if (tsrp->server == serverp) {
473                 /* REDIRECT */
474                 if (errorCode == VMOVED) {
475                     tsrp->status = srv_deleted;
476                 } else {
477                     tsrp->status = srv_offline;
478                 }
479
480                 if (fidp) { /* File Server query */
481                     code = cm_FindVolumeByID(cellp, fidp->volume, userp, reqp, 
482                                              CM_GETVOL_FLAG_NO_LRU_UPDATE, 
483                                              &volp);
484                     if (code == 0)
485                         cm_VolumeStateByID(volp, fidp->volume);
486                 }   
487             }
488         }   
489         lock_ReleaseWrite(&cm_serverLock);
490
491         if (fidp && errorCode == VMOVED)
492             cm_ForceUpdateVolume(fidp, userp, reqp);
493
494         if (statep) {
495             cm_UpdateVolumeStatus(volp, statep->ID);
496             lock_ObtainRead(&cm_volumeLock);
497             cm_PutVolume(volp);
498             lock_ReleaseRead(&cm_volumeLock);
499             volp = NULL;
500         }
501
502         if (free_svr_list) {
503             cm_FreeServerList(&serversp, 0);
504             *serverspp = serversp;
505         }
506         if ( timeLeft > 2 )
507             retry = 1;
508     } else if ( errorCode == VNOVNODE ) {
509         if ( fidp ) {
510             cm_scache_t * scp;
511             osi_Log4(afsd_logp, "cm_Analyze passed VNOVNODE cell %u vol %u vn %u uniq %u.",
512                       fidp->cell, fidp->volume, fidp->vnode, fidp->unique);
513
514             scp = cm_FindSCache(fidp);
515             if (scp) {
516                 cm_scache_t *pscp = NULL;
517
518                 if (scp->fileType != CM_SCACHETYPE_DIRECTORY)
519                     pscp = cm_FindSCacheParent(scp);
520
521                 lock_ObtainWrite(&scp->rw);
522                 lock_ObtainWrite(&cm_scacheLock);
523                 cm_RemoveSCacheFromHashTable(scp);
524                 lock_ReleaseWrite(&cm_scacheLock);
525                 cm_LockMarkSCacheLost(scp);
526                 scp->flags |= CM_SCACHEFLAG_DELETED;
527                 lock_ReleaseWrite(&scp->rw);
528                 cm_ReleaseSCache(scp);
529
530                 if (pscp) {
531                     if (cm_HaveCallback(pscp)) {
532                         lock_ObtainWrite(&pscp->rw);
533                         cm_DiscardSCache(pscp);
534                         lock_ReleaseWrite(&pscp->rw);
535                     }
536                     cm_ReleaseSCache(pscp);
537                 }
538             }
539         } else {
540             osi_Log0(afsd_logp, "cm_Analyze passed VNOVNODE unknown fid.");
541         }
542     }
543
544     /* RX codes */
545     else if (errorCode == RX_CALL_TIMEOUT) {
546         /* server took longer than hardDeadTime 
547          * don't mark server as down but don't retry
548          * this is to prevent the SMB session from timing out
549          * In addition, we log an event to the event log 
550          */
551
552         if (serverp) {
553         /* Log server being offline for this volume */
554         sprintf(addr, "%d.%d.%d.%d", 
555                  ((serverp->addr.sin_addr.s_addr & 0xff)),
556                  ((serverp->addr.sin_addr.s_addr & 0xff00)>> 8),
557                  ((serverp->addr.sin_addr.s_addr & 0xff0000)>> 16),
558                  ((serverp->addr.sin_addr.s_addr & 0xff000000)>> 24)); 
559
560         LogEvent(EVENTLOG_WARNING_TYPE, MSG_RX_HARD_DEAD_TIME_EXCEEDED, addr);
561           
562         osi_Log1(afsd_logp, "cm_Analyze: hardDeadTime exceeded addr[%s]",
563                  osi_LogSaveString(afsd_logp,addr));
564         reqp->tokenIdleErrorServp = serverp;
565         reqp->idleError++;
566         retry = 1;
567     }
568     }
569     else if (errorCode >= -64 && errorCode < 0) {
570         /* mark server as down */
571         lock_ObtainMutex(&serverp->mx);
572         if (reqp->flags & CM_REQ_NEW_CONN_FORCED) {
573             if (!(serverp->flags & CM_SERVERFLAG_DOWN)) {
574                 serverp->flags |= CM_SERVERFLAG_DOWN;
575                 serverp->downTime = time(NULL);
576             }
577         } else {
578             reqp->flags |= CM_REQ_NEW_CONN_FORCED;
579             forcing_new = 1;
580         }
581         lock_ReleaseMutex(&serverp->mx);
582         cm_ForceNewConnections(serverp);
583         if ( timeLeft > 2 )
584             retry = 1;
585     }
586     else if (errorCode == RXKADEXPIRED) {
587         if (!dead_session) {
588             lock_ObtainMutex(&userp->mx);
589             ucellp = cm_GetUCell(userp, serverp->cellp);
590             if (ucellp->ticketp) {
591                 free(ucellp->ticketp);
592                 ucellp->ticketp = NULL;
593             }
594             ucellp->flags &= ~CM_UCELLFLAG_RXKAD;
595             ucellp->gen++;
596             lock_ReleaseMutex(&userp->mx);
597             if ( timeLeft > 2 )
598                 retry = 1;
599         }
600     } else if (errorCode >= ERROR_TABLE_BASE_RXK && errorCode < ERROR_TABLE_BASE_RXK + 256) {
601         if (serverp) {
602         reqp->tokenIdleErrorServp = serverp;
603         reqp->tokenError = errorCode;
604         retry = 1;
605         }
606     } else if (errorCode == VICECONNBAD || errorCode == VICETOKENDEAD) {
607         cm_ForceNewConnections(serverp);
608         if ( timeLeft > 2 )
609             retry = 1;
610     } else {
611         if (errorCode) {
612             char * s = "unknown error";
613             switch ( errorCode ) {
614             case RXKADINCONSISTENCY: s = "RXKADINCONSISTENCY"; break;
615             case RXKADPACKETSHORT  : s = "RXKADPACKETSHORT";   break;
616             case RXKADLEVELFAIL    : s = "RXKADLEVELFAIL";     break;
617             case RXKADTICKETLEN    : s = "RXKADTICKETLEN";     break;
618             case RXKADOUTOFSEQUENCE: s = "RXKADOUTOFSEQUENCE"; break;
619             case RXKADNOAUTH       : s = "RXKADNOAUTH";        break;
620             case RXKADBADKEY       : s = "RXKADBADKEY";        break;
621             case RXKADBADTICKET    : s = "RXKADBADTICKET";     break;
622             case RXKADUNKNOWNKEY   : s = "RXKADUNKNOWNKEY";    break;
623             case RXKADEXPIRED      : s = "RXKADEXPIRED";       break;
624             case RXKADSEALEDINCON  : s = "RXKADSEALEDINCON";   break;
625             case RXKADDATALEN      : s = "RXKADDATALEN";       break;
626             case RXKADILLEGALLEVEL : s = "RXKADILLEGALLEVEL";  break;
627             case VSALVAGE          : s = "VSALVAGE";           break;
628             case VNOVNODE          : s = "VNOVNODE";           break;
629             case VNOVOL            : s = "VNOVOL";             break;
630             case VVOLEXISTS        : s = "VVOLEXISTS";         break;
631             case VNOSERVICE        : s = "VNOSERVICE";         break;
632             case VOFFLINE          : s = "VOFFLINE";           break;
633             case VONLINE           : s = "VONLINE";            break;
634             case VDISKFULL         : s = "VDISKFULL";          break;
635             case VOVERQUOTA        : s = "VOVERQUOTA";         break;
636             case VBUSY             : s = "VBUSY";              break;
637             case VMOVED            : s = "VMOVED";             break;
638             case VIO               : s = "VIO";                break;
639             case VRESTRICTED       : s = "VRESTRICTED";        break;
640             case VRESTARTING       : s = "VRESTARTING";        break;
641             case VREADONLY         : s = "VREADONLY";          break;
642             case EAGAIN            : s = "EAGAIN";             break;
643             case UAEAGAIN          : s = "UAEAGAIN";           break;
644             case EINVAL            : s = "EINVAL";             break;
645             case UAEINVAL          : s = "UAEINVAL";           break;
646             case EACCES            : s = "EACCES";             break;
647             case UAEACCES          : s = "UAEACCES";           break;
648             case ENOENT            : s = "ENOENT";             break;
649             case UAENOENT          : s = "UAENOENT";           break;
650             case VICECONNBAD       : s = "VICECONNBAD";        break;
651             case VICETOKENDEAD     : s = "VICETOKENDEAD";      break;
652             case WSAEWOULDBLOCK    : s = "WSAEWOULDBLOCK";     break;
653             case UAEWOULDBLOCK     : s = "UAEWOULDBLOCK";      break;
654             case VL_IDEXIST        : s = "VL_IDEXIST";         break;
655             case VL_IO             : s = "VL_IO";              break;
656             case VL_NAMEEXIST      : s = "VL_NAMEEXIST";       break;
657             case VL_CREATEFAIL     : s = "VL_CREATEFAIL";      break;
658             case VL_NOENT          : s = "VL_NOENT";           break;
659             case VL_EMPTY          : s = "VL_EMPTY";           break;
660             case VL_ENTDELETED     : s = "VL_ENTDELETED";      break;
661             case VL_BADNAME        : s = "VL_BADNAME";         break;
662             case VL_BADINDEX       : s = "VL_BADINDEX";        break;
663             case VL_BADVOLTYPE     : s = "VL_BADVOLTYPE";      break;
664             case VL_BADSERVER      : s = "VL_BADSERVER";       break;
665             case VL_BADPARTITION   : s = "VL_BADPARTITION";    break;
666             case VL_REPSFULL       : s = "VL_REPSFULL";        break;
667             case VL_NOREPSERVER    : s = "VL_NOREPSERVER";     break;
668             case VL_DUPREPSERVER   : s = "VL_DUPREPSERVER";    break;
669             case VL_RWNOTFOUND     : s = "VL_RWNOTFOUND";      break;
670             case VL_BADREFCOUNT    : s = "VL_BADREFCOUNT";     break;
671             case VL_SIZEEXCEEDED   : s = "VL_SIZEEXCEEDED";    break;
672             case VL_BADENTRY       : s = "VL_BADENTRY";        break;
673             case VL_BADVOLIDBUMP   : s = "VL_BADVOLIDBUMP";    break;
674             case VL_IDALREADYHASHED: s = "VL_IDALREADYHASHED"; break;
675             case VL_ENTRYLOCKED    : s = "VL_ENTRYLOCKED";     break;
676             case VL_BADVOLOPER     : s = "VL_BADVOLOPER";      break;
677             case VL_BADRELLOCKTYPE : s = "VL_BADRELLOCKTYPE";  break;
678             case VL_RERELEASE      : s = "VL_RERELEASE";       break;
679             case VL_BADSERVERFLAG  : s = "VL_BADSERVERFLAG";   break;
680             case VL_PERM           : s = "VL_PERM";            break;
681             case VL_NOMEM          : s = "VL_NOMEM";           break;
682             case VL_BADVERSION     : s = "VL_BADVERSION";      break;
683             case VL_INDEXERANGE    : s = "VL_INDEXERANGE";     break;
684             case VL_MULTIPADDR     : s = "VL_MULTIPADDR";      break;
685             case VL_BADMASK        : s = "VL_BADMASK";         break;
686             case CM_ERROR_NOSUCHCELL        : s = "CM_ERROR_NOSUCHCELL";         break;                         
687             case CM_ERROR_NOSUCHVOLUME      : s = "CM_ERROR_NOSUCHVOLUME";       break;                         
688             case CM_ERROR_TIMEDOUT          : s = "CM_ERROR_TIMEDOUT";           break;                 
689             case CM_ERROR_RETRY             : s = "CM_ERROR_RETRY";              break; 
690             case CM_ERROR_NOACCESS          : s = "CM_ERROR_NOACCESS";           break; 
691             case CM_ERROR_NOSUCHFILE        : s = "CM_ERROR_NOSUCHFILE";         break;                         
692             case CM_ERROR_STOPNOW           : s = "CM_ERROR_STOPNOW";            break;                         
693             case CM_ERROR_TOOBIG            : s = "CM_ERROR_TOOBIG";             break;                                 
694             case CM_ERROR_INVAL             : s = "CM_ERROR_INVAL";              break;                                 
695             case CM_ERROR_BADFD             : s = "CM_ERROR_BADFD";              break;                                 
696             case CM_ERROR_BADFDOP           : s = "CM_ERROR_BADFDOP";            break;                         
697             case CM_ERROR_EXISTS            : s = "CM_ERROR_EXISTS";             break;                                 
698             case CM_ERROR_CROSSDEVLINK      : s = "CM_ERROR_CROSSDEVLINK";       break;                         
699             case CM_ERROR_BADOP             : s = "CM_ERROR_BADOP";              break;                                 
700             case CM_ERROR_BADPASSWORD       : s = "CM_ERROR_BADPASSWORD";        break;         
701             case CM_ERROR_NOTDIR            : s = "CM_ERROR_NOTDIR";             break;                                 
702             case CM_ERROR_ISDIR             : s = "CM_ERROR_ISDIR";              break;                                 
703             case CM_ERROR_READONLY          : s = "CM_ERROR_READONLY";           break;                         
704             case CM_ERROR_WOULDBLOCK        : s = "CM_ERROR_WOULDBLOCK";         break;                         
705             case CM_ERROR_QUOTA             : s = "CM_ERROR_QUOTA";              break;                                 
706             case CM_ERROR_SPACE             : s = "CM_ERROR_SPACE";              break;                                 
707             case CM_ERROR_BADSHARENAME      : s = "CM_ERROR_BADSHARENAME";       break;                         
708             case CM_ERROR_BADTID            : s = "CM_ERROR_BADTID";             break;                                 
709             case CM_ERROR_UNKNOWN           : s = "CM_ERROR_UNKNOWN";            break;                         
710             case CM_ERROR_NOMORETOKENS      : s = "CM_ERROR_NOMORETOKENS";       break;                         
711             case CM_ERROR_NOTEMPTY          : s = "CM_ERROR_NOTEMPTY";           break;                         
712             case CM_ERROR_USESTD            : s = "CM_ERROR_USESTD";             break;                                 
713             case CM_ERROR_REMOTECONN        : s = "CM_ERROR_REMOTECONN";         break;                         
714             case CM_ERROR_ATSYS             : s = "CM_ERROR_ATSYS";              break;                                 
715             case CM_ERROR_NOSUCHPATH        : s = "CM_ERROR_NOSUCHPATH";         break;                         
716             case CM_ERROR_CLOCKSKEW         : s = "CM_ERROR_CLOCKSKEW";          break;                         
717             case CM_ERROR_BADSMB            : s = "CM_ERROR_BADSMB";             break;                                 
718             case CM_ERROR_ALLBUSY           : s = "CM_ERROR_ALLBUSY";            break;                         
719             case CM_ERROR_NOFILES           : s = "CM_ERROR_NOFILES";            break;                         
720             case CM_ERROR_PARTIALWRITE      : s = "CM_ERROR_PARTIALWRITE";       break;                         
721             case CM_ERROR_NOIPC             : s = "CM_ERROR_NOIPC";              break;                                 
722             case CM_ERROR_BADNTFILENAME     : s = "CM_ERROR_BADNTFILENAME";      break;                         
723             case CM_ERROR_BUFFERTOOSMALL    : s = "CM_ERROR_BUFFERTOOSMALL";     break;                         
724             case CM_ERROR_RENAME_IDENTICAL  : s = "CM_ERROR_RENAME_IDENTICAL";   break;                 
725             case CM_ERROR_ALLOFFLINE        : s = "CM_ERROR_ALLOFFLINE";         break;          
726             case CM_ERROR_AMBIGUOUS_FILENAME: s = "CM_ERROR_AMBIGUOUS_FILENAME"; break;  
727             case CM_ERROR_BADLOGONTYPE      : s = "CM_ERROR_BADLOGONTYPE";       break;             
728             case CM_ERROR_GSSCONTINUE       : s = "CM_ERROR_GSSCONTINUE";        break;         
729             case CM_ERROR_TIDIPC            : s = "CM_ERROR_TIDIPC";             break;              
730             case CM_ERROR_TOO_MANY_SYMLINKS : s = "CM_ERROR_TOO_MANY_SYMLINKS";  break;   
731             case CM_ERROR_PATH_NOT_COVERED  : s = "CM_ERROR_PATH_NOT_COVERED";   break;    
732             case CM_ERROR_LOCK_CONFLICT     : s = "CM_ERROR_LOCK_CONFLICT";      break;       
733             case CM_ERROR_SHARING_VIOLATION : s = "CM_ERROR_SHARING_VIOLATION";  break;   
734             case CM_ERROR_ALLDOWN           : s = "CM_ERROR_ALLDOWN";            break;             
735             case CM_ERROR_TOOFEWBUFS        : s = "CM_ERROR_TOOFEWBUFS";         break;                         
736             case CM_ERROR_TOOMANYBUFS       : s = "CM_ERROR_TOOMANYBUFS";        break;                         
737             }
738             osi_Log2(afsd_logp, "cm_Analyze: ignoring error code 0x%x (%s)", 
739                      errorCode, s);
740             retry = 0;
741         }
742     }
743
744     /* If not allowed to retry, don't */
745     if (!forcing_new && (reqp->flags & CM_REQ_NORETRY))
746         retry = 0;
747     else if (retry && dead_session)
748         retry = 0;
749
750   out:
751     /* drop this on the way out */
752     if (connp)
753         cm_PutConn(connp);
754
755     /* retry until we fail to find a connection */
756     return retry;
757 }
758
759 long cm_ConnByMServers(cm_serverRef_t *serversp, cm_user_t *usersp,
760         cm_req_t *reqp, cm_conn_t **connpp)
761 {
762     long code;
763     cm_serverRef_t *tsrp;
764     cm_server_t *tsp;
765     long firstError = 0;
766     int someBusy = 0, someOffline = 0, allOffline = 1, allBusy = 1, allDown = 1;
767     long timeUsed, timeLeft, hardTimeLeft;
768
769     *connpp = NULL;
770
771     if (serversp == NULL) {
772         osi_Log1(afsd_logp, "cm_ConnByMServers returning 0x%x", CM_ERROR_ALLDOWN);
773         return CM_ERROR_ALLDOWN;
774     }
775
776     timeUsed = (GetTickCount() - reqp->startTime) / 1000;
777         
778     /* leave 5 seconds margin of safety */
779     timeLeft =  ConnDeadtimeout - timeUsed - 5;
780     hardTimeLeft = HardDeadtimeout - timeUsed - 5;
781
782     lock_ObtainRead(&cm_serverLock);
783     for (tsrp = serversp; tsrp; tsrp=tsrp->next) {
784         tsp = tsrp->server;
785         if (reqp->tokenIdleErrorServp) {
786             /* 
787              * search the list until we find the server
788              * that failed last time.  When we find it
789              * clear the error, skip it and try the one
790              * in the list.
791              */
792             if (tsp == reqp->tokenIdleErrorServp)
793                 reqp->tokenIdleErrorServp = NULL;
794             continue;
795         }
796         cm_GetServerNoLock(tsp);
797         lock_ReleaseRead(&cm_serverLock);
798         if (!(tsp->flags & CM_SERVERFLAG_DOWN)) {
799             allDown = 0;
800             if (tsrp->status == srv_deleted) {
801                 /* skip this entry.  no longer valid. */;
802             } else if (tsrp->status == srv_busy) {
803                 allOffline = 0;
804                 someBusy = 1;
805             } else if (tsrp->status == srv_offline) {
806                 allBusy = 0;
807                 someOffline = 1;
808             } else {
809                 allOffline = 0;
810                 allBusy = 0;
811                 code = cm_ConnByServer(tsp, usersp, connpp);
812                 if (code == 0) {        /* cm_CBS only returns 0 */
813                     cm_PutServer(tsp);
814                     /* Set RPC timeout */
815                     if (timeLeft > ConnDeadtimeout)
816                         timeLeft = ConnDeadtimeout;
817
818                     if (hardTimeLeft > HardDeadtimeout) 
819                         hardTimeLeft = HardDeadtimeout;
820
821                     lock_ObtainMutex(&(*connpp)->mx);
822                     rx_SetConnDeadTime((*connpp)->callp, timeLeft);
823                     rx_SetConnHardDeadTime((*connpp)->callp, (u_short) hardTimeLeft);
824                     lock_ReleaseMutex(&(*connpp)->mx);
825                     return 0;
826                 }
827                 
828                 /* therefore, this code is never executed */
829                 if (firstError == 0)
830                     firstError = code;
831             }
832         }
833         lock_ObtainRead(&cm_serverLock);
834         cm_PutServerNoLock(tsp);
835     }   
836     lock_ReleaseRead(&cm_serverLock);
837
838     if (firstError == 0) {
839         if (allDown) 
840             firstError = (reqp->tokenError ? reqp->tokenError : 
841                           (reqp->idleError ? RX_CALL_TIMEOUT : CM_ERROR_ALLDOWN));
842         else if (allBusy) 
843             firstError = CM_ERROR_ALLBUSY;
844         else if (allOffline || (someBusy && someOffline))
845             firstError = CM_ERROR_ALLOFFLINE;
846         else {
847             osi_Log0(afsd_logp, "cm_ConnByMServers returning impossible error TIMEDOUT");
848             firstError = CM_ERROR_TIMEDOUT;
849         }
850     }
851
852     osi_Log1(afsd_logp, "cm_ConnByMServers returning 0x%x", firstError);
853     return firstError;
854 }
855
856 /* called with a held server to GC all bad connections hanging off of the server */
857 void cm_GCConnections(cm_server_t *serverp)
858 {
859     cm_conn_t *tcp;
860     cm_conn_t **lcpp;
861     cm_user_t *userp;
862
863     lock_ObtainWrite(&cm_connLock);
864     lcpp = &serverp->connsp;
865     for (tcp = *lcpp; tcp; tcp = *lcpp) {
866         userp = tcp->userp;
867         if (userp && tcp->refCount == 0 && (userp->vcRefs == 0)) {
868             /* do the deletion of this guy */
869             cm_PutServer(tcp->serverp);
870             cm_ReleaseUser(userp);
871             *lcpp = tcp->nextp;
872             rx_DestroyConnection(tcp->callp);
873             lock_FinalizeMutex(&tcp->mx);
874             free(tcp);
875         }
876         else {
877             /* just advance to the next */
878             lcpp = &tcp->nextp;
879         }
880     }
881     lock_ReleaseWrite(&cm_connLock);
882 }
883
884 static void cm_NewRXConnection(cm_conn_t *tcp, cm_ucell_t *ucellp,
885                                cm_server_t *serverp)
886 {
887     unsigned short port;
888     int serviceID;
889     int secIndex;
890     struct rx_securityClass *secObjp;
891
892     if (serverp->type == CM_SERVER_VLDB) {
893         port = htons(7003);
894         serviceID = 52;
895     }
896     else {
897         osi_assertx(serverp->type == CM_SERVER_FILE, "incorrect server type");
898         port = htons(7000);
899         serviceID = 1;
900     }
901     if (ucellp->flags & CM_UCELLFLAG_RXKAD) {
902         secIndex = 2;
903         if (cryptall) {
904             tcp->cryptlevel = rxkad_crypt;
905         } else {
906             tcp->cryptlevel = rxkad_clear;
907         }
908         secObjp = rxkad_NewClientSecurityObject(tcp->cryptlevel,
909                                                 &ucellp->sessionKey, ucellp->kvno,
910                                                 ucellp->ticketLen, ucellp->ticketp);    
911     } else {
912         /* normal auth */
913         secIndex = 0;
914         tcp->cryptlevel = rxkad_clear;
915         secObjp = rxnull_NewClientSecurityObject();
916     }
917     osi_assertx(secObjp != NULL, "null rx_securityClass");
918     tcp->callp = rx_NewConnection(serverp->addr.sin_addr.s_addr,
919                                   port,
920                                   serviceID,
921                                   secObjp,
922                                   secIndex);
923     rx_SetConnDeadTime(tcp->callp, ConnDeadtimeout);
924     rx_SetConnHardDeadTime(tcp->callp, HardDeadtimeout);
925     rx_SetConnIdleDeadTime(tcp->callp, IdleDeadtimeout);
926     tcp->ucgen = ucellp->gen;
927     if (secObjp)
928         rxs_Release(secObjp);   /* Decrement the initial refCount */
929 }
930
931 long cm_ConnByServer(cm_server_t *serverp, cm_user_t *userp, cm_conn_t **connpp)
932 {
933     cm_conn_t *tcp;
934     cm_ucell_t *ucellp;
935
936     *connpp = NULL;
937
938     if (cm_anonvldb && serverp->type == CM_SERVER_VLDB)
939         userp = cm_rootUserp;
940
941     lock_ObtainMutex(&userp->mx);
942     lock_ObtainRead(&cm_connLock);
943     for (tcp = serverp->connsp; tcp; tcp=tcp->nextp) {
944         if (tcp->userp == userp) 
945             break;
946     }
947     
948     /* find ucell structure */
949     ucellp = cm_GetUCell(userp, serverp->cellp);
950     if (!tcp) {
951         lock_ConvertRToW(&cm_connLock);
952         for (tcp = serverp->connsp; tcp; tcp=tcp->nextp) {
953             if (tcp->userp == userp) 
954                 break;
955         }
956         if (tcp) {
957             lock_ReleaseWrite(&cm_connLock);
958             goto haveconn;
959         }
960         cm_GetServer(serverp);
961         tcp = malloc(sizeof(*tcp));
962         memset(tcp, 0, sizeof(*tcp));
963         tcp->nextp = serverp->connsp;
964         serverp->connsp = tcp;
965         cm_HoldUser(userp);
966         tcp->userp = userp;
967         lock_InitializeMutex(&tcp->mx, "cm_conn_t mutex");
968         lock_ObtainMutex(&tcp->mx);
969         tcp->serverp = serverp;
970         tcp->cryptlevel = rxkad_clear;
971         cm_NewRXConnection(tcp, ucellp, serverp);
972         tcp->refCount = 1;
973         lock_ReleaseMutex(&tcp->mx);
974         lock_ReleaseWrite(&cm_connLock);
975     } else {
976         lock_ReleaseRead(&cm_connLock);
977       haveconn:
978         InterlockedIncrement(&tcp->refCount);
979
980         lock_ObtainMutex(&tcp->mx);
981         if ((tcp->flags & CM_CONN_FLAG_FORCE_NEW) ||
982             (tcp->ucgen < ucellp->gen) ||
983             (tcp->cryptlevel != (cryptall ? (ucellp->flags & CM_UCELLFLAG_RXKAD ? rxkad_crypt : rxkad_clear) : rxkad_clear)))
984         {
985             if (tcp->ucgen < ucellp->gen)
986                 osi_Log0(afsd_logp, "cm_ConnByServer replace connection due to token update");
987             else
988                 osi_Log0(afsd_logp, "cm_ConnByServer replace connection due to crypt change");
989             tcp->flags &= ~CM_CONN_FLAG_FORCE_NEW;
990             rx_DestroyConnection(tcp->callp);
991             cm_NewRXConnection(tcp, ucellp, serverp);
992         }
993         lock_ReleaseMutex(&tcp->mx);
994     }
995     lock_ReleaseMutex(&userp->mx);
996
997     /* return this pointer to our caller */
998     osi_Log1(afsd_logp, "cm_ConnByServer returning conn 0x%p", tcp);
999     *connpp = tcp;
1000
1001     return 0;
1002 }
1003
1004 long cm_ServerAvailable(struct cm_fid *fidp, struct cm_user *userp)
1005 {
1006     long code;
1007     cm_req_t req;
1008     cm_serverRef_t **serverspp;
1009     cm_serverRef_t *tsrp;
1010     cm_server_t *tsp;
1011     int someBusy = 0, someOffline = 0, allOffline = 1, allBusy = 1, allDown = 1;
1012
1013     cm_InitReq(&req);
1014
1015     code = cm_GetServerList(fidp, userp, &req, &serverspp);
1016     if (code)
1017         return 0;
1018
1019     lock_ObtainRead(&cm_serverLock);
1020     for (tsrp = *serverspp; tsrp; tsrp=tsrp->next) {
1021         tsp = tsrp->server;
1022         if (!(tsp->flags & CM_SERVERFLAG_DOWN)) {
1023             allDown = 0;
1024             if (tsrp->status == srv_busy) {
1025                 allOffline = 0;
1026                 someBusy = 1;
1027             } else if (tsrp->status == srv_offline) {
1028                 allBusy = 0;
1029                 someOffline = 1;
1030             } else {
1031                 allOffline = 0;
1032                 allBusy = 0;
1033             }
1034         }
1035     }   
1036     lock_ReleaseRead(&cm_serverLock);
1037     cm_FreeServerList(serverspp, 0);
1038
1039     if (allDown)
1040         return 0;
1041     else if (allBusy) 
1042         return 0;
1043     else if (allOffline || (someBusy && someOffline))
1044         return 0;
1045     else
1046         return 1;
1047 }
1048
1049 /* 
1050  * The returned cm_conn_t ** object is released in the subsequent call
1051  * to cm_Analyze().  
1052  */
1053 long cm_ConnFromFID(struct cm_fid *fidp, struct cm_user *userp, cm_req_t *reqp,
1054                     cm_conn_t **connpp)
1055 {
1056     long code;
1057     cm_serverRef_t **serverspp;
1058
1059     *connpp = NULL;
1060
1061     code = cm_GetServerList(fidp, userp, reqp, &serverspp);
1062     if (code) {
1063         return code;
1064     }
1065
1066     code = cm_ConnByMServers(*serverspp, userp, reqp, connpp);
1067     cm_FreeServerList(serverspp, 0);
1068     return code;
1069 }
1070
1071
1072 long cm_ConnFromVolume(struct cm_volume *volp, unsigned long volid, struct cm_user *userp, cm_req_t *reqp,
1073                        cm_conn_t **connpp)
1074 {
1075     long code;
1076     cm_serverRef_t **serverspp;
1077
1078     *connpp = NULL;
1079
1080     serverspp = cm_GetVolServers(volp, volid);
1081
1082     code = cm_ConnByMServers(*serverspp, userp, reqp, connpp);
1083     cm_FreeServerList(serverspp, 0);
1084     return code;
1085 }
1086
1087
1088 extern struct rx_connection *
1089 cm_GetRxConn(cm_conn_t *connp)
1090 {
1091     struct rx_connection * rxconn;
1092     lock_ObtainMutex(&connp->mx);
1093     rxconn = connp->callp;
1094     rx_GetConnection(rxconn);
1095     lock_ReleaseMutex(&connp->mx);
1096     return rxconn;
1097 }
1098
1099 void cm_ForceNewConnections(cm_server_t *serverp)
1100 {
1101     cm_conn_t *tcp;
1102
1103     lock_ObtainWrite(&cm_connLock);
1104     for (tcp = serverp->connsp; tcp; tcp=tcp->nextp) {
1105         lock_ObtainMutex(&tcp->mx);
1106         tcp->flags |= CM_CONN_FLAG_FORCE_NEW;
1107         lock_ReleaseMutex(&tcp->mx);
1108     }
1109     lock_ReleaseWrite(&cm_connLock);
1110 }