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