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