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