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