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