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