e0feafe4361e36e297d7b3da3bd457c65631b9cf
[openafs.git] / src / rx / rx.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 /* RX:  Extended Remote Procedure Call */
11
12 #include <afsconfig.h>
13 #ifdef  KERNEL
14 #include "afs/param.h"
15 #else
16 #include <afs/param.h>
17 #endif
18
19 RCSID
20     ("$Header$");
21
22 #ifdef KERNEL
23 #include "afs/sysincludes.h"
24 #include "afsincludes.h"
25 #ifndef UKERNEL
26 #include "h/types.h"
27 #include "h/time.h"
28 #include "h/stat.h"
29 #ifdef  AFS_OSF_ENV
30 #include <net/net_globals.h>
31 #endif /* AFS_OSF_ENV */
32 #ifdef AFS_LINUX20_ENV
33 #include "h/socket.h"
34 #endif
35 #include "netinet/in.h"
36 #include "afs/afs_args.h"
37 #include "afs/afs_osi.h"
38 #ifdef RX_KERNEL_TRACE
39 #include "rx_kcommon.h"
40 #endif
41 #if     (defined(AFS_AUX_ENV) || defined(AFS_AIX_ENV))
42 #include "h/systm.h"
43 #endif
44 #ifdef RXDEBUG
45 #undef RXDEBUG                  /* turn off debugging */
46 #endif /* RXDEBUG */
47 #if defined(AFS_SGI_ENV)
48 #include "sys/debug.h"
49 #endif
50 #include "afsint.h"
51 #ifdef  AFS_OSF_ENV
52 #undef kmem_alloc
53 #undef kmem_free
54 #undef mem_alloc
55 #undef mem_free
56 #undef register
57 #endif /* AFS_OSF_ENV */
58 #else /* !UKERNEL */
59 #include "afs/sysincludes.h"
60 #include "afsincludes.h"
61 #endif /* !UKERNEL */
62 #include "afs/lock.h"
63 #include "rx_kmutex.h"
64 #include "rx_kernel.h"
65 #include "rx_clock.h"
66 #include "rx_queue.h"
67 #include "rx.h"
68 #include "rx_globals.h"
69 #include "rx_trace.h"
70 #define AFSOP_STOP_RXCALLBACK   210     /* Stop CALLBACK process */
71 #define AFSOP_STOP_AFS          211     /* Stop AFS process */
72 #define AFSOP_STOP_BKG          212     /* Stop BKG process */
73 #include "afsint.h"
74 extern afs_int32 afs_termState;
75 #ifdef AFS_AIX41_ENV
76 #include "sys/lockl.h"
77 #include "sys/lock_def.h"
78 #endif /* AFS_AIX41_ENV */
79 # include "rxgen_consts.h"
80 #else /* KERNEL */
81 # include <sys/types.h>
82 # include <string.h>
83 # include <errno.h>
84 #ifdef AFS_NT40_ENV
85 # include <stdlib.h>
86 # include <fcntl.h>
87 # include <afs/afsutil.h>
88 # include <WINNT\afsreg.h>
89 #else
90 # include <sys/socket.h>
91 # include <sys/file.h>
92 # include <netdb.h>
93 # include <sys/stat.h>
94 # include <netinet/in.h>
95 # include <sys/time.h>
96 #endif
97 # include "rx.h"
98 # include "rx_user.h"
99 # include "rx_clock.h"
100 # include "rx_queue.h"
101 # include "rx_globals.h"
102 # include "rx_trace.h"
103 # include <afs/rxgen_consts.h>
104 #endif /* KERNEL */
105
106 int (*registerProgram) () = 0;
107 int (*swapNameProgram) () = 0;
108
109 /* Local static routines */
110 static void rxi_DestroyConnectionNoLock(register struct rx_connection *conn);
111 #ifdef RX_ENABLE_LOCKS
112 static void rxi_SetAcksInTransmitQueue(register struct rx_call *call);
113 #endif
114
115 #ifdef  AFS_GLOBAL_RXLOCK_KERNEL
116 struct rx_tq_debug {
117     afs_int32 rxi_start_aborted;        /* rxi_start awoke after rxi_Send in error. */
118     afs_int32 rxi_start_in_error;
119 } rx_tq_debug;
120 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
121
122 /*
123  * rxi_rpc_peer_stat_cnt counts the total number of peer stat structures
124  * currently allocated within rx.  This number is used to allocate the
125  * memory required to return the statistics when queried.
126  */
127
128 static unsigned int rxi_rpc_peer_stat_cnt;
129
130 /*
131  * rxi_rpc_process_stat_cnt counts the total number of local process stat
132  * structures currently allocated within rx.  The number is used to allocate
133  * the memory required to return the statistics when queried.
134  */
135
136 static unsigned int rxi_rpc_process_stat_cnt;
137
138 #if !defined(offsetof)
139 #include <stddef.h>             /* for definition of offsetof() */
140 #endif
141
142 #ifdef AFS_PTHREAD_ENV
143 #include <assert.h>
144
145 /*
146  * Use procedural initialization of mutexes/condition variables
147  * to ease NT porting
148  */
149
150 extern pthread_mutex_t rx_stats_mutex;
151 extern pthread_mutex_t des_init_mutex;
152 extern pthread_mutex_t des_random_mutex;
153 extern pthread_mutex_t rx_clock_mutex;
154 extern pthread_mutex_t rxi_connCacheMutex;
155 extern pthread_mutex_t rx_event_mutex;
156 extern pthread_mutex_t osi_malloc_mutex;
157 extern pthread_mutex_t event_handler_mutex;
158 extern pthread_mutex_t listener_mutex;
159 extern pthread_mutex_t rx_if_init_mutex;
160 extern pthread_mutex_t rx_if_mutex;
161 extern pthread_mutex_t rxkad_client_uid_mutex;
162 extern pthread_mutex_t rxkad_random_mutex;
163
164 extern pthread_cond_t rx_event_handler_cond;
165 extern pthread_cond_t rx_listener_cond;
166
167 static pthread_mutex_t epoch_mutex;
168 static pthread_mutex_t rx_init_mutex;
169 static pthread_mutex_t rx_debug_mutex;
170
171 static void
172 rxi_InitPthread(void)
173 {
174     assert(pthread_mutex_init(&rx_clock_mutex, (const pthread_mutexattr_t *)0)
175            == 0);
176     assert(pthread_mutex_init(&rx_stats_mutex, (const pthread_mutexattr_t *)0)
177            == 0);
178     assert(pthread_mutex_init
179            (&rxi_connCacheMutex, (const pthread_mutexattr_t *)0) == 0);
180     assert(pthread_mutex_init(&rx_init_mutex, (const pthread_mutexattr_t *)0)
181            == 0);
182     assert(pthread_mutex_init(&epoch_mutex, (const pthread_mutexattr_t *)0) ==
183            0);
184     assert(pthread_mutex_init(&rx_event_mutex, (const pthread_mutexattr_t *)0)
185            == 0);
186     assert(pthread_mutex_init(&des_init_mutex, (const pthread_mutexattr_t *)0)
187            == 0);
188     assert(pthread_mutex_init
189            (&des_random_mutex, (const pthread_mutexattr_t *)0) == 0);
190     assert(pthread_mutex_init
191            (&osi_malloc_mutex, (const pthread_mutexattr_t *)0) == 0);
192     assert(pthread_mutex_init
193            (&event_handler_mutex, (const pthread_mutexattr_t *)0) == 0);
194     assert(pthread_mutex_init(&listener_mutex, (const pthread_mutexattr_t *)0)
195            == 0);
196     assert(pthread_mutex_init
197            (&rx_if_init_mutex, (const pthread_mutexattr_t *)0) == 0);
198     assert(pthread_mutex_init(&rx_if_mutex, (const pthread_mutexattr_t *)0) ==
199            0);
200     assert(pthread_mutex_init
201            (&rxkad_client_uid_mutex, (const pthread_mutexattr_t *)0) == 0);
202     assert(pthread_mutex_init
203            (&rxkad_random_mutex, (const pthread_mutexattr_t *)0) == 0);
204     assert(pthread_mutex_init(&rx_debug_mutex, (const pthread_mutexattr_t *)0)
205            == 0);
206
207     assert(pthread_cond_init
208            (&rx_event_handler_cond, (const pthread_condattr_t *)0) == 0);
209     assert(pthread_cond_init(&rx_listener_cond, (const pthread_condattr_t *)0)
210            == 0);
211     assert(pthread_key_create(&rx_thread_id_key, NULL) == 0);
212     assert(pthread_key_create(&rx_ts_info_key, NULL) == 0);
213  
214     rxkad_global_stats_init();
215 }
216
217 pthread_once_t rx_once_init = PTHREAD_ONCE_INIT;
218 #define INIT_PTHREAD_LOCKS \
219 assert(pthread_once(&rx_once_init, rxi_InitPthread)==0)
220 /*
221  * The rx_stats_mutex mutex protects the following global variables:
222  * rxi_dataQuota
223  * rxi_minDeficit
224  * rxi_availProcs
225  * rxi_totalMin
226  * rxi_lowConnRefCount
227  * rxi_lowPeerRefCount
228  * rxi_nCalls
229  * rxi_Alloccnt
230  * rxi_Allocsize
231  * rx_nFreePackets
232  * rx_tq_debug
233  * rx_stats
234  */
235 #else
236 #define INIT_PTHREAD_LOCKS
237 #endif
238
239
240 /* Variables for handling the minProcs implementation.  availProcs gives the
241  * number of threads available in the pool at this moment (not counting dudes
242  * executing right now).  totalMin gives the total number of procs required
243  * for handling all minProcs requests.  minDeficit is a dynamic variable
244  * tracking the # of procs required to satisfy all of the remaining minProcs
245  * demands.
246  * For fine grain locking to work, the quota check and the reservation of
247  * a server thread has to come while rxi_availProcs and rxi_minDeficit
248  * are locked. To this end, the code has been modified under #ifdef
249  * RX_ENABLE_LOCKS so that quota checks and reservation occur at the
250  * same time. A new function, ReturnToServerPool() returns the allocation.
251  * 
252  * A call can be on several queue's (but only one at a time). When
253  * rxi_ResetCall wants to remove the call from a queue, it has to ensure
254  * that no one else is touching the queue. To this end, we store the address
255  * of the queue lock in the call structure (under the call lock) when we
256  * put the call on a queue, and we clear the call_queue_lock when the
257  * call is removed from a queue (once the call lock has been obtained).
258  * This allows rxi_ResetCall to safely synchronize with others wishing
259  * to manipulate the queue.
260  */
261
262 #ifdef RX_ENABLE_LOCKS
263 static afs_kmutex_t rx_rpc_stats;
264 void rxi_StartUnlocked();
265 #endif
266
267 /* We keep a "last conn pointer" in rxi_FindConnection. The odds are 
268 ** pretty good that the next packet coming in is from the same connection 
269 ** as the last packet, since we're send multiple packets in a transmit window.
270 */
271 struct rx_connection *rxLastConn = 0;
272
273 #ifdef RX_ENABLE_LOCKS
274 /* The locking hierarchy for rx fine grain locking is composed of these
275  * tiers:
276  *
277  * rx_connHashTable_lock - synchronizes conn creation, rx_connHashTable access
278  * conn_call_lock - used to synchonize rx_EndCall and rx_NewCall
279  * call->lock - locks call data fields.
280  * These are independent of each other:
281  *      rx_freeCallQueue_lock
282  *      rxi_keyCreate_lock
283  * rx_serverPool_lock
284  * freeSQEList_lock
285  *
286  * serverQueueEntry->lock
287  * rx_rpc_stats
288  * rx_peerHashTable_lock - locked under rx_connHashTable_lock
289  * peer->lock - locks peer data fields.
290  * conn_data_lock - that more than one thread is not updating a conn data
291  *                  field at the same time.
292  * rx_freePktQ_lock
293  *
294  * lowest level:
295  *      multi_handle->lock
296  *      rxevent_lock
297  *      rx_stats_mutex
298  *
299  * Do we need a lock to protect the peer field in the conn structure?
300  *      conn->peer was previously a constant for all intents and so has no
301  *      lock protecting this field. The multihomed client delta introduced
302  *      a RX code change : change the peer field in the connection structure
303  *      to that remote inetrface from which the last packet for this
304  *      connection was sent out. This may become an issue if further changes
305  *      are made.
306  */
307 #define SET_CALL_QUEUE_LOCK(C, L) (C)->call_queue_lock = (L)
308 #define CLEAR_CALL_QUEUE_LOCK(C) (C)->call_queue_lock = NULL
309 #ifdef RX_LOCKS_DB
310 /* rxdb_fileID is used to identify the lock location, along with line#. */
311 static int rxdb_fileID = RXDB_FILE_RX;
312 #endif /* RX_LOCKS_DB */
313 #else /* RX_ENABLE_LOCKS */
314 #define SET_CALL_QUEUE_LOCK(C, L)
315 #define CLEAR_CALL_QUEUE_LOCK(C)
316 #endif /* RX_ENABLE_LOCKS */
317 struct rx_serverQueueEntry *rx_waitForPacket = 0;
318 struct rx_serverQueueEntry *rx_waitingForPacket = 0;
319
320 /* ------------Exported Interfaces------------- */
321
322 /* This function allows rxkad to set the epoch to a suitably random number
323  * which rx_NewConnection will use in the future.  The principle purpose is to
324  * get rxnull connections to use the same epoch as the rxkad connections do, at
325  * least once the first rxkad connection is established.  This is important now
326  * that the host/port addresses aren't used in FindConnection: the uniqueness
327  * of epoch/cid matters and the start time won't do. */
328
329 #ifdef AFS_PTHREAD_ENV
330 /*
331  * This mutex protects the following global variables:
332  * rx_epoch
333  */
334
335 #define LOCK_EPOCH assert(pthread_mutex_lock(&epoch_mutex)==0)
336 #define UNLOCK_EPOCH assert(pthread_mutex_unlock(&epoch_mutex)==0)
337 #else
338 #define LOCK_EPOCH
339 #define UNLOCK_EPOCH
340 #endif /* AFS_PTHREAD_ENV */
341
342 void
343 rx_SetEpoch(afs_uint32 epoch)
344 {
345     LOCK_EPOCH;
346     rx_epoch = epoch;
347     UNLOCK_EPOCH;
348 }
349
350 /* Initialize rx.  A port number may be mentioned, in which case this
351  * becomes the default port number for any service installed later.
352  * If 0 is provided for the port number, a random port will be chosen
353  * by the kernel.  Whether this will ever overlap anything in
354  * /etc/services is anybody's guess...  Returns 0 on success, -1 on
355  * error. */
356 static int rxinit_status = 1;
357 #ifdef AFS_PTHREAD_ENV
358 /*
359  * This mutex protects the following global variables:
360  * rxinit_status
361  */
362
363 #define LOCK_RX_INIT assert(pthread_mutex_lock(&rx_init_mutex)==0)
364 #define UNLOCK_RX_INIT assert(pthread_mutex_unlock(&rx_init_mutex)==0)
365 #else
366 #define LOCK_RX_INIT
367 #define UNLOCK_RX_INIT
368 #endif
369
370 int
371 rx_InitHost(u_int host, u_int port)
372 {
373 #ifdef KERNEL
374     osi_timeval_t tv;
375 #else /* KERNEL */
376     struct timeval tv;
377 #endif /* KERNEL */
378     char *htable, *ptable;
379     int tmp_status;
380     
381     SPLVAR;
382     
383     INIT_PTHREAD_LOCKS;
384     LOCK_RX_INIT;
385     if (rxinit_status == 0) {
386         tmp_status = rxinit_status;
387         UNLOCK_RX_INIT;
388         return tmp_status;      /* Already started; return previous error code. */
389     }
390 #ifdef RXDEBUG
391     rxi_DebugInit();
392 #endif
393 #ifdef AFS_NT40_ENV
394     if (afs_winsockInit() < 0)
395         return -1;
396 #endif
397     
398 #ifndef KERNEL
399     /*
400      * Initialize anything necessary to provide a non-premptive threading
401      * environment.
402      */
403     rxi_InitializeThreadSupport();
404 #endif
405     
406     /* Allocate and initialize a socket for client and perhaps server
407      * connections. */
408     
409     rx_socket = rxi_GetHostUDPSocket(host, (u_short) port);
410     if (rx_socket == OSI_NULLSOCKET) {
411         UNLOCK_RX_INIT;
412         return RX_ADDRINUSE;
413     }
414 #ifdef  RX_ENABLE_LOCKS
415 #ifdef RX_LOCKS_DB
416     rxdb_init();
417 #endif /* RX_LOCKS_DB */
418     MUTEX_INIT(&rx_stats_mutex, "rx_stats_mutex", MUTEX_DEFAULT, 0);
419     MUTEX_INIT(&rx_rpc_stats, "rx_rpc_stats", MUTEX_DEFAULT, 0);
420     MUTEX_INIT(&rx_freePktQ_lock, "rx_freePktQ_lock", MUTEX_DEFAULT, 0);
421     MUTEX_INIT(&freeSQEList_lock, "freeSQEList lock", MUTEX_DEFAULT, 0);
422     MUTEX_INIT(&rx_freeCallQueue_lock, "rx_freeCallQueue_lock", MUTEX_DEFAULT,
423                0);
424     CV_INIT(&rx_waitingForPackets_cv, "rx_waitingForPackets_cv", CV_DEFAULT,
425             0);
426     MUTEX_INIT(&rx_peerHashTable_lock, "rx_peerHashTable_lock", MUTEX_DEFAULT,
427                0);
428     MUTEX_INIT(&rx_connHashTable_lock, "rx_connHashTable_lock", MUTEX_DEFAULT,
429                0);
430     MUTEX_INIT(&rx_serverPool_lock, "rx_serverPool_lock", MUTEX_DEFAULT, 0);
431 #ifndef KERNEL
432     MUTEX_INIT(&rxi_keyCreate_lock, "rxi_keyCreate_lock", MUTEX_DEFAULT, 0);
433 #endif /* !KERNEL */
434 #if defined(KERNEL) && defined(AFS_HPUX110_ENV)
435     if (!uniprocessor)
436         rx_sleepLock = alloc_spinlock(LAST_HELD_ORDER - 10, "rx_sleepLock");
437 #endif /* KERNEL && AFS_HPUX110_ENV */
438 #endif /* RX_ENABLE_LOCKS */
439
440     rxi_nCalls = 0;
441     rx_connDeadTime = 12;
442     rx_tranquil = 0;            /* reset flag */
443     memset((char *)&rx_stats, 0, sizeof(struct rx_stats));
444     htable = (char *)
445         osi_Alloc(rx_hashTableSize * sizeof(struct rx_connection *));
446     PIN(htable, rx_hashTableSize * sizeof(struct rx_connection *));     /* XXXXX */
447     memset(htable, 0, rx_hashTableSize * sizeof(struct rx_connection *));
448     ptable = (char *)osi_Alloc(rx_hashTableSize * sizeof(struct rx_peer *));
449     PIN(ptable, rx_hashTableSize * sizeof(struct rx_peer *));   /* XXXXX */
450     memset(ptable, 0, rx_hashTableSize * sizeof(struct rx_peer *));
451
452     /* Malloc up a bunch of packets & buffers */
453     rx_nFreePackets = 0;
454     queue_Init(&rx_freePacketQueue);
455     rxi_NeedMorePackets = FALSE;
456 #ifdef RX_ENABLE_TSFPQ
457     rx_nPackets = 0;    /* in TSFPQ version, rx_nPackets is managed by rxi_MorePackets* */
458     rxi_MorePacketsTSFPQ(rx_extraPackets + RX_MAX_QUOTA + 2, RX_TS_FPQ_FLUSH_GLOBAL, 0);
459 #else /* RX_ENABLE_TSFPQ */
460     rx_nPackets = rx_extraPackets + RX_MAX_QUOTA + 2;   /* fudge */
461     rxi_MorePackets(rx_nPackets);
462 #endif /* RX_ENABLE_TSFPQ */
463     rx_CheckPackets();
464
465     NETPRI;
466
467     clock_Init();
468
469 #if defined(AFS_NT40_ENV) && !defined(AFS_PTHREAD_ENV)
470     tv.tv_sec = clock_now.sec;
471     tv.tv_usec = clock_now.usec;
472     srand((unsigned int)tv.tv_usec);
473 #else
474     osi_GetTime(&tv);
475 #endif
476     if (port) {
477         rx_port = port;
478     } else {
479 #if defined(KERNEL) && !defined(UKERNEL)
480         /* Really, this should never happen in a real kernel */
481         rx_port = 0;
482 #else
483         struct sockaddr_in addr;
484         int addrlen = sizeof(addr);
485         if (getsockname((int)rx_socket, (struct sockaddr *)&addr, &addrlen)) {
486             rx_Finalize();
487             return -1;
488         }
489         rx_port = addr.sin_port;
490 #endif
491     }
492     rx_stats.minRtt.sec = 9999999;
493 #ifdef  KERNEL
494     rx_SetEpoch(tv.tv_sec | 0x80000000);
495 #else
496     rx_SetEpoch(tv.tv_sec);     /* Start time of this package, rxkad
497                                  * will provide a randomer value. */
498 #endif
499     MUTEX_ENTER(&rx_stats_mutex);
500     rxi_dataQuota += rx_extraQuota;     /* + extra pkts caller asked to rsrv */
501     MUTEX_EXIT(&rx_stats_mutex);
502     /* *Slightly* random start time for the cid.  This is just to help
503      * out with the hashing function at the peer */
504     rx_nextCid = ((tv.tv_sec ^ tv.tv_usec) << RX_CIDSHIFT);
505     rx_connHashTable = (struct rx_connection **)htable;
506     rx_peerHashTable = (struct rx_peer **)ptable;
507
508     rx_lastAckDelay.sec = 0;
509     rx_lastAckDelay.usec = 400000;      /* 400 milliseconds */
510     rx_hardAckDelay.sec = 0;
511     rx_hardAckDelay.usec = 100000;      /* 100 milliseconds */
512     rx_softAckDelay.sec = 0;
513     rx_softAckDelay.usec = 100000;      /* 100 milliseconds */
514
515     rxevent_Init(20, rxi_ReScheduleEvents);
516
517     /* Initialize various global queues */
518     queue_Init(&rx_idleServerQueue);
519     queue_Init(&rx_incomingCallQueue);
520     queue_Init(&rx_freeCallQueue);
521
522 #if defined(AFS_NT40_ENV) && !defined(KERNEL)
523     /* Initialize our list of usable IP addresses. */
524     rx_GetIFInfo();
525 #endif
526
527     /* Start listener process (exact function is dependent on the
528      * implementation environment--kernel or user space) */
529     rxi_StartListener();
530
531     USERPRI;
532     tmp_status = rxinit_status = 0;
533     UNLOCK_RX_INIT;
534     return tmp_status;
535 }
536
537 int
538 rx_Init(u_int port)
539 {
540     return rx_InitHost(htonl(INADDR_ANY), port);
541 }
542
543 /* called with unincremented nRequestsRunning to see if it is OK to start
544  * a new thread in this service.  Could be "no" for two reasons: over the
545  * max quota, or would prevent others from reaching their min quota.
546  */
547 #ifdef RX_ENABLE_LOCKS
548 /* This verion of QuotaOK reserves quota if it's ok while the
549  * rx_serverPool_lock is held.  Return quota using ReturnToServerPool().
550  */
551 static int
552 QuotaOK(register struct rx_service *aservice)
553 {
554     /* check if over max quota */
555     if (aservice->nRequestsRunning >= aservice->maxProcs) {
556         return 0;
557     }
558
559     /* under min quota, we're OK */
560     /* otherwise, can use only if there are enough to allow everyone
561      * to go to their min quota after this guy starts.
562      */
563     MUTEX_ENTER(&rx_stats_mutex);
564     if ((aservice->nRequestsRunning < aservice->minProcs)
565         || (rxi_availProcs > rxi_minDeficit)) {
566         aservice->nRequestsRunning++;
567         /* just started call in minProcs pool, need fewer to maintain
568          * guarantee */
569         if (aservice->nRequestsRunning <= aservice->minProcs)
570             rxi_minDeficit--;
571         rxi_availProcs--;
572         MUTEX_EXIT(&rx_stats_mutex);
573         return 1;
574     }
575     MUTEX_EXIT(&rx_stats_mutex);
576
577     return 0;
578 }
579
580 static void
581 ReturnToServerPool(register struct rx_service *aservice)
582 {
583     aservice->nRequestsRunning--;
584     MUTEX_ENTER(&rx_stats_mutex);
585     if (aservice->nRequestsRunning < aservice->minProcs)
586         rxi_minDeficit++;
587     rxi_availProcs++;
588     MUTEX_EXIT(&rx_stats_mutex);
589 }
590
591 #else /* RX_ENABLE_LOCKS */
592 static int
593 QuotaOK(register struct rx_service *aservice)
594 {
595     int rc = 0;
596     /* under min quota, we're OK */
597     if (aservice->nRequestsRunning < aservice->minProcs)
598         return 1;
599
600     /* check if over max quota */
601     if (aservice->nRequestsRunning >= aservice->maxProcs)
602         return 0;
603
604     /* otherwise, can use only if there are enough to allow everyone
605      * to go to their min quota after this guy starts.
606      */
607     if (rxi_availProcs > rxi_minDeficit)
608         rc = 1;
609     return rc;
610 }
611 #endif /* RX_ENABLE_LOCKS */
612
613 #ifndef KERNEL
614 /* Called by rx_StartServer to start up lwp's to service calls.
615    NExistingProcs gives the number of procs already existing, and which
616    therefore needn't be created. */
617 void
618 rxi_StartServerProcs(int nExistingProcs)
619 {
620     register struct rx_service *service;
621     register int i;
622     int maxdiff = 0;
623     int nProcs = 0;
624
625     /* For each service, reserve N processes, where N is the "minimum"
626      * number of processes that MUST be able to execute a request in parallel,
627      * at any time, for that process.  Also compute the maximum difference
628      * between any service's maximum number of processes that can run
629      * (i.e. the maximum number that ever will be run, and a guarantee
630      * that this number will run if other services aren't running), and its
631      * minimum number.  The result is the extra number of processes that
632      * we need in order to provide the latter guarantee */
633     for (i = 0; i < RX_MAX_SERVICES; i++) {
634         int diff;
635         service = rx_services[i];
636         if (service == (struct rx_service *)0)
637             break;
638         nProcs += service->minProcs;
639         diff = service->maxProcs - service->minProcs;
640         if (diff > maxdiff)
641             maxdiff = diff;
642     }
643     nProcs += maxdiff;          /* Extra processes needed to allow max number requested to run in any given service, under good conditions */
644     nProcs -= nExistingProcs;   /* Subtract the number of procs that were previously created for use as server procs */
645     for (i = 0; i < nProcs; i++) {
646         rxi_StartServerProc(rx_ServerProc, rx_stackSize);
647     }
648 }
649 #endif /* KERNEL */
650
651 #ifdef AFS_NT40_ENV
652 /* This routine is only required on Windows */
653 void
654 rx_StartClientThread(void)
655 {
656 #ifdef AFS_PTHREAD_ENV
657     int pid;
658     pid = (int) pthread_self();
659 #endif /* AFS_PTHREAD_ENV */
660 }
661 #endif /* AFS_NT40_ENV */
662
663 /* This routine must be called if any services are exported.  If the
664  * donateMe flag is set, the calling process is donated to the server
665  * process pool */
666 void
667 rx_StartServer(int donateMe)
668 {
669     register struct rx_service *service;
670     register int i;
671     SPLVAR;
672     clock_NewTime();
673
674     NETPRI;
675     /* Start server processes, if necessary (exact function is dependent
676      * on the implementation environment--kernel or user space).  DonateMe
677      * will be 1 if there is 1 pre-existing proc, i.e. this one.  In this
678      * case, one less new proc will be created rx_StartServerProcs.
679      */
680     rxi_StartServerProcs(donateMe);
681
682     /* count up the # of threads in minProcs, and add set the min deficit to
683      * be that value, too.
684      */
685     for (i = 0; i < RX_MAX_SERVICES; i++) {
686         service = rx_services[i];
687         if (service == (struct rx_service *)0)
688             break;
689         MUTEX_ENTER(&rx_stats_mutex);
690         rxi_totalMin += service->minProcs;
691         /* below works even if a thread is running, since minDeficit would
692          * still have been decremented and later re-incremented.
693          */
694         rxi_minDeficit += service->minProcs;
695         MUTEX_EXIT(&rx_stats_mutex);
696     }
697
698     /* Turn on reaping of idle server connections */
699     rxi_ReapConnections();
700
701     USERPRI;
702
703     if (donateMe) {
704 #ifndef AFS_NT40_ENV
705 #ifndef KERNEL
706         char name[32];
707         static int nProcs;
708 #ifdef AFS_PTHREAD_ENV
709         pid_t pid;
710         pid = (pid_t) pthread_self();
711 #else /* AFS_PTHREAD_ENV */
712         PROCESS pid;
713         LWP_CurrentProcess(&pid);
714 #endif /* AFS_PTHREAD_ENV */
715
716         sprintf(name, "srv_%d", ++nProcs);
717         if (registerProgram)
718             (*registerProgram) (pid, name);
719 #endif /* KERNEL */
720 #endif /* AFS_NT40_ENV */
721         rx_ServerProc();        /* Never returns */
722     }
723 #ifdef RX_ENABLE_TSFPQ
724     /* no use leaving packets around in this thread's local queue if
725      * it isn't getting donated to the server thread pool. 
726      */
727     rxi_FlushLocalPacketsTSFPQ();
728 #endif /* RX_ENABLE_TSFPQ */
729     return;
730 }
731
732 /* Create a new client connection to the specified service, using the
733  * specified security object to implement the security model for this
734  * connection. */
735 struct rx_connection *
736 rx_NewConnection(register afs_uint32 shost, u_short sport, u_short sservice,
737                  register struct rx_securityClass *securityObject,
738                  int serviceSecurityIndex)
739 {
740     int hashindex;
741     afs_int32 cid;
742     register struct rx_connection *conn;
743
744     SPLVAR;
745
746     clock_NewTime();
747     dpf(("rx_NewConnection(host %x, port %u, service %u, securityObject %x, serviceSecurityIndex %d)\n", ntohl(shost), ntohs(sport), sservice, securityObject, serviceSecurityIndex));
748
749     /* Vasilsi said: "NETPRI protects Cid and Alloc", but can this be true in
750      * the case of kmem_alloc? */
751     conn = rxi_AllocConnection();
752 #ifdef  RX_ENABLE_LOCKS
753     MUTEX_INIT(&conn->conn_call_lock, "conn call lock", MUTEX_DEFAULT, 0);
754     MUTEX_INIT(&conn->conn_data_lock, "conn call lock", MUTEX_DEFAULT, 0);
755     CV_INIT(&conn->conn_call_cv, "conn call cv", CV_DEFAULT, 0);
756 #endif
757     NETPRI;
758     MUTEX_ENTER(&rx_connHashTable_lock);
759     cid = (rx_nextCid += RX_MAXCALLS);
760     conn->type = RX_CLIENT_CONNECTION;
761     conn->cid = cid;
762     conn->epoch = rx_epoch;
763     conn->peer = rxi_FindPeer(shost, sport, 0, 1);
764     conn->serviceId = sservice;
765     conn->securityObject = securityObject;
766     /* This doesn't work in all compilers with void (they're buggy), so fake it
767      * with VOID */
768     conn->securityData = (VOID *) 0;
769     conn->securityIndex = serviceSecurityIndex;
770     rx_SetConnDeadTime(conn, rx_connDeadTime);
771     conn->ackRate = RX_FAST_ACK_RATE;
772     conn->nSpecific = 0;
773     conn->specific = NULL;
774     conn->challengeEvent = NULL;
775     conn->delayedAbortEvent = NULL;
776     conn->abortCount = 0;
777     conn->error = 0;
778
779     RXS_NewConnection(securityObject, conn);
780     hashindex =
781         CONN_HASH(shost, sport, conn->cid, conn->epoch, RX_CLIENT_CONNECTION);
782
783     conn->refCount++;           /* no lock required since only this thread knows... */
784     conn->next = rx_connHashTable[hashindex];
785     rx_connHashTable[hashindex] = conn;
786     MUTEX_ENTER(&rx_stats_mutex);
787     rx_stats.nClientConns++;
788     MUTEX_EXIT(&rx_stats_mutex);
789
790     MUTEX_EXIT(&rx_connHashTable_lock);
791     USERPRI;
792     return conn;
793 }
794
795 void
796 rx_SetConnDeadTime(register struct rx_connection *conn, register int seconds)
797 {
798     /* The idea is to set the dead time to a value that allows several
799      * keepalives to be dropped without timing out the connection. */
800     conn->secondsUntilDead = MAX(seconds, 6);
801     conn->secondsUntilPing = conn->secondsUntilDead / 6;
802 }
803
804 int rxi_lowPeerRefCount = 0;
805 int rxi_lowConnRefCount = 0;
806
807 /*
808  * Cleanup a connection that was destroyed in rxi_DestroyConnectioNoLock.
809  * NOTE: must not be called with rx_connHashTable_lock held.
810  */
811 void
812 rxi_CleanupConnection(struct rx_connection *conn)
813 {
814     /* Notify the service exporter, if requested, that this connection
815      * is being destroyed */
816     if (conn->type == RX_SERVER_CONNECTION && conn->service->destroyConnProc)
817         (*conn->service->destroyConnProc) (conn);
818
819     /* Notify the security module that this connection is being destroyed */
820     RXS_DestroyConnection(conn->securityObject, conn);
821
822     /* If this is the last connection using the rx_peer struct, set its
823      * idle time to now. rxi_ReapConnections will reap it if it's still
824      * idle (refCount == 0) after rx_idlePeerTime (60 seconds) have passed.
825      */
826     MUTEX_ENTER(&rx_peerHashTable_lock);
827     if (conn->peer->refCount < 2) {
828         conn->peer->idleWhen = clock_Sec();
829         if (conn->peer->refCount < 1) {
830             conn->peer->refCount = 1;
831             MUTEX_ENTER(&rx_stats_mutex);
832             rxi_lowPeerRefCount++;
833             MUTEX_EXIT(&rx_stats_mutex);
834         }
835     }
836     conn->peer->refCount--;
837     MUTEX_EXIT(&rx_peerHashTable_lock);
838
839     MUTEX_ENTER(&rx_stats_mutex);
840     if (conn->type == RX_SERVER_CONNECTION)
841         rx_stats.nServerConns--;
842     else
843         rx_stats.nClientConns--;
844     MUTEX_EXIT(&rx_stats_mutex);
845
846 #ifndef KERNEL
847     if (conn->specific) {
848         int i;
849         for (i = 0; i < conn->nSpecific; i++) {
850             if (conn->specific[i] && rxi_keyCreate_destructor[i])
851                 (*rxi_keyCreate_destructor[i]) (conn->specific[i]);
852             conn->specific[i] = NULL;
853         }
854         free(conn->specific);
855     }
856     conn->specific = NULL;
857     conn->nSpecific = 0;
858 #endif /* !KERNEL */
859
860     MUTEX_DESTROY(&conn->conn_call_lock);
861     MUTEX_DESTROY(&conn->conn_data_lock);
862     CV_DESTROY(&conn->conn_call_cv);
863
864     rxi_FreeConnection(conn);
865 }
866
867 /* Destroy the specified connection */
868 void
869 rxi_DestroyConnection(register struct rx_connection *conn)
870 {
871     MUTEX_ENTER(&rx_connHashTable_lock);
872     rxi_DestroyConnectionNoLock(conn);
873     /* conn should be at the head of the cleanup list */
874     if (conn == rx_connCleanup_list) {
875         rx_connCleanup_list = rx_connCleanup_list->next;
876         MUTEX_EXIT(&rx_connHashTable_lock);
877         rxi_CleanupConnection(conn);
878     }
879 #ifdef RX_ENABLE_LOCKS
880     else {
881         MUTEX_EXIT(&rx_connHashTable_lock);
882     }
883 #endif /* RX_ENABLE_LOCKS */
884 }
885
886 static void
887 rxi_DestroyConnectionNoLock(register struct rx_connection *conn)
888 {
889     register struct rx_connection **conn_ptr;
890     register int havecalls = 0;
891     struct rx_packet *packet;
892     int i;
893     SPLVAR;
894
895     clock_NewTime();
896
897     NETPRI;
898     MUTEX_ENTER(&conn->conn_data_lock);
899     if (conn->refCount > 0)
900         conn->refCount--;
901     else {
902         MUTEX_ENTER(&rx_stats_mutex);
903         rxi_lowConnRefCount++;
904         MUTEX_EXIT(&rx_stats_mutex);
905     }
906
907     if ((conn->refCount > 0) || (conn->flags & RX_CONN_BUSY)) {
908         /* Busy; wait till the last guy before proceeding */
909         MUTEX_EXIT(&conn->conn_data_lock);
910         USERPRI;
911         return;
912     }
913
914     /* If the client previously called rx_NewCall, but it is still
915      * waiting, treat this as a running call, and wait to destroy the
916      * connection later when the call completes. */
917     if ((conn->type == RX_CLIENT_CONNECTION)
918         && (conn->flags & RX_CONN_MAKECALL_WAITING)) {
919         conn->flags |= RX_CONN_DESTROY_ME;
920         MUTEX_EXIT(&conn->conn_data_lock);
921         USERPRI;
922         return;
923     }
924     MUTEX_EXIT(&conn->conn_data_lock);
925
926     /* Check for extant references to this connection */
927     for (i = 0; i < RX_MAXCALLS; i++) {
928         register struct rx_call *call = conn->call[i];
929         if (call) {
930             havecalls = 1;
931             if (conn->type == RX_CLIENT_CONNECTION) {
932                 MUTEX_ENTER(&call->lock);
933                 if (call->delayedAckEvent) {
934                     /* Push the final acknowledgment out now--there
935                      * won't be a subsequent call to acknowledge the
936                      * last reply packets */
937                     rxevent_Cancel(call->delayedAckEvent, call,
938                                    RX_CALL_REFCOUNT_DELAY);
939                     if (call->state == RX_STATE_PRECALL
940                         || call->state == RX_STATE_ACTIVE) {
941                         rxi_SendAck(call, 0, 0, RX_ACK_DELAY, 0);
942                     } else {
943                         rxi_AckAll(NULL, call, 0);
944                     }
945                 }
946                 MUTEX_EXIT(&call->lock);
947             }
948         }
949     }
950 #ifdef RX_ENABLE_LOCKS
951     if (!havecalls) {
952         if (MUTEX_TRYENTER(&conn->conn_data_lock)) {
953             MUTEX_EXIT(&conn->conn_data_lock);
954         } else {
955             /* Someone is accessing a packet right now. */
956             havecalls = 1;
957         }
958     }
959 #endif /* RX_ENABLE_LOCKS */
960
961     if (havecalls) {
962         /* Don't destroy the connection if there are any call
963          * structures still in use */
964         MUTEX_ENTER(&conn->conn_data_lock);
965         conn->flags |= RX_CONN_DESTROY_ME;
966         MUTEX_EXIT(&conn->conn_data_lock);
967         USERPRI;
968         return;
969     }
970
971     if (conn->delayedAbortEvent) {
972         rxevent_Cancel(conn->delayedAbortEvent, (struct rx_call *)0, 0);
973         packet = rxi_AllocPacket(RX_PACKET_CLASS_SPECIAL);
974         if (packet) {
975             MUTEX_ENTER(&conn->conn_data_lock);
976             rxi_SendConnectionAbort(conn, packet, 0, 1);
977             MUTEX_EXIT(&conn->conn_data_lock);
978             rxi_FreePacket(packet);
979         }
980     }
981
982     /* Remove from connection hash table before proceeding */
983     conn_ptr =
984         &rx_connHashTable[CONN_HASH
985                           (peer->host, peer->port, conn->cid, conn->epoch,
986                            conn->type)];
987     for (; *conn_ptr; conn_ptr = &(*conn_ptr)->next) {
988         if (*conn_ptr == conn) {
989             *conn_ptr = conn->next;
990             break;
991         }
992     }
993     /* if the conn that we are destroying was the last connection, then we
994      * clear rxLastConn as well */
995     if (rxLastConn == conn)
996         rxLastConn = 0;
997
998     /* Make sure the connection is completely reset before deleting it. */
999     /* get rid of pending events that could zap us later */
1000     if (conn->challengeEvent)
1001         rxevent_Cancel(conn->challengeEvent, (struct rx_call *)0, 0);
1002     if (conn->checkReachEvent)
1003         rxevent_Cancel(conn->checkReachEvent, (struct rx_call *)0, 0);
1004
1005     /* Add the connection to the list of destroyed connections that
1006      * need to be cleaned up. This is necessary to avoid deadlocks
1007      * in the routines we call to inform others that this connection is
1008      * being destroyed. */
1009     conn->next = rx_connCleanup_list;
1010     rx_connCleanup_list = conn;
1011 }
1012
1013 /* Externally available version */
1014 void
1015 rx_DestroyConnection(register struct rx_connection *conn)
1016 {
1017     SPLVAR;
1018
1019     NETPRI;
1020     rxi_DestroyConnection(conn);
1021     USERPRI;
1022 }
1023
1024 void
1025 rx_GetConnection(register struct rx_connection *conn)
1026 {
1027     SPLVAR;
1028
1029     NETPRI;
1030     MUTEX_ENTER(&conn->conn_data_lock);
1031     conn->refCount++;
1032     MUTEX_EXIT(&conn->conn_data_lock);
1033     USERPRI;
1034 }
1035
1036 /* Wait for the transmit queue to no longer be busy. 
1037  * requires the call->lock to be held */
1038 static void rxi_WaitforTQBusy(struct rx_call *call) {
1039     while (call->flags & RX_CALL_TQ_BUSY) {
1040         call->flags |= RX_CALL_TQ_WAIT;
1041         call->tqWaiters++;
1042 #ifdef RX_ENABLE_LOCKS
1043         osirx_AssertMine(&call->lock, "rxi_WaitforTQ lock");
1044         CV_WAIT(&call->cv_tq, &call->lock);
1045 #else /* RX_ENABLE_LOCKS */
1046         osi_rxSleep(&call->tq);
1047 #endif /* RX_ENABLE_LOCKS */
1048         call->tqWaiters--;
1049         if (call->tqWaiters == 0) {
1050             call->flags &= ~RX_CALL_TQ_WAIT;
1051         }
1052     }
1053 }
1054 /* Start a new rx remote procedure call, on the specified connection.
1055  * If wait is set to 1, wait for a free call channel; otherwise return
1056  * 0.  Maxtime gives the maximum number of seconds this call may take,
1057  * after rx_NewCall returns.  After this time interval, a call to any
1058  * of rx_SendData, rx_ReadData, etc. will fail with RX_CALL_TIMEOUT.
1059  * For fine grain locking, we hold the conn_call_lock in order to 
1060  * to ensure that we don't get signalle after we found a call in an active
1061  * state and before we go to sleep.
1062  */
1063 struct rx_call *
1064 rx_NewCall(register struct rx_connection *conn)
1065 {
1066     register int i;
1067     register struct rx_call *call;
1068     struct clock queueTime;
1069     SPLVAR;
1070
1071     clock_NewTime();
1072     dpf(("rx_NewCall(conn %x)\n", conn));
1073
1074     NETPRI;
1075     clock_GetTime(&queueTime);
1076     MUTEX_ENTER(&conn->conn_call_lock);
1077
1078     /*
1079      * Check if there are others waiting for a new call.
1080      * If so, let them go first to avoid starving them.
1081      * This is a fairly simple scheme, and might not be
1082      * a complete solution for large numbers of waiters.
1083      * 
1084      * makeCallWaiters keeps track of the number of 
1085      * threads waiting to make calls and the 
1086      * RX_CONN_MAKECALL_WAITING flag bit is used to 
1087      * indicate that there are indeed calls waiting.
1088      * The flag is set when the waiter is incremented.
1089      * It is only cleared in rx_EndCall when 
1090      * makeCallWaiters is 0.  This prevents us from 
1091      * accidently destroying the connection while it
1092      * is potentially about to be used.
1093      */
1094     MUTEX_ENTER(&conn->conn_data_lock);
1095     if (conn->makeCallWaiters) {
1096         conn->flags |= RX_CONN_MAKECALL_WAITING;
1097         conn->makeCallWaiters++;
1098         MUTEX_EXIT(&conn->conn_data_lock);
1099
1100 #ifdef  RX_ENABLE_LOCKS
1101         CV_WAIT(&conn->conn_call_cv, &conn->conn_call_lock);
1102 #else
1103         osi_rxSleep(conn);
1104 #endif
1105         MUTEX_ENTER(&conn->conn_data_lock);
1106         conn->makeCallWaiters--;
1107     } 
1108     MUTEX_EXIT(&conn->conn_data_lock);
1109
1110     for (;;) {
1111         for (i = 0; i < RX_MAXCALLS; i++) {
1112             call = conn->call[i];
1113             if (call) {
1114                 MUTEX_ENTER(&call->lock);
1115                 if (call->state == RX_STATE_DALLY) {
1116                     rxi_ResetCall(call, 0);
1117                     (*call->callNumber)++;
1118                     break;
1119                 }
1120                 MUTEX_EXIT(&call->lock);
1121             } else {
1122                 call = rxi_NewCall(conn, i);
1123                 break;
1124             }
1125         }
1126         if (i < RX_MAXCALLS) {
1127             break;
1128         }
1129         MUTEX_ENTER(&conn->conn_data_lock);
1130         conn->flags |= RX_CONN_MAKECALL_WAITING;
1131         conn->makeCallWaiters++;
1132         MUTEX_EXIT(&conn->conn_data_lock);
1133
1134 #ifdef  RX_ENABLE_LOCKS
1135         CV_WAIT(&conn->conn_call_cv, &conn->conn_call_lock);
1136 #else
1137         osi_rxSleep(conn);
1138 #endif
1139         MUTEX_ENTER(&conn->conn_data_lock);
1140         conn->makeCallWaiters--;
1141         MUTEX_EXIT(&conn->conn_data_lock);
1142     }
1143     /*
1144      * Wake up anyone else who might be giving us a chance to
1145      * run (see code above that avoids resource starvation).
1146      */
1147 #ifdef  RX_ENABLE_LOCKS
1148     CV_BROADCAST(&conn->conn_call_cv);
1149 #else
1150     osi_rxWakeup(conn);
1151 #endif
1152
1153     CALL_HOLD(call, RX_CALL_REFCOUNT_BEGIN);
1154
1155     /* Client is initially in send mode */
1156     call->state = RX_STATE_ACTIVE;
1157     call->error = conn->error;
1158     if (call->error)
1159         call->mode = RX_MODE_ERROR;
1160     else
1161         call->mode = RX_MODE_SENDING;
1162     
1163     /* remember start time for call in case we have hard dead time limit */
1164     call->queueTime = queueTime;
1165     clock_GetTime(&call->startTime);
1166     hzero(call->bytesSent);
1167     hzero(call->bytesRcvd);
1168
1169     /* Turn on busy protocol. */
1170     rxi_KeepAliveOn(call);
1171
1172     MUTEX_EXIT(&call->lock);
1173     MUTEX_EXIT(&conn->conn_call_lock);
1174     USERPRI;
1175
1176 #ifdef  AFS_GLOBAL_RXLOCK_KERNEL
1177     /* Now, if TQ wasn't cleared earlier, do it now. */
1178     MUTEX_ENTER(&call->lock);
1179     rxi_WaitforTQBusy(call);
1180     if (call->flags & RX_CALL_TQ_CLEARME) {
1181         rxi_ClearTransmitQueue(call, 0);
1182         queue_Init(&call->tq);
1183     }
1184     MUTEX_EXIT(&call->lock);
1185 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
1186
1187     dpf(("rx_NewCall(call %x)\n", call));
1188     return call;
1189 }
1190
1191 int
1192 rxi_HasActiveCalls(register struct rx_connection *aconn)
1193 {
1194     register int i;
1195     register struct rx_call *tcall;
1196     SPLVAR;
1197
1198     NETPRI;
1199     for (i = 0; i < RX_MAXCALLS; i++) {
1200         if ((tcall = aconn->call[i])) {
1201             if ((tcall->state == RX_STATE_ACTIVE)
1202                 || (tcall->state == RX_STATE_PRECALL)) {
1203                 USERPRI;
1204                 return 1;
1205             }
1206         }
1207     }
1208     USERPRI;
1209     return 0;
1210 }
1211
1212 int
1213 rxi_GetCallNumberVector(register struct rx_connection *aconn,
1214                         register afs_int32 * aint32s)
1215 {
1216     register int i;
1217     register struct rx_call *tcall;
1218     SPLVAR;
1219
1220     NETPRI;
1221     for (i = 0; i < RX_MAXCALLS; i++) {
1222         if ((tcall = aconn->call[i]) && (tcall->state == RX_STATE_DALLY))
1223             aint32s[i] = aconn->callNumber[i] + 1;
1224         else
1225             aint32s[i] = aconn->callNumber[i];
1226     }
1227     USERPRI;
1228     return 0;
1229 }
1230
1231 int
1232 rxi_SetCallNumberVector(register struct rx_connection *aconn,
1233                         register afs_int32 * aint32s)
1234 {
1235     register int i;
1236     register struct rx_call *tcall;
1237     SPLVAR;
1238
1239     NETPRI;
1240     for (i = 0; i < RX_MAXCALLS; i++) {
1241         if ((tcall = aconn->call[i]) && (tcall->state == RX_STATE_DALLY))
1242             aconn->callNumber[i] = aint32s[i] - 1;
1243         else
1244             aconn->callNumber[i] = aint32s[i];
1245     }
1246     USERPRI;
1247     return 0;
1248 }
1249
1250 /* Advertise a new service.  A service is named locally by a UDP port
1251  * number plus a 16-bit service id.  Returns (struct rx_service *) 0
1252  * on a failure. 
1253  *
1254      char *serviceName;  Name for identification purposes (e.g. the
1255                          service name might be used for probing for
1256                          statistics) */
1257 struct rx_service *
1258 rx_NewServiceHost(afs_uint32 host, u_short port, u_short serviceId, 
1259                   char *serviceName, struct rx_securityClass **securityObjects,
1260                   int nSecurityObjects, 
1261                   afs_int32(*serviceProc) (struct rx_call * acall))
1262 {
1263     osi_socket socket = OSI_NULLSOCKET;
1264     register struct rx_service *tservice;
1265     register int i;
1266     SPLVAR;
1267
1268     clock_NewTime();
1269
1270     if (serviceId == 0) {
1271         (osi_Msg
1272          "rx_NewService:  service id for service %s is not non-zero.\n",
1273          serviceName);
1274         return 0;
1275     }
1276     if (port == 0) {
1277         if (rx_port == 0) {
1278             (osi_Msg
1279              "rx_NewService: A non-zero port must be specified on this call if a non-zero port was not provided at Rx initialization (service %s).\n",
1280              serviceName);
1281             return 0;
1282         }
1283         port = rx_port;
1284         socket = rx_socket;
1285     }
1286
1287     tservice = rxi_AllocService();
1288     NETPRI;
1289     for (i = 0; i < RX_MAX_SERVICES; i++) {
1290         register struct rx_service *service = rx_services[i];
1291         if (service) {
1292             if (port == service->servicePort && host == service->serviceHost) {
1293                 if (service->serviceId == serviceId) {
1294                     /* The identical service has already been
1295                      * installed; if the caller was intending to
1296                      * change the security classes used by this
1297                      * service, he/she loses. */
1298                     (osi_Msg
1299                      "rx_NewService: tried to install service %s with service id %d, which is already in use for service %s\n",
1300                      serviceName, serviceId, service->serviceName);
1301                     USERPRI;
1302                     rxi_FreeService(tservice);
1303                     return service;
1304                 }
1305                 /* Different service, same port: re-use the socket
1306                  * which is bound to the same port */
1307                 socket = service->socket;
1308             }
1309         } else {
1310             if (socket == OSI_NULLSOCKET) {
1311                 /* If we don't already have a socket (from another
1312                  * service on same port) get a new one */
1313                 socket = rxi_GetHostUDPSocket(htonl(INADDR_ANY), port);
1314                 if (socket == OSI_NULLSOCKET) {
1315                     USERPRI;
1316                     rxi_FreeService(tservice);
1317                     return 0;
1318                 }
1319             }
1320             service = tservice;
1321             service->socket = socket;
1322             service->serviceHost = host;
1323             service->servicePort = port;
1324             service->serviceId = serviceId;
1325             service->serviceName = serviceName;
1326             service->nSecurityObjects = nSecurityObjects;
1327             service->securityObjects = securityObjects;
1328             service->minProcs = 0;
1329             service->maxProcs = 1;
1330             service->idleDeadTime = 60;
1331             service->connDeadTime = rx_connDeadTime;
1332             service->executeRequestProc = serviceProc;
1333             service->checkReach = 0;
1334             rx_services[i] = service;   /* not visible until now */
1335             USERPRI;
1336             return service;
1337         }
1338     }
1339     USERPRI;
1340     rxi_FreeService(tservice);
1341     (osi_Msg "rx_NewService: cannot support > %d services\n",
1342      RX_MAX_SERVICES);
1343     return 0;
1344 }
1345
1346 /* Set configuration options for all of a service's security objects */
1347
1348 afs_int32 
1349 rx_SetSecurityConfiguration(struct rx_service *service, 
1350                             rx_securityConfigVariables type,
1351                             void *value)
1352 {
1353     int i;
1354     for (i = 0; i<service->nSecurityObjects; i++) {
1355         if (service->securityObjects[i]) {
1356             RXS_SetConfiguration(service->securityObjects[i], NULL, type, 
1357                                  value, NULL);
1358         }
1359     }
1360     return 0;
1361 }
1362
1363 struct rx_service *
1364 rx_NewService(u_short port, u_short serviceId, char *serviceName,
1365               struct rx_securityClass **securityObjects, int nSecurityObjects,
1366               afs_int32(*serviceProc) (struct rx_call * acall))
1367 {
1368     return rx_NewServiceHost(htonl(INADDR_ANY), port, serviceId, serviceName, securityObjects, nSecurityObjects, serviceProc);
1369 }
1370
1371 /* Generic request processing loop. This routine should be called
1372  * by the implementation dependent rx_ServerProc. If socketp is
1373  * non-null, it will be set to the file descriptor that this thread
1374  * is now listening on. If socketp is null, this routine will never
1375  * returns. */
1376 void
1377 rxi_ServerProc(int threadID, struct rx_call *newcall, osi_socket * socketp)
1378 {
1379     register struct rx_call *call;
1380     register afs_int32 code;
1381     register struct rx_service *tservice = NULL;
1382
1383     for (;;) {
1384         if (newcall) {
1385             call = newcall;
1386             newcall = NULL;
1387         } else {
1388             call = rx_GetCall(threadID, tservice, socketp);
1389             if (socketp && *socketp != OSI_NULLSOCKET) {
1390                 /* We are now a listener thread */
1391                 return;
1392             }
1393         }
1394
1395         /* if server is restarting( typically smooth shutdown) then do not
1396          * allow any new calls.
1397          */
1398
1399         if (rx_tranquil && (call != NULL)) {
1400             SPLVAR;
1401
1402             NETPRI;
1403             MUTEX_ENTER(&call->lock);
1404
1405             rxi_CallError(call, RX_RESTARTING);
1406             rxi_SendCallAbort(call, (struct rx_packet *)0, 0, 0);
1407
1408             MUTEX_EXIT(&call->lock);
1409             USERPRI;
1410         }
1411 #ifdef  KERNEL
1412         if (afs_termState == AFSOP_STOP_RXCALLBACK) {
1413 #ifdef RX_ENABLE_LOCKS
1414             AFS_GLOCK();
1415 #endif /* RX_ENABLE_LOCKS */
1416             afs_termState = AFSOP_STOP_AFS;
1417             afs_osi_Wakeup(&afs_termState);
1418 #ifdef RX_ENABLE_LOCKS
1419             AFS_GUNLOCK();
1420 #endif /* RX_ENABLE_LOCKS */
1421             return;
1422         }
1423 #endif
1424
1425         tservice = call->conn->service;
1426
1427         if (tservice->beforeProc)
1428             (*tservice->beforeProc) (call);
1429
1430         code = call->conn->service->executeRequestProc(call);
1431
1432         if (tservice->afterProc)
1433             (*tservice->afterProc) (call, code);
1434
1435         rx_EndCall(call, code);
1436         MUTEX_ENTER(&rx_stats_mutex);
1437         rxi_nCalls++;
1438         MUTEX_EXIT(&rx_stats_mutex);
1439     }
1440 }
1441
1442
1443 void
1444 rx_WakeupServerProcs(void)
1445 {
1446     struct rx_serverQueueEntry *np, *tqp;
1447     SPLVAR;
1448
1449     NETPRI;
1450     MUTEX_ENTER(&rx_serverPool_lock);
1451
1452 #ifdef RX_ENABLE_LOCKS
1453     if (rx_waitForPacket)
1454         CV_BROADCAST(&rx_waitForPacket->cv);
1455 #else /* RX_ENABLE_LOCKS */
1456     if (rx_waitForPacket)
1457         osi_rxWakeup(rx_waitForPacket);
1458 #endif /* RX_ENABLE_LOCKS */
1459     MUTEX_ENTER(&freeSQEList_lock);
1460     for (np = rx_FreeSQEList; np; np = tqp) {
1461         tqp = *(struct rx_serverQueueEntry **)np;
1462 #ifdef RX_ENABLE_LOCKS
1463         CV_BROADCAST(&np->cv);
1464 #else /* RX_ENABLE_LOCKS */
1465         osi_rxWakeup(np);
1466 #endif /* RX_ENABLE_LOCKS */
1467     }
1468     MUTEX_EXIT(&freeSQEList_lock);
1469     for (queue_Scan(&rx_idleServerQueue, np, tqp, rx_serverQueueEntry)) {
1470 #ifdef RX_ENABLE_LOCKS
1471         CV_BROADCAST(&np->cv);
1472 #else /* RX_ENABLE_LOCKS */
1473         osi_rxWakeup(np);
1474 #endif /* RX_ENABLE_LOCKS */
1475     }
1476     MUTEX_EXIT(&rx_serverPool_lock);
1477     USERPRI;
1478 }
1479
1480 /* meltdown:
1481  * One thing that seems to happen is that all the server threads get
1482  * tied up on some empty or slow call, and then a whole bunch of calls
1483  * arrive at once, using up the packet pool, so now there are more 
1484  * empty calls.  The most critical resources here are server threads
1485  * and the free packet pool.  The "doreclaim" code seems to help in
1486  * general.  I think that eventually we arrive in this state: there
1487  * are lots of pending calls which do have all their packets present,
1488  * so they won't be reclaimed, are multi-packet calls, so they won't
1489  * be scheduled until later, and thus are tying up most of the free 
1490  * packet pool for a very long time.
1491  * future options:
1492  * 1.  schedule multi-packet calls if all the packets are present.  
1493  * Probably CPU-bound operation, useful to return packets to pool. 
1494  * Do what if there is a full window, but the last packet isn't here?
1495  * 3.  preserve one thread which *only* runs "best" calls, otherwise
1496  * it sleeps and waits for that type of call.
1497  * 4.  Don't necessarily reserve a whole window for each thread.  In fact, 
1498  * the current dataquota business is badly broken.  The quota isn't adjusted
1499  * to reflect how many packets are presently queued for a running call.
1500  * So, when we schedule a queued call with a full window of packets queued
1501  * up for it, that *should* free up a window full of packets for other 2d-class
1502  * calls to be able to use from the packet pool.  But it doesn't.
1503  *
1504  * NB.  Most of the time, this code doesn't run -- since idle server threads
1505  * sit on the idle server queue and are assigned by "...ReceivePacket" as soon
1506  * as a new call arrives.
1507  */
1508 /* Sleep until a call arrives.  Returns a pointer to the call, ready
1509  * for an rx_Read. */
1510 #ifdef RX_ENABLE_LOCKS
1511 struct rx_call *
1512 rx_GetCall(int tno, struct rx_service *cur_service, osi_socket * socketp)
1513 {
1514     struct rx_serverQueueEntry *sq;
1515     register struct rx_call *call = (struct rx_call *)0;
1516     struct rx_service *service = NULL;
1517     SPLVAR;
1518
1519     MUTEX_ENTER(&freeSQEList_lock);
1520
1521     if ((sq = rx_FreeSQEList)) {
1522         rx_FreeSQEList = *(struct rx_serverQueueEntry **)sq;
1523         MUTEX_EXIT(&freeSQEList_lock);
1524     } else {                    /* otherwise allocate a new one and return that */
1525         MUTEX_EXIT(&freeSQEList_lock);
1526         sq = (struct rx_serverQueueEntry *)
1527             rxi_Alloc(sizeof(struct rx_serverQueueEntry));
1528         MUTEX_INIT(&sq->lock, "server Queue lock", MUTEX_DEFAULT, 0);
1529         CV_INIT(&sq->cv, "server Queue lock", CV_DEFAULT, 0);
1530     }
1531
1532     MUTEX_ENTER(&rx_serverPool_lock);
1533     if (cur_service != NULL) {
1534         ReturnToServerPool(cur_service);
1535     }
1536     while (1) {
1537         if (queue_IsNotEmpty(&rx_incomingCallQueue)) {
1538             register struct rx_call *tcall, *ncall, *choice2 = NULL;
1539
1540             /* Scan for eligible incoming calls.  A call is not eligible
1541              * if the maximum number of calls for its service type are
1542              * already executing */
1543             /* One thread will process calls FCFS (to prevent starvation),
1544              * while the other threads may run ahead looking for calls which
1545              * have all their input data available immediately.  This helps 
1546              * keep threads from blocking, waiting for data from the client. */
1547             for (queue_Scan(&rx_incomingCallQueue, tcall, ncall, rx_call)) {
1548                 service = tcall->conn->service;
1549                 if (!QuotaOK(service)) {
1550                     continue;
1551                 }
1552                 if (tno == rxi_fcfs_thread_num
1553                     || !tcall->queue_item_header.next) {
1554                     /* If we're the fcfs thread , then  we'll just use 
1555                      * this call. If we haven't been able to find an optimal 
1556                      * choice, and we're at the end of the list, then use a 
1557                      * 2d choice if one has been identified.  Otherwise... */
1558                     call = (choice2 ? choice2 : tcall);
1559                     service = call->conn->service;
1560                 } else if (!queue_IsEmpty(&tcall->rq)) {
1561                     struct rx_packet *rp;
1562                     rp = queue_First(&tcall->rq, rx_packet);
1563                     if (rp->header.seq == 1) {
1564                         if (!meltdown_1pkt
1565                             || (rp->header.flags & RX_LAST_PACKET)) {
1566                             call = tcall;
1567                         } else if (rxi_2dchoice && !choice2
1568                                    && !(tcall->flags & RX_CALL_CLEARED)
1569                                    && (tcall->rprev > rxi_HardAckRate)) {
1570                             choice2 = tcall;
1571                         } else
1572                             rxi_md2cnt++;
1573                     }
1574                 }
1575                 if (call) {
1576                     break;
1577                 } else {
1578                     ReturnToServerPool(service);
1579                 }
1580             }
1581         }
1582
1583         if (call) {
1584             queue_Remove(call);
1585             MUTEX_EXIT(&rx_serverPool_lock);
1586             MUTEX_ENTER(&call->lock);
1587
1588             if (call->flags & RX_CALL_WAIT_PROC) {
1589                 call->flags &= ~RX_CALL_WAIT_PROC;
1590                 MUTEX_ENTER(&rx_stats_mutex);
1591                 rx_nWaiting--;
1592                 MUTEX_EXIT(&rx_stats_mutex);
1593             }
1594
1595             if (call->state != RX_STATE_PRECALL || call->error) {
1596                 MUTEX_EXIT(&call->lock);
1597                 MUTEX_ENTER(&rx_serverPool_lock);
1598                 ReturnToServerPool(service);
1599                 call = NULL;
1600                 continue;
1601             }
1602
1603             if (queue_IsEmpty(&call->rq)
1604                 || queue_First(&call->rq, rx_packet)->header.seq != 1)
1605                 rxi_SendAck(call, 0, 0, RX_ACK_DELAY, 0);
1606
1607             CLEAR_CALL_QUEUE_LOCK(call);
1608             break;
1609         } else {
1610             /* If there are no eligible incoming calls, add this process
1611              * to the idle server queue, to wait for one */
1612             sq->newcall = 0;
1613             sq->tno = tno;
1614             if (socketp) {
1615                 *socketp = OSI_NULLSOCKET;
1616             }
1617             sq->socketp = socketp;
1618             queue_Append(&rx_idleServerQueue, sq);
1619 #ifndef AFS_AIX41_ENV
1620             rx_waitForPacket = sq;
1621 #else
1622             rx_waitingForPacket = sq;
1623 #endif /* AFS_AIX41_ENV */
1624             do {
1625                 CV_WAIT(&sq->cv, &rx_serverPool_lock);
1626 #ifdef  KERNEL
1627                 if (afs_termState == AFSOP_STOP_RXCALLBACK) {
1628                     MUTEX_EXIT(&rx_serverPool_lock);
1629                     return (struct rx_call *)0;
1630                 }
1631 #endif
1632             } while (!(call = sq->newcall)
1633                      && !(socketp && *socketp != OSI_NULLSOCKET));
1634             MUTEX_EXIT(&rx_serverPool_lock);
1635             if (call) {
1636                 MUTEX_ENTER(&call->lock);
1637             }
1638             break;
1639         }
1640     }
1641
1642     MUTEX_ENTER(&freeSQEList_lock);
1643     *(struct rx_serverQueueEntry **)sq = rx_FreeSQEList;
1644     rx_FreeSQEList = sq;
1645     MUTEX_EXIT(&freeSQEList_lock);
1646
1647     if (call) {
1648         clock_GetTime(&call->startTime);
1649         call->state = RX_STATE_ACTIVE;
1650         call->mode = RX_MODE_RECEIVING;
1651 #ifdef RX_KERNEL_TRACE
1652         if (ICL_SETACTIVE(afs_iclSetp)) {
1653             int glockOwner = ISAFS_GLOCK();
1654             if (!glockOwner)
1655                 AFS_GLOCK();
1656             afs_Trace3(afs_iclSetp, CM_TRACE_WASHERE, ICL_TYPE_STRING,
1657                        __FILE__, ICL_TYPE_INT32, __LINE__, ICL_TYPE_POINTER,
1658                        call);
1659             if (!glockOwner)
1660                 AFS_GUNLOCK();
1661         }
1662 #endif
1663
1664         rxi_calltrace(RX_CALL_START, call);
1665         dpf(("rx_GetCall(port=%d, service=%d) ==> call %x\n",
1666              call->conn->service->servicePort, call->conn->service->serviceId,
1667              call));
1668
1669         CALL_HOLD(call, RX_CALL_REFCOUNT_BEGIN);
1670         MUTEX_EXIT(&call->lock);
1671     } else {
1672         dpf(("rx_GetCall(socketp=0x%x, *socketp=0x%x)\n", socketp, *socketp));
1673     }
1674
1675     return call;
1676 }
1677 #else /* RX_ENABLE_LOCKS */
1678 struct rx_call *
1679 rx_GetCall(int tno, struct rx_service *cur_service, osi_socket * socketp)
1680 {
1681     struct rx_serverQueueEntry *sq;
1682     register struct rx_call *call = (struct rx_call *)0, *choice2;
1683     struct rx_service *service = NULL;
1684     SPLVAR;
1685
1686     NETPRI;
1687     MUTEX_ENTER(&freeSQEList_lock);
1688
1689     if ((sq = rx_FreeSQEList)) {
1690         rx_FreeSQEList = *(struct rx_serverQueueEntry **)sq;
1691         MUTEX_EXIT(&freeSQEList_lock);
1692     } else {                    /* otherwise allocate a new one and return that */
1693         MUTEX_EXIT(&freeSQEList_lock);
1694         sq = (struct rx_serverQueueEntry *)
1695             rxi_Alloc(sizeof(struct rx_serverQueueEntry));
1696         MUTEX_INIT(&sq->lock, "server Queue lock", MUTEX_DEFAULT, 0);
1697         CV_INIT(&sq->cv, "server Queue lock", CV_DEFAULT, 0);
1698     }
1699     MUTEX_ENTER(&sq->lock);
1700
1701     if (cur_service != NULL) {
1702         cur_service->nRequestsRunning--;
1703         if (cur_service->nRequestsRunning < cur_service->minProcs)
1704             rxi_minDeficit++;
1705         rxi_availProcs++;
1706     }
1707     if (queue_IsNotEmpty(&rx_incomingCallQueue)) {
1708         register struct rx_call *tcall, *ncall;
1709         /* Scan for eligible incoming calls.  A call is not eligible
1710          * if the maximum number of calls for its service type are
1711          * already executing */
1712         /* One thread will process calls FCFS (to prevent starvation),
1713          * while the other threads may run ahead looking for calls which
1714          * have all their input data available immediately.  This helps 
1715          * keep threads from blocking, waiting for data from the client. */
1716         choice2 = (struct rx_call *)0;
1717         for (queue_Scan(&rx_incomingCallQueue, tcall, ncall, rx_call)) {
1718             service = tcall->conn->service;
1719             if (QuotaOK(service)) {
1720                 if (tno == rxi_fcfs_thread_num
1721                     || !tcall->queue_item_header.next) {
1722                     /* If we're the fcfs thread, then  we'll just use 
1723                      * this call. If we haven't been able to find an optimal 
1724                      * choice, and we're at the end of the list, then use a 
1725                      * 2d choice if one has been identified.  Otherwise... */
1726                     call = (choice2 ? choice2 : tcall);
1727                     service = call->conn->service;
1728                 } else if (!queue_IsEmpty(&tcall->rq)) {
1729                     struct rx_packet *rp;
1730                     rp = queue_First(&tcall->rq, rx_packet);
1731                     if (rp->header.seq == 1
1732                         && (!meltdown_1pkt
1733                             || (rp->header.flags & RX_LAST_PACKET))) {
1734                         call = tcall;
1735                     } else if (rxi_2dchoice && !choice2
1736                                && !(tcall->flags & RX_CALL_CLEARED)
1737                                && (tcall->rprev > rxi_HardAckRate)) {
1738                         choice2 = tcall;
1739                     } else
1740                         rxi_md2cnt++;
1741                 }
1742             }
1743             if (call)
1744                 break;
1745         }
1746     }
1747
1748     if (call) {
1749         queue_Remove(call);
1750         /* we can't schedule a call if there's no data!!! */
1751         /* send an ack if there's no data, if we're missing the
1752          * first packet, or we're missing something between first 
1753          * and last -- there's a "hole" in the incoming data. */
1754         if (queue_IsEmpty(&call->rq)
1755             || queue_First(&call->rq, rx_packet)->header.seq != 1
1756             || call->rprev != queue_Last(&call->rq, rx_packet)->header.seq)
1757             rxi_SendAck(call, 0, 0, RX_ACK_DELAY, 0);
1758
1759         call->flags &= (~RX_CALL_WAIT_PROC);
1760         service->nRequestsRunning++;
1761         /* just started call in minProcs pool, need fewer to maintain
1762          * guarantee */
1763         if (service->nRequestsRunning <= service->minProcs)
1764             rxi_minDeficit--;
1765         rxi_availProcs--;
1766         rx_nWaiting--;
1767         /* MUTEX_EXIT(&call->lock); */
1768     } else {
1769         /* If there are no eligible incoming calls, add this process
1770          * to the idle server queue, to wait for one */
1771         sq->newcall = 0;
1772         if (socketp) {
1773             *socketp = OSI_NULLSOCKET;
1774         }
1775         sq->socketp = socketp;
1776         queue_Append(&rx_idleServerQueue, sq);
1777         do {
1778             osi_rxSleep(sq);
1779 #ifdef  KERNEL
1780             if (afs_termState == AFSOP_STOP_RXCALLBACK) {
1781                 USERPRI;
1782                 rxi_Free(sq, sizeof(struct rx_serverQueueEntry));
1783                 return (struct rx_call *)0;
1784             }
1785 #endif
1786         } while (!(call = sq->newcall)
1787                  && !(socketp && *socketp != OSI_NULLSOCKET));
1788     }
1789     MUTEX_EXIT(&sq->lock);
1790
1791     MUTEX_ENTER(&freeSQEList_lock);
1792     *(struct rx_serverQueueEntry **)sq = rx_FreeSQEList;
1793     rx_FreeSQEList = sq;
1794     MUTEX_EXIT(&freeSQEList_lock);
1795
1796     if (call) {
1797         clock_GetTime(&call->startTime);
1798         call->state = RX_STATE_ACTIVE;
1799         call->mode = RX_MODE_RECEIVING;
1800 #ifdef RX_KERNEL_TRACE
1801         if (ICL_SETACTIVE(afs_iclSetp)) {
1802             int glockOwner = ISAFS_GLOCK();
1803             if (!glockOwner)
1804                 AFS_GLOCK();
1805             afs_Trace3(afs_iclSetp, CM_TRACE_WASHERE, ICL_TYPE_STRING,
1806                        __FILE__, ICL_TYPE_INT32, __LINE__, ICL_TYPE_POINTER,
1807                        call);
1808             if (!glockOwner)
1809                 AFS_GUNLOCK();
1810         }
1811 #endif
1812
1813         rxi_calltrace(RX_CALL_START, call);
1814         dpf(("rx_GetCall(port=%d, service=%d) ==> call %x\n",
1815              call->conn->service->servicePort, call->conn->service->serviceId,
1816              call));
1817     } else {
1818         dpf(("rx_GetCall(socketp=0x%x, *socketp=0x%x)\n", socketp, *socketp));
1819     }
1820
1821     USERPRI;
1822
1823     return call;
1824 }
1825 #endif /* RX_ENABLE_LOCKS */
1826
1827
1828
1829 /* Establish a procedure to be called when a packet arrives for a
1830  * call.  This routine will be called at most once after each call,
1831  * and will also be called if there is an error condition on the or
1832  * the call is complete.  Used by multi rx to build a selection
1833  * function which determines which of several calls is likely to be a
1834  * good one to read from.  
1835  * NOTE: the way this is currently implemented it is probably only a
1836  * good idea to (1) use it immediately after a newcall (clients only)
1837  * and (2) only use it once.  Other uses currently void your warranty
1838  */
1839 void
1840 rx_SetArrivalProc(register struct rx_call *call,
1841                   register void (*proc) (register struct rx_call * call,
1842                                         register VOID * mh,
1843                                         register int index),
1844                   register VOID * handle, register int arg)
1845 {
1846     call->arrivalProc = proc;
1847     call->arrivalProcHandle = handle;
1848     call->arrivalProcArg = arg;
1849 }
1850
1851 /* Call is finished (possibly prematurely).  Return rc to the peer, if
1852  * appropriate, and return the final error code from the conversation
1853  * to the caller */
1854
1855 afs_int32
1856 rx_EndCall(register struct rx_call *call, afs_int32 rc)
1857 {
1858     register struct rx_connection *conn = call->conn;
1859     register struct rx_service *service;
1860     afs_int32 error;
1861     SPLVAR;
1862
1863
1864
1865     dpf(("rx_EndCall(call %x rc %d error %d abortCode %d)\n", call, rc, call->error, call->abortCode));
1866
1867     NETPRI;
1868     MUTEX_ENTER(&call->lock);
1869
1870     if (rc == 0 && call->error == 0) {
1871         call->abortCode = 0;
1872         call->abortCount = 0;
1873     }
1874
1875     call->arrivalProc = (void (*)())0;
1876     if (rc && call->error == 0) {
1877         rxi_CallError(call, rc);
1878         /* Send an abort message to the peer if this error code has
1879          * only just been set.  If it was set previously, assume the
1880          * peer has already been sent the error code or will request it 
1881          */
1882         rxi_SendCallAbort(call, (struct rx_packet *)0, 0, 0);
1883     }
1884     if (conn->type == RX_SERVER_CONNECTION) {
1885         /* Make sure reply or at least dummy reply is sent */
1886         if (call->mode == RX_MODE_RECEIVING) {
1887             rxi_WriteProc(call, 0, 0);
1888         }
1889         if (call->mode == RX_MODE_SENDING) {
1890             rxi_FlushWrite(call);
1891         }
1892         service = conn->service;
1893         rxi_calltrace(RX_CALL_END, call);
1894         /* Call goes to hold state until reply packets are acknowledged */
1895         if (call->tfirst + call->nSoftAcked < call->tnext) {
1896             call->state = RX_STATE_HOLD;
1897         } else {
1898             call->state = RX_STATE_DALLY;
1899             rxi_ClearTransmitQueue(call, 0);
1900             rxevent_Cancel(call->resendEvent, call, RX_CALL_REFCOUNT_RESEND);
1901             rxevent_Cancel(call->keepAliveEvent, call,
1902                            RX_CALL_REFCOUNT_ALIVE);
1903         }
1904     } else {                    /* Client connection */
1905         char dummy;
1906         /* Make sure server receives input packets, in the case where
1907          * no reply arguments are expected */
1908         if ((call->mode == RX_MODE_SENDING)
1909             || (call->mode == RX_MODE_RECEIVING && call->rnext == 1)) {
1910             (void)rxi_ReadProc(call, &dummy, 1);
1911         }
1912
1913         /* If we had an outstanding delayed ack, be nice to the server
1914          * and force-send it now.
1915          */
1916         if (call->delayedAckEvent) {
1917             rxevent_Cancel(call->delayedAckEvent, call,
1918                            RX_CALL_REFCOUNT_DELAY);
1919             call->delayedAckEvent = NULL;
1920             rxi_SendDelayedAck(NULL, call, NULL);
1921         }
1922
1923         /* We need to release the call lock since it's lower than the
1924          * conn_call_lock and we don't want to hold the conn_call_lock
1925          * over the rx_ReadProc call. The conn_call_lock needs to be held
1926          * here for the case where rx_NewCall is perusing the calls on
1927          * the connection structure. We don't want to signal until
1928          * rx_NewCall is in a stable state. Otherwise, rx_NewCall may
1929          * have checked this call, found it active and by the time it
1930          * goes to sleep, will have missed the signal.
1931          *
1932          * Do not clear the RX_CONN_MAKECALL_WAITING flag as long as
1933          * there are threads waiting to use the conn object.
1934          */
1935         MUTEX_EXIT(&call->lock);
1936         MUTEX_ENTER(&conn->conn_call_lock);
1937         MUTEX_ENTER(&call->lock);
1938         MUTEX_ENTER(&conn->conn_data_lock);
1939         conn->flags |= RX_CONN_BUSY;
1940         if (conn->flags & RX_CONN_MAKECALL_WAITING) {
1941             if (conn->makeCallWaiters == 0)
1942                 conn->flags &= (~RX_CONN_MAKECALL_WAITING);
1943             MUTEX_EXIT(&conn->conn_data_lock);
1944 #ifdef  RX_ENABLE_LOCKS
1945             CV_BROADCAST(&conn->conn_call_cv);
1946 #else
1947             osi_rxWakeup(conn);
1948 #endif
1949         }
1950 #ifdef RX_ENABLE_LOCKS
1951         else {
1952             MUTEX_EXIT(&conn->conn_data_lock);
1953         }
1954 #endif /* RX_ENABLE_LOCKS */
1955         call->state = RX_STATE_DALLY;
1956     }
1957     error = call->error;
1958
1959     /* currentPacket, nLeft, and NFree must be zeroed here, because
1960      * ResetCall cannot: ResetCall may be called at splnet(), in the
1961      * kernel version, and may interrupt the macros rx_Read or
1962      * rx_Write, which run at normal priority for efficiency. */
1963     if (call->currentPacket) {
1964         queue_Prepend(&call->iovq, call->currentPacket);
1965         call->currentPacket = (struct rx_packet *)0;
1966     }
1967         
1968     call->nLeft = call->nFree = call->curlen = 0;
1969
1970     /* Free any packets from the last call to ReadvProc/WritevProc */
1971     rxi_FreePackets(0, &call->iovq);
1972
1973     CALL_RELE(call, RX_CALL_REFCOUNT_BEGIN);
1974     MUTEX_EXIT(&call->lock);
1975     if (conn->type == RX_CLIENT_CONNECTION) {
1976         MUTEX_EXIT(&conn->conn_call_lock);
1977         conn->flags &= ~RX_CONN_BUSY;
1978     }
1979     USERPRI;
1980     /*
1981      * Map errors to the local host's errno.h format.
1982      */
1983     error = ntoh_syserr_conv(error);
1984     return error;
1985 }
1986
1987 #if !defined(KERNEL)
1988
1989 /* Call this routine when shutting down a server or client (especially
1990  * clients).  This will allow Rx to gracefully garbage collect server
1991  * connections, and reduce the number of retries that a server might
1992  * make to a dead client.
1993  * This is not quite right, since some calls may still be ongoing and
1994  * we can't lock them to destroy them. */
1995 void
1996 rx_Finalize(void)
1997 {
1998     register struct rx_connection **conn_ptr, **conn_end;
1999
2000     INIT_PTHREAD_LOCKS;
2001     LOCK_RX_INIT;
2002     if (rxinit_status == 1) {
2003         UNLOCK_RX_INIT;
2004         return;                 /* Already shutdown. */
2005     }
2006     rxi_DeleteCachedConnections();
2007     if (rx_connHashTable) {
2008         MUTEX_ENTER(&rx_connHashTable_lock);
2009         for (conn_ptr = &rx_connHashTable[0], conn_end =
2010              &rx_connHashTable[rx_hashTableSize]; conn_ptr < conn_end;
2011              conn_ptr++) {
2012             struct rx_connection *conn, *next;
2013             for (conn = *conn_ptr; conn; conn = next) {
2014                 next = conn->next;
2015                 if (conn->type == RX_CLIENT_CONNECTION) {
2016                     /* MUTEX_ENTER(&conn->conn_data_lock); when used in kernel */
2017                     conn->refCount++;
2018                     /* MUTEX_EXIT(&conn->conn_data_lock); when used in kernel */
2019 #ifdef RX_ENABLE_LOCKS
2020                     rxi_DestroyConnectionNoLock(conn);
2021 #else /* RX_ENABLE_LOCKS */
2022                     rxi_DestroyConnection(conn);
2023 #endif /* RX_ENABLE_LOCKS */
2024                 }
2025             }
2026         }
2027 #ifdef RX_ENABLE_LOCKS
2028         while (rx_connCleanup_list) {
2029             struct rx_connection *conn;
2030             conn = rx_connCleanup_list;
2031             rx_connCleanup_list = rx_connCleanup_list->next;
2032             MUTEX_EXIT(&rx_connHashTable_lock);
2033             rxi_CleanupConnection(conn);
2034             MUTEX_ENTER(&rx_connHashTable_lock);
2035         }
2036         MUTEX_EXIT(&rx_connHashTable_lock);
2037 #endif /* RX_ENABLE_LOCKS */
2038     }
2039     rxi_flushtrace();
2040
2041 #ifdef AFS_NT40_ENV
2042     afs_winsockCleanup();
2043 #endif
2044
2045     rxinit_status = 1;
2046     UNLOCK_RX_INIT;
2047 }
2048 #endif
2049
2050 /* if we wakeup packet waiter too often, can get in loop with two
2051     AllocSendPackets each waking each other up (from ReclaimPacket calls) */
2052 void
2053 rxi_PacketsUnWait(void)
2054 {
2055     if (!rx_waitingForPackets) {
2056         return;
2057     }
2058 #ifdef KERNEL
2059     if (rxi_OverQuota(RX_PACKET_CLASS_SEND)) {
2060         return;                 /* still over quota */
2061     }
2062 #endif /* KERNEL */
2063     rx_waitingForPackets = 0;
2064 #ifdef  RX_ENABLE_LOCKS
2065     CV_BROADCAST(&rx_waitingForPackets_cv);
2066 #else
2067     osi_rxWakeup(&rx_waitingForPackets);
2068 #endif
2069     return;
2070 }
2071
2072
2073 /* ------------------Internal interfaces------------------------- */
2074
2075 /* Return this process's service structure for the
2076  * specified socket and service */
2077 struct rx_service *
2078 rxi_FindService(register osi_socket socket, register u_short serviceId)
2079 {
2080     register struct rx_service **sp;
2081     for (sp = &rx_services[0]; *sp; sp++) {
2082         if ((*sp)->serviceId == serviceId && (*sp)->socket == socket)
2083             return *sp;
2084     }
2085     return 0;
2086 }
2087
2088 /* Allocate a call structure, for the indicated channel of the
2089  * supplied connection.  The mode and state of the call must be set by
2090  * the caller. Returns the call with mutex locked. */
2091 struct rx_call *
2092 rxi_NewCall(register struct rx_connection *conn, register int channel)
2093 {
2094     register struct rx_call *call;
2095 #ifdef  AFS_GLOBAL_RXLOCK_KERNEL
2096     register struct rx_call *cp;        /* Call pointer temp */
2097     register struct rx_call *nxp;       /* Next call pointer, for queue_Scan */
2098 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
2099
2100     dpf(("rxi_NewCall(conn %x, channel %d)\n", conn, channel));
2101
2102     /* Grab an existing call structure, or allocate a new one.
2103      * Existing call structures are assumed to have been left reset by
2104      * rxi_FreeCall */
2105     MUTEX_ENTER(&rx_freeCallQueue_lock);
2106
2107 #ifdef  AFS_GLOBAL_RXLOCK_KERNEL
2108     /*
2109      * EXCEPT that the TQ might not yet be cleared out.
2110      * Skip over those with in-use TQs.
2111      */
2112     call = NULL;
2113     for (queue_Scan(&rx_freeCallQueue, cp, nxp, rx_call)) {
2114         if (!(cp->flags & RX_CALL_TQ_BUSY)) {
2115             call = cp;
2116             break;
2117         }
2118     }
2119     if (call) {
2120 #else /* AFS_GLOBAL_RXLOCK_KERNEL */
2121     if (queue_IsNotEmpty(&rx_freeCallQueue)) {
2122         call = queue_First(&rx_freeCallQueue, rx_call);
2123 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
2124         queue_Remove(call);
2125         MUTEX_ENTER(&rx_stats_mutex);
2126         rx_stats.nFreeCallStructs--;
2127         MUTEX_EXIT(&rx_stats_mutex);
2128         MUTEX_EXIT(&rx_freeCallQueue_lock);
2129         MUTEX_ENTER(&call->lock);
2130         CLEAR_CALL_QUEUE_LOCK(call);
2131 #ifdef  AFS_GLOBAL_RXLOCK_KERNEL
2132         /* Now, if TQ wasn't cleared earlier, do it now. */
2133         if (call->flags & RX_CALL_TQ_CLEARME) {
2134             rxi_ClearTransmitQueue(call, 0);
2135             queue_Init(&call->tq);
2136         }
2137 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
2138         /* Bind the call to its connection structure */
2139         call->conn = conn;
2140         rxi_ResetCall(call, 1);
2141     } else {
2142         call = (struct rx_call *)rxi_Alloc(sizeof(struct rx_call));
2143
2144         MUTEX_EXIT(&rx_freeCallQueue_lock);
2145         MUTEX_INIT(&call->lock, "call lock", MUTEX_DEFAULT, NULL);
2146         MUTEX_ENTER(&call->lock);
2147         CV_INIT(&call->cv_twind, "call twind", CV_DEFAULT, 0);
2148         CV_INIT(&call->cv_rq, "call rq", CV_DEFAULT, 0);
2149         CV_INIT(&call->cv_tq, "call tq", CV_DEFAULT, 0);
2150
2151         MUTEX_ENTER(&rx_stats_mutex);
2152         rx_stats.nCallStructs++;
2153         MUTEX_EXIT(&rx_stats_mutex);
2154         /* Initialize once-only items */
2155         queue_Init(&call->tq);
2156         queue_Init(&call->rq);
2157         queue_Init(&call->iovq);
2158         /* Bind the call to its connection structure (prereq for reset) */
2159         call->conn = conn;
2160         rxi_ResetCall(call, 1);
2161     }
2162     call->channel = channel;
2163     call->callNumber = &conn->callNumber[channel];
2164     /* Note that the next expected call number is retained (in
2165      * conn->callNumber[i]), even if we reallocate the call structure
2166      */
2167     conn->call[channel] = call;
2168     /* if the channel's never been used (== 0), we should start at 1, otherwise
2169      * the call number is valid from the last time this channel was used */
2170     if (*call->callNumber == 0)
2171         *call->callNumber = 1;
2172
2173     return call;
2174 }
2175
2176 /* A call has been inactive long enough that so we can throw away
2177  * state, including the call structure, which is placed on the call
2178  * free list.
2179  * Call is locked upon entry.
2180  * haveCTLock set if called from rxi_ReapConnections
2181  */
2182 #ifdef RX_ENABLE_LOCKS
2183 void
2184 rxi_FreeCall(register struct rx_call *call, int haveCTLock)
2185 #else /* RX_ENABLE_LOCKS */
2186 void
2187 rxi_FreeCall(register struct rx_call *call)
2188 #endif                          /* RX_ENABLE_LOCKS */
2189 {
2190     register int channel = call->channel;
2191     register struct rx_connection *conn = call->conn;
2192
2193
2194     if (call->state == RX_STATE_DALLY || call->state == RX_STATE_HOLD)
2195         (*call->callNumber)++;
2196     rxi_ResetCall(call, 0);
2197     call->conn->call[channel] = (struct rx_call *)0;
2198
2199     MUTEX_ENTER(&rx_freeCallQueue_lock);
2200     SET_CALL_QUEUE_LOCK(call, &rx_freeCallQueue_lock);
2201 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
2202     /* A call may be free even though its transmit queue is still in use.
2203      * Since we search the call list from head to tail, put busy calls at
2204      * the head of the list, and idle calls at the tail.
2205      */
2206     if (call->flags & RX_CALL_TQ_BUSY)
2207         queue_Prepend(&rx_freeCallQueue, call);
2208     else
2209         queue_Append(&rx_freeCallQueue, call);
2210 #else /* AFS_GLOBAL_RXLOCK_KERNEL */
2211     queue_Append(&rx_freeCallQueue, call);
2212 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
2213     MUTEX_ENTER(&rx_stats_mutex);
2214     rx_stats.nFreeCallStructs++;
2215     MUTEX_EXIT(&rx_stats_mutex);
2216
2217     MUTEX_EXIT(&rx_freeCallQueue_lock);
2218
2219     /* Destroy the connection if it was previously slated for
2220      * destruction, i.e. the Rx client code previously called
2221      * rx_DestroyConnection (client connections), or
2222      * rxi_ReapConnections called the same routine (server
2223      * connections).  Only do this, however, if there are no
2224      * outstanding calls. Note that for fine grain locking, there appears
2225      * to be a deadlock in that rxi_FreeCall has a call locked and
2226      * DestroyConnectionNoLock locks each call in the conn. But note a
2227      * few lines up where we have removed this call from the conn.
2228      * If someone else destroys a connection, they either have no
2229      * call lock held or are going through this section of code.
2230      */
2231     if (conn->flags & RX_CONN_DESTROY_ME && !(conn->flags & RX_CONN_MAKECALL_WAITING)) {
2232         MUTEX_ENTER(&conn->conn_data_lock);
2233         conn->refCount++;
2234         MUTEX_EXIT(&conn->conn_data_lock);
2235 #ifdef RX_ENABLE_LOCKS
2236         if (haveCTLock)
2237             rxi_DestroyConnectionNoLock(conn);
2238         else
2239             rxi_DestroyConnection(conn);
2240 #else /* RX_ENABLE_LOCKS */
2241         rxi_DestroyConnection(conn);
2242 #endif /* RX_ENABLE_LOCKS */
2243     }
2244 }
2245
2246 afs_int32 rxi_Alloccnt = 0, rxi_Allocsize = 0;
2247 char *
2248 rxi_Alloc(register size_t size)
2249 {
2250     register char *p;
2251
2252     MUTEX_ENTER(&rx_stats_mutex);
2253     rxi_Alloccnt++;
2254     rxi_Allocsize += (afs_int32)size;
2255     MUTEX_EXIT(&rx_stats_mutex);
2256
2257     p = (char *)osi_Alloc(size);
2258
2259     if (!p)
2260         osi_Panic("rxi_Alloc error");
2261     memset(p, 0, size);
2262     return p;
2263 }
2264
2265 void
2266 rxi_Free(void *addr, register size_t size)
2267 {
2268     MUTEX_ENTER(&rx_stats_mutex);
2269     rxi_Alloccnt--;
2270     rxi_Allocsize -= (afs_int32)size;
2271     MUTEX_EXIT(&rx_stats_mutex);
2272
2273     osi_Free(addr, size);
2274 }
2275
2276 /* Find the peer process represented by the supplied (host,port)
2277  * combination.  If there is no appropriate active peer structure, a
2278  * new one will be allocated and initialized 
2279  * The origPeer, if set, is a pointer to a peer structure on which the
2280  * refcount will be be decremented. This is used to replace the peer
2281  * structure hanging off a connection structure */
2282 struct rx_peer *
2283 rxi_FindPeer(register afs_uint32 host, register u_short port,
2284              struct rx_peer *origPeer, int create)
2285 {
2286     register struct rx_peer *pp;
2287     int hashIndex;
2288     hashIndex = PEER_HASH(host, port);
2289     MUTEX_ENTER(&rx_peerHashTable_lock);
2290     for (pp = rx_peerHashTable[hashIndex]; pp; pp = pp->next) {
2291         if ((pp->host == host) && (pp->port == port))
2292             break;
2293     }
2294     if (!pp) {
2295         if (create) {
2296             pp = rxi_AllocPeer();       /* This bzero's *pp */
2297             pp->host = host;    /* set here or in InitPeerParams is zero */
2298             pp->port = port;
2299             MUTEX_INIT(&pp->peer_lock, "peer_lock", MUTEX_DEFAULT, 0);
2300             queue_Init(&pp->congestionQueue);
2301             queue_Init(&pp->rpcStats);
2302             pp->next = rx_peerHashTable[hashIndex];
2303             rx_peerHashTable[hashIndex] = pp;
2304             rxi_InitPeerParams(pp);
2305             MUTEX_ENTER(&rx_stats_mutex);
2306             rx_stats.nPeerStructs++;
2307             MUTEX_EXIT(&rx_stats_mutex);
2308         }
2309     }
2310     if (pp && create) {
2311         pp->refCount++;
2312     }
2313     if (origPeer)
2314         origPeer->refCount--;
2315     MUTEX_EXIT(&rx_peerHashTable_lock);
2316     return pp;
2317 }
2318
2319
2320 /* Find the connection at (host, port) started at epoch, and with the
2321  * given connection id.  Creates the server connection if necessary.
2322  * The type specifies whether a client connection or a server
2323  * connection is desired.  In both cases, (host, port) specify the
2324  * peer's (host, pair) pair.  Client connections are not made
2325  * automatically by this routine.  The parameter socket gives the
2326  * socket descriptor on which the packet was received.  This is used,
2327  * in the case of server connections, to check that *new* connections
2328  * come via a valid (port, serviceId).  Finally, the securityIndex
2329  * parameter must match the existing index for the connection.  If a
2330  * server connection is created, it will be created using the supplied
2331  * index, if the index is valid for this service */
2332 struct rx_connection *
2333 rxi_FindConnection(osi_socket socket, register afs_int32 host,
2334                    register u_short port, u_short serviceId, afs_uint32 cid,
2335                    afs_uint32 epoch, int type, u_int securityIndex)
2336 {
2337     int hashindex, flag;
2338     register struct rx_connection *conn;
2339     hashindex = CONN_HASH(host, port, cid, epoch, type);
2340     MUTEX_ENTER(&rx_connHashTable_lock);
2341     rxLastConn ? (conn = rxLastConn, flag = 0) : (conn =
2342                                                   rx_connHashTable[hashindex],
2343                                                   flag = 1);
2344     for (; conn;) {
2345         if ((conn->type == type) && ((cid & RX_CIDMASK) == conn->cid)
2346             && (epoch == conn->epoch)) {
2347             register struct rx_peer *pp = conn->peer;
2348             if (securityIndex != conn->securityIndex) {
2349                 /* this isn't supposed to happen, but someone could forge a packet
2350                  * like this, and there seems to be some CM bug that makes this
2351                  * happen from time to time -- in which case, the fileserver
2352                  * asserts. */
2353                 MUTEX_EXIT(&rx_connHashTable_lock);
2354                 return (struct rx_connection *)0;
2355             }
2356             if (pp->host == host && pp->port == port)
2357                 break;
2358             if (type == RX_CLIENT_CONNECTION && pp->port == port)
2359                 break;
2360             /* So what happens when it's a callback connection? */
2361             if (                /*type == RX_CLIENT_CONNECTION && */
2362                    (conn->epoch & 0x80000000))
2363                 break;
2364         }
2365         if (!flag) {
2366             /* the connection rxLastConn that was used the last time is not the
2367              ** one we are looking for now. Hence, start searching in the hash */
2368             flag = 1;
2369             conn = rx_connHashTable[hashindex];
2370         } else
2371             conn = conn->next;
2372     }
2373     if (!conn) {
2374         struct rx_service *service;
2375         if (type == RX_CLIENT_CONNECTION) {
2376             MUTEX_EXIT(&rx_connHashTable_lock);
2377             return (struct rx_connection *)0;
2378         }
2379         service = rxi_FindService(socket, serviceId);
2380         if (!service || (securityIndex >= service->nSecurityObjects)
2381             || (service->securityObjects[securityIndex] == 0)) {
2382             MUTEX_EXIT(&rx_connHashTable_lock);
2383             return (struct rx_connection *)0;
2384         }
2385         conn = rxi_AllocConnection();   /* This bzero's the connection */
2386         MUTEX_INIT(&conn->conn_call_lock, "conn call lock", MUTEX_DEFAULT, 0);
2387         MUTEX_INIT(&conn->conn_data_lock, "conn data lock", MUTEX_DEFAULT, 0);
2388         CV_INIT(&conn->conn_call_cv, "conn call cv", CV_DEFAULT, 0);
2389         conn->next = rx_connHashTable[hashindex];
2390         rx_connHashTable[hashindex] = conn;
2391         conn->peer = rxi_FindPeer(host, port, 0, 1);
2392         conn->type = RX_SERVER_CONNECTION;
2393         conn->lastSendTime = clock_Sec();       /* don't GC immediately */
2394         conn->epoch = epoch;
2395         conn->cid = cid & RX_CIDMASK;
2396         /* conn->serial = conn->lastSerial = 0; */
2397         /* conn->timeout = 0; */
2398         conn->ackRate = RX_FAST_ACK_RATE;
2399         conn->service = service;
2400         conn->serviceId = serviceId;
2401         conn->securityIndex = securityIndex;
2402         conn->securityObject = service->securityObjects[securityIndex];
2403         conn->nSpecific = 0;
2404         conn->specific = NULL;
2405         rx_SetConnDeadTime(conn, service->connDeadTime);
2406         rx_SetConnIdleDeadTime(conn, service->idleDeadTime);
2407         /* Notify security object of the new connection */
2408         RXS_NewConnection(conn->securityObject, conn);
2409         /* XXXX Connection timeout? */
2410         if (service->newConnProc)
2411             (*service->newConnProc) (conn);
2412         MUTEX_ENTER(&rx_stats_mutex);
2413         rx_stats.nServerConns++;
2414         MUTEX_EXIT(&rx_stats_mutex);
2415     }
2416
2417     MUTEX_ENTER(&conn->conn_data_lock);
2418     conn->refCount++;
2419     MUTEX_EXIT(&conn->conn_data_lock);
2420
2421     rxLastConn = conn;          /* store this connection as the last conn used */
2422     MUTEX_EXIT(&rx_connHashTable_lock);
2423     return conn;
2424 }
2425
2426 /* There are two packet tracing routines available for testing and monitoring
2427  * Rx.  One is called just after every packet is received and the other is
2428  * called just before every packet is sent.  Received packets, have had their
2429  * headers decoded, and packets to be sent have not yet had their headers
2430  * encoded.  Both take two parameters: a pointer to the packet and a sockaddr
2431  * containing the network address.  Both can be modified.  The return value, if
2432  * non-zero, indicates that the packet should be dropped.  */
2433
2434 int (*rx_justReceived) () = 0;
2435 int (*rx_almostSent) () = 0;
2436
2437 /* A packet has been received off the interface.  Np is the packet, socket is
2438  * the socket number it was received from (useful in determining which service
2439  * this packet corresponds to), and (host, port) reflect the host,port of the
2440  * sender.  This call returns the packet to the caller if it is finished with
2441  * it, rather than de-allocating it, just as a small performance hack */
2442
2443 struct rx_packet *
2444 rxi_ReceivePacket(register struct rx_packet *np, osi_socket socket,
2445                   afs_uint32 host, u_short port, int *tnop,
2446                   struct rx_call **newcallp)
2447 {
2448     register struct rx_call *call;
2449     register struct rx_connection *conn;
2450     int channel;
2451     afs_uint32 currentCallNumber;
2452     int type;
2453     int skew;
2454 #ifdef RXDEBUG
2455     char *packetType;
2456 #endif
2457     struct rx_packet *tnp;
2458
2459 #ifdef RXDEBUG
2460 /* We don't print out the packet until now because (1) the time may not be
2461  * accurate enough until now in the lwp implementation (rx_Listener only gets
2462  * the time after the packet is read) and (2) from a protocol point of view,
2463  * this is the first time the packet has been seen */
2464     packetType = (np->header.type > 0 && np->header.type < RX_N_PACKET_TYPES)
2465         ? rx_packetTypes[np->header.type - 1] : "*UNKNOWN*";
2466     dpf(("R %d %s: %x.%d.%d.%d.%d.%d.%d flags %d, packet %x",
2467          np->header.serial, packetType, ntohl(host), ntohs(port), np->header.serviceId,
2468          np->header.epoch, np->header.cid, np->header.callNumber,
2469          np->header.seq, np->header.flags, np));
2470 #endif
2471
2472     if (np->header.type == RX_PACKET_TYPE_VERSION) {
2473         return rxi_ReceiveVersionPacket(np, socket, host, port, 1);
2474     }
2475
2476     if (np->header.type == RX_PACKET_TYPE_DEBUG) {
2477         return rxi_ReceiveDebugPacket(np, socket, host, port, 1);
2478     }
2479 #ifdef RXDEBUG
2480     /* If an input tracer function is defined, call it with the packet and
2481      * network address.  Note this function may modify its arguments. */
2482     if (rx_justReceived) {
2483         struct sockaddr_in addr;
2484         int drop;
2485         addr.sin_family = AF_INET;
2486         addr.sin_port = port;
2487         addr.sin_addr.s_addr = host;
2488 #ifdef STRUCT_SOCKADDR_HAS_SA_LEN
2489         addr.sin_len = sizeof(addr);
2490 #endif /* AFS_OSF_ENV */
2491         drop = (*rx_justReceived) (np, &addr);
2492         /* drop packet if return value is non-zero */
2493         if (drop)
2494             return np;
2495         port = addr.sin_port;   /* in case fcn changed addr */
2496         host = addr.sin_addr.s_addr;
2497     }
2498 #endif
2499
2500     /* If packet was not sent by the client, then *we* must be the client */
2501     type = ((np->header.flags & RX_CLIENT_INITIATED) != RX_CLIENT_INITIATED)
2502         ? RX_CLIENT_CONNECTION : RX_SERVER_CONNECTION;
2503
2504     /* Find the connection (or fabricate one, if we're the server & if
2505      * necessary) associated with this packet */
2506     conn =
2507         rxi_FindConnection(socket, host, port, np->header.serviceId,
2508                            np->header.cid, np->header.epoch, type,
2509                            np->header.securityIndex);
2510
2511     if (!conn) {
2512         /* If no connection found or fabricated, just ignore the packet.
2513          * (An argument could be made for sending an abort packet for
2514          * the conn) */
2515         return np;
2516     }
2517
2518     MUTEX_ENTER(&conn->conn_data_lock);
2519     if (conn->maxSerial < np->header.serial)
2520         conn->maxSerial = np->header.serial;
2521     MUTEX_EXIT(&conn->conn_data_lock);
2522
2523     /* If the connection is in an error state, send an abort packet and ignore
2524      * the incoming packet */
2525     if (conn->error) {
2526         /* Don't respond to an abort packet--we don't want loops! */
2527         MUTEX_ENTER(&conn->conn_data_lock);
2528         if (np->header.type != RX_PACKET_TYPE_ABORT)
2529             np = rxi_SendConnectionAbort(conn, np, 1, 0);
2530         conn->refCount--;
2531         MUTEX_EXIT(&conn->conn_data_lock);
2532         return np;
2533     }
2534
2535     /* Check for connection-only requests (i.e. not call specific). */
2536     if (np->header.callNumber == 0) {
2537         switch (np->header.type) {
2538         case RX_PACKET_TYPE_ABORT: {
2539             /* What if the supplied error is zero? */
2540             afs_int32 errcode = ntohl(rx_GetInt32(np, 0));
2541             dpf(("rxi_ReceivePacket ABORT rx_GetInt32 = %d", errcode));
2542             rxi_ConnectionError(conn, errcode);
2543             MUTEX_ENTER(&conn->conn_data_lock);
2544             conn->refCount--;
2545             MUTEX_EXIT(&conn->conn_data_lock);
2546             return np;
2547         }
2548         case RX_PACKET_TYPE_CHALLENGE:
2549             tnp = rxi_ReceiveChallengePacket(conn, np, 1);
2550             MUTEX_ENTER(&conn->conn_data_lock);
2551             conn->refCount--;
2552             MUTEX_EXIT(&conn->conn_data_lock);
2553             return tnp;
2554         case RX_PACKET_TYPE_RESPONSE:
2555             tnp = rxi_ReceiveResponsePacket(conn, np, 1);
2556             MUTEX_ENTER(&conn->conn_data_lock);
2557             conn->refCount--;
2558             MUTEX_EXIT(&conn->conn_data_lock);
2559             return tnp;
2560         case RX_PACKET_TYPE_PARAMS:
2561         case RX_PACKET_TYPE_PARAMS + 1:
2562         case RX_PACKET_TYPE_PARAMS + 2:
2563             /* ignore these packet types for now */
2564             MUTEX_ENTER(&conn->conn_data_lock);
2565             conn->refCount--;
2566             MUTEX_EXIT(&conn->conn_data_lock);
2567             return np;
2568
2569
2570         default:
2571             /* Should not reach here, unless the peer is broken: send an
2572              * abort packet */
2573             rxi_ConnectionError(conn, RX_PROTOCOL_ERROR);
2574             MUTEX_ENTER(&conn->conn_data_lock);
2575             tnp = rxi_SendConnectionAbort(conn, np, 1, 0);
2576             conn->refCount--;
2577             MUTEX_EXIT(&conn->conn_data_lock);
2578             return tnp;
2579         }
2580     }
2581
2582     channel = np->header.cid & RX_CHANNELMASK;
2583     call = conn->call[channel];
2584 #ifdef  RX_ENABLE_LOCKS
2585     if (call)
2586         MUTEX_ENTER(&call->lock);
2587     /* Test to see if call struct is still attached to conn. */
2588     if (call != conn->call[channel]) {
2589         if (call)
2590             MUTEX_EXIT(&call->lock);
2591         if (type == RX_SERVER_CONNECTION) {
2592             call = conn->call[channel];
2593             /* If we started with no call attached and there is one now,
2594              * another thread is also running this routine and has gotten
2595              * the connection channel. We should drop this packet in the tests
2596              * below. If there was a call on this connection and it's now
2597              * gone, then we'll be making a new call below.
2598              * If there was previously a call and it's now different then
2599              * the old call was freed and another thread running this routine
2600              * has created a call on this channel. One of these two threads
2601              * has a packet for the old call and the code below handles those
2602              * cases.
2603              */
2604             if (call)
2605                 MUTEX_ENTER(&call->lock);
2606         } else {
2607             /* This packet can't be for this call. If the new call address is
2608              * 0 then no call is running on this channel. If there is a call
2609              * then, since this is a client connection we're getting data for
2610              * it must be for the previous call.
2611              */
2612             MUTEX_ENTER(&rx_stats_mutex);
2613             rx_stats.spuriousPacketsRead++;
2614             MUTEX_EXIT(&rx_stats_mutex);
2615             MUTEX_ENTER(&conn->conn_data_lock);
2616             conn->refCount--;
2617             MUTEX_EXIT(&conn->conn_data_lock);
2618             return np;
2619         }
2620     }
2621 #endif
2622     currentCallNumber = conn->callNumber[channel];
2623
2624     if (type == RX_SERVER_CONNECTION) { /* We're the server */
2625         if (np->header.callNumber < currentCallNumber) {
2626             MUTEX_ENTER(&rx_stats_mutex);
2627             rx_stats.spuriousPacketsRead++;
2628             MUTEX_EXIT(&rx_stats_mutex);
2629 #ifdef  RX_ENABLE_LOCKS
2630             if (call)
2631                 MUTEX_EXIT(&call->lock);
2632 #endif
2633             MUTEX_ENTER(&conn->conn_data_lock);
2634             conn->refCount--;
2635             MUTEX_EXIT(&conn->conn_data_lock);
2636             return np;
2637         }
2638         if (!call) {
2639             MUTEX_ENTER(&conn->conn_call_lock);
2640             call = rxi_NewCall(conn, channel);
2641             MUTEX_EXIT(&conn->conn_call_lock);
2642             *call->callNumber = np->header.callNumber;
2643             if (np->header.callNumber == 0) 
2644                 dpf(("RecPacket call 0 %d %s: %x.%u.%u.%u.%u.%u.%u flags %d, packet %lx resend %d.%0.3d len %d", np->header.serial, rx_packetTypes[np->header.type - 1], ntohl(conn->peer->host), ntohs(conn->peer->port), np->header.serial, np->header.epoch, np->header.cid, np->header.callNumber, np->header.seq, np->header.flags, (unsigned long)np, np->retryTime.sec, np->retryTime.usec / 1000, np->length));
2645
2646             call->state = RX_STATE_PRECALL;
2647             clock_GetTime(&call->queueTime);
2648             hzero(call->bytesSent);
2649             hzero(call->bytesRcvd);
2650             /*
2651              * If the number of queued calls exceeds the overload
2652              * threshold then abort this call.
2653              */
2654             if ((rx_BusyThreshold > 0) && (rx_nWaiting > rx_BusyThreshold)) {
2655                 struct rx_packet *tp;
2656                 
2657                 rxi_CallError(call, rx_BusyError);
2658                 tp = rxi_SendCallAbort(call, np, 1, 0);
2659                 MUTEX_EXIT(&call->lock);
2660                 MUTEX_ENTER(&conn->conn_data_lock);
2661                 conn->refCount--;
2662                 MUTEX_EXIT(&conn->conn_data_lock);
2663                 MUTEX_ENTER(&rx_stats_mutex);
2664                 rx_stats.nBusies++;
2665                 MUTEX_EXIT(&rx_stats_mutex);
2666                 return tp;
2667             }
2668             rxi_KeepAliveOn(call);
2669         } else if (np->header.callNumber != currentCallNumber) {
2670             /* Wait until the transmit queue is idle before deciding
2671              * whether to reset the current call. Chances are that the
2672              * call will be in ether DALLY or HOLD state once the TQ_BUSY
2673              * flag is cleared.
2674              */
2675 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
2676             while ((call->state == RX_STATE_ACTIVE)
2677                    && (call->flags & RX_CALL_TQ_BUSY)) {
2678                 call->flags |= RX_CALL_TQ_WAIT;
2679                 call->tqWaiters++;
2680 #ifdef RX_ENABLE_LOCKS
2681                 osirx_AssertMine(&call->lock, "rxi_Start lock3");
2682                 CV_WAIT(&call->cv_tq, &call->lock);
2683 #else /* RX_ENABLE_LOCKS */
2684                 osi_rxSleep(&call->tq);
2685 #endif /* RX_ENABLE_LOCKS */
2686                 call->tqWaiters--;
2687                 if (call->tqWaiters == 0)
2688                     call->flags &= ~RX_CALL_TQ_WAIT;
2689             }
2690 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
2691             /* If the new call cannot be taken right now send a busy and set
2692              * the error condition in this call, so that it terminates as
2693              * quickly as possible */
2694             if (call->state == RX_STATE_ACTIVE) {
2695                 struct rx_packet *tp;
2696
2697                 rxi_CallError(call, RX_CALL_DEAD);
2698                 tp = rxi_SendSpecial(call, conn, np, RX_PACKET_TYPE_BUSY,
2699                                      NULL, 0, 1);
2700                 MUTEX_EXIT(&call->lock);
2701                 MUTEX_ENTER(&conn->conn_data_lock);
2702                 conn->refCount--;
2703                 MUTEX_EXIT(&conn->conn_data_lock);
2704                 return tp;
2705             }
2706             rxi_ResetCall(call, 0);
2707             *call->callNumber = np->header.callNumber;
2708             if (np->header.callNumber == 0) 
2709                 dpf(("RecPacket call 0 %d %s: %x.%u.%u.%u.%u.%u.%u flags %d, packet %lx resend %d.%0.3d len %d", np->header.serial, rx_packetTypes[np->header.type - 1], ntohl(conn->peer->host), ntohs(conn->peer->port), np->header.serial, np->header.epoch, np->header.cid, np->header.callNumber, np->header.seq, np->header.flags, (unsigned long)np, np->retryTime.sec, np->retryTime.usec / 1000, np->length));
2710
2711             call->state = RX_STATE_PRECALL;
2712             clock_GetTime(&call->queueTime);
2713             hzero(call->bytesSent);
2714             hzero(call->bytesRcvd);
2715             /*
2716              * If the number of queued calls exceeds the overload
2717              * threshold then abort this call.
2718              */
2719             if ((rx_BusyThreshold > 0) && (rx_nWaiting > rx_BusyThreshold)) {
2720                 struct rx_packet *tp;
2721
2722                 rxi_CallError(call, rx_BusyError);
2723                 tp = rxi_SendCallAbort(call, np, 1, 0);
2724                 MUTEX_EXIT(&call->lock);
2725                 MUTEX_ENTER(&conn->conn_data_lock);
2726                 conn->refCount--;
2727                 MUTEX_EXIT(&conn->conn_data_lock);
2728                 MUTEX_ENTER(&rx_stats_mutex);
2729                 rx_stats.nBusies++;
2730                 MUTEX_EXIT(&rx_stats_mutex);
2731                 return tp;
2732             }
2733             rxi_KeepAliveOn(call);
2734         } else {
2735             /* Continuing call; do nothing here. */
2736         }
2737     } else {                    /* we're the client */
2738         /* Ignore all incoming acknowledgements for calls in DALLY state */
2739         if (call && (call->state == RX_STATE_DALLY)
2740             && (np->header.type == RX_PACKET_TYPE_ACK)) {
2741             MUTEX_ENTER(&rx_stats_mutex);
2742             rx_stats.ignorePacketDally++;
2743             MUTEX_EXIT(&rx_stats_mutex);
2744 #ifdef  RX_ENABLE_LOCKS
2745             if (call) {
2746                 MUTEX_EXIT(&call->lock);
2747             }
2748 #endif
2749             MUTEX_ENTER(&conn->conn_data_lock);
2750             conn->refCount--;
2751             MUTEX_EXIT(&conn->conn_data_lock);
2752             return np;
2753         }
2754
2755         /* Ignore anything that's not relevant to the current call.  If there
2756          * isn't a current call, then no packet is relevant. */
2757         if (!call || (np->header.callNumber != currentCallNumber)) {
2758             MUTEX_ENTER(&rx_stats_mutex);
2759             rx_stats.spuriousPacketsRead++;
2760             MUTEX_EXIT(&rx_stats_mutex);
2761 #ifdef  RX_ENABLE_LOCKS
2762             if (call) {
2763                 MUTEX_EXIT(&call->lock);
2764             }
2765 #endif
2766             MUTEX_ENTER(&conn->conn_data_lock);
2767             conn->refCount--;
2768             MUTEX_EXIT(&conn->conn_data_lock);
2769             return np;
2770         }
2771         /* If the service security object index stamped in the packet does not
2772          * match the connection's security index, ignore the packet */
2773         if (np->header.securityIndex != conn->securityIndex) {
2774 #ifdef  RX_ENABLE_LOCKS
2775             MUTEX_EXIT(&call->lock);
2776 #endif
2777             MUTEX_ENTER(&conn->conn_data_lock);
2778             conn->refCount--;
2779             MUTEX_EXIT(&conn->conn_data_lock);
2780             return np;
2781         }
2782
2783         /* If we're receiving the response, then all transmit packets are
2784          * implicitly acknowledged.  Get rid of them. */
2785         if (np->header.type == RX_PACKET_TYPE_DATA) {
2786 #ifdef  AFS_GLOBAL_RXLOCK_KERNEL
2787             /* XXX Hack. Because we must release the global rx lock when
2788              * sending packets (osi_NetSend) we drop all acks while we're
2789              * traversing the tq in rxi_Start sending packets out because
2790              * packets may move to the freePacketQueue as result of being here!
2791              * So we drop these packets until we're safely out of the
2792              * traversing. Really ugly! 
2793              * For fine grain RX locking, we set the acked field in the
2794              * packets and let rxi_Start remove them from the transmit queue.
2795              */
2796             if (call->flags & RX_CALL_TQ_BUSY) {
2797 #ifdef  RX_ENABLE_LOCKS
2798                 rxi_SetAcksInTransmitQueue(call);
2799 #else
2800                 conn->refCount--;
2801                 return np;      /* xmitting; drop packet */
2802 #endif
2803             } else {
2804                 rxi_ClearTransmitQueue(call, 0);
2805             }
2806 #else /* AFS_GLOBAL_RXLOCK_KERNEL */
2807             rxi_ClearTransmitQueue(call, 0);
2808 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
2809         } else {
2810             if (np->header.type == RX_PACKET_TYPE_ACK) {
2811                 /* now check to see if this is an ack packet acknowledging that the
2812                  * server actually *lost* some hard-acked data.  If this happens we
2813                  * ignore this packet, as it may indicate that the server restarted in
2814                  * the middle of a call.  It is also possible that this is an old ack
2815                  * packet.  We don't abort the connection in this case, because this
2816                  * *might* just be an old ack packet.  The right way to detect a server
2817                  * restart in the midst of a call is to notice that the server epoch
2818                  * changed, btw.  */
2819                 /* XXX I'm not sure this is exactly right, since tfirst **IS**
2820                  * XXX unacknowledged.  I think that this is off-by-one, but
2821                  * XXX I don't dare change it just yet, since it will
2822                  * XXX interact badly with the server-restart detection 
2823                  * XXX code in receiveackpacket.  */
2824                 if (ntohl(rx_GetInt32(np, FIRSTACKOFFSET)) < call->tfirst) {
2825                     MUTEX_ENTER(&rx_stats_mutex);
2826                     rx_stats.spuriousPacketsRead++;
2827                     MUTEX_EXIT(&rx_stats_mutex);
2828                     MUTEX_EXIT(&call->lock);
2829                     MUTEX_ENTER(&conn->conn_data_lock);
2830                     conn->refCount--;
2831                     MUTEX_EXIT(&conn->conn_data_lock);
2832                     return np;
2833                 }
2834             }
2835         }                       /* else not a data packet */
2836     }
2837
2838     osirx_AssertMine(&call->lock, "rxi_ReceivePacket middle");
2839     /* Set remote user defined status from packet */
2840     call->remoteStatus = np->header.userStatus;
2841
2842     /* Note the gap between the expected next packet and the actual
2843      * packet that arrived, when the new packet has a smaller serial number
2844      * than expected.  Rioses frequently reorder packets all by themselves,
2845      * so this will be quite important with very large window sizes.
2846      * Skew is checked against 0 here to avoid any dependence on the type of
2847      * inPacketSkew (which may be unsigned).  In C, -1 > (unsigned) 0 is always
2848      * true! 
2849      * The inPacketSkew should be a smoothed running value, not just a maximum.  MTUXXX
2850      * see CalculateRoundTripTime for an example of how to keep smoothed values.
2851      * I think using a beta of 1/8 is probably appropriate.  93.04.21
2852      */
2853     MUTEX_ENTER(&conn->conn_data_lock);
2854     skew = conn->lastSerial - np->header.serial;
2855     conn->lastSerial = np->header.serial;
2856     MUTEX_EXIT(&conn->conn_data_lock);
2857     if (skew > 0) {
2858         register struct rx_peer *peer;
2859         peer = conn->peer;
2860         if (skew > peer->inPacketSkew) {
2861             dpf(("*** In skew changed from %d to %d\n", peer->inPacketSkew,
2862                  skew));
2863             peer->inPacketSkew = skew;
2864         }
2865     }
2866
2867     /* Now do packet type-specific processing */
2868     switch (np->header.type) {
2869     case RX_PACKET_TYPE_DATA:
2870         np = rxi_ReceiveDataPacket(call, np, 1, socket, host, port, tnop,
2871                                    newcallp);
2872         break;
2873     case RX_PACKET_TYPE_ACK:
2874         /* Respond immediately to ack packets requesting acknowledgement
2875          * (ping packets) */
2876         if (np->header.flags & RX_REQUEST_ACK) {
2877             if (call->error)
2878                 (void)rxi_SendCallAbort(call, 0, 1, 0);
2879             else
2880                 (void)rxi_SendAck(call, 0, np->header.serial,
2881                                   RX_ACK_PING_RESPONSE, 1);
2882         }
2883         np = rxi_ReceiveAckPacket(call, np, 1);
2884         break;
2885     case RX_PACKET_TYPE_ABORT: {
2886         /* An abort packet: reset the call, passing the error up to the user. */
2887         /* What if error is zero? */
2888         /* What if the error is -1? the application will treat it as a timeout. */
2889         afs_int32 errdata = ntohl(*(afs_int32 *) rx_DataOf(np));
2890         dpf(("rxi_ReceivePacket ABORT rx_DataOf = %d", errdata));
2891         rxi_CallError(call, errdata);
2892         MUTEX_EXIT(&call->lock);
2893         MUTEX_ENTER(&conn->conn_data_lock);
2894         conn->refCount--;
2895         MUTEX_EXIT(&conn->conn_data_lock);
2896         return np;              /* xmitting; drop packet */
2897     }
2898     case RX_PACKET_TYPE_BUSY:
2899         /* XXXX */
2900         break;
2901     case RX_PACKET_TYPE_ACKALL:
2902         /* All packets acknowledged, so we can drop all packets previously
2903          * readied for sending */
2904 #ifdef  AFS_GLOBAL_RXLOCK_KERNEL
2905         /* XXX Hack. We because we can't release the global rx lock when
2906          * sending packets (osi_NetSend) we drop all ack pkts while we're
2907          * traversing the tq in rxi_Start sending packets out because
2908          * packets may move to the freePacketQueue as result of being
2909          * here! So we drop these packets until we're safely out of the
2910          * traversing. Really ugly! 
2911          * For fine grain RX locking, we set the acked field in the packets
2912          * and let rxi_Start remove the packets from the transmit queue.
2913          */
2914         if (call->flags & RX_CALL_TQ_BUSY) {
2915 #ifdef  RX_ENABLE_LOCKS
2916             rxi_SetAcksInTransmitQueue(call);
2917             break;
2918 #else /* RX_ENABLE_LOCKS */
2919             MUTEX_EXIT(&call->lock);
2920             MUTEX_ENTER(&conn->conn_data_lock);
2921             conn->refCount--;
2922             MUTEX_EXIT(&conn->conn_data_lock);
2923             return np;          /* xmitting; drop packet */
2924 #endif /* RX_ENABLE_LOCKS */
2925         }
2926 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
2927         rxi_ClearTransmitQueue(call, 0);
2928         break;
2929     default:
2930         /* Should not reach here, unless the peer is broken: send an abort
2931          * packet */
2932         rxi_CallError(call, RX_PROTOCOL_ERROR);
2933         np = rxi_SendCallAbort(call, np, 1, 0);
2934         break;
2935     };
2936     /* Note when this last legitimate packet was received, for keep-alive
2937      * processing.  Note, we delay getting the time until now in the hope that
2938      * the packet will be delivered to the user before any get time is required
2939      * (if not, then the time won't actually be re-evaluated here). */
2940     call->lastReceiveTime = clock_Sec();
2941     MUTEX_EXIT(&call->lock);
2942     MUTEX_ENTER(&conn->conn_data_lock);
2943     conn->refCount--;
2944     MUTEX_EXIT(&conn->conn_data_lock);
2945     return np;
2946 }
2947
2948 /* return true if this is an "interesting" connection from the point of view
2949     of someone trying to debug the system */
2950 int
2951 rxi_IsConnInteresting(struct rx_connection *aconn)
2952 {
2953     register int i;
2954     register struct rx_call *tcall;
2955
2956     if (aconn->flags & (RX_CONN_MAKECALL_WAITING | RX_CONN_DESTROY_ME))
2957         return 1;
2958     for (i = 0; i < RX_MAXCALLS; i++) {
2959         tcall = aconn->call[i];
2960         if (tcall) {
2961             if ((tcall->state == RX_STATE_PRECALL)
2962                 || (tcall->state == RX_STATE_ACTIVE))
2963                 return 1;
2964             if ((tcall->mode == RX_MODE_SENDING)
2965                 || (tcall->mode == RX_MODE_RECEIVING))
2966                 return 1;
2967         }
2968     }
2969     return 0;
2970 }
2971
2972 #ifdef KERNEL
2973 /* if this is one of the last few packets AND it wouldn't be used by the
2974    receiving call to immediately satisfy a read request, then drop it on
2975    the floor, since accepting it might prevent a lock-holding thread from
2976    making progress in its reading. If a call has been cleared while in
2977    the precall state then ignore all subsequent packets until the call
2978    is assigned to a thread. */
2979
2980 static int
2981 TooLow(struct rx_packet *ap, struct rx_call *acall)
2982 {
2983     int rc = 0;
2984     MUTEX_ENTER(&rx_stats_mutex);
2985     if (((ap->header.seq != 1) && (acall->flags & RX_CALL_CLEARED)
2986          && (acall->state == RX_STATE_PRECALL))
2987         || ((rx_nFreePackets < rxi_dataQuota + 2)
2988             && !((ap->header.seq < acall->rnext + rx_initSendWindow)
2989                  && (acall->flags & RX_CALL_READER_WAIT)))) {
2990         rc = 1;
2991     }
2992     MUTEX_EXIT(&rx_stats_mutex);
2993     return rc;
2994 }
2995 #endif /* KERNEL */
2996
2997 static void
2998 rxi_CheckReachEvent(struct rxevent *event, struct rx_connection *conn,
2999                     struct rx_call *acall)
3000 {
3001     struct rx_call *call = acall;
3002     struct clock when;
3003     int i, waiting;
3004
3005     MUTEX_ENTER(&conn->conn_data_lock);
3006     conn->checkReachEvent = NULL;
3007     waiting = conn->flags & RX_CONN_ATTACHWAIT;
3008     if (event)
3009         conn->refCount--;
3010     MUTEX_EXIT(&conn->conn_data_lock);
3011
3012     if (waiting) {
3013         if (!call) {
3014             MUTEX_ENTER(&conn->conn_call_lock);
3015             MUTEX_ENTER(&conn->conn_data_lock);
3016             for (i = 0; i < RX_MAXCALLS; i++) {
3017                 struct rx_call *tc = conn->call[i];
3018                 if (tc && tc->state == RX_STATE_PRECALL) {
3019                     call = tc;
3020                     break;
3021                 }
3022             }
3023             if (!call)
3024                 /* Indicate that rxi_CheckReachEvent is no longer running by
3025                  * clearing the flag.  Must be atomic under conn_data_lock to
3026                  * avoid a new call slipping by: rxi_CheckConnReach holds
3027                  * conn_data_lock while checking RX_CONN_ATTACHWAIT.
3028                  */
3029                 conn->flags &= ~RX_CONN_ATTACHWAIT;
3030             MUTEX_EXIT(&conn->conn_data_lock);
3031             MUTEX_EXIT(&conn->conn_call_lock);
3032         }
3033
3034         if (call) {
3035             if (call != acall)
3036                 MUTEX_ENTER(&call->lock);
3037             rxi_SendAck(call, NULL, 0, RX_ACK_PING, 0);
3038             if (call != acall)
3039                 MUTEX_EXIT(&call->lock);
3040
3041             clock_GetTime(&when);
3042             when.sec += RX_CHECKREACH_TIMEOUT;
3043             MUTEX_ENTER(&conn->conn_data_lock);
3044             if (!conn->checkReachEvent) {
3045                 conn->refCount++;
3046                 conn->checkReachEvent =
3047                     rxevent_Post(&when, rxi_CheckReachEvent, conn, NULL);
3048             }
3049             MUTEX_EXIT(&conn->conn_data_lock);
3050         }
3051     }
3052 }
3053
3054 static int
3055 rxi_CheckConnReach(struct rx_connection *conn, struct rx_call *call)
3056 {
3057     struct rx_service *service = conn->service;
3058     struct rx_peer *peer = conn->peer;
3059     afs_uint32 now, lastReach;
3060
3061     if (service->checkReach == 0)
3062         return 0;
3063
3064     now = clock_Sec();
3065     MUTEX_ENTER(&peer->peer_lock);
3066     lastReach = peer->lastReachTime;
3067     MUTEX_EXIT(&peer->peer_lock);
3068     if (now - lastReach < RX_CHECKREACH_TTL)
3069         return 0;
3070
3071     MUTEX_ENTER(&conn->conn_data_lock);
3072     if (conn->flags & RX_CONN_ATTACHWAIT) {
3073         MUTEX_EXIT(&conn->conn_data_lock);
3074         return 1;
3075     }
3076     conn->flags |= RX_CONN_ATTACHWAIT;
3077     MUTEX_EXIT(&conn->conn_data_lock);
3078     if (!conn->checkReachEvent)
3079         rxi_CheckReachEvent(NULL, conn, call);
3080
3081     return 1;
3082 }
3083
3084 /* try to attach call, if authentication is complete */
3085 static void
3086 TryAttach(register struct rx_call *acall, register osi_socket socket,
3087           register int *tnop, register struct rx_call **newcallp,
3088           int reachOverride)
3089 {
3090     struct rx_connection *conn = acall->conn;
3091
3092     if (conn->type == RX_SERVER_CONNECTION
3093         && acall->state == RX_STATE_PRECALL) {
3094         /* Don't attach until we have any req'd. authentication. */
3095         if (RXS_CheckAuthentication(conn->securityObject, conn) == 0) {
3096             if (reachOverride || rxi_CheckConnReach(conn, acall) == 0)
3097                 rxi_AttachServerProc(acall, socket, tnop, newcallp);
3098             /* Note:  this does not necessarily succeed; there
3099              * may not any proc available
3100              */
3101         } else {
3102             rxi_ChallengeOn(acall->conn);
3103         }
3104     }
3105 }
3106
3107 /* A data packet has been received off the interface.  This packet is
3108  * appropriate to the call (the call is in the right state, etc.).  This
3109  * routine can return a packet to the caller, for re-use */
3110
3111 struct rx_packet *
3112 rxi_ReceiveDataPacket(register struct rx_call *call,
3113                       register struct rx_packet *np, int istack,
3114                       osi_socket socket, afs_uint32 host, u_short port,
3115                       int *tnop, struct rx_call **newcallp)
3116 {
3117     int ackNeeded = 0;          /* 0 means no, otherwise ack_reason */
3118     int newPackets = 0;
3119     int didHardAck = 0;
3120     int haveLast = 0;
3121     afs_uint32 seq, serial, flags;
3122     int isFirst;
3123     struct rx_packet *tnp;
3124     struct clock when;
3125     MUTEX_ENTER(&rx_stats_mutex);
3126     rx_stats.dataPacketsRead++;
3127     MUTEX_EXIT(&rx_stats_mutex);
3128
3129 #ifdef KERNEL
3130     /* If there are no packet buffers, drop this new packet, unless we can find
3131      * packet buffers from inactive calls */
3132     if (!call->error
3133         && (rxi_OverQuota(RX_PACKET_CLASS_RECEIVE) || TooLow(np, call))) {
3134         MUTEX_ENTER(&rx_freePktQ_lock);
3135         rxi_NeedMorePackets = TRUE;
3136         MUTEX_EXIT(&rx_freePktQ_lock);
3137         MUTEX_ENTER(&rx_stats_mutex);
3138         rx_stats.noPacketBuffersOnRead++;
3139         MUTEX_EXIT(&rx_stats_mutex);
3140         call->rprev = np->header.serial;
3141         rxi_calltrace(RX_TRACE_DROP, call);
3142         dpf(("packet %x dropped on receipt - quota problems", np));
3143         if (rxi_doreclaim)
3144             rxi_ClearReceiveQueue(call);
3145         clock_GetTime(&when);
3146         clock_Add(&when, &rx_softAckDelay);
3147         if (!call->delayedAckEvent
3148             || clock_Gt(&call->delayedAckEvent->eventTime, &when)) {
3149             rxevent_Cancel(call->delayedAckEvent, call,
3150                            RX_CALL_REFCOUNT_DELAY);
3151             CALL_HOLD(call, RX_CALL_REFCOUNT_DELAY);
3152             call->delayedAckEvent =
3153                 rxevent_Post(&when, rxi_SendDelayedAck, call, 0);
3154         }
3155         /* we've damaged this call already, might as well do it in. */
3156         return np;
3157     }
3158 #endif /* KERNEL */
3159
3160     /*
3161      * New in AFS 3.5, if the RX_JUMBO_PACKET flag is set then this
3162      * packet is one of several packets transmitted as a single
3163      * datagram. Do not send any soft or hard acks until all packets
3164      * in a jumbogram have been processed. Send negative acks right away.
3165      */
3166     for (isFirst = 1, tnp = NULL; isFirst || tnp; isFirst = 0) {
3167         /* tnp is non-null when there are more packets in the
3168          * current jumbo gram */
3169         if (tnp) {
3170             if (np)
3171                 rxi_FreePacket(np);
3172             np = tnp;
3173         }
3174
3175         seq = np->header.seq;
3176         serial = np->header.serial;
3177         flags = np->header.flags;
3178
3179         /* If the call is in an error state, send an abort message */
3180         if (call->error)
3181             return rxi_SendCallAbort(call, np, istack, 0);
3182
3183         /* The RX_JUMBO_PACKET is set in all but the last packet in each
3184          * AFS 3.5 jumbogram. */
3185         if (flags & RX_JUMBO_PACKET) {
3186             tnp = rxi_SplitJumboPacket(np, host, port, isFirst);
3187         } else {
3188             tnp = NULL;
3189         }
3190
3191         if (np->header.spare != 0) {
3192             MUTEX_ENTER(&call->conn->conn_data_lock);
3193             call->conn->flags |= RX_CONN_USING_PACKET_CKSUM;
3194             MUTEX_EXIT(&call->conn->conn_data_lock);
3195         }
3196
3197         /* The usual case is that this is the expected next packet */
3198         if (seq == call->rnext) {
3199
3200             /* Check to make sure it is not a duplicate of one already queued */
3201             if (queue_IsNotEmpty(&call->rq)
3202                 && queue_First(&call->rq, rx_packet)->header.seq == seq) {
3203                 MUTEX_ENTER(&rx_stats_mutex);
3204                 rx_stats.dupPacketsRead++;
3205                 MUTEX_EXIT(&rx_stats_mutex);
3206                 dpf(("packet %x dropped on receipt - duplicate", np));
3207                 rxevent_Cancel(call->delayedAckEvent, call,
3208                                RX_CALL_REFCOUNT_DELAY);
3209                 np = rxi_SendAck(call, np, serial, RX_ACK_DUPLICATE, istack);
3210                 ackNeeded = 0;
3211                 call->rprev = seq;
3212                 continue;
3213             }
3214
3215             /* It's the next packet. Stick it on the receive queue
3216              * for this call. Set newPackets to make sure we wake
3217              * the reader once all packets have been processed */
3218             queue_Prepend(&call->rq, np);
3219             call->nSoftAcks++;
3220             np = NULL;          /* We can't use this anymore */
3221             newPackets = 1;
3222
3223             /* If an ack is requested then set a flag to make sure we
3224              * send an acknowledgement for this packet */
3225             if (flags & RX_REQUEST_ACK) {
3226                 ackNeeded = RX_ACK_REQUESTED;
3227             }
3228
3229             /* Keep track of whether we have received the last packet */
3230             if (flags & RX_LAST_PACKET) {
3231                 call->flags |= RX_CALL_HAVE_LAST;
3232                 haveLast = 1;
3233             }
3234
3235             /* Check whether we have all of the packets for this call */
3236             if (call->flags & RX_CALL_HAVE_LAST) {
3237                 afs_uint32 tseq;        /* temporary sequence number */
3238                 struct rx_packet *tp;   /* Temporary packet pointer */
3239                 struct rx_packet *nxp;  /* Next pointer, for queue_Scan */
3240
3241                 for (tseq = seq, queue_Scan(&call->rq, tp, nxp, rx_packet)) {
3242                     if (tseq != tp->header.seq)
3243                         break;
3244                     if (tp->header.flags & RX_LAST_PACKET) {
3245                         call->flags |= RX_CALL_RECEIVE_DONE;
3246                         break;
3247                     }
3248                     tseq++;
3249                 }
3250             }
3251
3252             /* Provide asynchronous notification for those who want it
3253              * (e.g. multi rx) */
3254             if (call->arrivalProc) {
3255                 (*call->arrivalProc) (call, call->arrivalProcHandle,
3256                                       call->arrivalProcArg);
3257                 call->arrivalProc = (void (*)())0;
3258             }
3259
3260             /* Update last packet received */
3261             call->rprev = seq;
3262
3263             /* If there is no server process serving this call, grab
3264              * one, if available. We only need to do this once. If a
3265              * server thread is available, this thread becomes a server
3266              * thread and the server thread becomes a listener thread. */
3267             if (isFirst) {
3268                 TryAttach(call, socket, tnop, newcallp, 0);
3269             }
3270         }
3271         /* This is not the expected next packet. */
3272         else {
3273             /* Determine whether this is a new or old packet, and if it's
3274              * a new one, whether it fits into the current receive window.
3275              * Also figure out whether the packet was delivered in sequence.
3276              * We use the prev variable to determine whether the new packet
3277              * is the successor of its immediate predecessor in the
3278              * receive queue, and the missing flag to determine whether
3279              * any of this packets predecessors are missing.  */
3280
3281             afs_uint32 prev;    /* "Previous packet" sequence number */
3282             struct rx_packet *tp;       /* Temporary packet pointer */
3283             struct rx_packet *nxp;      /* Next pointer, for queue_Scan */
3284             int missing;        /* Are any predecessors missing? */
3285
3286             /* If the new packet's sequence number has been sent to the
3287              * application already, then this is a duplicate */
3288             if (seq < call->rnext) {
3289                 MUTEX_ENTER(&rx_stats_mutex);
3290                 rx_stats.dupPacketsRead++;
3291                 MUTEX_EXIT(&rx_stats_mutex);
3292                 rxevent_Cancel(call->delayedAckEvent, call,
3293                                RX_CALL_REFCOUNT_DELAY);
3294                 np = rxi_SendAck(call, np, serial, RX_ACK_DUPLICATE, istack);
3295                 ackNeeded = 0;
3296                 call->rprev = seq;
3297                 continue;
3298             }
3299
3300             /* If the sequence number is greater than what can be
3301              * accomodated by the current window, then send a negative
3302              * acknowledge and drop the packet */
3303             if ((call->rnext + call->rwind) <= seq) {
3304                 rxevent_Cancel(call->delayedAckEvent, call,
3305                                RX_CALL_REFCOUNT_DELAY);
3306                 np = rxi_SendAck(call, np, serial, RX_ACK_EXCEEDS_WINDOW,
3307                                  istack);
3308                 ackNeeded = 0;
3309                 call->rprev = seq;
3310                 continue;
3311             }
3312
3313             /* Look for the packet in the queue of old received packets */
3314             for (prev = call->rnext - 1, missing =
3315                  0, queue_Scan(&call->rq, tp, nxp, rx_packet)) {
3316                 /*Check for duplicate packet */
3317                 if (seq == tp->header.seq) {
3318                     MUTEX_ENTER(&rx_stats_mutex);
3319                     rx_stats.dupPacketsRead++;
3320                     MUTEX_EXIT(&rx_stats_mutex);
3321                     rxevent_Cancel(call->delayedAckEvent, call,
3322                                    RX_CALL_REFCOUNT_DELAY);
3323                     np = rxi_SendAck(call, np, serial, RX_ACK_DUPLICATE,
3324                                      istack);
3325                     ackNeeded = 0;
3326                     call->rprev = seq;
3327                     goto nextloop;
3328                 }
3329                 /* If we find a higher sequence packet, break out and
3330                  * insert the new packet here. */
3331                 if (seq < tp->header.seq)
3332                     break;
3333                 /* Check for missing packet */
3334                 if (tp->header.seq != prev + 1) {
3335                     missing = 1;
3336                 }
3337
3338                 prev = tp->header.seq;
3339             }
3340
3341             /* Keep track of whether we have received the last packet. */
3342             if (flags & RX_LAST_PACKET) {
3343                 call->flags |= RX_CALL_HAVE_LAST;
3344             }
3345
3346             /* It's within the window: add it to the the receive queue.
3347              * tp is left by the previous loop either pointing at the
3348              * packet before which to insert the new packet, or at the
3349              * queue head if the queue is empty or the packet should be
3350              * appended. */
3351             queue_InsertBefore(tp, np);
3352             call->nSoftAcks++;
3353             np = NULL;
3354
3355             /* Check whether we have all of the packets for this call */
3356             if ((call->flags & RX_CALL_HAVE_LAST)
3357                 && !(call->flags & RX_CALL_RECEIVE_DONE)) {
3358                 afs_uint32 tseq;        /* temporary sequence number */
3359
3360                 for (tseq =
3361                      call->rnext, queue_Scan(&call->rq, tp, nxp, rx_packet)) {
3362                     if (tseq != tp->header.seq)
3363                         break;
3364                     if (tp->header.flags & RX_LAST_PACKET) {
3365                         call->flags |= RX_CALL_RECEIVE_DONE;
3366                         break;
3367                     }
3368                     tseq++;
3369                 }
3370             }
3371
3372             /* We need to send an ack of the packet is out of sequence, 
3373              * or if an ack was requested by the peer. */
3374             if (seq != prev + 1 || missing) {
3375                 ackNeeded = RX_ACK_OUT_OF_SEQUENCE;
3376             } else if (flags & RX_REQUEST_ACK) {
3377                 ackNeeded = RX_ACK_REQUESTED;
3378             }
3379
3380             /* Acknowledge the last packet for each call */
3381             if (flags & RX_LAST_PACKET) {
3382                 haveLast = 1;
3383             }
3384
3385             call->rprev = seq;
3386         }
3387       nextloop:;
3388     }
3389
3390     if (newPackets) {
3391         /*
3392          * If the receiver is waiting for an iovec, fill the iovec
3393          * using the data from the receive queue */
3394         if (call->flags & RX_CALL_IOVEC_WAIT) {
3395             didHardAck = rxi_FillReadVec(call, serial);
3396             /* the call may have been aborted */
3397             if (call->error) {
3398                 return NULL;
3399             }
3400             if (didHardAck) {
3401                 ackNeeded = 0;
3402             }
3403         }
3404
3405         /* Wakeup the reader if any */
3406         if ((call->flags & RX_CALL_READER_WAIT)
3407             && (!(call->flags & RX_CALL_IOVEC_WAIT) || !(call->iovNBytes)
3408                 || (call->iovNext >= call->iovMax)
3409                 || (call->flags & RX_CALL_RECEIVE_DONE))) {
3410             call->flags &= ~RX_CALL_READER_WAIT;
3411 #ifdef  RX_ENABLE_LOCKS
3412             CV_BROADCAST(&call->cv_rq);
3413 #else
3414             osi_rxWakeup(&call->rq);
3415 #endif
3416         }
3417     }
3418
3419     /*
3420      * Send an ack when requested by the peer, or once every
3421      * rxi_SoftAckRate packets until the last packet has been
3422      * received. Always send a soft ack for the last packet in
3423      * the server's reply. */
3424     if (ackNeeded) {
3425         rxevent_Cancel(call->delayedAckEvent, call, RX_CALL_REFCOUNT_DELAY);
3426         np = rxi_SendAck(call, np, serial, ackNeeded, istack);
3427     } else if (call->nSoftAcks > (u_short) rxi_SoftAckRate) {
3428         rxevent_Cancel(call->delayedAckEvent, call, RX_CALL_REFCOUNT_DELAY);
3429         np = rxi_SendAck(call, np, serial, RX_ACK_IDLE, istack);
3430     } else if (call->nSoftAcks) {
3431         clock_GetTime(&when);
3432         if (haveLast && !(flags & RX_CLIENT_INITIATED)) {
3433             clock_Add(&when, &rx_lastAckDelay);
3434         } else {
3435             clock_Add(&when, &rx_softAckDelay);
3436         }
3437         if (!call->delayedAckEvent
3438             || clock_Gt(&call->delayedAckEvent->eventTime, &when)) {
3439             rxevent_Cancel(call->delayedAckEvent, call,
3440                            RX_CALL_REFCOUNT_DELAY);
3441             CALL_HOLD(call, RX_CALL_REFCOUNT_DELAY);
3442             call->delayedAckEvent =
3443                 rxevent_Post(&when, rxi_SendDelayedAck, call, 0);
3444         }
3445     } else if (call->flags & RX_CALL_RECEIVE_DONE) {
3446         rxevent_Cancel(call->delayedAckEvent, call, RX_CALL_REFCOUNT_DELAY);
3447     }
3448
3449     return np;
3450 }
3451
3452 #ifdef  ADAPT_WINDOW
3453 static void rxi_ComputeRate();
3454 #endif
3455
3456 static void
3457 rxi_UpdatePeerReach(struct rx_connection *conn, struct rx_call *acall)
3458 {
3459     struct rx_peer *peer = conn->peer;
3460
3461     MUTEX_ENTER(&peer->peer_lock);
3462     peer->lastReachTime = clock_Sec();
3463     MUTEX_EXIT(&peer->peer_lock);
3464
3465     MUTEX_ENTER(&conn->conn_data_lock);
3466     if (conn->flags & RX_CONN_ATTACHWAIT) {
3467         int i;
3468
3469         conn->flags &= ~RX_CONN_ATTACHWAIT;
3470         MUTEX_EXIT(&conn->conn_data_lock);
3471
3472         for (i = 0; i < RX_MAXCALLS; i++) {
3473             struct rx_call *call = conn->call[i];
3474             if (call) {
3475                 if (call != acall)
3476                     MUTEX_ENTER(&call->lock);
3477                 /* tnop can be null if newcallp is null */
3478                 TryAttach(call, (osi_socket) - 1, NULL, NULL, 1);
3479                 if (call != acall)
3480                     MUTEX_EXIT(&call->lock);
3481             }
3482         }
3483     } else
3484         MUTEX_EXIT(&conn->conn_data_lock);
3485 }
3486
3487 static const char *
3488 rx_ack_reason(int reason)
3489 {
3490     switch (reason) {
3491     case RX_ACK_REQUESTED:
3492         return "requested";
3493     case RX_ACK_DUPLICATE:
3494         return "duplicate";
3495     case RX_ACK_OUT_OF_SEQUENCE:
3496         return "sequence";
3497     case RX_ACK_EXCEEDS_WINDOW:
3498         return "window";
3499     case RX_ACK_NOSPACE:
3500         return "nospace";
3501     case RX_ACK_PING:
3502         return "ping";
3503     case RX_ACK_PING_RESPONSE:
3504         return "response";
3505     case RX_ACK_DELAY:
3506         return "delay";
3507     case RX_ACK_IDLE:
3508         return "idle";
3509     default:
3510         return "unknown!!";
3511     }
3512 }
3513
3514
3515 /* rxi_ComputePeerNetStats
3516  *
3517  * Called exclusively by rxi_ReceiveAckPacket to compute network link
3518  * estimates (like RTT and throughput) based on ack packets.  Caller
3519  * must ensure that the packet in question is the right one (i.e.
3520  * serial number matches).
3521  */
3522 static void
3523 rxi_ComputePeerNetStats(struct rx_call *call, struct rx_packet *p,
3524                         struct rx_ackPacket *ap, struct rx_packet *np)
3525 {
3526     struct rx_peer *peer = call->conn->peer;
3527
3528     /* Use RTT if not delayed by client. */
3529     if (ap->reason != RX_ACK_DELAY)
3530         rxi_ComputeRoundTripTime(p, &p->timeSent, peer);
3531 #ifdef ADAPT_WINDOW
3532     rxi_ComputeRate(peer, call, p, np, ap->reason);
3533 #endif
3534 }
3535
3536 /* The real smarts of the whole thing.  */
3537 struct rx_packet *
3538 rxi_ReceiveAckPacket(register struct rx_call *call, struct rx_packet *np,
3539                      int istack)
3540 {
3541     struct rx_ackPacket *ap;
3542     int nAcks;
3543     register struct rx_packet *tp;
3544     register struct rx_packet *nxp;     /* Next packet pointer for queue_Scan */
3545     register struct rx_connection *conn = call->conn;
3546     struct rx_peer *peer = conn->peer;
3547     afs_uint32 first;
3548     afs_uint32 serial;
3549     /* because there are CM's that are bogus, sending weird values for this. */
3550     afs_uint32 skew = 0;
3551     int nbytes;
3552     int missing;
3553     int acked;
3554     int nNacked = 0;
3555     int newAckCount = 0;
3556     u_short maxMTU = 0;         /* Set if peer supports AFS 3.4a jumbo datagrams */
3557     int maxDgramPackets = 0;    /* Set if peer supports AFS 3.5 jumbo datagrams */
3558
3559     MUTEX_ENTER(&rx_stats_mutex);
3560     rx_stats.ackPacketsRead++;
3561     MUTEX_EXIT(&rx_stats_mutex);
3562     ap = (struct rx_ackPacket *)rx_DataOf(np);
3563     nbytes = rx_Contiguous(np) - (int)((ap->acks) - (u_char *) ap);
3564     if (nbytes < 0)
3565         return np;              /* truncated ack packet */
3566
3567     /* depends on ack packet struct */
3568     nAcks = MIN((unsigned)nbytes, (unsigned)ap->nAcks);
3569     first = ntohl(ap->firstPacket);
3570     serial = ntohl(ap->serial);
3571     /* temporarily disabled -- needs to degrade over time 
3572      * skew = ntohs(ap->maxSkew); */
3573
3574     /* Ignore ack packets received out of order */
3575     if (first < call->tfirst) {
3576         return np;
3577     }
3578
3579     if (np->header.flags & RX_SLOW_START_OK) {
3580         call->flags |= RX_CALL_SLOW_START_OK;
3581     }
3582
3583     if (ap->reason == RX_ACK_PING_RESPONSE)
3584         rxi_UpdatePeerReach(conn, call);
3585
3586 #ifdef RXDEBUG
3587 #ifdef AFS_NT40_ENV
3588     if (rxdebug_active) {
3589         char msg[512];
3590         size_t len;
3591
3592         len = _snprintf(msg, sizeof(msg),
3593                         "tid[%d] RACK: reason %s serial %u previous %u seq %u skew %d first %u acks %u space %u ",
3594                          GetCurrentThreadId(), rx_ack_reason(ap->reason), 
3595                          ntohl(ap->serial), ntohl(ap->previousPacket),
3596                          (unsigned int)np->header.seq, (unsigned int)skew, 
3597                          ntohl(ap->firstPacket), ap->nAcks, ntohs(ap->bufferSpace) );
3598         if (nAcks) {
3599             int offset;
3600
3601             for (offset = 0; offset < nAcks && len < sizeof(msg); offset++) 
3602                 msg[len++] = (ap->acks[offset] == RX_ACK_TYPE_NACK ? '-' : '*');
3603         }
3604         msg[len++]='\n';
3605         msg[len] = '\0';
3606         OutputDebugString(msg);
3607     }
3608 #else /* AFS_NT40_ENV */
3609     if (rx_Log) {
3610         fprintf(rx_Log,
3611                 "RACK: reason %x previous %u seq %u serial %u skew %d first %u",
3612                 ap->reason, ntohl(ap->previousPacket),
3613                 (unsigned int)np->header.seq, (unsigned int)serial,
3614                 (unsigned int)skew, ntohl(ap->firstPacket));
3615         if (nAcks) {
3616             int offset;
3617             for (offset = 0; offset < nAcks; offset++)
3618                 putc(ap->acks[offset] == RX_ACK_TYPE_NACK ? '-' : '*',
3619                      rx_Log);
3620         }
3621         putc('\n', rx_Log);
3622     }
3623 #endif /* AFS_NT40_ENV */
3624 #endif
3625
3626     /* Update the outgoing packet skew value to the latest value of
3627      * the peer's incoming packet skew value.  The ack packet, of
3628      * course, could arrive out of order, but that won't affect things
3629      * much */
3630     MUTEX_ENTER(&peer->peer_lock);
3631     peer->outPacketSkew = skew;
3632
3633     /* Check for packets that no longer need to be transmitted, and
3634      * discard them.  This only applies to packets positively
3635      * acknowledged as having been sent to the peer's upper level.
3636      * All other packets must be retained.  So only packets with
3637      * sequence numbers < ap->firstPacket are candidates. */
3638     for (queue_Scan(&call->tq, tp, nxp, rx_packet)) {
3639         if (tp->header.seq >= first)
3640             break;
3641         call->tfirst = tp->header.seq + 1;
3642         if (serial
3643             && (tp->header.serial == serial || tp->firstSerial == serial))
3644             rxi_ComputePeerNetStats(call, tp, ap, np);
3645         if (!(tp->flags & RX_PKTFLAG_ACKED)) {
3646             newAckCount++;
3647         }
3648 #ifdef  AFS_GLOBAL_RXLOCK_KERNEL
3649         /* XXX Hack. Because we have to release the global rx lock when sending
3650          * packets (osi_NetSend) we drop all acks while we're traversing the tq
3651          * in rxi_Start sending packets out because packets may move to the
3652          * freePacketQueue as result of being here! So we drop these packets until
3653          * we're safely out of the traversing. Really ugly! 
3654          * To make it even uglier, if we're using fine grain locking, we can
3655          * set the ack bits in the packets and have rxi_Start remove the packets
3656          * when it's done transmitting.
3657          */
3658         if (call->flags & RX_CALL_TQ_BUSY) {
3659 #ifdef RX_ENABLE_LOCKS
3660             tp->flags |= RX_PKTFLAG_ACKED;
3661             call->flags |= RX_CALL_TQ_SOME_ACKED;
3662 #else /* RX_ENABLE_LOCKS */
3663             break;
3664 #endif /* RX_ENABLE_LOCKS */
3665         } else
3666 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
3667         {
3668             queue_Remove(tp);
3669             rxi_FreePacket(tp); /* rxi_FreePacket mustn't wake up anyone, preemptively. */
3670         }
3671     }
3672
3673 #ifdef ADAPT_WINDOW
3674     /* Give rate detector a chance to respond to ping requests */
3675     if (ap->reason == RX_ACK_PING_RESPONSE) {
3676         rxi_ComputeRate(peer, call, 0, np, ap->reason);
3677     }
3678 #endif
3679
3680     /* N.B. we don't turn off any timers here.  They'll go away by themselves, anyway */
3681
3682     /* Now go through explicit acks/nacks and record the results in
3683      * the waiting packets.  These are packets that can't be released
3684      * yet, even with a positive acknowledge.  This positive
3685      * acknowledge only means the packet has been received by the
3686      * peer, not that it will be retained long enough to be sent to
3687      * the peer's upper level.  In addition, reset the transmit timers
3688      * of any missing packets (those packets that must be missing
3689      * because this packet was out of sequence) */
3690
3691     call->nSoftAcked = 0;
3692     for (missing = 0, queue_Scan(&call->tq, tp, nxp, rx_packet)) {
3693         /* Update round trip time if the ack was stimulated on receipt
3694          * of this packet */
3695 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
3696 #ifdef RX_ENABLE_LOCKS
3697         if (tp->header.seq >= first)
3698 #endif /* RX_ENABLE_LOCKS */
3699 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
3700             if (serial
3701                 && (tp->header.serial == serial || tp->firstSerial == serial))
3702                 rxi_ComputePeerNetStats(call, tp, ap, np);
3703
3704         /* Set the acknowledge flag per packet based on the
3705          * information in the ack packet. An acknowlegded packet can
3706          * be downgraded when the server has discarded a packet it
3707          * soacked previously, or when an ack packet is received
3708          * out of sequence. */
3709         if (tp->header.seq < first) {
3710             /* Implicit ack information */
3711             if (!(tp->flags & RX_PKTFLAG_ACKED)) {
3712                 newAckCount++;
3713             }
3714             tp->flags |= RX_PKTFLAG_ACKED;
3715         } else if (tp->header.seq < first + nAcks) {
3716             /* Explicit ack information:  set it in the packet appropriately */
3717             if (ap->acks[tp->header.seq - first] == RX_ACK_TYPE_ACK) {
3718                 if (!(tp->flags & RX_PKTFLAG_ACKED)) {
3719                     newAckCount++;
3720                     tp->flags |= RX_PKTFLAG_ACKED;
3721                 }
3722                 if (missing) {
3723                     nNacked++;
3724                 } else {
3725                     call->nSoftAcked++;
3726                 }
3727             } else /* RX_ACK_TYPE_NACK */ {
3728                 tp->flags &= ~RX_PKTFLAG_ACKED;
3729                 missing = 1;
3730             }
3731         } else {
3732             tp->flags &= ~RX_PKTFLAG_ACKED;
3733             missing = 1;
3734         }
3735
3736         /* If packet isn't yet acked, and it has been transmitted at least 
3737          * once, reset retransmit time using latest timeout 
3738          * ie, this should readjust the retransmit timer for all outstanding 
3739          * packets...  So we don't just retransmit when we should know better*/
3740
3741         if (!(tp->flags & RX_PKTFLAG_ACKED) && !clock_IsZero(&tp->retryTime)) {
3742             tp->retryTime = tp->timeSent;
3743             clock_Add(&tp->retryTime, &peer->timeout);
3744             /* shift by eight because one quarter-sec ~ 256 milliseconds */
3745             clock_Addmsec(&(tp->retryTime), ((afs_uint32) tp->backoff) << 8);
3746         }
3747     }
3748
3749     /* If the window has been extended by this acknowledge packet,
3750      * then wakeup a sender waiting in alloc for window space, or try
3751      * sending packets now, if he's been sitting on packets due to
3752      * lack of window space */
3753     if (call->tnext < (call->tfirst + call->twind)) {
3754 #ifdef  RX_ENABLE_LOCKS
3755         CV_SIGNAL(&call->cv_twind);
3756 #else
3757         if (call->flags & RX_CALL_WAIT_WINDOW_ALLOC) {
3758             call->flags &= ~RX_CALL_WAIT_WINDOW_ALLOC;
3759             osi_rxWakeup(&call->twind);
3760         }
3761 #endif
3762         if (call->flags & RX_CALL_WAIT_WINDOW_SEND) {
3763             call->flags &= ~RX_CALL_WAIT_WINDOW_SEND;
3764         }
3765     }
3766
3767     /* if the ack packet has a receivelen field hanging off it,
3768      * update our state */
3769     if (np->length >= rx_AckDataSize(ap->nAcks) + 2 * sizeof(afs_int32)) {
3770         afs_uint32 tSize;
3771
3772         /* If the ack packet has a "recommended" size that is less than 
3773          * what I am using now, reduce my size to match */
3774         rx_packetread(np, rx_AckDataSize(ap->nAcks) + sizeof(afs_int32),
3775                       (int)sizeof(afs_int32), &tSize);
3776         tSize = (afs_uint32) ntohl(tSize);
3777         peer->natMTU = rxi_AdjustIfMTU(MIN(tSize, peer->ifMTU));
3778
3779         /* Get the maximum packet size to send to this peer */
3780         rx_packetread(np, rx_AckDataSize(ap->nAcks), (int)sizeof(afs_int32),
3781                       &tSize);
3782         tSize = (afs_uint32) ntohl(tSize);
3783         tSize = (afs_uint32) MIN(tSize, rx_MyMaxSendSize);
3784         tSize = rxi_AdjustMaxMTU(peer->natMTU, tSize);
3785
3786         /* sanity check - peer might have restarted with different params.
3787          * If peer says "send less", dammit, send less...  Peer should never 
3788          * be unable to accept packets of the size that prior AFS versions would
3789          * send without asking.  */
3790         if (peer->maxMTU != tSize) {
3791             if (peer->maxMTU > tSize) /* possible cong., maxMTU decreased */
3792                 peer->congestSeq++;
3793             peer->maxMTU = tSize;
3794             peer->MTU = MIN(tSize, peer->MTU);
3795             call->MTU = MIN(call->MTU, tSize);
3796         }
3797
3798         if (np->length == rx_AckDataSize(ap->nAcks) + 3 * sizeof(afs_int32)) {
3799             /* AFS 3.4a */
3800             rx_packetread(np,
3801                           rx_AckDataSize(ap->nAcks) + 2 * sizeof(afs_int32),
3802                           (int)sizeof(afs_int32), &tSize);
3803             tSize = (afs_uint32) ntohl(tSize);  /* peer's receive window, if it's */
3804             if (tSize < call->twind) {  /* smaller than our send */
3805                 call->twind = tSize;    /* window, we must send less... */
3806                 call->ssthresh = MIN(call->twind, call->ssthresh);
3807             }
3808
3809             /* Only send jumbograms to 3.4a fileservers. 3.3a RX gets the
3810              * network MTU confused with the loopback MTU. Calculate the
3811              * maximum MTU here for use in the slow start code below.
3812              */
3813             maxMTU = peer->maxMTU;
3814             /* Did peer restart with older RX version? */
3815             if (peer->maxDgramPackets > 1) {
3816                 peer->maxDgramPackets = 1;
3817             }
3818         } else if (np->length >=
3819                    rx_AckDataSize(ap->nAcks) + 4 * sizeof(afs_int32)) {
3820             /* AFS 3.5 */
3821             rx_packetread(np,
3822                           rx_AckDataSize(ap->nAcks) + 2 * sizeof(afs_int32),
3823                           sizeof(afs_int32), &tSize);
3824             tSize = (afs_uint32) ntohl(tSize);
3825             /*
3826              * As of AFS 3.5 we set the send window to match the receive window. 
3827              */
3828             if (tSize < call->twind) {
3829                 call->twind = tSize;
3830                 call->ssthresh = MIN(call->twind, call->ssthresh);
3831             } else if (tSize > call->twind) {
3832                 call->twind = tSize;
3833             }
3834
3835             /*
3836              * As of AFS 3.5, a jumbogram is more than one fixed size
3837              * packet transmitted in a single UDP datagram. If the remote
3838              * MTU is smaller than our local MTU then never send a datagram
3839              * larger than the natural MTU.
3840              */
3841             rx_packetread(np,
3842                           rx_AckDataSize(ap->nAcks) + 3 * sizeof(afs_int32),
3843                           sizeof(afs_int32), &tSize);
3844             maxDgramPackets = (afs_uint32) ntohl(tSize);
3845             maxDgramPackets = MIN(maxDgramPackets, rxi_nDgramPackets);
3846             maxDgramPackets = MIN(maxDgramPackets, peer->ifDgramPackets);
3847             if (peer->natMTU < peer->ifMTU)
3848                 maxDgramPackets = MIN(maxDgramPackets, rxi_AdjustDgramPackets(1, peer->natMTU));
3849             if (maxDgramPackets > 1) {
3850                 peer->maxDgramPackets = maxDgramPackets;
3851                 call->MTU = RX_JUMBOBUFFERSIZE + RX_HEADER_SIZE;
3852             } else {
3853                 peer->maxDgramPackets = 1;
3854                 call->MTU = peer->natMTU;
3855             }
3856         } else if (peer->maxDgramPackets > 1) {
3857             /* Restarted with lower version of RX */
3858             peer->maxDgramPackets = 1;
3859         }
3860     } else if (peer->maxDgramPackets > 1
3861                || peer->maxMTU != OLD_MAX_PACKET_SIZE) {
3862         /* Restarted with lower version of RX */
3863         peer->maxMTU = OLD_MAX_PACKET_SIZE;
3864         peer->natMTU = OLD_MAX_PACKET_SIZE;
3865         peer->MTU = OLD_MAX_PACKET_SIZE;
3866         peer->maxDgramPackets = 1;
3867         peer->nDgramPackets = 1;
3868         peer->congestSeq++;
3869         call->MTU = OLD_MAX_PACKET_SIZE;
3870     }
3871
3872     if (nNacked) {
3873         /*
3874          * Calculate how many datagrams were successfully received after
3875          * the first missing packet and adjust the negative ack counter
3876          * accordingly.
3877          */
3878         call->nAcks = 0;
3879         call->nNacks++;
3880         nNacked = (nNacked + call->nDgramPackets - 1) / call->nDgramPackets;
3881         if (call->nNacks < nNacked) {
3882             call->nNacks = nNacked;
3883         }
3884     } else {
3885         if (newAckCount) {
3886             call->nAcks++;
3887         }
3888         call->nNacks = 0;
3889     }
3890
3891     if (call->flags & RX_CALL_FAST_RECOVER) {
3892         if (nNacked) {
3893             call->cwind = MIN((int)(call->cwind + 1), rx_maxSendWindow);
3894         } else {
3895             call->flags &= ~RX_CALL_FAST_RECOVER;
3896             call->cwind = call->nextCwind;
3897             call->nextCwind = 0;
3898             call->nAcks = 0;
3899         }
3900         call->nCwindAcks = 0;
3901     } else if (nNacked && call->nNacks >= (u_short) rx_nackThreshold) {
3902         /* Three negative acks in a row trigger congestion recovery */
3903 #ifdef  AFS_GLOBAL_RXLOCK_KERNEL
3904         MUTEX_EXIT(&peer->peer_lock);
3905         if (call->flags & RX_CALL_FAST_RECOVER_WAIT) {
3906             /* someone else is waiting to start recovery */
3907             return np;
3908         }
3909         call->flags |= RX_CALL_FAST_RECOVER_WAIT;
3910         rxi_WaitforTQBusy(call);
3911         MUTEX_ENTER(&peer->peer_lock);
3912 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
3913         call->flags &= ~RX_CALL_FAST_RECOVER_WAIT;
3914         call->flags |= RX_CALL_FAST_RECOVER;
3915         call->ssthresh = MAX(4, MIN((int)call->cwind, (int)call->twind)) >> 1;
3916         call->cwind =
3917             MIN((int)(call->ssthresh + rx_nackThreshold), rx_maxSendWindow);
3918         call->nDgramPackets = MAX(2, (int)call->nDgramPackets) >> 1;
3919         call->nextCwind = call->ssthresh;
3920         call->nAcks = 0;
3921         call->nNacks = 0;
3922         peer->MTU = call->MTU;
3923         peer->cwind = call->nextCwind;
3924         peer->nDgramPackets = call->nDgramPackets;
3925         peer->congestSeq++;
3926         call->congestSeq = peer->congestSeq;
3927         /* Reset the resend times on the packets that were nacked
3928          * so we will retransmit as soon as the window permits*/
3929         for (acked = 0, queue_ScanBackwards(&call->tq, tp, nxp, rx_packet)) {
3930             if (acked) {
3931                 if (!(tp->flags & RX_PKTFLAG_ACKED)) {
3932                     clock_Zero(&tp->retryTime);
3933                 }
3934             } else if (tp->flags & RX_PKTFLAG_ACKED) {
3935                 acked = 1;
3936             }
3937         }
3938     } else {
3939         /* If cwind is smaller than ssthresh, then increase
3940          * the window one packet for each ack we receive (exponential
3941          * growth).
3942          * If cwind is greater than or equal to ssthresh then increase
3943          * the congestion window by one packet for each cwind acks we
3944          * receive (linear growth).  */
3945         if (call->cwind < call->ssthresh) {
3946             call->cwind =
3947                 MIN((int)call->ssthresh, (int)(call->cwind + newAckCount));
3948             call->nCwindAcks = 0;
3949         } else {
3950             call->nCwindAcks += newAckCount;
3951             if (call->nCwindAcks >= call->cwind) {
3952                 call->nCwindAcks = 0;
3953                 call->cwind = MIN((int)(call->cwind + 1), rx_maxSendWindow);
3954             }
3955         }
3956         /*
3957          * If we have received several acknowledgements in a row then
3958          * it is time to increase the size of our datagrams
3959          */
3960         if ((int)call->nAcks > rx_nDgramThreshold) {
3961             if (peer->maxDgramPackets > 1) {
3962                 if (call->nDgramPackets < peer->maxDgramPackets) {
3963                     call->nDgramPackets++;
3964                 }
3965                 call->MTU = RX_HEADER_SIZE + RX_JUMBOBUFFERSIZE;
3966             } else if (call->MTU < peer->maxMTU) {
3967                 call->MTU += peer->natMTU;
3968                 call->MTU = MIN(call->MTU, peer->maxMTU);
3969             }
3970             call->nAcks = 0;
3971         }
3972     }
3973
3974     MUTEX_EXIT(&peer->peer_lock);       /* rxi_Start will lock peer. */
3975
3976     /* Servers need to hold the call until all response packets have
3977      * been acknowledged. Soft acks are good enough since clients
3978      * are not allowed to clear their receive queues. */
3979     if (call->state == RX_STATE_HOLD
3980         && call->tfirst + call->nSoftAcked >= call->tnext) {
3981         call->state = RX_STATE_DALLY;
3982         rxi_ClearTransmitQueue(call, 0);
3983     } else if (!queue_IsEmpty(&call->tq)) {
3984         rxi_Start(0, call, 0, istack);
3985     }
3986     return np;
3987 }
3988
3989 /* Received a response to a challenge packet */
3990 struct rx_packet *
3991 rxi_ReceiveResponsePacket(register struct rx_connection *conn,
3992                           register struct rx_packet *np, int istack)
3993 {
3994     int error;
3995
3996     /* Ignore the packet if we're the client */
3997     if (conn->type == RX_CLIENT_CONNECTION)
3998         return np;
3999
4000     /* If already authenticated, ignore the packet (it's probably a retry) */
4001     if (RXS_CheckAuthentication(conn->securityObject, conn) == 0)
4002         return np;
4003
4004     /* Otherwise, have the security object evaluate the response packet */
4005     error = RXS_CheckResponse(conn->securityObject, conn, np);
4006     if (error) {
4007         /* If the response is invalid, reset the connection, sending
4008          * an abort to the peer */
4009 #ifndef KERNEL
4010         rxi_Delay(1);
4011 #endif
4012         rxi_ConnectionError(conn, error);
4013         MUTEX_ENTER(&conn->conn_data_lock);
4014         np = rxi_SendConnectionAbort(conn, np, istack, 0);
4015         MUTEX_EXIT(&conn->conn_data_lock);
4016         return np;
4017     } else {
4018         /* If the response is valid, any calls waiting to attach
4019          * servers can now do so */
4020         int i;
4021
4022         for (i = 0; i < RX_MAXCALLS; i++) {
4023             struct rx_call *call = conn->call[i];
4024             if (call) {
4025                 MUTEX_ENTER(&call->lock);
4026                 if (call->state == RX_STATE_PRECALL)
4027                     rxi_AttachServerProc(call, (osi_socket) - 1, NULL, NULL);
4028                 /* tnop can be null if newcallp is null */
4029                 MUTEX_EXIT(&call->lock);
4030             }
4031         }
4032
4033         /* Update the peer reachability information, just in case
4034          * some calls went into attach-wait while we were waiting
4035          * for authentication..
4036          */
4037         rxi_UpdatePeerReach(conn, NULL);
4038     }
4039     return np;
4040 }
4041
4042 /* A client has received an authentication challenge: the security
4043  * object is asked to cough up a respectable response packet to send
4044  * back to the server.  The server is responsible for retrying the
4045  * challenge if it fails to get a response. */
4046
4047 struct rx_packet *
4048 rxi_ReceiveChallengePacket(register struct rx_connection *conn,
4049                            register struct rx_packet *np, int istack)
4050 {
4051     int error;
4052
4053     /* Ignore the challenge if we're the server */
4054     if (conn->type == RX_SERVER_CONNECTION)
4055         return np;
4056
4057     /* Ignore the challenge if the connection is otherwise idle; someone's
4058      * trying to use us as an oracle. */
4059     if (!rxi_HasActiveCalls(conn))
4060         return np;
4061
4062     /* Send the security object the challenge packet.  It is expected to fill
4063      * in the response. */
4064     error = RXS_GetResponse(conn->securityObject, conn, np);
4065
4066     /* If the security object is unable to return a valid response, reset the
4067      * connection and send an abort to the peer.  Otherwise send the response
4068      * packet to the peer connection. */
4069     if (error) {
4070         rxi_ConnectionError(conn, error);
4071         MUTEX_ENTER(&conn->conn_data_lock);
4072         np = rxi_SendConnectionAbort(conn, np, istack, 0);
4073         MUTEX_EXIT(&conn->conn_data_lock);
4074     } else {
4075         np = rxi_SendSpecial((struct rx_call *)0, conn, np,
4076                              RX_PACKET_TYPE_RESPONSE, NULL, -1, istack);
4077     }
4078     return np;
4079 }
4080
4081
4082 /* Find an available server process to service the current request in
4083  * the given call structure.  If one isn't available, queue up this
4084  * call so it eventually gets one */
4085 void
4086 rxi_AttachServerProc(register struct rx_call *call,
4087                      register osi_socket socket, register int *tnop,
4088                      register struct rx_call **newcallp)
4089 {
4090     register struct rx_serverQueueEntry *sq;
4091     register struct rx_service *service = call->conn->service;
4092     register int haveQuota = 0;
4093
4094     /* May already be attached */
4095     if (call->state == RX_STATE_ACTIVE)
4096         return;
4097
4098     MUTEX_ENTER(&rx_serverPool_lock);
4099
4100     haveQuota = QuotaOK(service);
4101     if ((!haveQuota) || queue_IsEmpty(&rx_idleServerQueue)) {
4102         /* If there are no processes available to service this call,
4103          * put the call on the incoming call queue (unless it's
4104          * already on the queue).
4105          */
4106 #ifdef RX_ENABLE_LOCKS
4107         if (haveQuota)
4108             ReturnToServerPool(service);
4109 #endif /* RX_ENABLE_LOCKS */
4110
4111         if (!(call->flags & RX_CALL_WAIT_PROC)) {
4112             call->flags |= RX_CALL_WAIT_PROC;
4113             MUTEX_ENTER(&rx_stats_mutex);
4114             rx_nWaiting++;
4115             rx_nWaited++;
4116             MUTEX_EXIT(&rx_stats_mutex);
4117             rxi_calltrace(RX_CALL_ARRIVAL, call);
4118             SET_CALL_QUEUE_LOCK(call, &rx_serverPool_lock);
4119             queue_Append(&rx_incomingCallQueue, call);
4120         }
4121     } else {
4122         sq = queue_First(&rx_idleServerQueue, rx_serverQueueEntry);
4123
4124         /* If hot threads are enabled, and both newcallp and sq->socketp
4125          * are non-null, then this thread will process the call, and the
4126          * idle server thread will start listening on this threads socket.
4127          */
4128         queue_Remove(sq);
4129         if (rx_enable_hot_thread && newcallp && sq->socketp) {
4130             *newcallp = call;
4131             *tnop = sq->tno;
4132             *sq->socketp = socket;
4133             clock_GetTime(&call->startTime);
4134             CALL_HOLD(call, RX_CALL_REFCOUNT_BEGIN);
4135         } else {
4136             sq->newcall = call;
4137         }
4138         if (call->flags & RX_CALL_WAIT_PROC) {
4139             /* Conservative:  I don't think this should happen */
4140             call->flags &= ~RX_CALL_WAIT_PROC;
4141             if (queue_IsOnQueue(call)) {
4142                 queue_Remove(call);
4143                 MUTEX_ENTER(&rx_stats_mutex);
4144                 rx_nWaiting--;
4145                 MUTEX_EXIT(&rx_stats_mutex);
4146             }
4147         }
4148         call->state = RX_STATE_ACTIVE;
4149         call->mode = RX_MODE_RECEIVING;
4150 #ifdef RX_KERNEL_TRACE
4151         {
4152             int glockOwner = ISAFS_GLOCK();
4153             if (!glockOwner)
4154                 AFS_GLOCK();
4155             afs_Trace3(afs_iclSetp, CM_TRACE_WASHERE, ICL_TYPE_STRING,
4156                        __FILE__, ICL_TYPE_INT32, __LINE__, ICL_TYPE_POINTER,
4157                        call);
4158             if (!glockOwner)
4159                 AFS_GUNLOCK();
4160         }
4161 #endif
4162         if (call->flags & RX_CALL_CLEARED) {
4163             /* send an ack now to start the packet flow up again */
4164             call->flags &= ~RX_CALL_CLEARED;
4165             rxi_SendAck(call, 0, 0, RX_ACK_DELAY, 0);
4166         }
4167 #ifdef  RX_ENABLE_LOCKS
4168         CV_SIGNAL(&sq->cv);
4169 #else
4170         service->nRequestsRunning++;
4171         if (service->nRequestsRunning <= service->minProcs)
4172             rxi_minDeficit--;
4173         rxi_availProcs--;
4174         osi_rxWakeup(sq);
4175 #endif
4176     }
4177     MUTEX_EXIT(&rx_serverPool_lock);
4178 }
4179
4180 /* Delay the sending of an acknowledge event for a short while, while
4181  * a new call is being prepared (in the case of a client) or a reply
4182  * is being prepared (in the case of a server).  Rather than sending
4183  * an ack packet, an ACKALL packet is sent. */
4184 void
4185 rxi_AckAll(struct rxevent *event, register struct rx_call *call, char *dummy)
4186 {
4187 #ifdef RX_ENABLE_LOCKS
4188     if (event) {
4189         MUTEX_ENTER(&call->lock);
4190         call->delayedAckEvent = NULL;
4191         CALL_RELE(call, RX_CALL_REFCOUNT_ACKALL);
4192     }
4193     rxi_SendSpecial(call, call->conn, (struct rx_packet *)0,
4194                     RX_PACKET_TYPE_ACKALL, NULL, 0, 0);
4195     if (event)
4196         MUTEX_EXIT(&call->lock);
4197 #else /* RX_ENABLE_LOCKS */
4198     if (event)
4199         call->delayedAckEvent = NULL;
4200     rxi_SendSpecial(call, call->conn, (struct rx_packet *)0,
4201                     RX_PACKET_TYPE_ACKALL, NULL, 0, 0);
4202 #endif /* RX_ENABLE_LOCKS */
4203 }
4204
4205 void
4206 rxi_SendDelayedAck(struct rxevent *event, register struct rx_call *call,
4207                    char *dummy)
4208 {
4209 #ifdef RX_ENABLE_LOCKS
4210     if (event) {
4211         MUTEX_ENTER(&call->lock);
4212         if (event == call->delayedAckEvent)
4213             call->delayedAckEvent = NULL;
4214         CALL_RELE(call, RX_CALL_REFCOUNT_DELAY);
4215     }
4216     (void)rxi_SendAck(call, 0, 0, RX_ACK_DELAY, 0);
4217     if (event)
4218         MUTEX_EXIT(&call->lock);
4219 #else /* RX_ENABLE_LOCKS */
4220     if (event)
4221         call->delayedAckEvent = NULL;
4222     (void)rxi_SendAck(call, 0, 0, RX_ACK_DELAY, 0);
4223 #endif /* RX_ENABLE_LOCKS */
4224 }
4225
4226
4227 #ifdef RX_ENABLE_LOCKS
4228 /* Set ack in all packets in transmit queue. rxi_Start will deal with
4229  * clearing them out.
4230  */
4231 static void
4232 rxi_SetAcksInTransmitQueue(register struct rx_call *call)
4233 {
4234     register struct rx_packet *p, *tp;
4235     int someAcked = 0;
4236
4237     for (queue_Scan(&call->tq, p, tp, rx_packet)) {
4238         p->flags |= RX_PKTFLAG_ACKED;
4239         someAcked = 1;
4240     }
4241     if (someAcked) {
4242         call->flags |= RX_CALL_TQ_CLEARME;
4243         call->flags |= RX_CALL_TQ_SOME_ACKED;
4244     }
4245
4246     rxevent_Cancel(call->resendEvent, call, RX_CALL_REFCOUNT_RESEND);
4247     rxevent_Cancel(call->keepAliveEvent, call, RX_CALL_REFCOUNT_ALIVE);
4248     call->tfirst = call->tnext;
4249     call->nSoftAcked = 0;
4250
4251     if (call->flags & RX_CALL_FAST_RECOVER) {
4252         call->flags &= ~RX_CALL_FAST_RECOVER;
4253         call->cwind = call->nextCwind;
4254         call->nextCwind = 0;
4255     }
4256
4257     CV_SIGNAL(&call->cv_twind);
4258 }
4259 #endif /* RX_ENABLE_LOCKS */
4260
4261 /* Clear out the transmit queue for the current call (all packets have
4262  * been received by peer) */
4263 void
4264 rxi_ClearTransmitQueue(register struct rx_call *call, register int force)
4265 {
4266 #ifdef  AFS_GLOBAL_RXLOCK_KERNEL
4267     register struct rx_packet *p, *tp;
4268
4269     if (!force && (call->flags & RX_CALL_TQ_BUSY)) {
4270         int someAcked = 0;
4271         for (queue_Scan(&call->tq, p, tp, rx_packet)) {
4272             p->flags |= RX_PKTFLAG_ACKED;
4273             someAcked = 1;
4274         }
4275         if (someAcked) {
4276             call->flags |= RX_CALL_TQ_CLEARME;
4277             call->flags |= RX_CALL_TQ_SOME_ACKED;
4278         }
4279     } else {
4280 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
4281         rxi_FreePackets(0, &call->tq);
4282 #ifdef  AFS_GLOBAL_RXLOCK_KERNEL
4283         call->flags &= ~RX_CALL_TQ_CLEARME;
4284     }
4285 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
4286
4287     rxevent_Cancel(call->resendEvent, call, RX_CALL_REFCOUNT_RESEND);
4288     rxevent_Cancel(call->keepAliveEvent, call, RX_CALL_REFCOUNT_ALIVE);
4289     call->tfirst = call->tnext; /* implicitly acknowledge all data already sent */
4290     call->nSoftAcked = 0;
4291
4292     if (call->flags & RX_CALL_FAST_RECOVER) {
4293         call->flags &= ~RX_CALL_FAST_RECOVER;
4294         call->cwind = call->nextCwind;
4295     }
4296 #ifdef  RX_ENABLE_LOCKS
4297     CV_SIGNAL(&call->cv_twind);
4298 #else
4299     osi_rxWakeup(&call->twind);
4300 #endif
4301 }
4302
4303 void
4304 rxi_ClearReceiveQueue(register struct rx_call *call)
4305 {
4306     if (queue_IsNotEmpty(&call->rq)) {
4307         rx_packetReclaims += rxi_FreePackets(0, &call->rq);
4308         call->flags &= ~(RX_CALL_RECEIVE_DONE | RX_CALL_HAVE_LAST);
4309     }
4310     if (call->state == RX_STATE_PRECALL) {
4311         call->flags |= RX_CALL_CLEARED;
4312     }
4313 }
4314
4315 /* Send an abort packet for the specified call */
4316 struct rx_packet *
4317 rxi_SendCallAbort(register struct rx_call *call, struct rx_packet *packet,
4318                   int istack, int force)
4319 {
4320     afs_int32 error;
4321     struct clock when;
4322
4323     if (!call->error)
4324         return packet;
4325
4326     /* Clients should never delay abort messages */
4327     if (rx_IsClientConn(call->conn))
4328         force = 1;
4329
4330     if (call->abortCode != call->error) {
4331         call->abortCode = call->error;
4332         call->abortCount = 0;
4333     }
4334
4335     if (force || rxi_callAbortThreshhold == 0
4336         || call->abortCount < rxi_callAbortThreshhold) {
4337         if (call->delayedAbortEvent) {
4338             rxevent_Cancel(call->delayedAbortEvent, call,
4339                            RX_CALL_REFCOUNT_ABORT);
4340         }
4341         error = htonl(call->error);
4342         call->abortCount++;
4343         packet =
4344             rxi_SendSpecial(call, call->conn, packet, RX_PACKET_TYPE_ABORT,
4345                             (char *)&error, sizeof(error), istack);
4346     } else if (!call->delayedAbortEvent) {
4347         clock_GetTime(&when);
4348         clock_Addmsec(&when, rxi_callAbortDelay);
4349         CALL_HOLD(call, RX_CALL_REFCOUNT_ABORT);
4350         call->delayedAbortEvent =
4351             rxevent_Post(&when, rxi_SendDelayedCallAbort, call, 0);
4352     }
4353     return packet;
4354 }
4355
4356 /* Send an abort packet for the specified connection.  Packet is an
4357  * optional pointer to a packet that can be used to send the abort.
4358  * Once the number of abort messages reaches the threshhold, an
4359  * event is scheduled to send the abort. Setting the force flag
4360  * overrides sending delayed abort messages.
4361  *
4362  * NOTE: Called with conn_data_lock held. con