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