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