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 = 0;
 147     cm_serverRef_t **serverspp = 0;
 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
 155     osi_Log2(afsd_logp, "cm_Analyze connp 0x%x, code 0x%x",
 156              (long) connp, errorCode);
 157
 158     /* no locking required, since connp->serverp never changes after
 159      * creation */
 160     dead_session = (userp->cellInfop == NULL);
 161     if (connp)
 162         serverp = connp->serverp;
 163
 164     /* Update callback pointer */
 165     if (cbrp && serverp && errorCode == 0) {
 166         if (cbrp->serverp) {
 167             if ( cbrp->serverp != serverp ) {
 168                 lock_ObtainWrite(&cm_serverLock);
 169                 cm_PutServerNoLock(cbrp->serverp);
 170                 cm_GetServerNoLock(serverp);
 171                 lock_ReleaseWrite(&cm_serverLock);
 172             }
 173         } else {
 174             cm_GetServer(serverp);
 175         }
 176         lock_ObtainWrite(&cm_callbackLock);
 177         cbrp->serverp = serverp;
 178         lock_ReleaseWrite(&cm_callbackLock);
 179     }
 180
 181     /* If not allowed to retry, don't */
 182     if (reqp->flags & CM_REQ_NORETRY)
 183         goto out;
 184
 185     /* if timeout - check that it did not exceed the SMB timeout
 186      * and retry */
 187
 188     /* timeleft - get if from reqp the same way as cmXonnByMServers does */
 189 #ifndef DJGPP
 190     timeUsed = (GetCurrentTime() - reqp->startTime) / 1000;
 191 #else
 192     gettimeofday(&now, NULL);
 193     timeUsed = sub_time(now, reqp->startTime) / 1000;
 194 #endif
 195
 196     /* leave 5 seconds margin for sleep */
 197     timeLeft = RDRtimeout - timeUsed;
 198
 199     if (errorCode == CM_ERROR_TIMEDOUT) {
 200         if (timeLeft > 5 ) {
 201             thrd_Sleep(3000);
 202             cm_CheckServers(CM_FLAG_CHECKDOWNSERVERS, NULL);
 203             retry = 1;
 204         }
 205     }
 206
 207     /* if there is nosuchvolume, then we have a situation in which a
 208      * previously known volume no longer has a set of servers
 209      * associated with it.  Either the volume has moved or
 210      * the volume has been deleted.  Try to find a new server list
 211      * until the timeout period expires.
 212      */
 213     else if (errorCode == CM_ERROR_NOSUCHVOLUME) {
 214         if (timeLeft > 7) {
 215             osi_Log0(afsd_logp, "cm_Analyze passed CM_ERROR_NOSUCHVOLUME.");
 216             thrd_Sleep(5000);
 217
 218             retry = 1;
 219
 220             if (fidp != NULL)   /* Not a VLDB call */
 221                 cm_ForceUpdateVolume(fidp, userp, reqp);
 222         }
 223     }
 224
 225     else if (errorCode == CM_ERROR_ALLOFFLINE) {
 226         if (timeLeft > 7) {
 227             osi_Log0(afsd_logp, "cm_Analyze passed CM_ERROR_ALLOFFLINE.");
 228             thrd_Sleep(5000);
 229             /* cm_ForceUpdateVolume marks all servers as non_busy */
 230             /* No it doesn't and it won't do anything if all of the
 231              * the servers are marked as DOWN.  So clear the DOWN
 232              * flag and reset the busy state as well.
 233              */
 234             if (!serversp) {
 235                 cm_GetServerList(fidp, userp, reqp, &serverspp);
 236                 serversp = *serverspp;
 237                 free_svr_list = 1;
 238             }
 239             if (serversp) {
 240                 lock_ObtainWrite(&cm_serverLock);
 241                 for (tsrp = serversp; tsrp; tsrp=tsrp->next) {
 242                     tsrp->server->flags &= ~CM_SERVERFLAG_DOWN;
 243                     if (tsrp->status == busy)
 244                         tsrp->status = not_busy;
 245                 }
 246                 lock_ReleaseWrite(&cm_serverLock);
 247                 if (free_svr_list) {
 248                     cm_FreeServerList(&serversp);
 249                     *serverspp = serversp;
 250                 }
 251                 retry = 1;
 252             }
 253
 254             if (fidp != NULL)   /* Not a VLDB call */
 255                 cm_ForceUpdateVolume(fidp, userp, reqp);
 256         }
 257     }
 258
 259     /* if all servers are busy, mark them non-busy and start over */
 260     else if (errorCode == CM_ERROR_ALLBUSY) {
 261         if (timeLeft > 7) {
 262             thrd_Sleep(5000);
 263             if (!serversp) {
 264                 cm_GetServerList(fidp, userp, reqp, &serverspp);
 265                 serversp = *serverspp;
 266                 free_svr_list = 1;
 267             }
 268             lock_ObtainWrite(&cm_serverLock);
 269             for (tsrp = serversp; tsrp; tsrp=tsrp->next) {
 270                 if (tsrp->status == busy)
 271                     tsrp->status = not_busy;
 272             }
 273             lock_ReleaseWrite(&cm_serverLock);
 274             if (free_svr_list) {
 275                 cm_FreeServerList(&serversp);
 276                 *serverspp = serversp;
 277             }
 278             retry = 1;
 279         }
 280     }
 281
 282     /* special codes:  VBUSY and VRESTARTING */
 283     else if (errorCode == VBUSY || errorCode == VRESTARTING) {
 284         if (!serversp) {
 285             cm_GetServerList(fidp, userp, reqp, &serverspp);
 286             serversp = *serverspp;
 287             free_svr_list = 1;
 288         }
 289         lock_ObtainWrite(&cm_serverLock);
 290         for (tsrp = serversp; tsrp; tsrp=tsrp->next) {
 291             if (tsrp->server == serverp
 292                  && tsrp->status == not_busy) {
 293                 tsrp->status = busy;
 294                 break;
 295             }
 296         }
 297         lock_ReleaseWrite(&cm_serverLock);
 298         if (free_svr_list) {
 299             cm_FreeServerList(&serversp);
 300             *serverspp = serversp;
 301         }
 302         retry = 1;
 303     }
 304
 305     /* special codes:  missing volumes */
 306     else if (errorCode == VNOVOL || errorCode == VMOVED || errorCode == VOFFLINE
 307          || errorCode == VSALVAGE || errorCode == VNOSERVICE)
 308     {
 309         /* Log server being offline for this volume */
 310         osi_Log4(afsd_logp, "cm_Analyze found server %d.%d.%d.%d marked offline for a volume",
 311                   ((serverp->addr.sin_addr.s_addr & 0xff)),
 312                   ((serverp->addr.sin_addr.s_addr & 0xff00)>> 8),
 313                   ((serverp->addr.sin_addr.s_addr & 0xff0000)>> 16),
 314                   ((serverp->addr.sin_addr.s_addr & 0xff000000)>> 24));
 315         /* Create Event Log message */
 316         {
 317             HANDLE h;
 318             char *ptbuf[1];
 319             char s[100];
 320             h = RegisterEventSource(NULL, AFS_DAEMON_EVENT_NAME);
 321             sprintf(s, "cm_Analyze: Server %d.%d.%d.%d reported volume %d as missing.",
 322                      ((serverp->addr.sin_addr.s_addr & 0xff)),
 323                      ((serverp->addr.sin_addr.s_addr & 0xff00)>> 8),
 324                      ((serverp->addr.sin_addr.s_addr & 0xff0000)>> 16),
 325                      ((serverp->addr.sin_addr.s_addr & 0xff000000)>> 24),
 326                      fidp->volume);
 327             ptbuf[0] = s;
 328             ReportEvent(h, EVENTLOG_WARNING_TYPE, 0, 1009, NULL,
 329                          1, 0, ptbuf, NULL);
 330             DeregisterEventSource(h);
 331         }
 332
 333         /* Mark server offline for this volume */
 334         if (!serversp) {
 335             cm_GetServerList(fidp, userp, reqp, &serverspp);
 336             serversp = *serverspp;
 337             free_svr_list = 1;
 338         }
 339         for (tsrp = serversp; tsrp; tsrp=tsrp->next) {
 340             if (tsrp->server == serverp)
 341                 tsrp->status = offline;
 342         }
 343         if (free_svr_list) {
 344             cm_FreeServerList(&serversp);
 345             *serverspp = serversp;
 346         }
 347         if ( timeLeft > 2 )
 348             retry = 1;
 349     }
 350
 351     /* RX codes */
 352     else if (errorCode == RX_CALL_TIMEOUT) {
 353         /* server took longer than hardDeadTime
 354          * don't mark server as down but don't retry
 355          * this is to prevent the SMB session from timing out
 356          * In addition, we log an event to the event log
 357          */
 358 #ifndef DJGPP
 359         HANDLE h;
 360         char *ptbuf[1];
 361         char s[100];
 362         h = RegisterEventSource(NULL, AFS_DAEMON_EVENT_NAME);
 363         sprintf(s, "cm_Analyze: HardDeadTime exceeded.");
 364         ptbuf[0] = s;
 365         ReportEvent(h, EVENTLOG_WARNING_TYPE, 0, 1009, NULL,
 366                      1, 0, ptbuf, NULL);
 367         DeregisterEventSource(h);
 368 #endif /* !DJGPP */
 369
 370         retry = 0;
 371         osi_Log0(afsd_logp, "cm_Analyze: hardDeadTime exceeded");
 372     }
 373     else if (errorCode >= -64 && errorCode < 0) {
 374         /* mark server as down */
 375         lock_ObtainMutex(&serverp->mx);
 376         serverp->flags |= CM_SERVERFLAG_DOWN;
 377         lock_ReleaseMutex(&serverp->mx);
 378         if ( timeLeft > 2 )
 379             retry = 1;
 380     }
 381     else if (errorCode == RXKADEXPIRED ||
 382              errorCode == RXKADBADTICKET) {
 383         if (!dead_session) {
 384             lock_ObtainMutex(&userp->mx);
 385             ucellp = cm_GetUCell(userp, serverp->cellp);
 386             if (ucellp->ticketp) {
 387                 free(ucellp->ticketp);
 388                 ucellp->ticketp = NULL;
 389             }
 390             ucellp->flags &= ~CM_UCELLFLAG_RXKAD;
 391             ucellp->gen++;
 392             lock_ReleaseMutex(&userp->mx);
 393             if ( timeLeft > 2 )
 394                 retry = 1;
 395         }
 396     } else {
 397         if (errorCode) {
 398             char * s = "unknown error";
 399             switch ( errorCode ) {
 400             case RXKADINCONSISTENCY: s = "RXKADINCONSISTENCY"; break;
 401             case RXKADPACKETSHORT  : s = "RXKADPACKETSHORT  "; break;
 402             case RXKADLEVELFAIL    : s = "RXKADLEVELFAIL    "; break;
 403             case RXKADTICKETLEN    : s = "RXKADTICKETLEN    "; break;
 404             case RXKADOUTOFSEQUENCE: s = "RXKADOUTOFSEQUENCE"; break;
 405             case RXKADNOAUTH       : s = "RXKADNOAUTH       "; break;
 406             case RXKADBADKEY       : s = "RXKADBADKEY       "; break;
 407             case RXKADBADTICKET    : s = "RXKADBADTICKET    "; break;
 408             case RXKADUNKNOWNKEY   : s = "RXKADUNKNOWNKEY   "; break;
 409             case RXKADEXPIRED      : s = "RXKADEXPIRED      "; break;
 410             case RXKADSEALEDINCON  : s = "RXKADSEALEDINCON  "; break;
 411             case RXKADDATALEN      : s = "RXKADDATALEN      "; break;
 412             case RXKADILLEGALLEVEL : s = "RXKADILLEGALLEVEL "; break;
 413             }
 414             osi_Log2(afsd_logp, "cm_Analyze: ignoring error code 0x%x (%s)",
 415                      errorCode, s);
 416         }
 417     }
 418
 419     if (retry && dead_session)
 420         retry = 0;
 421
 422   out:
 423     /* drop this on the way out */
 424     if (connp)
 425         cm_PutConn(connp);
 426
 427     /* retry until we fail to find a connection */
 428     return retry;
 429 }
 430
 431 long cm_ConnByMServers(cm_serverRef_t *serversp, cm_user_t *usersp,
 432         cm_req_t *reqp, cm_conn_t **connpp)
 433 {
 434     long code;
 435     cm_serverRef_t *tsrp;
 436     cm_server_t *tsp;
 437     long firstError = 0;
 438     int someBusy = 0, someOffline = 0, allBusy = 1, allDown = 1;
 439     long timeUsed, timeLeft, hardTimeLeft;
 440 #ifdef DJGPP
 441     struct timeval now;
 442 #endif /* DJGPP */
 443
 444     *connpp = NULL;
 445
 446 #ifndef DJGPP
 447     timeUsed = (GetCurrentTime() - reqp->startTime) / 1000;
 448 #else
 449     gettimeofday(&now, NULL);
 450     timeUsed = sub_time(now, reqp->startTime) / 1000;
 451 #endif
 452
 453     /* leave 5 seconds margin of safety */
 454     timeLeft =  ConnDeadtimeout - timeUsed - 5;
 455     hardTimeLeft = HardDeadtimeout - timeUsed - 5;
 456
 457     lock_ObtainWrite(&cm_serverLock);
 458     for (tsrp = serversp; tsrp; tsrp=tsrp->next) {
 459         tsp = tsrp->server;
 460         cm_GetServerNoLock(tsp);
 461         lock_ReleaseWrite(&cm_serverLock);
 462         if (!(tsp->flags & CM_SERVERFLAG_DOWN)) {
 463             if (tsrp->status == busy) {
 464                 allDown = 0;
 465                 someBusy = 1;
 466             } else if (tsrp->status == offline) {
 467                 someOffline = 1;
 468             } else {
 469                 allDown = 0;
 470                 allBusy = 0;
 471                 code = cm_ConnByServer(tsp, usersp, connpp);
 472                 if (code == 0) {        /* cm_CBS only returns 0 */
 473                     cm_PutServer(tsp);
 474                     /* Set RPC timeout */
 475                     if (timeLeft > ConnDeadtimeout)
 476                         timeLeft = ConnDeadtimeout;
 477
 478                     if (hardTimeLeft > HardDeadtimeout)
 479                         hardTimeLeft = HardDeadtimeout;
 480
 481                     lock_ObtainMutex(&(*connpp)->mx);
 482                     rx_SetConnDeadTime((*connpp)->callp, timeLeft);
 483                     rx_SetConnHardDeadTime((*connpp)->callp, (u_short) hardTimeLeft);
 484                     lock_ReleaseMutex(&(*connpp)->mx);
 485                     return 0;
 486                 }
 487
 488                 /* therefore, this code is never executed */
 489                 if (firstError == 0)
 490                     firstError = code;
 491             }
 492         }
 493         lock_ObtainWrite(&cm_serverLock);
 494         cm_PutServerNoLock(tsp);
 495     }
 496
 497     lock_ReleaseWrite(&cm_serverLock);
 498     if (firstError == 0) {
 499         if (serversp == NULL)
 500             firstError = CM_ERROR_NOSUCHVOLUME;
 501         else if (allDown)
 502             firstError = CM_ERROR_ALLOFFLINE;
 503         else if (allBusy)
 504             firstError = CM_ERROR_ALLBUSY;
 505         else {
 506             osi_Log0(afsd_logp, "cm_ConnByMServers returning impossible error TIMEDOUT");
 507             firstError = CM_ERROR_TIMEDOUT;
 508         }
 509     }
 510
 511     osi_Log1(afsd_logp, "cm_ConnByMServers returning 0x%x", firstError);
 512     return firstError;
 513 }
 514
 515 /* called with a held server to GC all bad connections hanging off of the server */
 516 void cm_GCConnections(cm_server_t *serverp)
 517 {
 518     cm_conn_t *tcp;
 519     cm_conn_t **lcpp;
 520     cm_user_t *userp;
 521
 522     lock_ObtainWrite(&cm_connLock);
 523     lcpp = &serverp->connsp;
 524     for (tcp = *lcpp; tcp; tcp = *lcpp) {
 525         userp = tcp->userp;
 526         if (userp && tcp->refCount == 0 && (userp->vcRefs == 0)) {
 527             /* do the deletion of this guy */
 528             cm_PutServer(tcp->serverp);
 529             cm_ReleaseUser(userp);
 530             *lcpp = tcp->nextp;
 531             rx_DestroyConnection(tcp->callp);
 532             lock_FinalizeMutex(&tcp->mx);
 533             free(tcp);
 534         }
 535         else {
 536             /* just advance to the next */
 537             lcpp = &tcp->nextp;
 538         }
 539     }
 540     lock_ReleaseWrite(&cm_connLock);
 541 }
 542
 543 static void cm_NewRXConnection(cm_conn_t *tcp, cm_ucell_t *ucellp,
 544                                cm_server_t *serverp)
 545 {
 546     unsigned short port;
 547     int serviceID;
 548     int secIndex;
 549     struct rx_securityClass *secObjp;
 550
 551     if (serverp->type == CM_SERVER_VLDB) {
 552         port = htons(7003);
 553         serviceID = 52;
 554     }
 555     else {
 556         osi_assert(serverp->type == CM_SERVER_FILE);
 557         port = htons(7000);
 558         serviceID = 1;
 559     }
 560     if (ucellp->flags & CM_UCELLFLAG_RXKAD) {
 561         secIndex = 2;
 562         if (cryptall) {
 563             tcp->cryptlevel = rxkad_crypt;
 564         } else {
 565             tcp->cryptlevel = rxkad_clear;
 566         }
 567         secObjp = rxkad_NewClientSecurityObject(tcp->cryptlevel,
 568                                                 &ucellp->sessionKey, ucellp->kvno,
 569                                                 ucellp->ticketLen, ucellp->ticketp);
 570     } else {
 571         /* normal auth */
 572         secIndex = 0;
 573         tcp->cryptlevel = rxkad_clear;
 574         secObjp = rxnull_NewClientSecurityObject();
 575     }
 576     osi_assert(secObjp != NULL);
 577     tcp->callp = rx_NewConnection(serverp->addr.sin_addr.s_addr,
 578                                   port,
 579                                   serviceID,
 580                                   secObjp,
 581                                   secIndex);
 582     rx_SetConnDeadTime(tcp->callp, ConnDeadtimeout);
 583     rx_SetConnHardDeadTime(tcp->callp, HardDeadtimeout);
 584     tcp->ucgen = ucellp->gen;
 585     if (secObjp)
 586         rxs_Release(secObjp);   /* Decrement the initial refCount */
 587 }
 588
 589 long cm_ConnByServer(cm_server_t *serverp, cm_user_t *userp, cm_conn_t **connpp)
 590 {
 591     cm_conn_t *tcp;
 592     cm_ucell_t *ucellp;
 593
 594     lock_ObtainMutex(&userp->mx);
 595     lock_ObtainWrite(&cm_connLock);
 596     for (tcp = serverp->connsp; tcp; tcp=tcp->nextp) {
 597         if (tcp->userp == userp)
 598             break;
 599     }
 600
 601     /* find ucell structure */
 602     ucellp = cm_GetUCell(userp, serverp->cellp);
 603     if (!tcp) {
 604         cm_GetServer(serverp);
 605         tcp = malloc(sizeof(*tcp));
 606         memset(tcp, 0, sizeof(*tcp));
 607         tcp->nextp = serverp->connsp;
 608         serverp->connsp = tcp;
 609         cm_HoldUser(userp);
 610         tcp->userp = userp;
 611         lock_InitializeMutex(&tcp->mx, "cm_conn_t mutex");
 612         lock_ObtainMutex(&tcp->mx);
 613         tcp->serverp = serverp;
 614         tcp->cryptlevel = rxkad_clear;
 615         cm_NewRXConnection(tcp, ucellp, serverp);
 616         tcp->refCount = 1;
 617         lock_ReleaseMutex(&tcp->mx);
 618     } else {
 619         if ((tcp->ucgen < ucellp->gen) ||
 620             (tcp->cryptlevel != (cryptall ? (ucellp->flags & CM_UCELLFLAG_RXKAD ? rxkad_crypt : rxkad_clear) : rxkad_clear)))
 621         {
 622             if (tcp->ucgen < ucellp->gen)
 623                 osi_Log0(afsd_logp, "cm_ConnByServer replace connection due to token update");
 624             else
 625                 osi_Log0(afsd_logp, "cm_ConnByServer replace connection due to crypt change");
 626             lock_ObtainMutex(&tcp->mx);
 627             rx_DestroyConnection(tcp->callp);
 628             cm_NewRXConnection(tcp, ucellp, serverp);
 629             lock_ReleaseMutex(&tcp->mx);
 630         }
 631         tcp->refCount++;
 632     }
 633     lock_ReleaseWrite(&cm_connLock);
 634     lock_ReleaseMutex(&userp->mx);
 635
 636     /* return this pointer to our caller */
 637     osi_Log1(afsd_logp, "cm_ConnByServer returning conn 0x%x", (long) tcp);
 638     *connpp = tcp;
 639
 640     return 0;
 641 }
 642
 643 long cm_Conn(struct cm_fid *fidp, struct cm_user *userp, cm_req_t *reqp,
 644              cm_conn_t **connpp)
 645 {
 646     long code;
 647
 648     cm_serverRef_t **serverspp;
 649
 650     code = cm_GetServerList(fidp, userp, reqp, &serverspp);
 651     if (code) {
 652         *connpp = NULL;
 653         return code;
 654     }
 655
 656     code = cm_ConnByMServers(*serverspp, userp, reqp, connpp);
 657     cm_FreeServerList(serverspp);
 658     return code;
 659 }
 660
 661 extern struct rx_connection *
 662 cm_GetRxConn(cm_conn_t *connp)
 663 {
 664     struct rx_connection * rxconn;
 665     lock_ObtainMutex(&connp->mx);
 666     rxconn = connp->callp;
 667     rx_GetConnection(rxconn);
 668     lock_ReleaseMutex(&connp->mx);
 669     return rxconn;
 670 }
 671