windows-afsifs-20050620
[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 #ifndef DJGPP
14 #include <windows.h>
15 #endif /* !DJGPP */
16 #include <string.h>
17 #include <malloc.h>
18 #include <osi.h>
19 #include <rx/rx.h>
20 #ifndef DJGPP
21 #include <rx/rxkad.h>
22 #else
23 #include <rx/rxkad.h>
24 #endif
25
26 #include "afsd.h"
27
28 osi_rwlock_t cm_connLock;
29
30 long RDRtimeout = CM_CONN_DEFAULTRDRTIMEOUT;
31 long ConnDeadtimeout = CM_CONN_CONNDEADTIME;
32 long HardDeadtimeout = CM_CONN_HARDDEADTIME;
33
34 #define LANMAN_WKS_PARAM_KEY "SYSTEM\\CurrentControlSet\\Services\\lanmanworkstation\\parameters"
35 #define LANMAN_WKS_SESSION_TIMEOUT "SessTimeout"
36
37 afs_int32 cryptall = 0;
38
39 void cm_PutConn(cm_conn_t *connp)
40 {
41         lock_ObtainWrite(&cm_connLock);
42         osi_assert(connp->refCount-- > 0);
43         lock_ReleaseWrite(&cm_connLock);
44 }
45
46 void cm_InitConn(void)
47 {
48         static osi_once_t once;
49         long code;
50         DWORD sessTimeout;
51         HKEY parmKey;
52         
53     if (osi_Once(&once)) {
54                 lock_InitializeRWLock(&cm_connLock, "connection global lock");
55
56         /* keisa - read timeout value for lanmanworkstation  service.
57          * jaltman - as per 
58          *   http://support.microsoft.com:80/support/kb/articles/Q102/0/67.asp&NoWebContent=1
59          * the SessTimeout is a minimum timeout not a maximum timeout.  Therefore, 
60          * I believe that the default should not be short.  Instead, we should wait until
61          * RX times out before reporting a timeout to the SMB client.
62          */
63                 code = RegOpenKeyEx(HKEY_LOCAL_MACHINE, LANMAN_WKS_PARAM_KEY,
64                             0, KEY_QUERY_VALUE, &parmKey);
65                 if (code == ERROR_SUCCESS)
66         {
67                     DWORD dummyLen = sizeof(sessTimeout);
68                     code = RegQueryValueEx(parmKey, LANMAN_WKS_SESSION_TIMEOUT, NULL, NULL, 
69                                    (BYTE *) &sessTimeout, &dummyLen);
70                     if (code == ERROR_SUCCESS)
71             {
72                 afsi_log("lanmanworkstation : SessTimeout %d", sessTimeout);
73                 RDRtimeout = sessTimeout;
74                 if ( ConnDeadtimeout < RDRtimeout + 15 ) {
75                     ConnDeadtimeout = RDRtimeout + 15;
76                     afsi_log("ConnDeadTimeout increased to %d", ConnDeadtimeout);
77                 }
78                 if ( HardDeadtimeout < 2 * ConnDeadtimeout ) {
79                     HardDeadtimeout = 2 * ConnDeadtimeout;
80                     afsi_log("HardDeadTimeout increased to %d", HardDeadtimeout);
81                 }
82             }
83         }
84
85         osi_EndOnce(&once);
86     }
87 }
88
89 void cm_InitReq(cm_req_t *reqp)
90 {
91         memset((char *)reqp, 0, sizeof(cm_req_t));
92 #ifndef DJGPP
93         reqp->startTime = GetCurrentTime();
94 #else
95         gettimeofday(&reqp->startTime, NULL);
96 #endif
97 }
98
99 static long cm_GetServerList(struct cm_fid *fidp, struct cm_user *userp,
100         struct cm_req *reqp, cm_serverRef_t ***serversppp)
101 {
102     long code;
103     cm_volume_t *volp = NULL;
104     cm_cell_t *cellp = NULL;
105
106     if (!fidp) {
107         *serversppp = NULL;
108         return 0;
109     }
110
111     cellp = cm_FindCellByID(fidp->cell);
112     if (!cellp) return CM_ERROR_NOSUCHCELL;
113
114     code = cm_GetVolumeByID(cellp, fidp->volume, userp, reqp, &volp);
115     if (code) return code;
116     
117     *serversppp = cm_GetVolServers(volp, fidp->volume);
118
119     cm_PutVolume(volp);
120     return 0;
121 }
122
123 /*
124  * Analyze the error return from an RPC.  Determine whether or not to retry,
125  * and if we're going to retry, determine whether failover is appropriate,
126  * and whether timed backoff is appropriate.
127  *
128  * If the error code is from cm_Conn() or friends, it will be a CM_ERROR code.
129  * Otherwise it will be an RPC code.  This may be a UNIX code (e.g. EDQUOT), or
130  * it may be an RX code, or it may be a special code (e.g. VNOVOL), or it may
131  * be a security code (e.g. RXKADEXPIRED).
132  *
133  * If the error code is from cm_Conn() or friends, connp will be NULL.
134  *
135  * For VLDB calls, fidp will be NULL.
136  *
137  * volSyncp and/or cbrp may also be NULL.
138  */
139 int
140 cm_Analyze(cm_conn_t *connp, cm_user_t *userp, cm_req_t *reqp,
141            struct cm_fid *fidp, 
142            AFSVolSync *volSyncp, 
143            cm_serverRef_t * serversp,
144            cm_callbackRequest_t *cbrp, long errorCode)
145 {
146     cm_server_t *serverp = NULL;
147     cm_serverRef_t **serverspp = NULL;
148     cm_serverRef_t *tsrp;
149     cm_ucell_t *ucellp;
150     int retry = 0;
151     int free_svr_list = 0;
152     int dead_session;
153     long timeUsed, timeLeft;
154     long code;
155         
156     osi_Log2(afsd_logp, "cm_Analyze connp 0x%x, code 0x%x",
157              (long) connp, errorCode);
158
159     /* no locking required, since connp->serverp never changes after
160      * creation */
161     dead_session = (userp->cellInfop == NULL);
162     if (connp)
163         serverp = connp->serverp;
164
165     /* Update callback pointer */
166     if (cbrp && serverp && errorCode == 0) {
167         if (cbrp->serverp) {
168             if ( cbrp->serverp != serverp ) {
169                 lock_ObtainWrite(&cm_serverLock);
170                 cm_PutServerNoLock(cbrp->serverp);
171                 cm_GetServerNoLock(serverp);
172                 lock_ReleaseWrite(&cm_serverLock);
173             }
174         } else {
175             cm_GetServer(serverp);
176         }
177         lock_ObtainWrite(&cm_callbackLock);
178         cbrp->serverp = serverp;
179         lock_ReleaseWrite(&cm_callbackLock);
180     }
181
182     /* If not allowed to retry, don't */
183     if (reqp->flags & CM_REQ_NORETRY)
184         goto out;
185
186     /* if timeout - check that it did not exceed the SMB timeout
187      * and retry */
188     
189     /* timeleft - get if from reqp the same way as cmXonnByMServers does */
190 #ifndef DJGPP
191     timeUsed = (GetCurrentTime() - reqp->startTime) / 1000;
192 #else
193     gettimeofday(&now, NULL);
194     timeUsed = sub_time(now, reqp->startTime) / 1000;
195 #endif
196             
197     /* leave 5 seconds margin for sleep */
198     timeLeft = RDRtimeout - timeUsed;
199
200     if (errorCode == CM_ERROR_TIMEDOUT) {
201         if (timeLeft > 5 ) {
202             thrd_Sleep(3000);
203             cm_CheckServers(CM_FLAG_CHECKDOWNSERVERS, NULL);
204             retry = 1;
205         }
206     } 
207
208     /* if there is nosuchvolume, then we have a situation in which a 
209      * previously known volume no longer has a set of servers 
210      * associated with it.  Either the volume has moved or
211      * the volume has been deleted.  Try to find a new server list
212      * until the timeout period expires.
213      */
214     else if (errorCode == CM_ERROR_NOSUCHVOLUME) {
215         if (timeLeft > 7) {
216             osi_Log0(afsd_logp, "cm_Analyze passed CM_ERROR_NOSUCHVOLUME.");
217             thrd_Sleep(5000);
218             
219             retry = 1;
220
221             if (fidp != NULL)   /* Not a VLDB call */
222                 cm_ForceUpdateVolume(fidp, userp, reqp);
223         }
224     }
225
226     else if (errorCode == CM_ERROR_ALLOFFLINE) {
227         if (timeLeft > 7) {
228             osi_Log0(afsd_logp, "cm_Analyze passed CM_ERROR_ALLOFFLINE.");
229             thrd_Sleep(5000);
230             
231             /* cm_ForceUpdateVolume marks all servers as non_busy */
232             /* No it doesn't and it won't do anything if all of the 
233              * the servers are marked as DOWN.  So clear the DOWN
234              * flag and reset the busy state as well.
235              */
236             if (!serversp) {
237                 code = cm_GetServerList(fidp, userp, reqp, &serverspp);
238                 if (code == 0) {
239                     serversp = *serverspp;
240                     free_svr_list = 1;
241                 }
242             }
243             if (serversp) {
244                 lock_ObtainWrite(&cm_serverLock);
245                 for (tsrp = serversp; tsrp; tsrp=tsrp->next) {
246                     tsrp->server->flags &= ~CM_SERVERFLAG_DOWN;
247                     if (tsrp->status == busy)
248                         tsrp->status = not_busy;
249                 }
250                 lock_ReleaseWrite(&cm_serverLock);
251                 if (free_svr_list) {
252                     cm_FreeServerList(&serversp);
253                     *serverspp = serversp;
254                 }
255                 retry = 1;
256             }
257
258             if (fidp != NULL)   /* Not a VLDB call */
259                 cm_ForceUpdateVolume(fidp, userp, reqp);
260                         else
261                                 retry = 0;
262         }
263     }
264
265     /* if all servers are busy, mark them non-busy and start over */
266     else if (errorCode == CM_ERROR_ALLBUSY) {
267         if (timeLeft > 7) {
268             thrd_Sleep(5000);
269             if (!serversp) {
270                 code = cm_GetServerList(fidp, userp, reqp, &serverspp);
271                 if (code == 0) {
272                     serversp = *serverspp;
273                     free_svr_list = 1;
274                 }
275             }
276             lock_ObtainWrite(&cm_serverLock);
277             for (tsrp = serversp; tsrp; tsrp=tsrp->next) {
278                 if (tsrp->status == busy)
279                     tsrp->status = not_busy;
280             }
281             lock_ReleaseWrite(&cm_serverLock);
282             if (free_svr_list) {
283                 cm_FreeServerList(&serversp);
284                 *serverspp = serversp;
285             }
286             retry = 1;
287         }
288     }
289
290     /* special codes:  VBUSY and VRESTARTING */
291     else if (errorCode == VBUSY || errorCode == VRESTARTING) {
292         if (!serversp) {
293             code = cm_GetServerList(fidp, userp, reqp, &serverspp);
294             if (code == 0) {
295                 serversp = *serverspp;
296                 free_svr_list = 1;
297             }
298         }
299         lock_ObtainWrite(&cm_serverLock);
300         for (tsrp = serversp; tsrp; tsrp=tsrp->next) {
301             if (tsrp->server == serverp
302                  && tsrp->status == not_busy) {
303                 tsrp->status = busy;
304                 break;
305             }
306         }
307         lock_ReleaseWrite(&cm_serverLock);
308         if (free_svr_list) {
309             cm_FreeServerList(&serversp);
310             *serverspp = serversp;
311         }
312         retry = 1;
313     }
314
315     /* special codes:  missing volumes */
316     else if (errorCode == VNOVOL || errorCode == VMOVED || errorCode == VOFFLINE ||
317              errorCode == VSALVAGE || errorCode == VNOSERVICE || errorCode == VIO) 
318     {       
319         /* Log server being offline for this volume */
320         osi_Log4(afsd_logp, "cm_Analyze found server %d.%d.%d.%d marked offline for a volume",
321                   ((serverp->addr.sin_addr.s_addr & 0xff)),
322                   ((serverp->addr.sin_addr.s_addr & 0xff00)>> 8),
323                   ((serverp->addr.sin_addr.s_addr & 0xff0000)>> 16),
324                   ((serverp->addr.sin_addr.s_addr & 0xff000000)>> 24));
325         /* Create Event Log message */ 
326         {
327             HANDLE h;
328             char *ptbuf[1];
329             char s[100];
330             h = RegisterEventSource(NULL, AFS_DAEMON_EVENT_NAME);
331             sprintf(s, "cm_Analyze: Server %d.%d.%d.%d reported volume %d as missing.",
332                      ((serverp->addr.sin_addr.s_addr & 0xff)),
333                      ((serverp->addr.sin_addr.s_addr & 0xff00)>> 8),
334                      ((serverp->addr.sin_addr.s_addr & 0xff0000)>> 16),
335                      ((serverp->addr.sin_addr.s_addr & 0xff000000)>> 24),
336                      fidp->volume);
337             ptbuf[0] = s;
338             ReportEvent(h, EVENTLOG_WARNING_TYPE, 0, 1009, NULL,
339                          1, 0, ptbuf, NULL);
340             DeregisterEventSource(h);
341         }
342
343         /* Mark server offline for this volume */
344         if (!serversp) {
345             code = cm_GetServerList(fidp, userp, reqp, &serverspp);
346             if (code == 0) {
347                 serversp = *serverspp;
348                 free_svr_list = 1;
349             }
350         }
351         for (tsrp = serversp; tsrp; tsrp=tsrp->next) {
352             if (tsrp->server == serverp)
353                 tsrp->status = offline;
354         }   
355         if (free_svr_list) {
356             cm_FreeServerList(&serversp);
357             *serverspp = serversp;
358         }
359         if ( timeLeft > 2 )
360             retry = 1;
361     }
362
363     /* RX codes */
364     else if (errorCode == RX_CALL_TIMEOUT) {
365         /* server took longer than hardDeadTime 
366          * don't mark server as down but don't retry
367          * this is to prevent the SMB session from timing out
368          * In addition, we log an event to the event log 
369          */
370 #ifndef DJGPP
371         HANDLE h;
372         char *ptbuf[1];
373         char s[100];
374         h = RegisterEventSource(NULL, AFS_DAEMON_EVENT_NAME);
375         sprintf(s, "cm_Analyze: HardDeadTime exceeded.");
376         ptbuf[0] = s;
377         ReportEvent(h, EVENTLOG_WARNING_TYPE, 0, 1009, NULL,
378                      1, 0, ptbuf, NULL);
379         DeregisterEventSource(h);
380 #endif /* !DJGPP */
381           
382         retry = 0;
383         osi_Log0(afsd_logp, "cm_Analyze: hardDeadTime exceeded");
384     }
385     else if (errorCode >= -64 && errorCode < 0) {
386         /* mark server as down */
387         lock_ObtainMutex(&serverp->mx);
388         serverp->flags |= CM_SERVERFLAG_DOWN;
389         lock_ReleaseMutex(&serverp->mx);
390         if ( timeLeft > 2 )
391             retry = 1;
392     }
393     else if (errorCode == RXKADEXPIRED || 
394              errorCode == RXKADBADTICKET) {
395         if (!dead_session) {
396             lock_ObtainMutex(&userp->mx);
397             ucellp = cm_GetUCell(userp, serverp->cellp);
398             if (ucellp->ticketp) {
399                 free(ucellp->ticketp);
400                 ucellp->ticketp = NULL;
401             }
402             ucellp->flags &= ~CM_UCELLFLAG_RXKAD;
403             ucellp->gen++;
404             lock_ReleaseMutex(&userp->mx);
405             if ( timeLeft > 2 )
406                 retry = 1;
407         }
408     } else {
409         if (errorCode) {
410             char * s = "unknown error";
411             switch ( errorCode ) {
412             case RXKADINCONSISTENCY: s = "RXKADINCONSISTENCY"; break;
413             case RXKADPACKETSHORT  : s = "RXKADPACKETSHORT";   break;
414             case RXKADLEVELFAIL    : s = "RXKADLEVELFAIL";     break;
415             case RXKADTICKETLEN    : s = "RXKADTICKETLEN";     break;
416             case RXKADOUTOFSEQUENCE: s = "RXKADOUTOFSEQUENCE"; break;
417             case RXKADNOAUTH       : s = "RXKADNOAUTH";        break;
418             case RXKADBADKEY       : s = "RXKADBADKEY";        break;
419             case RXKADBADTICKET    : s = "RXKADBADTICKET";     break;
420             case RXKADUNKNOWNKEY   : s = "RXKADUNKNOWNKEY";    break;
421             case RXKADEXPIRED      : s = "RXKADEXPIRED";       break;
422             case RXKADSEALEDINCON  : s = "RXKADSEALEDINCON";   break;
423             case RXKADDATALEN      : s = "RXKADDATALEN";       break;
424             case RXKADILLEGALLEVEL : s = "RXKADILLEGALLEVEL";  break;
425             case VSALVAGE          : s = "VSALVAGE";           break;
426             case VNOVNODE          : s = "VNOVNODE";           break;
427             case VNOVOL            : s = "VNOVOL";             break;
428             case VVOLEXISTS        : s = "VVOLEXISTS";         break;
429             case VNOSERVICE        : s = "VNOSERVICE";         break;
430             case VOFFLINE          : s = "VOFFLINE";           break;
431             case VONLINE           : s = "VONLINE";            break;
432             case VDISKFULL         : s = "VDISKFULL";          break;
433             case VOVERQUOTA        : s = "VOVERQUOTA";         break;
434             case VBUSY             : s = "VBUSY";              break;
435             case VMOVED            : s = "VMOVED";             break;
436             case VIO               : s = "VIO";                break;
437             case VRESTRICTED       : s = "VRESTRICTED";        break;
438             case VRESTARTING       : s = "VRESTARTING";        break;
439             case VREADONLY         : s = "VREADONLY";          break;
440             }
441             osi_Log2(afsd_logp, "cm_Analyze: ignoring error code 0x%x (%s)", 
442                      errorCode, s);
443             retry = 0;
444         }
445     }
446
447     if (retry && dead_session)
448         retry = 0;
449
450   out:
451     /* drop this on the way out */
452     if (connp)
453         cm_PutConn(connp);
454
455     /* retry until we fail to find a connection */
456     return retry;
457 }
458
459 long cm_ConnByMServers(cm_serverRef_t *serversp, cm_user_t *usersp,
460         cm_req_t *reqp, cm_conn_t **connpp)
461 {
462     long code;
463     cm_serverRef_t *tsrp;
464     cm_server_t *tsp;
465     long firstError = 0;
466     int someBusy = 0, someOffline = 0, allBusy = 1, allDown = 1;
467     long timeUsed, timeLeft, hardTimeLeft;
468 #ifdef DJGPP
469     struct timeval now;
470 #endif /* DJGPP */        
471
472     *connpp = NULL;
473
474 #ifndef DJGPP
475     timeUsed = (GetCurrentTime() - reqp->startTime) / 1000;
476 #else
477     gettimeofday(&now, NULL);
478     timeUsed = sub_time(now, reqp->startTime) / 1000;
479 #endif
480         
481     /* leave 5 seconds margin of safety */
482     timeLeft =  ConnDeadtimeout - timeUsed - 5;
483     hardTimeLeft = HardDeadtimeout - timeUsed - 5;
484
485     lock_ObtainWrite(&cm_serverLock);
486     for (tsrp = serversp; tsrp; tsrp=tsrp->next) {
487         tsp = tsrp->server;
488         cm_GetServerNoLock(tsp);
489         lock_ReleaseWrite(&cm_serverLock);
490         if (!(tsp->flags & CM_SERVERFLAG_DOWN)) {
491             if (tsrp->status == busy) {
492                 allDown = 0;
493                 someBusy = 1;
494             } else if (tsrp->status == offline) {
495                 someOffline = 1;
496             } else {
497                 allDown = 0;
498                 allBusy = 0;
499                 code = cm_ConnByServer(tsp, usersp, connpp);
500                 if (code == 0) {        /* cm_CBS only returns 0 */
501                     cm_PutServer(tsp);
502                     /* Set RPC timeout */
503                     if (timeLeft > ConnDeadtimeout)
504                         timeLeft = ConnDeadtimeout;
505
506                     if (hardTimeLeft > HardDeadtimeout) 
507                         hardTimeLeft = HardDeadtimeout;
508
509                     lock_ObtainMutex(&(*connpp)->mx);
510                     rx_SetConnDeadTime((*connpp)->callp, timeLeft);
511                     rx_SetConnHardDeadTime((*connpp)->callp, (u_short) hardTimeLeft);
512                     lock_ReleaseMutex(&(*connpp)->mx);
513                     return 0;
514                 }
515                 
516                 /* therefore, this code is never executed */
517                 if (firstError == 0)
518                     firstError = code;
519             }
520         }
521         lock_ObtainWrite(&cm_serverLock);
522         cm_PutServerNoLock(tsp);
523     }   
524
525     lock_ReleaseWrite(&cm_serverLock);
526     if (firstError == 0) {
527         if (serversp == NULL)
528             firstError = CM_ERROR_NOSUCHVOLUME;
529         else if (allDown) 
530             firstError = CM_ERROR_ALLOFFLINE;
531         else if (allBusy) 
532             firstError = CM_ERROR_ALLBUSY;
533         else {
534             osi_Log0(afsd_logp, "cm_ConnByMServers returning impossible error TIMEDOUT");
535             firstError = CM_ERROR_TIMEDOUT;
536         }
537     }
538
539     osi_Log1(afsd_logp, "cm_ConnByMServers returning 0x%x", firstError);
540     return firstError;
541 }
542
543 /* called with a held server to GC all bad connections hanging off of the server */
544 void cm_GCConnections(cm_server_t *serverp)
545 {
546     cm_conn_t *tcp;
547     cm_conn_t **lcpp;
548     cm_user_t *userp;
549
550     lock_ObtainWrite(&cm_connLock);
551     lcpp = &serverp->connsp;
552     for (tcp = *lcpp; tcp; tcp = *lcpp) {
553         userp = tcp->userp;
554         if (userp && tcp->refCount == 0 && (userp->vcRefs == 0)) {
555             /* do the deletion of this guy */
556             cm_PutServer(tcp->serverp);
557             cm_ReleaseUser(userp);
558             *lcpp = tcp->nextp;
559             rx_DestroyConnection(tcp->callp);
560             lock_FinalizeMutex(&tcp->mx);
561             free(tcp);
562         }
563         else {
564             /* just advance to the next */
565             lcpp = &tcp->nextp;
566         }
567     }
568     lock_ReleaseWrite(&cm_connLock);
569 }
570
571 static void cm_NewRXConnection(cm_conn_t *tcp, cm_ucell_t *ucellp,
572                                cm_server_t *serverp)
573 {
574     unsigned short port;
575     int serviceID;
576     int secIndex;
577     struct rx_securityClass *secObjp;
578
579     if (serverp->type == CM_SERVER_VLDB) {
580         port = htons(7003);
581         serviceID = 52;
582     }
583     else {
584         osi_assert(serverp->type == CM_SERVER_FILE);
585         port = htons(7000);
586         serviceID = 1;
587     }
588     if (ucellp->flags & CM_UCELLFLAG_RXKAD) {
589         secIndex = 2;
590         if (cryptall) {
591             tcp->cryptlevel = rxkad_crypt;
592         } else {
593             tcp->cryptlevel = rxkad_clear;
594         }
595         secObjp = rxkad_NewClientSecurityObject(tcp->cryptlevel,
596                                                 &ucellp->sessionKey, ucellp->kvno,
597                                                 ucellp->ticketLen, ucellp->ticketp);    
598     } else {
599         /* normal auth */
600         secIndex = 0;
601         tcp->cryptlevel = rxkad_clear;
602         secObjp = rxnull_NewClientSecurityObject();
603     }
604     osi_assert(secObjp != NULL);
605     tcp->callp = rx_NewConnection(serverp->addr.sin_addr.s_addr,
606                                   port,
607                                   serviceID,
608                                   secObjp,
609                                   secIndex);
610     rx_SetConnDeadTime(tcp->callp, ConnDeadtimeout);
611     rx_SetConnHardDeadTime(tcp->callp, HardDeadtimeout);
612     tcp->ucgen = ucellp->gen;
613     if (secObjp)
614         rxs_Release(secObjp);   /* Decrement the initial refCount */
615 }
616
617 long cm_ConnByServer(cm_server_t *serverp, cm_user_t *userp, cm_conn_t **connpp)
618 {
619     cm_conn_t *tcp;
620     cm_ucell_t *ucellp;
621
622     lock_ObtainMutex(&userp->mx);
623     lock_ObtainWrite(&cm_connLock);
624     for (tcp = serverp->connsp; tcp; tcp=tcp->nextp) {
625         if (tcp->userp == userp) 
626             break;
627     }
628     
629     /* find ucell structure */
630     ucellp = cm_GetUCell(userp, serverp->cellp);
631     if (!tcp) {
632         cm_GetServer(serverp);
633         tcp = malloc(sizeof(*tcp));
634         memset(tcp, 0, sizeof(*tcp));
635         tcp->nextp = serverp->connsp;
636         serverp->connsp = tcp;
637         cm_HoldUser(userp);
638         tcp->userp = userp;
639         lock_InitializeMutex(&tcp->mx, "cm_conn_t mutex");
640         lock_ObtainMutex(&tcp->mx);
641         tcp->serverp = serverp;
642         tcp->cryptlevel = rxkad_clear;
643         cm_NewRXConnection(tcp, ucellp, serverp);
644         tcp->refCount = 1;
645         lock_ReleaseMutex(&tcp->mx);
646     } else {
647         if ((tcp->ucgen < ucellp->gen) ||
648             (tcp->cryptlevel != (cryptall ? (ucellp->flags & CM_UCELLFLAG_RXKAD ? rxkad_crypt : rxkad_clear) : rxkad_clear)))
649         {
650             if (tcp->ucgen < ucellp->gen)
651                 osi_Log0(afsd_logp, "cm_ConnByServer replace connection due to token update");
652             else
653                 osi_Log0(afsd_logp, "cm_ConnByServer replace connection due to crypt change");
654             lock_ObtainMutex(&tcp->mx);
655             rx_DestroyConnection(tcp->callp);
656             cm_NewRXConnection(tcp, ucellp, serverp);
657             lock_ReleaseMutex(&tcp->mx);
658         }
659         tcp->refCount++;
660     }
661     lock_ReleaseWrite(&cm_connLock);
662     lock_ReleaseMutex(&userp->mx);
663
664     /* return this pointer to our caller */
665     osi_Log1(afsd_logp, "cm_ConnByServer returning conn 0x%x", (long) tcp);
666     *connpp = tcp;
667
668     return 0;
669 }
670
671 long cm_Conn(struct cm_fid *fidp, struct cm_user *userp, cm_req_t *reqp,
672              cm_conn_t **connpp)
673 {
674     long code;
675
676     cm_serverRef_t **serverspp;
677
678     code = cm_GetServerList(fidp, userp, reqp, &serverspp);
679     if (code) {
680         *connpp = NULL;
681         return code;
682     }
683
684     code = cm_ConnByMServers(*serverspp, userp, reqp, connpp);
685     cm_FreeServerList(serverspp);
686     return code;
687 }
688
689 extern struct rx_connection * 
690 cm_GetRxConn(cm_conn_t *connp)
691 {
692     struct rx_connection * rxconn;
693     lock_ObtainMutex(&connp->mx);
694     rxconn = connp->callp;
695     rx_GetConnection(rxconn);
696     lock_ReleaseMutex(&connp->mx);
697     return rxconn;
698 }
699