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