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