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