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