2 * Copyright 2000, International Business Machines Corporation and others.
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
10 /* RX: Extended Remote Procedure Call */
12 #include <afsconfig.h>
13 #include <afs/param.h>
16 # include "afs/sysincludes.h"
17 # include "afsincludes.h"
22 # ifdef AFS_LINUX20_ENV
23 # include "h/socket.h"
25 # include "netinet/in.h"
27 # include "netinet/ip6.h"
28 # include "inet/common.h"
30 # include "inet/ip_ire.h"
32 # include "afs/afs_args.h"
33 # include "afs/afs_osi.h"
34 # ifdef RX_KERNEL_TRACE
35 # include "rx_kcommon.h"
37 # if defined(AFS_AIX_ENV)
41 # undef RXDEBUG /* turn off debugging */
43 # if defined(AFS_SGI_ENV)
44 # include "sys/debug.h"
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;
58 # include "sys/lockl.h"
59 # include "sys/lock_def.h"
60 # endif /* AFS_AIX41_ENV */
61 # include "afs/rxgen_consts.h"
66 # include <afs/afsutil.h>
67 # include <WINNT\afsreg.h>
75 #include <opr/queue.h>
76 #include <hcrypto/rand.h>
80 #include "rx_atomic.h"
81 #include "rx_globals.h"
83 #include "rx_internal.h"
90 #include "rx_packet.h"
91 #include "rx_server.h"
93 #include <afs/rxgen_consts.h>
96 #ifdef AFS_PTHREAD_ENV
98 int (*registerProgram) (pid_t, char *) = 0;
99 int (*swapNameProgram) (pid_t, const char *, char *) = 0;
102 int (*registerProgram) (PROCESS, char *) = 0;
103 int (*swapNameProgram) (PROCESS, const char *, char *) = 0;
107 /* Local static routines */
108 static void rxi_DestroyConnectionNoLock(struct rx_connection *conn);
109 static void rxi_ComputeRoundTripTime(struct rx_packet *, struct rx_ackPacket *,
110 struct rx_call *, struct rx_peer *,
112 static void rxi_Resend(struct rxevent *event, void *arg0, void *arg1,
114 static void rxi_SendDelayedAck(struct rxevent *event, void *call,
115 void *dummy, int dummy2);
116 static void rxi_SendDelayedCallAbort(struct rxevent *event, void *arg1,
117 void *dummy, int dummy2);
118 static void rxi_SendDelayedConnAbort(struct rxevent *event, void *arg1,
119 void *unused, int unused2);
120 static void rxi_ReapConnections(struct rxevent *unused, void *unused1,
121 void *unused2, int unused3);
122 static struct rx_packet *rxi_SendCallAbort(struct rx_call *call,
123 struct rx_packet *packet,
124 int istack, int force);
125 static void rxi_AckAll(struct rx_call *call);
126 static struct rx_connection
127 *rxi_FindConnection(osi_socket socket, afs_uint32 host, u_short port,
128 u_short serviceId, afs_uint32 cid,
129 afs_uint32 epoch, int type, u_int securityIndex,
130 int *unknownService);
131 static struct rx_packet
132 *rxi_ReceiveDataPacket(struct rx_call *call, struct rx_packet *np,
133 int istack, osi_socket socket,
134 afs_uint32 host, u_short port, int *tnop,
135 struct rx_call **newcallp);
136 static struct rx_packet
137 *rxi_ReceiveAckPacket(struct rx_call *call, struct rx_packet *np,
139 static struct rx_packet
140 *rxi_ReceiveResponsePacket(struct rx_connection *conn,
141 struct rx_packet *np, int istack);
142 static struct rx_packet
143 *rxi_ReceiveChallengePacket(struct rx_connection *conn,
144 struct rx_packet *np, int istack);
145 static void rxi_AttachServerProc(struct rx_call *call, osi_socket socket,
146 int *tnop, struct rx_call **newcallp);
147 static void rxi_ClearTransmitQueue(struct rx_call *call, int force);
148 static void rxi_ClearReceiveQueue(struct rx_call *call);
149 static void rxi_ResetCall(struct rx_call *call, int newcall);
150 static void rxi_ScheduleKeepAliveEvent(struct rx_call *call);
151 static void rxi_ScheduleNatKeepAliveEvent(struct rx_connection *conn);
152 static void rxi_ScheduleGrowMTUEvent(struct rx_call *call, int secs);
153 static void rxi_KeepAliveOn(struct rx_call *call);
154 static void rxi_GrowMTUOn(struct rx_call *call);
155 static void rxi_ChallengeOn(struct rx_connection *conn);
156 static int rxi_CheckCall(struct rx_call *call, int haveCTLock);
157 static void rxi_AckAllInTransmitQueue(struct rx_call *call);
158 static void rxi_CancelKeepAliveEvent(struct rx_call *call);
159 static void rxi_CancelDelayedAbortEvent(struct rx_call *call);
160 static void rxi_CancelGrowMTUEvent(struct rx_call *call);
161 static void update_nextCid(void);
163 #ifdef RX_ENABLE_LOCKS
165 rx_atomic_t rxi_start_aborted; /* rxi_start awoke after rxi_Send in error.*/
166 rx_atomic_t rxi_start_in_error;
168 #endif /* RX_ENABLE_LOCKS */
170 /* Constant delay time before sending an acknowledge of the last packet
171 * received. This is to avoid sending an extra acknowledge when the
172 * client is about to make another call, anyway, or the server is
175 * The lastAckDelay may not exceeed 400ms without causing peers to
176 * unecessarily timeout.
178 struct clock rx_lastAckDelay = {0, 400000};
180 /* Constant delay time before sending a soft ack when none was requested.
181 * This is to make sure we send soft acks before the sender times out,
182 * Normally we wait and send a hard ack when the receiver consumes the packet
184 * This value has been 100ms in all shipping versions of OpenAFS. Changing it
185 * will require changes to the peer's RTT calculations.
187 struct clock rx_softAckDelay = {0, 100000};
190 * rxi_rpc_peer_stat_cnt counts the total number of peer stat structures
191 * currently allocated within rx. This number is used to allocate the
192 * memory required to return the statistics when queried.
193 * Protected by the rx_rpc_stats mutex.
196 static unsigned int rxi_rpc_peer_stat_cnt;
199 * rxi_rpc_process_stat_cnt counts the total number of local process stat
200 * structures currently allocated within rx. The number is used to allocate
201 * the memory required to return the statistics when queried.
202 * Protected by the rx_rpc_stats mutex.
205 static unsigned int rxi_rpc_process_stat_cnt;
207 rx_atomic_t rx_nWaiting = RX_ATOMIC_INIT(0);
208 rx_atomic_t rx_nWaited = RX_ATOMIC_INIT(0);
210 /* Incoming calls wait on this queue when there are no available
211 * server processes */
212 struct opr_queue rx_incomingCallQueue;
214 /* Server processes wait on this queue when there are no appropriate
215 * calls to process */
216 struct opr_queue rx_idleServerQueue;
218 #if !defined(offsetof)
219 #include <stddef.h> /* for definition of offsetof() */
222 #ifdef RX_ENABLE_LOCKS
223 afs_kmutex_t rx_atomic_mutex;
226 /* Forward prototypes */
227 static struct rx_call * rxi_NewCall(struct rx_connection *, int);
230 putConnection (struct rx_connection *conn) {
231 MUTEX_ENTER(&rx_refcnt_mutex);
233 MUTEX_EXIT(&rx_refcnt_mutex);
236 #ifdef AFS_PTHREAD_ENV
239 * Use procedural initialization of mutexes/condition variables
243 extern afs_kmutex_t rx_quota_mutex;
244 extern afs_kmutex_t rx_pthread_mutex;
245 extern afs_kmutex_t rx_packets_mutex;
246 extern afs_kmutex_t rx_refcnt_mutex;
247 extern afs_kmutex_t des_init_mutex;
248 extern afs_kmutex_t des_random_mutex;
250 extern afs_kmutex_t rx_clock_mutex;
251 extern afs_kmutex_t rxi_connCacheMutex;
252 extern afs_kmutex_t event_handler_mutex;
253 extern afs_kmutex_t listener_mutex;
254 extern afs_kmutex_t rx_if_init_mutex;
255 extern afs_kmutex_t rx_if_mutex;
257 extern afs_kcondvar_t rx_event_handler_cond;
258 extern afs_kcondvar_t rx_listener_cond;
261 static afs_kmutex_t epoch_mutex;
262 static afs_kmutex_t rx_init_mutex;
263 static afs_kmutex_t rx_debug_mutex;
264 static afs_kmutex_t rx_rpc_stats;
267 rxi_InitPthread(void)
269 MUTEX_INIT(&rx_quota_mutex, "quota", MUTEX_DEFAULT, 0);
270 MUTEX_INIT(&rx_pthread_mutex, "pthread", MUTEX_DEFAULT, 0);
271 MUTEX_INIT(&rx_packets_mutex, "packets", MUTEX_DEFAULT, 0);
272 MUTEX_INIT(&rx_refcnt_mutex, "refcnts", MUTEX_DEFAULT, 0);
274 MUTEX_INIT(&rx_clock_mutex, "clock", MUTEX_DEFAULT, 0);
275 MUTEX_INIT(&rxi_connCacheMutex, "conn cache", MUTEX_DEFAULT, 0);
276 MUTEX_INIT(&event_handler_mutex, "event handler", MUTEX_DEFAULT, 0);
277 MUTEX_INIT(&listener_mutex, "listener", MUTEX_DEFAULT, 0);
278 MUTEX_INIT(&rx_if_init_mutex, "if init", MUTEX_DEFAULT, 0);
279 MUTEX_INIT(&rx_if_mutex, "if", MUTEX_DEFAULT, 0);
281 MUTEX_INIT(&rx_stats_mutex, "stats", MUTEX_DEFAULT, 0);
282 MUTEX_INIT(&rx_atomic_mutex, "atomic", MUTEX_DEFAULT, 0);
283 MUTEX_INIT(&epoch_mutex, "epoch", MUTEX_DEFAULT, 0);
284 MUTEX_INIT(&rx_init_mutex, "init", MUTEX_DEFAULT, 0);
285 MUTEX_INIT(&rx_debug_mutex, "debug", MUTEX_DEFAULT, 0);
288 CV_INIT(&rx_event_handler_cond, "evhand", CV_DEFAULT, 0);
289 CV_INIT(&rx_listener_cond, "rxlisten", CV_DEFAULT, 0);
292 osi_Assert(pthread_key_create(&rx_thread_id_key, NULL) == 0);
293 osi_Assert(pthread_key_create(&rx_ts_info_key, NULL) == 0);
295 MUTEX_INIT(&rx_rpc_stats, "rx_rpc_stats", MUTEX_DEFAULT, 0);
296 MUTEX_INIT(&rx_freePktQ_lock, "rx_freePktQ_lock", MUTEX_DEFAULT, 0);
297 MUTEX_INIT(&rx_mallocedPktQ_lock, "rx_mallocedPktQ_lock", MUTEX_DEFAULT,
300 #ifdef RX_ENABLE_LOCKS
303 #endif /* RX_LOCKS_DB */
304 MUTEX_INIT(&freeSQEList_lock, "freeSQEList lock", MUTEX_DEFAULT, 0);
305 MUTEX_INIT(&rx_freeCallQueue_lock, "rx_freeCallQueue_lock", MUTEX_DEFAULT,
307 CV_INIT(&rx_waitingForPackets_cv, "rx_waitingForPackets_cv", CV_DEFAULT,
309 MUTEX_INIT(&rx_peerHashTable_lock, "rx_peerHashTable_lock", MUTEX_DEFAULT,
311 MUTEX_INIT(&rx_connHashTable_lock, "rx_connHashTable_lock", MUTEX_DEFAULT,
313 MUTEX_INIT(&rx_serverPool_lock, "rx_serverPool_lock", MUTEX_DEFAULT, 0);
315 MUTEX_INIT(&rxi_keyCreate_lock, "rxi_keyCreate_lock", MUTEX_DEFAULT, 0);
317 #endif /* RX_ENABLE_LOCKS */
320 pthread_once_t rx_once_init = PTHREAD_ONCE_INIT;
321 #define INIT_PTHREAD_LOCKS osi_Assert(pthread_once(&rx_once_init, rxi_InitPthread)==0)
323 * The rx_stats_mutex mutex protects the following global variables:
324 * rxi_lowConnRefCount
325 * rxi_lowPeerRefCount
334 * The rx_quota_mutex mutex protects the following global variables:
342 * The rx_freePktQ_lock protects the following global variables:
347 * The rx_packets_mutex mutex protects the following global variables:
355 * The rx_pthread_mutex mutex protects the following global variables:
356 * rxi_fcfs_thread_num
359 #define INIT_PTHREAD_LOCKS
363 /* Variables for handling the minProcs implementation. availProcs gives the
364 * number of threads available in the pool at this moment (not counting dudes
365 * executing right now). totalMin gives the total number of procs required
366 * for handling all minProcs requests. minDeficit is a dynamic variable
367 * tracking the # of procs required to satisfy all of the remaining minProcs
369 * For fine grain locking to work, the quota check and the reservation of
370 * a server thread has to come while rxi_availProcs and rxi_minDeficit
371 * are locked. To this end, the code has been modified under #ifdef
372 * RX_ENABLE_LOCKS so that quota checks and reservation occur at the
373 * same time. A new function, ReturnToServerPool() returns the allocation.
375 * A call can be on several queue's (but only one at a time). When
376 * rxi_ResetCall wants to remove the call from a queue, it has to ensure
377 * that no one else is touching the queue. To this end, we store the address
378 * of the queue lock in the call structure (under the call lock) when we
379 * put the call on a queue, and we clear the call_queue_lock when the
380 * call is removed from a queue (once the call lock has been obtained).
381 * This allows rxi_ResetCall to safely synchronize with others wishing
382 * to manipulate the queue.
385 #if defined(RX_ENABLE_LOCKS)
386 static afs_kmutex_t rx_rpc_stats;
389 /* We keep a "last conn pointer" in rxi_FindConnection. The odds are
390 ** pretty good that the next packet coming in is from the same connection
391 ** as the last packet, since we're send multiple packets in a transmit window.
393 struct rx_connection *rxLastConn = 0;
395 #ifdef RX_ENABLE_LOCKS
396 /* The locking hierarchy for rx fine grain locking is composed of these
399 * rx_connHashTable_lock - synchronizes conn creation, rx_connHashTable access
400 * also protects updates to rx_nextCid
401 * conn_call_lock - used to synchonize rx_EndCall and rx_NewCall
402 * call->lock - locks call data fields.
403 * These are independent of each other:
404 * rx_freeCallQueue_lock
409 * serverQueueEntry->lock
410 * rx_peerHashTable_lock - locked under rx_connHashTable_lock
412 * peer->lock - locks peer data fields.
413 * conn_data_lock - that more than one thread is not updating a conn data
414 * field at the same time.
425 * Do we need a lock to protect the peer field in the conn structure?
426 * conn->peer was previously a constant for all intents and so has no
427 * lock protecting this field. The multihomed client delta introduced
428 * a RX code change : change the peer field in the connection structure
429 * to that remote interface from which the last packet for this
430 * connection was sent out. This may become an issue if further changes
433 #define SET_CALL_QUEUE_LOCK(C, L) (C)->call_queue_lock = (L)
434 #define CLEAR_CALL_QUEUE_LOCK(C) (C)->call_queue_lock = NULL
436 /* rxdb_fileID is used to identify the lock location, along with line#. */
437 static int rxdb_fileID = RXDB_FILE_RX;
438 #endif /* RX_LOCKS_DB */
439 #else /* RX_ENABLE_LOCKS */
440 #define SET_CALL_QUEUE_LOCK(C, L)
441 #define CLEAR_CALL_QUEUE_LOCK(C)
442 #endif /* RX_ENABLE_LOCKS */
443 struct rx_serverQueueEntry *rx_waitForPacket = 0;
445 /* ------------Exported Interfaces------------- */
447 /* Initialize rx. A port number may be mentioned, in which case this
448 * becomes the default port number for any service installed later.
449 * If 0 is provided for the port number, a random port will be chosen
450 * by the kernel. Whether this will ever overlap anything in
451 * /etc/services is anybody's guess... Returns 0 on success, -1 on
453 #if !(defined(AFS_NT40_ENV) || defined(RXK_UPCALL_ENV))
456 rx_atomic_t rxinit_status = RX_ATOMIC_INIT(1);
459 rx_InitHost(u_int host, u_int port)
466 char *htable, *ptable;
471 if (!rx_atomic_test_and_clear_bit(&rxinit_status, 0))
472 return 0; /* already started */
478 if (afs_winsockInit() < 0)
484 * Initialize anything necessary to provide a non-premptive threading
487 rxi_InitializeThreadSupport();
490 /* Allocate and initialize a socket for client and perhaps server
493 rx_socket = rxi_GetHostUDPSocket(host, (u_short) port);
494 if (rx_socket == OSI_NULLSOCKET) {
497 #if defined(RX_ENABLE_LOCKS) && defined(KERNEL)
500 #endif /* RX_LOCKS_DB */
501 MUTEX_INIT(&rx_stats_mutex, "rx_stats_mutex", MUTEX_DEFAULT, 0);
502 MUTEX_INIT(&rx_quota_mutex, "rx_quota_mutex", MUTEX_DEFAULT, 0);
503 MUTEX_INIT(&rx_atomic_mutex, "rx_atomic_mutex", MUTEX_DEFAULT, 0);
504 MUTEX_INIT(&rx_pthread_mutex, "rx_pthread_mutex", MUTEX_DEFAULT, 0);
505 MUTEX_INIT(&rx_packets_mutex, "rx_packets_mutex", MUTEX_DEFAULT, 0);
506 MUTEX_INIT(&rx_refcnt_mutex, "rx_refcnt_mutex", MUTEX_DEFAULT, 0);
507 MUTEX_INIT(&rx_rpc_stats, "rx_rpc_stats", MUTEX_DEFAULT, 0);
508 MUTEX_INIT(&rx_freePktQ_lock, "rx_freePktQ_lock", MUTEX_DEFAULT, 0);
509 MUTEX_INIT(&freeSQEList_lock, "freeSQEList lock", MUTEX_DEFAULT, 0);
510 MUTEX_INIT(&rx_freeCallQueue_lock, "rx_freeCallQueue_lock", MUTEX_DEFAULT,
512 CV_INIT(&rx_waitingForPackets_cv, "rx_waitingForPackets_cv", CV_DEFAULT,
514 MUTEX_INIT(&rx_peerHashTable_lock, "rx_peerHashTable_lock", MUTEX_DEFAULT,
516 MUTEX_INIT(&rx_connHashTable_lock, "rx_connHashTable_lock", MUTEX_DEFAULT,
518 MUTEX_INIT(&rx_serverPool_lock, "rx_serverPool_lock", MUTEX_DEFAULT, 0);
519 MUTEX_INIT(&rx_mallocedPktQ_lock, "rx_mallocedPktQ_lock", MUTEX_DEFAULT,
522 #if defined(AFS_HPUX110_ENV)
524 rx_sleepLock = alloc_spinlock(LAST_HELD_ORDER - 10, "rx_sleepLock");
525 #endif /* AFS_HPUX110_ENV */
526 #endif /* RX_ENABLE_LOCKS && KERNEL */
529 rx_connDeadTime = 12;
530 rx_tranquil = 0; /* reset flag */
531 rxi_ResetStatistics();
532 htable = osi_Alloc(rx_hashTableSize * sizeof(struct rx_connection *));
533 PIN(htable, rx_hashTableSize * sizeof(struct rx_connection *)); /* XXXXX */
534 memset(htable, 0, rx_hashTableSize * sizeof(struct rx_connection *));
535 ptable = osi_Alloc(rx_hashTableSize * sizeof(struct rx_peer *));
536 PIN(ptable, rx_hashTableSize * sizeof(struct rx_peer *)); /* XXXXX */
537 memset(ptable, 0, rx_hashTableSize * sizeof(struct rx_peer *));
539 /* Malloc up a bunch of packets & buffers */
541 opr_queue_Init(&rx_freePacketQueue);
542 rxi_NeedMorePackets = FALSE;
543 rx_nPackets = 0; /* rx_nPackets is managed by rxi_MorePackets* */
544 opr_queue_Init(&rx_mallocedPacketQueue);
546 /* enforce a minimum number of allocated packets */
547 if (rx_extraPackets < rxi_nSendFrags * rx_maxSendWindow)
548 rx_extraPackets = rxi_nSendFrags * rx_maxSendWindow;
550 /* allocate the initial free packet pool */
551 #ifdef RX_ENABLE_TSFPQ
552 rxi_MorePacketsTSFPQ(rx_extraPackets + RX_MAX_QUOTA + 2, RX_TS_FPQ_FLUSH_GLOBAL, 0);
553 #else /* RX_ENABLE_TSFPQ */
554 rxi_MorePackets(rx_extraPackets + RX_MAX_QUOTA + 2); /* fudge */
555 #endif /* RX_ENABLE_TSFPQ */
562 #if defined(AFS_NT40_ENV) && !defined(AFS_PTHREAD_ENV)
563 tv.tv_sec = clock_now.sec;
564 tv.tv_usec = clock_now.usec;
565 srand((unsigned int)tv.tv_usec);
572 #if defined(KERNEL) && !defined(UKERNEL)
573 /* Really, this should never happen in a real kernel */
576 struct sockaddr_in addr;
578 int addrlen = sizeof(addr);
580 socklen_t addrlen = sizeof(addr);
582 if (getsockname((intptr_t)rx_socket, (struct sockaddr *)&addr, &addrlen)) {
584 osi_Free(htable, rx_hashTableSize * sizeof(struct rx_connection *));
587 rx_port = addr.sin_port;
590 rx_stats.minRtt.sec = 9999999;
591 if (RAND_bytes(&rx_epoch, sizeof(rx_epoch)) != 1)
593 rx_epoch = (rx_epoch & ~0x40000000) | 0x80000000;
594 if (RAND_bytes(&rx_nextCid, sizeof(rx_nextCid)) != 1)
596 rx_nextCid &= RX_CIDMASK;
597 MUTEX_ENTER(&rx_quota_mutex);
598 rxi_dataQuota += rx_extraQuota; /* + extra pkts caller asked to rsrv */
599 MUTEX_EXIT(&rx_quota_mutex);
600 /* *Slightly* random start time for the cid. This is just to help
601 * out with the hashing function at the peer */
602 rx_nextCid = ((tv.tv_sec ^ tv.tv_usec) << RX_CIDSHIFT);
603 rx_connHashTable = (struct rx_connection **)htable;
604 rx_peerHashTable = (struct rx_peer **)ptable;
606 rx_hardAckDelay.sec = 0;
607 rx_hardAckDelay.usec = 100000; /* 100 milliseconds */
609 rxevent_Init(20, rxi_ReScheduleEvents);
611 /* Initialize various global queues */
612 opr_queue_Init(&rx_idleServerQueue);
613 opr_queue_Init(&rx_incomingCallQueue);
614 opr_queue_Init(&rx_freeCallQueue);
616 #if defined(AFS_NT40_ENV) && !defined(KERNEL)
617 /* Initialize our list of usable IP addresses. */
621 /* Start listener process (exact function is dependent on the
622 * implementation environment--kernel or user space) */
626 rx_atomic_clear_bit(&rxinit_status, 0);
633 return rx_InitHost(htonl(INADDR_ANY), port);
639 * The rxi_rto functions implement a TCP (RFC2988) style algorithm for
640 * maintaing the round trip timer.
645 * Start a new RTT timer for a given call and packet.
647 * There must be no resendEvent already listed for this call, otherwise this
648 * will leak events - intended for internal use within the RTO code only
651 * the RX call to start the timer for
652 * @param[in] lastPacket
653 * a flag indicating whether the last packet has been sent or not
655 * @pre call must be locked before calling this function
659 rxi_rto_startTimer(struct rx_call *call, int lastPacket, int istack)
661 struct clock now, retryTime;
663 MUTEX_ASSERT(&call->lock);
667 clock_Add(&retryTime, &call->rto);
669 /* If we're sending the last packet, and we're the client, then the server
670 * may wait for an additional 400ms before returning the ACK, wait for it
671 * rather than hitting a timeout */
672 if (lastPacket && call->conn->type == RX_CLIENT_CONNECTION)
673 clock_Addmsec(&retryTime, 400);
675 CALL_HOLD(call, RX_CALL_REFCOUNT_RESEND);
676 call->resendEvent = rxevent_Post(&retryTime, &now, rxi_Resend,
681 * Cancel an RTT timer for a given call.
685 * the RX call to cancel the timer for
687 * @pre call must be locked before calling this function
692 rxi_rto_cancel(struct rx_call *call)
694 MUTEX_ASSERT(&call->lock);
695 if (rxevent_Cancel(&call->resendEvent))
696 CALL_RELE(call, RX_CALL_REFCOUNT_RESEND);
700 * Tell the RTO timer that we have sent a packet.
702 * If the timer isn't already running, then start it. If the timer is running,
706 * the RX call that the packet has been sent on
707 * @param[in] lastPacket
708 * A flag which is true if this is the last packet for the call
710 * @pre The call must be locked before calling this function
715 rxi_rto_packet_sent(struct rx_call *call, int lastPacket, int istack)
717 if (call->resendEvent)
720 rxi_rto_startTimer(call, lastPacket, istack);
724 * Tell the RTO timer that we have received an new ACK message
726 * This function should be called whenever a call receives an ACK that
727 * acknowledges new packets. Whatever happens, we stop the current timer.
728 * If there are unacked packets in the queue which have been sent, then
729 * we restart the timer from now. Otherwise, we leave it stopped.
732 * the RX call that the ACK has been received on
736 rxi_rto_packet_acked(struct rx_call *call, int istack)
738 struct opr_queue *cursor;
740 rxi_rto_cancel(call);
742 if (opr_queue_IsEmpty(&call->tq))
745 for (opr_queue_Scan(&call->tq, cursor)) {
746 struct rx_packet *p = opr_queue_Entry(cursor, struct rx_packet, entry);
747 if (p->header.seq > call->tfirst + call->twind)
750 if (!(p->flags & RX_PKTFLAG_ACKED) && p->flags & RX_PKTFLAG_SENT) {
751 rxi_rto_startTimer(call, p->header.flags & RX_LAST_PACKET, istack);
759 * Set an initial round trip timeout for a peer connection
761 * @param[in] secs The timeout to set in seconds
765 rx_rto_setPeerTimeoutSecs(struct rx_peer *peer, int secs) {
766 peer->rtt = secs * 8000;
770 * Set a delayed ack event on the specified call for the given time
772 * @param[in] call - the call on which to set the event
773 * @param[in] offset - the delay from now after which the event fires
776 rxi_PostDelayedAckEvent(struct rx_call *call, struct clock *offset)
778 struct clock now, when;
780 MUTEX_ASSERT(&call->lock);
783 clock_Add(&when, offset);
785 if (clock_Gt(&call->delayedAckTime, &when) &&
786 rxevent_Cancel(&call->delayedAckEvent)) {
787 /* We successfully cancelled an event too far in the future to install
788 * our new one; we can reuse the reference on the call. */
789 call->delayedAckEvent = rxevent_Post(&when, &now, rxi_SendDelayedAck,
792 call->delayedAckTime = when;
793 } else if (call->delayedAckEvent == NULL) {
794 CALL_HOLD(call, RX_CALL_REFCOUNT_DELAY);
795 call->delayedAckEvent = rxevent_Post(&when, &now,
798 call->delayedAckTime = when;
803 rxi_CancelDelayedAckEvent(struct rx_call *call)
805 MUTEX_ASSERT(&call->lock);
806 /* Only drop the ref if we cancelled it before it could run. */
807 if (rxevent_Cancel(&call->delayedAckEvent))
808 CALL_RELE(call, RX_CALL_REFCOUNT_DELAY);
811 /* called with unincremented nRequestsRunning to see if it is OK to start
812 * a new thread in this service. Could be "no" for two reasons: over the
813 * max quota, or would prevent others from reaching their min quota.
815 #ifdef RX_ENABLE_LOCKS
816 /* This verion of QuotaOK reserves quota if it's ok while the
817 * rx_serverPool_lock is held. Return quota using ReturnToServerPool().
820 QuotaOK(struct rx_service *aservice)
822 /* check if over max quota */
823 if (aservice->nRequestsRunning >= aservice->maxProcs) {
827 /* under min quota, we're OK */
828 /* otherwise, can use only if there are enough to allow everyone
829 * to go to their min quota after this guy starts.
832 MUTEX_ENTER(&rx_quota_mutex);
833 if ((aservice->nRequestsRunning < aservice->minProcs)
834 || (rxi_availProcs > rxi_minDeficit)) {
835 aservice->nRequestsRunning++;
836 /* just started call in minProcs pool, need fewer to maintain
838 if (aservice->nRequestsRunning <= aservice->minProcs)
841 MUTEX_EXIT(&rx_quota_mutex);
844 MUTEX_EXIT(&rx_quota_mutex);
850 ReturnToServerPool(struct rx_service *aservice)
852 aservice->nRequestsRunning--;
853 MUTEX_ENTER(&rx_quota_mutex);
854 if (aservice->nRequestsRunning < aservice->minProcs)
857 MUTEX_EXIT(&rx_quota_mutex);
860 #else /* RX_ENABLE_LOCKS */
862 QuotaOK(struct rx_service *aservice)
865 /* under min quota, we're OK */
866 if (aservice->nRequestsRunning < aservice->minProcs)
869 /* check if over max quota */
870 if (aservice->nRequestsRunning >= aservice->maxProcs)
873 /* otherwise, can use only if there are enough to allow everyone
874 * to go to their min quota after this guy starts.
876 MUTEX_ENTER(&rx_quota_mutex);
877 if (rxi_availProcs > rxi_minDeficit)
879 MUTEX_EXIT(&rx_quota_mutex);
882 #endif /* RX_ENABLE_LOCKS */
885 /* Called by rx_StartServer to start up lwp's to service calls.
886 NExistingProcs gives the number of procs already existing, and which
887 therefore needn't be created. */
889 rxi_StartServerProcs(int nExistingProcs)
891 struct rx_service *service;
896 /* For each service, reserve N processes, where N is the "minimum"
897 * number of processes that MUST be able to execute a request in parallel,
898 * at any time, for that process. Also compute the maximum difference
899 * between any service's maximum number of processes that can run
900 * (i.e. the maximum number that ever will be run, and a guarantee
901 * that this number will run if other services aren't running), and its
902 * minimum number. The result is the extra number of processes that
903 * we need in order to provide the latter guarantee */
904 for (i = 0; i < RX_MAX_SERVICES; i++) {
906 service = rx_services[i];
907 if (service == (struct rx_service *)0)
909 nProcs += service->minProcs;
910 diff = service->maxProcs - service->minProcs;
914 nProcs += maxdiff; /* Extra processes needed to allow max number requested to run in any given service, under good conditions */
915 nProcs -= nExistingProcs; /* Subtract the number of procs that were previously created for use as server procs */
916 for (i = 0; i < nProcs; i++) {
917 rxi_StartServerProc(rx_ServerProc, rx_stackSize);
923 /* This routine is only required on Windows */
925 rx_StartClientThread(void)
927 #ifdef AFS_PTHREAD_ENV
929 pid = pthread_self();
930 #endif /* AFS_PTHREAD_ENV */
932 #endif /* AFS_NT40_ENV */
934 /* This routine must be called if any services are exported. If the
935 * donateMe flag is set, the calling process is donated to the server
938 rx_StartServer(int donateMe)
940 struct rx_service *service;
946 /* Start server processes, if necessary (exact function is dependent
947 * on the implementation environment--kernel or user space). DonateMe
948 * will be 1 if there is 1 pre-existing proc, i.e. this one. In this
949 * case, one less new proc will be created rx_StartServerProcs.
951 rxi_StartServerProcs(donateMe);
953 /* count up the # of threads in minProcs, and add set the min deficit to
954 * be that value, too.
956 for (i = 0; i < RX_MAX_SERVICES; i++) {
957 service = rx_services[i];
958 if (service == (struct rx_service *)0)
960 MUTEX_ENTER(&rx_quota_mutex);
961 rxi_totalMin += service->minProcs;
962 /* below works even if a thread is running, since minDeficit would
963 * still have been decremented and later re-incremented.
965 rxi_minDeficit += service->minProcs;
966 MUTEX_EXIT(&rx_quota_mutex);
969 /* Turn on reaping of idle server connections */
970 rxi_ReapConnections(NULL, NULL, NULL, 0);
979 #ifdef AFS_PTHREAD_ENV
981 pid = afs_pointer_to_int(pthread_self());
982 #else /* AFS_PTHREAD_ENV */
984 LWP_CurrentProcess(&pid);
985 #endif /* AFS_PTHREAD_ENV */
987 sprintf(name, "srv_%d", ++nProcs);
989 (*registerProgram) (pid, name);
991 #endif /* AFS_NT40_ENV */
992 rx_ServerProc(NULL); /* Never returns */
994 #ifdef RX_ENABLE_TSFPQ
995 /* no use leaving packets around in this thread's local queue if
996 * it isn't getting donated to the server thread pool.
998 rxi_FlushLocalPacketsTSFPQ();
999 #endif /* RX_ENABLE_TSFPQ */
1003 /* Create a new client connection to the specified service, using the
1004 * specified security object to implement the security model for this
1006 struct rx_connection *
1007 rx_NewConnection(afs_uint32 shost, u_short sport, u_short sservice,
1008 struct rx_securityClass *securityObject,
1009 int serviceSecurityIndex)
1012 struct rx_connection *conn;
1017 dpf(("rx_NewConnection(host %x, port %u, service %u, securityObject %p, "
1018 "serviceSecurityIndex %d)\n",
1019 ntohl(shost), ntohs(sport), sservice, securityObject,
1020 serviceSecurityIndex));
1022 /* Vasilsi said: "NETPRI protects Cid and Alloc", but can this be true in
1023 * the case of kmem_alloc? */
1024 conn = rxi_AllocConnection();
1025 #ifdef RX_ENABLE_LOCKS
1026 MUTEX_INIT(&conn->conn_call_lock, "conn call lock", MUTEX_DEFAULT, 0);
1027 MUTEX_INIT(&conn->conn_data_lock, "conn data lock", MUTEX_DEFAULT, 0);
1028 CV_INIT(&conn->conn_call_cv, "conn call cv", CV_DEFAULT, 0);
1031 MUTEX_ENTER(&rx_connHashTable_lock);
1032 conn->type = RX_CLIENT_CONNECTION;
1033 conn->epoch = rx_epoch;
1034 conn->cid = rx_nextCid;
1036 conn->peer = rxi_FindPeer(shost, sport, 1);
1037 conn->serviceId = sservice;
1038 conn->securityObject = securityObject;
1039 conn->securityData = (void *) 0;
1040 conn->securityIndex = serviceSecurityIndex;
1041 rx_SetConnDeadTime(conn, rx_connDeadTime);
1042 rx_SetConnSecondsUntilNatPing(conn, 0);
1043 conn->ackRate = RX_FAST_ACK_RATE;
1044 conn->nSpecific = 0;
1045 conn->specific = NULL;
1046 conn->challengeEvent = NULL;
1047 conn->delayedAbortEvent = NULL;
1048 conn->abortCount = 0;
1050 for (i = 0; i < RX_MAXCALLS; i++) {
1051 conn->twind[i] = rx_initSendWindow;
1052 conn->rwind[i] = rx_initReceiveWindow;
1053 conn->lastBusy[i] = 0;
1056 RXS_NewConnection(securityObject, conn);
1058 CONN_HASH(shost, sport, conn->cid, conn->epoch, RX_CLIENT_CONNECTION);
1060 conn->refCount++; /* no lock required since only this thread knows... */
1061 conn->next = rx_connHashTable[hashindex];
1062 rx_connHashTable[hashindex] = conn;
1063 if (rx_stats_active)
1064 rx_atomic_inc(&rx_stats.nClientConns);
1065 MUTEX_EXIT(&rx_connHashTable_lock);
1071 * Ensure a connection's timeout values are valid.
1073 * @param[in] conn The connection to check
1075 * @post conn->secondUntilDead <= conn->idleDeadTime <= conn->hardDeadTime,
1076 * unless idleDeadTime and/or hardDeadTime are not set
1080 rxi_CheckConnTimeouts(struct rx_connection *conn)
1082 /* a connection's timeouts must have the relationship
1083 * deadTime <= idleDeadTime <= hardDeadTime. Otherwise, for example, a
1084 * total loss of network to a peer may cause an idle timeout instead of a
1085 * dead timeout, simply because the idle timeout gets hit first. Also set
1086 * a minimum deadTime of 6, just to ensure it doesn't get set too low. */
1087 /* this logic is slightly complicated by the fact that
1088 * idleDeadTime/hardDeadTime may not be set at all, but it's not too bad.
1090 conn->secondsUntilDead = MAX(conn->secondsUntilDead, 6);
1091 if (conn->idleDeadTime) {
1092 conn->idleDeadTime = MAX(conn->idleDeadTime, conn->secondsUntilDead);
1094 if (conn->hardDeadTime) {
1095 if (conn->idleDeadTime) {
1096 conn->hardDeadTime = MAX(conn->idleDeadTime, conn->hardDeadTime);
1098 conn->hardDeadTime = MAX(conn->secondsUntilDead, conn->hardDeadTime);
1104 rx_SetConnDeadTime(struct rx_connection *conn, int seconds)
1106 /* The idea is to set the dead time to a value that allows several
1107 * keepalives to be dropped without timing out the connection. */
1108 conn->secondsUntilDead = seconds;
1109 rxi_CheckConnTimeouts(conn);
1110 conn->secondsUntilPing = conn->secondsUntilDead / 6;
1114 rx_SetConnHardDeadTime(struct rx_connection *conn, int seconds)
1116 conn->hardDeadTime = seconds;
1117 rxi_CheckConnTimeouts(conn);
1121 rx_SetConnIdleDeadTime(struct rx_connection *conn, int seconds)
1123 conn->idleDeadTime = seconds;
1124 rxi_CheckConnTimeouts(conn);
1127 int rxi_lowPeerRefCount = 0;
1128 int rxi_lowConnRefCount = 0;
1131 * Cleanup a connection that was destroyed in rxi_DestroyConnectioNoLock.
1132 * NOTE: must not be called with rx_connHashTable_lock held.
1135 rxi_CleanupConnection(struct rx_connection *conn)
1137 /* Notify the service exporter, if requested, that this connection
1138 * is being destroyed */
1139 if (conn->type == RX_SERVER_CONNECTION && conn->service->destroyConnProc)
1140 (*conn->service->destroyConnProc) (conn);
1142 /* Notify the security module that this connection is being destroyed */
1143 RXS_DestroyConnection(conn->securityObject, conn);
1145 /* If this is the last connection using the rx_peer struct, set its
1146 * idle time to now. rxi_ReapConnections will reap it if it's still
1147 * idle (refCount == 0) after rx_idlePeerTime (60 seconds) have passed.
1149 MUTEX_ENTER(&rx_peerHashTable_lock);
1150 if (conn->peer->refCount < 2) {
1151 conn->peer->idleWhen = clock_Sec();
1152 if (conn->peer->refCount < 1) {
1153 conn->peer->refCount = 1;
1154 if (rx_stats_active) {
1155 MUTEX_ENTER(&rx_stats_mutex);
1156 rxi_lowPeerRefCount++;
1157 MUTEX_EXIT(&rx_stats_mutex);
1161 conn->peer->refCount--;
1162 MUTEX_EXIT(&rx_peerHashTable_lock);
1164 if (rx_stats_active)
1166 if (conn->type == RX_SERVER_CONNECTION)
1167 rx_atomic_dec(&rx_stats.nServerConns);
1169 rx_atomic_dec(&rx_stats.nClientConns);
1172 if (conn->specific) {
1174 for (i = 0; i < conn->nSpecific; i++) {
1175 if (conn->specific[i] && rxi_keyCreate_destructor[i])
1176 (*rxi_keyCreate_destructor[i]) (conn->specific[i]);
1177 conn->specific[i] = NULL;
1179 free(conn->specific);
1181 conn->specific = NULL;
1182 conn->nSpecific = 0;
1183 #endif /* !KERNEL */
1185 MUTEX_DESTROY(&conn->conn_call_lock);
1186 MUTEX_DESTROY(&conn->conn_data_lock);
1187 CV_DESTROY(&conn->conn_call_cv);
1189 rxi_FreeConnection(conn);
1192 /* Destroy the specified connection */
1194 rxi_DestroyConnection(struct rx_connection *conn)
1196 MUTEX_ENTER(&rx_connHashTable_lock);
1197 rxi_DestroyConnectionNoLock(conn);
1198 /* conn should be at the head of the cleanup list */
1199 if (conn == rx_connCleanup_list) {
1200 rx_connCleanup_list = rx_connCleanup_list->next;
1201 MUTEX_EXIT(&rx_connHashTable_lock);
1202 rxi_CleanupConnection(conn);
1204 #ifdef RX_ENABLE_LOCKS
1206 MUTEX_EXIT(&rx_connHashTable_lock);
1208 #endif /* RX_ENABLE_LOCKS */
1212 rxi_DestroyConnectionNoLock(struct rx_connection *conn)
1214 struct rx_connection **conn_ptr;
1222 MUTEX_ENTER(&conn->conn_data_lock);
1223 MUTEX_ENTER(&rx_refcnt_mutex);
1224 if (conn->refCount > 0)
1227 #ifdef RX_REFCOUNT_CHECK
1228 osi_Assert(conn->refCount == 0);
1230 if (rx_stats_active) {
1231 MUTEX_ENTER(&rx_stats_mutex);
1232 rxi_lowConnRefCount++;
1233 MUTEX_EXIT(&rx_stats_mutex);
1237 if ((conn->refCount > 0) || (conn->flags & RX_CONN_BUSY)) {
1238 /* Busy; wait till the last guy before proceeding */
1239 MUTEX_EXIT(&rx_refcnt_mutex);
1240 MUTEX_EXIT(&conn->conn_data_lock);
1245 /* If the client previously called rx_NewCall, but it is still
1246 * waiting, treat this as a running call, and wait to destroy the
1247 * connection later when the call completes. */
1248 if ((conn->type == RX_CLIENT_CONNECTION)
1249 && (conn->flags & (RX_CONN_MAKECALL_WAITING|RX_CONN_MAKECALL_ACTIVE))) {
1250 conn->flags |= RX_CONN_DESTROY_ME;
1251 MUTEX_EXIT(&rx_refcnt_mutex);
1252 MUTEX_EXIT(&conn->conn_data_lock);
1256 MUTEX_EXIT(&rx_refcnt_mutex);
1257 MUTEX_EXIT(&conn->conn_data_lock);
1259 /* Check for extant references to this connection */
1260 MUTEX_ENTER(&conn->conn_call_lock);
1261 for (i = 0; i < RX_MAXCALLS; i++) {
1262 struct rx_call *call = conn->call[i];
1265 if (conn->type == RX_CLIENT_CONNECTION) {
1266 MUTEX_ENTER(&call->lock);
1267 if (call->delayedAckEvent) {
1268 /* Push the final acknowledgment out now--there
1269 * won't be a subsequent call to acknowledge the
1270 * last reply packets */
1271 rxi_CancelDelayedAckEvent(call);
1272 if (call->state == RX_STATE_PRECALL
1273 || call->state == RX_STATE_ACTIVE) {
1274 rxi_SendAck(call, 0, 0, RX_ACK_DELAY, 0);
1279 MUTEX_EXIT(&call->lock);
1283 MUTEX_EXIT(&conn->conn_call_lock);
1285 #ifdef RX_ENABLE_LOCKS
1287 if (MUTEX_TRYENTER(&conn->conn_data_lock)) {
1288 MUTEX_EXIT(&conn->conn_data_lock);
1290 /* Someone is accessing a packet right now. */
1294 #endif /* RX_ENABLE_LOCKS */
1297 /* Don't destroy the connection if there are any call
1298 * structures still in use */
1299 MUTEX_ENTER(&conn->conn_data_lock);
1300 conn->flags |= RX_CONN_DESTROY_ME;
1301 MUTEX_EXIT(&conn->conn_data_lock);
1306 /* Remove from connection hash table before proceeding */
1308 &rx_connHashTable[CONN_HASH
1309 (peer->host, peer->port, conn->cid, conn->epoch,
1311 for (; *conn_ptr; conn_ptr = &(*conn_ptr)->next) {
1312 if (*conn_ptr == conn) {
1313 *conn_ptr = conn->next;
1317 /* if the conn that we are destroying was the last connection, then we
1318 * clear rxLastConn as well */
1319 if (rxLastConn == conn)
1322 /* Make sure the connection is completely reset before deleting it. */
1324 * Pending events hold a refcount, so we can't get here if they are
1326 osi_Assert(conn->challengeEvent == NULL);
1327 osi_Assert(conn->delayedAbortEvent == NULL);
1328 osi_Assert(conn->natKeepAliveEvent == NULL);
1329 osi_Assert(conn->checkReachEvent == NULL);
1331 /* Add the connection to the list of destroyed connections that
1332 * need to be cleaned up. This is necessary to avoid deadlocks
1333 * in the routines we call to inform others that this connection is
1334 * being destroyed. */
1335 conn->next = rx_connCleanup_list;
1336 rx_connCleanup_list = conn;
1339 /* Externally available version */
1341 rx_DestroyConnection(struct rx_connection *conn)
1346 rxi_DestroyConnection(conn);
1351 rx_GetConnection(struct rx_connection *conn)
1356 MUTEX_ENTER(&rx_refcnt_mutex);
1358 MUTEX_EXIT(&rx_refcnt_mutex);
1362 #ifdef RX_ENABLE_LOCKS
1363 /* Wait for the transmit queue to no longer be busy.
1364 * requires the call->lock to be held */
1366 rxi_WaitforTQBusy(struct rx_call *call) {
1367 while (!call->error && (call->flags & RX_CALL_TQ_BUSY)) {
1368 call->flags |= RX_CALL_TQ_WAIT;
1370 MUTEX_ASSERT(&call->lock);
1371 CV_WAIT(&call->cv_tq, &call->lock);
1373 if (call->tqWaiters == 0) {
1374 call->flags &= ~RX_CALL_TQ_WAIT;
1381 rxi_WakeUpTransmitQueue(struct rx_call *call)
1383 if (call->tqWaiters || (call->flags & RX_CALL_TQ_WAIT)) {
1384 dpf(("call %"AFS_PTR_FMT" has %d waiters and flags %d\n",
1385 call, call->tqWaiters, call->flags));
1386 #ifdef RX_ENABLE_LOCKS
1387 MUTEX_ASSERT(&call->lock);
1388 CV_BROADCAST(&call->cv_tq);
1389 #else /* RX_ENABLE_LOCKS */
1390 osi_rxWakeup(&call->tq);
1391 #endif /* RX_ENABLE_LOCKS */
1395 /* Start a new rx remote procedure call, on the specified connection.
1396 * If wait is set to 1, wait for a free call channel; otherwise return
1397 * 0. Maxtime gives the maximum number of seconds this call may take,
1398 * after rx_NewCall returns. After this time interval, a call to any
1399 * of rx_SendData, rx_ReadData, etc. will fail with RX_CALL_TIMEOUT.
1400 * For fine grain locking, we hold the conn_call_lock in order to
1401 * to ensure that we don't get signalle after we found a call in an active
1402 * state and before we go to sleep.
1405 rx_NewCall(struct rx_connection *conn)
1407 int i, wait, ignoreBusy = 1;
1408 struct rx_call *call;
1409 struct clock queueTime;
1410 afs_uint32 leastBusy = 0;
1414 dpf(("rx_NewCall(conn %"AFS_PTR_FMT")\n", conn));
1417 clock_GetTime(&queueTime);
1419 * Check if there are others waiting for a new call.
1420 * If so, let them go first to avoid starving them.
1421 * This is a fairly simple scheme, and might not be
1422 * a complete solution for large numbers of waiters.
1424 * makeCallWaiters keeps track of the number of
1425 * threads waiting to make calls and the
1426 * RX_CONN_MAKECALL_WAITING flag bit is used to
1427 * indicate that there are indeed calls waiting.
1428 * The flag is set when the waiter is incremented.
1429 * It is only cleared when makeCallWaiters is 0.
1430 * This prevents us from accidently destroying the
1431 * connection while it is potentially about to be used.
1433 MUTEX_ENTER(&conn->conn_call_lock);
1434 MUTEX_ENTER(&conn->conn_data_lock);
1435 while (conn->flags & RX_CONN_MAKECALL_ACTIVE) {
1436 conn->flags |= RX_CONN_MAKECALL_WAITING;
1437 conn->makeCallWaiters++;
1438 MUTEX_EXIT(&conn->conn_data_lock);
1440 #ifdef RX_ENABLE_LOCKS
1441 CV_WAIT(&conn->conn_call_cv, &conn->conn_call_lock);
1445 MUTEX_ENTER(&conn->conn_data_lock);
1446 conn->makeCallWaiters--;
1447 if (conn->makeCallWaiters == 0)
1448 conn->flags &= ~RX_CONN_MAKECALL_WAITING;
1451 /* We are now the active thread in rx_NewCall */
1452 conn->flags |= RX_CONN_MAKECALL_ACTIVE;
1453 MUTEX_EXIT(&conn->conn_data_lock);
1458 for (i = 0; i < RX_MAXCALLS; i++) {
1459 call = conn->call[i];
1461 if (!ignoreBusy && conn->lastBusy[i] != leastBusy) {
1462 /* we're not ignoring busy call slots; only look at the
1463 * call slot that is the "least" busy */
1467 if (call->state == RX_STATE_DALLY) {
1468 MUTEX_ENTER(&call->lock);
1469 if (call->state == RX_STATE_DALLY) {
1470 if (ignoreBusy && conn->lastBusy[i]) {
1471 /* if we're ignoring busy call slots, skip any ones that
1472 * have lastBusy set */
1473 if (leastBusy == 0 || conn->lastBusy[i] < leastBusy) {
1474 leastBusy = conn->lastBusy[i];
1476 MUTEX_EXIT(&call->lock);
1481 * We are setting the state to RX_STATE_RESET to
1482 * ensure that no one else will attempt to use this
1483 * call once we drop the conn->conn_call_lock and
1484 * call->lock. We must drop the conn->conn_call_lock
1485 * before calling rxi_ResetCall because the process
1486 * of clearing the transmit queue can block for an
1487 * extended period of time. If we block while holding
1488 * the conn->conn_call_lock, then all rx_EndCall
1489 * processing will block as well. This has a detrimental
1490 * effect on overall system performance.
1492 call->state = RX_STATE_RESET;
1493 (*call->callNumber)++;
1494 MUTEX_EXIT(&conn->conn_call_lock);
1495 CALL_HOLD(call, RX_CALL_REFCOUNT_BEGIN);
1496 rxi_ResetCall(call, 0);
1497 if (MUTEX_TRYENTER(&conn->conn_call_lock))
1501 * If we failed to be able to safely obtain the
1502 * conn->conn_call_lock we will have to drop the
1503 * call->lock to avoid a deadlock. When the call->lock
1504 * is released the state of the call can change. If it
1505 * is no longer RX_STATE_RESET then some other thread is
1508 MUTEX_EXIT(&call->lock);
1509 MUTEX_ENTER(&conn->conn_call_lock);
1510 MUTEX_ENTER(&call->lock);
1512 if (call->state == RX_STATE_RESET)
1516 * If we get here it means that after dropping
1517 * the conn->conn_call_lock and call->lock that
1518 * the call is no longer ours. If we can't find
1519 * a free call in the remaining slots we should
1520 * not go immediately to RX_CONN_MAKECALL_WAITING
1521 * because by dropping the conn->conn_call_lock
1522 * we have given up synchronization with rx_EndCall.
1523 * Instead, cycle through one more time to see if
1524 * we can find a call that can call our own.
1526 CALL_RELE(call, RX_CALL_REFCOUNT_BEGIN);
1529 MUTEX_EXIT(&call->lock);
1532 if (ignoreBusy && conn->lastBusy[i]) {
1533 /* if we're ignoring busy call slots, skip any ones that
1534 * have lastBusy set */
1535 if (leastBusy == 0 || conn->lastBusy[i] < leastBusy) {
1536 leastBusy = conn->lastBusy[i];
1541 /* rxi_NewCall returns with mutex locked */
1542 call = rxi_NewCall(conn, i);
1543 CALL_HOLD(call, RX_CALL_REFCOUNT_BEGIN);
1547 if (i < RX_MAXCALLS) {
1548 conn->lastBusy[i] = 0;
1553 if (leastBusy && ignoreBusy) {
1554 /* we didn't find a useable call slot, but we did see at least one
1555 * 'busy' slot; look again and only use a slot with the 'least
1561 MUTEX_ENTER(&conn->conn_data_lock);
1562 conn->flags |= RX_CONN_MAKECALL_WAITING;
1563 conn->makeCallWaiters++;
1564 MUTEX_EXIT(&conn->conn_data_lock);
1566 #ifdef RX_ENABLE_LOCKS
1567 CV_WAIT(&conn->conn_call_cv, &conn->conn_call_lock);
1571 MUTEX_ENTER(&conn->conn_data_lock);
1572 conn->makeCallWaiters--;
1573 if (conn->makeCallWaiters == 0)
1574 conn->flags &= ~RX_CONN_MAKECALL_WAITING;
1575 MUTEX_EXIT(&conn->conn_data_lock);
1577 /* Client is initially in send mode */
1578 call->state = RX_STATE_ACTIVE;
1579 call->error = conn->error;
1581 call->app.mode = RX_MODE_ERROR;
1583 call->app.mode = RX_MODE_SENDING;
1585 #ifdef AFS_RXERRQ_ENV
1586 /* remember how many network errors the peer has when we started, so if
1587 * more errors are encountered after the call starts, we know the other endpoint won't be
1588 * responding to us */
1589 call->neterr_gen = rx_atomic_read(&conn->peer->neterrs);
1592 /* remember start time for call in case we have hard dead time limit */
1593 call->queueTime = queueTime;
1594 clock_GetTime(&call->startTime);
1595 call->app.bytesSent = 0;
1596 call->app.bytesRcvd = 0;
1598 /* Turn on busy protocol. */
1599 rxi_KeepAliveOn(call);
1601 /* Attempt MTU discovery */
1602 rxi_GrowMTUOn(call);
1605 * We are no longer the active thread in rx_NewCall
1607 MUTEX_ENTER(&conn->conn_data_lock);
1608 conn->flags &= ~RX_CONN_MAKECALL_ACTIVE;
1609 MUTEX_EXIT(&conn->conn_data_lock);
1612 * Wake up anyone else who might be giving us a chance to
1613 * run (see code above that avoids resource starvation).
1615 #ifdef RX_ENABLE_LOCKS
1616 if (call->flags & (RX_CALL_TQ_BUSY | RX_CALL_TQ_CLEARME)) {
1617 osi_Panic("rx_NewCall call about to be used without an empty tq");
1620 CV_BROADCAST(&conn->conn_call_cv);
1624 MUTEX_EXIT(&conn->conn_call_lock);
1625 MUTEX_EXIT(&call->lock);
1628 dpf(("rx_NewCall(call %"AFS_PTR_FMT")\n", call));
1633 rxi_HasActiveCalls(struct rx_connection *aconn)
1636 struct rx_call *tcall;
1640 for (i = 0; i < RX_MAXCALLS; i++) {
1641 if ((tcall = aconn->call[i])) {
1642 if ((tcall->state == RX_STATE_ACTIVE)
1643 || (tcall->state == RX_STATE_PRECALL)) {
1654 rxi_GetCallNumberVector(struct rx_connection *aconn,
1655 afs_int32 * aint32s)
1658 struct rx_call *tcall;
1662 MUTEX_ENTER(&aconn->conn_call_lock);
1663 for (i = 0; i < RX_MAXCALLS; i++) {
1664 if ((tcall = aconn->call[i]) && (tcall->state == RX_STATE_DALLY))
1665 aint32s[i] = aconn->callNumber[i] + 1;
1667 aint32s[i] = aconn->callNumber[i];
1669 MUTEX_EXIT(&aconn->conn_call_lock);
1675 rxi_SetCallNumberVector(struct rx_connection *aconn,
1676 afs_int32 * aint32s)
1679 struct rx_call *tcall;
1683 MUTEX_ENTER(&aconn->conn_call_lock);
1684 for (i = 0; i < RX_MAXCALLS; i++) {
1685 if ((tcall = aconn->call[i]) && (tcall->state == RX_STATE_DALLY))
1686 aconn->callNumber[i] = aint32s[i] - 1;
1688 aconn->callNumber[i] = aint32s[i];
1690 MUTEX_EXIT(&aconn->conn_call_lock);
1695 /* Advertise a new service. A service is named locally by a UDP port
1696 * number plus a 16-bit service id. Returns (struct rx_service *) 0
1699 char *serviceName; Name for identification purposes (e.g. the
1700 service name might be used for probing for
1703 rx_NewServiceHost(afs_uint32 host, u_short port, u_short serviceId,
1704 char *serviceName, struct rx_securityClass **securityObjects,
1705 int nSecurityObjects,
1706 afs_int32(*serviceProc) (struct rx_call * acall))
1708 osi_socket socket = OSI_NULLSOCKET;
1709 struct rx_service *tservice;
1715 if (serviceId == 0) {
1717 "rx_NewService: service id for service %s is not non-zero.\n",
1724 "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",
1732 tservice = rxi_AllocService();
1735 MUTEX_INIT(&tservice->svc_data_lock, "svc data lock", MUTEX_DEFAULT, 0);
1737 for (i = 0; i < RX_MAX_SERVICES; i++) {
1738 struct rx_service *service = rx_services[i];
1740 if (port == service->servicePort && host == service->serviceHost) {
1741 if (service->serviceId == serviceId) {
1742 /* The identical service has already been
1743 * installed; if the caller was intending to
1744 * change the security classes used by this
1745 * service, he/she loses. */
1747 "rx_NewService: tried to install service %s with service id %d, which is already in use for service %s\n",
1748 serviceName, serviceId, service->serviceName);
1750 rxi_FreeService(tservice);
1753 /* Different service, same port: re-use the socket
1754 * which is bound to the same port */
1755 socket = service->socket;
1758 if (socket == OSI_NULLSOCKET) {
1759 /* If we don't already have a socket (from another
1760 * service on same port) get a new one */
1761 socket = rxi_GetHostUDPSocket(host, port);
1762 if (socket == OSI_NULLSOCKET) {
1764 rxi_FreeService(tservice);
1769 service->socket = socket;
1770 service->serviceHost = host;
1771 service->servicePort = port;
1772 service->serviceId = serviceId;
1773 service->serviceName = serviceName;
1774 service->nSecurityObjects = nSecurityObjects;
1775 service->securityObjects = securityObjects;
1776 service->minProcs = 0;
1777 service->maxProcs = 1;
1778 service->idleDeadTime = 60;
1779 service->connDeadTime = rx_connDeadTime;
1780 service->executeRequestProc = serviceProc;
1781 service->checkReach = 0;
1782 service->nSpecific = 0;
1783 service->specific = NULL;
1784 rx_services[i] = service; /* not visible until now */
1790 rxi_FreeService(tservice);
1791 (osi_Msg "rx_NewService: cannot support > %d services\n",
1796 /* Set configuration options for all of a service's security objects */
1799 rx_SetSecurityConfiguration(struct rx_service *service,
1800 rx_securityConfigVariables type,
1804 for (i = 0; i<service->nSecurityObjects; i++) {
1805 if (service->securityObjects[i]) {
1806 RXS_SetConfiguration(service->securityObjects[i], NULL, type,
1814 rx_NewService(u_short port, u_short serviceId, char *serviceName,
1815 struct rx_securityClass **securityObjects, int nSecurityObjects,
1816 afs_int32(*serviceProc) (struct rx_call * acall))
1818 return rx_NewServiceHost(htonl(INADDR_ANY), port, serviceId, serviceName, securityObjects, nSecurityObjects, serviceProc);
1821 /* Generic request processing loop. This routine should be called
1822 * by the implementation dependent rx_ServerProc. If socketp is
1823 * non-null, it will be set to the file descriptor that this thread
1824 * is now listening on. If socketp is null, this routine will never
1827 rxi_ServerProc(int threadID, struct rx_call *newcall, osi_socket * socketp)
1829 struct rx_call *call;
1831 struct rx_service *tservice = NULL;
1838 call = rx_GetCall(threadID, tservice, socketp);
1839 if (socketp && *socketp != OSI_NULLSOCKET) {
1840 /* We are now a listener thread */
1846 if (afs_termState == AFSOP_STOP_RXCALLBACK) {
1847 #ifdef RX_ENABLE_LOCKS
1849 #endif /* RX_ENABLE_LOCKS */
1850 afs_termState = AFSOP_STOP_AFS;
1851 afs_osi_Wakeup(&afs_termState);
1852 #ifdef RX_ENABLE_LOCKS
1854 #endif /* RX_ENABLE_LOCKS */
1859 /* if server is restarting( typically smooth shutdown) then do not
1860 * allow any new calls.
1863 if (rx_tranquil && (call != NULL)) {
1867 MUTEX_ENTER(&call->lock);
1869 rxi_CallError(call, RX_RESTARTING);
1870 rxi_SendCallAbort(call, (struct rx_packet *)0, 0, 0);
1872 MUTEX_EXIT(&call->lock);
1877 tservice = call->conn->service;
1879 if (tservice->beforeProc)
1880 (*tservice->beforeProc) (call);
1882 code = tservice->executeRequestProc(call);
1884 if (tservice->afterProc)
1885 (*tservice->afterProc) (call, code);
1887 rx_EndCall(call, code);
1889 if (tservice->postProc)
1890 (*tservice->postProc) (code);
1892 if (rx_stats_active) {
1893 MUTEX_ENTER(&rx_stats_mutex);
1895 MUTEX_EXIT(&rx_stats_mutex);
1902 rx_WakeupServerProcs(void)
1904 struct rx_serverQueueEntry *np, *tqp;
1905 struct opr_queue *cursor;
1909 MUTEX_ENTER(&rx_serverPool_lock);
1911 #ifdef RX_ENABLE_LOCKS
1912 if (rx_waitForPacket)
1913 CV_BROADCAST(&rx_waitForPacket->cv);
1914 #else /* RX_ENABLE_LOCKS */
1915 if (rx_waitForPacket)
1916 osi_rxWakeup(rx_waitForPacket);
1917 #endif /* RX_ENABLE_LOCKS */
1918 MUTEX_ENTER(&freeSQEList_lock);
1919 for (np = rx_FreeSQEList; np; np = tqp) {
1920 tqp = *(struct rx_serverQueueEntry **)np;
1921 #ifdef RX_ENABLE_LOCKS
1922 CV_BROADCAST(&np->cv);
1923 #else /* RX_ENABLE_LOCKS */
1925 #endif /* RX_ENABLE_LOCKS */
1927 MUTEX_EXIT(&freeSQEList_lock);
1928 for (opr_queue_Scan(&rx_idleServerQueue, cursor)) {
1929 np = opr_queue_Entry(cursor, struct rx_serverQueueEntry, entry);
1930 #ifdef RX_ENABLE_LOCKS
1931 CV_BROADCAST(&np->cv);
1932 #else /* RX_ENABLE_LOCKS */
1934 #endif /* RX_ENABLE_LOCKS */
1936 MUTEX_EXIT(&rx_serverPool_lock);
1941 * One thing that seems to happen is that all the server threads get
1942 * tied up on some empty or slow call, and then a whole bunch of calls
1943 * arrive at once, using up the packet pool, so now there are more
1944 * empty calls. The most critical resources here are server threads
1945 * and the free packet pool. The "doreclaim" code seems to help in
1946 * general. I think that eventually we arrive in this state: there
1947 * are lots of pending calls which do have all their packets present,
1948 * so they won't be reclaimed, are multi-packet calls, so they won't
1949 * be scheduled until later, and thus are tying up most of the free
1950 * packet pool for a very long time.
1952 * 1. schedule multi-packet calls if all the packets are present.
1953 * Probably CPU-bound operation, useful to return packets to pool.
1954 * Do what if there is a full window, but the last packet isn't here?
1955 * 3. preserve one thread which *only* runs "best" calls, otherwise
1956 * it sleeps and waits for that type of call.
1957 * 4. Don't necessarily reserve a whole window for each thread. In fact,
1958 * the current dataquota business is badly broken. The quota isn't adjusted
1959 * to reflect how many packets are presently queued for a running call.
1960 * So, when we schedule a queued call with a full window of packets queued
1961 * up for it, that *should* free up a window full of packets for other 2d-class
1962 * calls to be able to use from the packet pool. But it doesn't.
1964 * NB. Most of the time, this code doesn't run -- since idle server threads
1965 * sit on the idle server queue and are assigned by "...ReceivePacket" as soon
1966 * as a new call arrives.
1968 /* Sleep until a call arrives. Returns a pointer to the call, ready
1969 * for an rx_Read. */
1970 #ifdef RX_ENABLE_LOCKS
1972 rx_GetCall(int tno, struct rx_service *cur_service, osi_socket * socketp)
1974 struct rx_serverQueueEntry *sq;
1975 struct rx_call *call = (struct rx_call *)0;
1976 struct rx_service *service = NULL;
1978 MUTEX_ENTER(&freeSQEList_lock);
1980 if ((sq = rx_FreeSQEList)) {
1981 rx_FreeSQEList = *(struct rx_serverQueueEntry **)sq;
1982 MUTEX_EXIT(&freeSQEList_lock);
1983 } else { /* otherwise allocate a new one and return that */
1984 MUTEX_EXIT(&freeSQEList_lock);
1985 sq = rxi_Alloc(sizeof(struct rx_serverQueueEntry));
1986 MUTEX_INIT(&sq->lock, "server Queue lock", MUTEX_DEFAULT, 0);
1987 CV_INIT(&sq->cv, "server Queue lock", CV_DEFAULT, 0);
1990 MUTEX_ENTER(&rx_serverPool_lock);
1991 if (cur_service != NULL) {
1992 ReturnToServerPool(cur_service);
1995 if (!opr_queue_IsEmpty(&rx_incomingCallQueue)) {
1996 struct rx_call *tcall, *choice2 = NULL;
1997 struct opr_queue *cursor;
1999 /* Scan for eligible incoming calls. A call is not eligible
2000 * if the maximum number of calls for its service type are
2001 * already executing */
2002 /* One thread will process calls FCFS (to prevent starvation),
2003 * while the other threads may run ahead looking for calls which
2004 * have all their input data available immediately. This helps
2005 * keep threads from blocking, waiting for data from the client. */
2006 for (opr_queue_Scan(&rx_incomingCallQueue, cursor)) {
2007 tcall = opr_queue_Entry(cursor, struct rx_call, entry);
2009 service = tcall->conn->service;
2010 if (!QuotaOK(service)) {
2013 MUTEX_ENTER(&rx_pthread_mutex);
2014 if (tno == rxi_fcfs_thread_num
2015 || opr_queue_IsEnd(&rx_incomingCallQueue, cursor)) {
2016 MUTEX_EXIT(&rx_pthread_mutex);
2017 /* If we're the fcfs thread , then we'll just use
2018 * this call. If we haven't been able to find an optimal
2019 * choice, and we're at the end of the list, then use a
2020 * 2d choice if one has been identified. Otherwise... */
2021 call = (choice2 ? choice2 : tcall);
2022 service = call->conn->service;
2024 MUTEX_EXIT(&rx_pthread_mutex);
2025 if (!opr_queue_IsEmpty(&tcall->rq)) {
2026 struct rx_packet *rp;
2027 rp = opr_queue_First(&tcall->rq, struct rx_packet,
2029 if (rp->header.seq == 1) {
2031 || (rp->header.flags & RX_LAST_PACKET)) {
2033 } else if (rxi_2dchoice && !choice2
2034 && !(tcall->flags & RX_CALL_CLEARED)
2035 && (tcall->rprev > rxi_HardAckRate)) {
2045 ReturnToServerPool(service);
2051 opr_queue_Remove(&call->entry);
2052 MUTEX_EXIT(&rx_serverPool_lock);
2053 MUTEX_ENTER(&call->lock);
2055 if (call->flags & RX_CALL_WAIT_PROC) {
2056 call->flags &= ~RX_CALL_WAIT_PROC;
2057 rx_atomic_dec(&rx_nWaiting);
2060 if (call->state != RX_STATE_PRECALL || call->error) {
2061 MUTEX_EXIT(&call->lock);
2062 MUTEX_ENTER(&rx_serverPool_lock);
2063 ReturnToServerPool(service);
2068 if (opr_queue_IsEmpty(&call->rq)
2069 || opr_queue_First(&call->rq, struct rx_packet, entry)->header.seq != 1)
2070 rxi_SendAck(call, 0, 0, RX_ACK_DELAY, 0);
2072 CLEAR_CALL_QUEUE_LOCK(call);
2075 /* If there are no eligible incoming calls, add this process
2076 * to the idle server queue, to wait for one */
2080 *socketp = OSI_NULLSOCKET;
2082 sq->socketp = socketp;
2083 opr_queue_Append(&rx_idleServerQueue, &sq->entry);
2084 #ifndef AFS_AIX41_ENV
2085 rx_waitForPacket = sq;
2086 #endif /* AFS_AIX41_ENV */
2088 CV_WAIT(&sq->cv, &rx_serverPool_lock);
2090 if (afs_termState == AFSOP_STOP_RXCALLBACK) {
2091 MUTEX_EXIT(&rx_serverPool_lock);
2092 return (struct rx_call *)0;
2095 } while (!(call = sq->newcall)
2096 && !(socketp && *socketp != OSI_NULLSOCKET));
2097 MUTEX_EXIT(&rx_serverPool_lock);
2099 MUTEX_ENTER(&call->lock);
2105 MUTEX_ENTER(&freeSQEList_lock);
2106 *(struct rx_serverQueueEntry **)sq = rx_FreeSQEList;
2107 rx_FreeSQEList = sq;
2108 MUTEX_EXIT(&freeSQEList_lock);
2111 clock_GetTime(&call->startTime);
2112 call->state = RX_STATE_ACTIVE;
2113 call->app.mode = RX_MODE_RECEIVING;
2114 #ifdef RX_KERNEL_TRACE
2115 if (ICL_SETACTIVE(afs_iclSetp)) {
2116 int glockOwner = ISAFS_GLOCK();
2119 afs_Trace3(afs_iclSetp, CM_TRACE_WASHERE, ICL_TYPE_STRING,
2120 __FILE__, ICL_TYPE_INT32, __LINE__, ICL_TYPE_POINTER,
2127 rxi_calltrace(RX_CALL_START, call);
2128 dpf(("rx_GetCall(port=%d, service=%d) ==> call %"AFS_PTR_FMT"\n",
2129 call->conn->service->servicePort, call->conn->service->serviceId,
2132 MUTEX_EXIT(&call->lock);
2133 CALL_HOLD(call, RX_CALL_REFCOUNT_BEGIN);
2135 dpf(("rx_GetCall(socketp=%p, *socketp=0x%x)\n", socketp, *socketp));
2140 #else /* RX_ENABLE_LOCKS */
2142 rx_GetCall(int tno, struct rx_service *cur_service, osi_socket * socketp)
2144 struct rx_serverQueueEntry *sq;
2145 struct rx_call *call = (struct rx_call *)0, *choice2;
2146 struct rx_service *service = NULL;
2150 MUTEX_ENTER(&freeSQEList_lock);
2152 if ((sq = rx_FreeSQEList)) {
2153 rx_FreeSQEList = *(struct rx_serverQueueEntry **)sq;
2154 MUTEX_EXIT(&freeSQEList_lock);
2155 } else { /* otherwise allocate a new one and return that */
2156 MUTEX_EXIT(&freeSQEList_lock);
2157 sq = rxi_Alloc(sizeof(struct rx_serverQueueEntry));
2158 MUTEX_INIT(&sq->lock, "server Queue lock", MUTEX_DEFAULT, 0);
2159 CV_INIT(&sq->cv, "server Queue lock", CV_DEFAULT, 0);
2161 MUTEX_ENTER(&sq->lock);
2163 if (cur_service != NULL) {
2164 cur_service->nRequestsRunning--;
2165 MUTEX_ENTER(&rx_quota_mutex);
2166 if (cur_service->nRequestsRunning < cur_service->minProcs)
2169 MUTEX_EXIT(&rx_quota_mutex);
2171 if (!opr_queue_IsEmpty(&rx_incomingCallQueue)) {
2172 struct rx_call *tcall;
2173 struct opr_queue *cursor;
2174 /* Scan for eligible incoming calls. A call is not eligible
2175 * if the maximum number of calls for its service type are
2176 * already executing */
2177 /* One thread will process calls FCFS (to prevent starvation),
2178 * while the other threads may run ahead looking for calls which
2179 * have all their input data available immediately. This helps
2180 * keep threads from blocking, waiting for data from the client. */
2181 choice2 = (struct rx_call *)0;
2182 for (opr_queue_Scan(&rx_incomingCallQueue, cursor)) {
2183 tcall = opr_queue_Entry(cursor, struct rx_call, entry);
2184 service = tcall->conn->service;
2185 if (QuotaOK(service)) {
2186 MUTEX_ENTER(&rx_pthread_mutex);
2187 /* XXX - If tcall->entry.next is NULL, then we're no longer
2188 * on a queue at all. This shouldn't happen. */
2189 if (tno == rxi_fcfs_thread_num || !tcall->entry.next) {
2190 MUTEX_EXIT(&rx_pthread_mutex);
2191 /* If we're the fcfs thread, then we'll just use
2192 * this call. If we haven't been able to find an optimal
2193 * choice, and we're at the end of the list, then use a
2194 * 2d choice if one has been identified. Otherwise... */
2195 call = (choice2 ? choice2 : tcall);
2196 service = call->conn->service;
2198 MUTEX_EXIT(&rx_pthread_mutex);
2199 if (!opr_queue_IsEmpty(&tcall->rq)) {
2200 struct rx_packet *rp;
2201 rp = opr_queue_First(&tcall->rq, struct rx_packet,
2203 if (rp->header.seq == 1
2205 || (rp->header.flags & RX_LAST_PACKET))) {
2207 } else if (rxi_2dchoice && !choice2
2208 && !(tcall->flags & RX_CALL_CLEARED)
2209 && (tcall->rprev > rxi_HardAckRate)) {
2222 opr_queue_Remove(&call->entry);
2223 /* we can't schedule a call if there's no data!!! */
2224 /* send an ack if there's no data, if we're missing the
2225 * first packet, or we're missing something between first
2226 * and last -- there's a "hole" in the incoming data. */
2227 if (opr_queue_IsEmpty(&call->rq)
2228 || opr_queue_First(&call->rq, struct rx_packet, entry)->header.seq != 1
2229 || call->rprev != opr_queue_Last(&call->rq, struct rx_packet, entry)->header.seq)
2230 rxi_SendAck(call, 0, 0, RX_ACK_DELAY, 0);
2232 call->flags &= (~RX_CALL_WAIT_PROC);
2233 service->nRequestsRunning++;
2234 /* just started call in minProcs pool, need fewer to maintain
2236 MUTEX_ENTER(&rx_quota_mutex);
2237 if (service->nRequestsRunning <= service->minProcs)
2240 MUTEX_EXIT(&rx_quota_mutex);
2241 rx_atomic_dec(&rx_nWaiting);
2242 /* MUTEX_EXIT(&call->lock); */
2244 /* If there are no eligible incoming calls, add this process
2245 * to the idle server queue, to wait for one */
2248 *socketp = OSI_NULLSOCKET;
2250 sq->socketp = socketp;
2251 opr_queue_Append(&rx_idleServerQueue, &sq->entry);
2255 if (afs_termState == AFSOP_STOP_RXCALLBACK) {
2257 rxi_Free(sq, sizeof(struct rx_serverQueueEntry));
2258 return (struct rx_call *)0;
2261 } while (!(call = sq->newcall)
2262 && !(socketp && *socketp != OSI_NULLSOCKET));
2264 MUTEX_EXIT(&sq->lock);
2266 MUTEX_ENTER(&freeSQEList_lock);
2267 *(struct rx_serverQueueEntry **)sq = rx_FreeSQEList;
2268 rx_FreeSQEList = sq;
2269 MUTEX_EXIT(&freeSQEList_lock);
2272 clock_GetTime(&call->startTime);
2273 call->state = RX_STATE_ACTIVE;
2274 call->app.mode = RX_MODE_RECEIVING;
2275 #ifdef RX_KERNEL_TRACE
2276 if (ICL_SETACTIVE(afs_iclSetp)) {
2277 int glockOwner = ISAFS_GLOCK();
2280 afs_Trace3(afs_iclSetp, CM_TRACE_WASHERE, ICL_TYPE_STRING,
2281 __FILE__, ICL_TYPE_INT32, __LINE__, ICL_TYPE_POINTER,
2288 rxi_calltrace(RX_CALL_START, call);
2289 dpf(("rx_GetCall(port=%d, service=%d) ==> call %p\n",
2290 call->conn->service->servicePort, call->conn->service->serviceId,
2293 dpf(("rx_GetCall(socketp=%p, *socketp=0x%x)\n", socketp, *socketp));
2300 #endif /* RX_ENABLE_LOCKS */
2304 /* Establish a procedure to be called when a packet arrives for a
2305 * call. This routine will be called at most once after each call,
2306 * and will also be called if there is an error condition on the or
2307 * the call is complete. Used by multi rx to build a selection
2308 * function which determines which of several calls is likely to be a
2309 * good one to read from.
2310 * NOTE: the way this is currently implemented it is probably only a
2311 * good idea to (1) use it immediately after a newcall (clients only)
2312 * and (2) only use it once. Other uses currently void your warranty
2315 rx_SetArrivalProc(struct rx_call *call,
2316 void (*proc) (struct rx_call * call,
2319 void * handle, int arg)
2321 call->arrivalProc = proc;
2322 call->arrivalProcHandle = handle;
2323 call->arrivalProcArg = arg;
2326 /* Call is finished (possibly prematurely). Return rc to the peer, if
2327 * appropriate, and return the final error code from the conversation
2331 rx_EndCall(struct rx_call *call, afs_int32 rc)
2333 struct rx_connection *conn = call->conn;
2337 dpf(("rx_EndCall(call %"AFS_PTR_FMT" rc %d error %d abortCode %d)\n",
2338 call, rc, call->error, call->abortCode));
2341 MUTEX_ENTER(&call->lock);
2343 if (rc == 0 && call->error == 0) {
2344 call->abortCode = 0;
2345 call->abortCount = 0;
2348 call->arrivalProc = (void (*)())0;
2349 if (rc && call->error == 0) {
2350 rxi_CallError(call, rc);
2351 call->app.mode = RX_MODE_ERROR;
2352 /* Send an abort message to the peer if this error code has
2353 * only just been set. If it was set previously, assume the
2354 * peer has already been sent the error code or will request it
2356 rxi_SendCallAbort(call, (struct rx_packet *)0, 0, 0);
2358 if (conn->type == RX_SERVER_CONNECTION) {
2359 /* Make sure reply or at least dummy reply is sent */
2360 if (call->app.mode == RX_MODE_RECEIVING) {
2361 MUTEX_EXIT(&call->lock);
2362 rxi_WriteProc(call, 0, 0);
2363 MUTEX_ENTER(&call->lock);
2365 if (call->app.mode == RX_MODE_SENDING) {
2366 rxi_FlushWriteLocked(call);
2368 rxi_calltrace(RX_CALL_END, call);
2369 /* Call goes to hold state until reply packets are acknowledged */
2370 if (call->tfirst + call->nSoftAcked < call->tnext) {
2371 call->state = RX_STATE_HOLD;
2373 call->state = RX_STATE_DALLY;
2374 rxi_ClearTransmitQueue(call, 0);
2375 rxi_rto_cancel(call);
2376 rxi_CancelKeepAliveEvent(call);
2378 } else { /* Client connection */
2380 /* Make sure server receives input packets, in the case where
2381 * no reply arguments are expected */
2383 if ((call->app.mode == RX_MODE_SENDING)
2384 || (call->app.mode == RX_MODE_RECEIVING && call->rnext == 1)) {
2385 MUTEX_EXIT(&call->lock);
2386 (void)rxi_ReadProc(call, &dummy, 1);
2387 MUTEX_ENTER(&call->lock);
2390 /* If we had an outstanding delayed ack, be nice to the server
2391 * and force-send it now.
2393 if (call->delayedAckEvent) {
2394 rxi_CancelDelayedAckEvent(call);
2395 rxi_SendDelayedAck(NULL, call, NULL, 0);
2398 /* We need to release the call lock since it's lower than the
2399 * conn_call_lock and we don't want to hold the conn_call_lock
2400 * over the rx_ReadProc call. The conn_call_lock needs to be held
2401 * here for the case where rx_NewCall is perusing the calls on
2402 * the connection structure. We don't want to signal until
2403 * rx_NewCall is in a stable state. Otherwise, rx_NewCall may
2404 * have checked this call, found it active and by the time it
2405 * goes to sleep, will have missed the signal.
2407 MUTEX_EXIT(&call->lock);
2408 MUTEX_ENTER(&conn->conn_call_lock);
2409 MUTEX_ENTER(&call->lock);
2412 /* While there are some circumstances where a call with an error is
2413 * obviously not on a "busy" channel, be conservative (clearing
2414 * lastBusy is just best-effort to possibly speed up rx_NewCall).
2415 * The call channel is definitely not busy if we just successfully
2416 * completed a call on it. */
2417 conn->lastBusy[call->channel] = 0;
2419 } else if (call->error == RX_CALL_TIMEOUT) {
2420 /* The call is still probably running on the server side, so try to
2421 * avoid this call channel in the future. */
2422 conn->lastBusy[call->channel] = clock_Sec();
2425 MUTEX_ENTER(&conn->conn_data_lock);
2426 conn->flags |= RX_CONN_BUSY;
2427 if (conn->flags & RX_CONN_MAKECALL_WAITING) {
2428 MUTEX_EXIT(&conn->conn_data_lock);
2429 #ifdef RX_ENABLE_LOCKS
2430 CV_BROADCAST(&conn->conn_call_cv);
2435 #ifdef RX_ENABLE_LOCKS
2437 MUTEX_EXIT(&conn->conn_data_lock);
2439 #endif /* RX_ENABLE_LOCKS */
2440 call->state = RX_STATE_DALLY;
2442 error = call->error;
2444 /* currentPacket, nLeft, and NFree must be zeroed here, because
2445 * ResetCall cannot: ResetCall may be called at splnet(), in the
2446 * kernel version, and may interrupt the macros rx_Read or
2447 * rx_Write, which run at normal priority for efficiency. */
2448 if (call->app.currentPacket) {
2449 #ifdef RX_TRACK_PACKETS
2450 call->app.currentPacket->flags &= ~RX_PKTFLAG_CP;
2452 rxi_FreePacket(call->app.currentPacket);
2453 call->app.currentPacket = (struct rx_packet *)0;
2456 call->app.nLeft = call->app.nFree = call->app.curlen = 0;
2458 /* Free any packets from the last call to ReadvProc/WritevProc */
2459 #ifdef RXDEBUG_PACKET
2461 #endif /* RXDEBUG_PACKET */
2462 rxi_FreePackets(0, &call->app.iovq);
2463 MUTEX_EXIT(&call->lock);
2465 CALL_RELE(call, RX_CALL_REFCOUNT_BEGIN);
2466 if (conn->type == RX_CLIENT_CONNECTION) {
2467 MUTEX_ENTER(&conn->conn_data_lock);
2468 conn->flags &= ~RX_CONN_BUSY;
2469 MUTEX_EXIT(&conn->conn_data_lock);
2470 MUTEX_EXIT(&conn->conn_call_lock);
2474 * Map errors to the local host's errno.h format.
2476 error = ntoh_syserr_conv(error);
2478 /* If the caller said the call failed with some error, we had better
2479 * return an error code. */
2480 osi_Assert(!rc || error);
2484 #if !defined(KERNEL)
2486 /* Call this routine when shutting down a server or client (especially
2487 * clients). This will allow Rx to gracefully garbage collect server
2488 * connections, and reduce the number of retries that a server might
2489 * make to a dead client.
2490 * This is not quite right, since some calls may still be ongoing and
2491 * we can't lock them to destroy them. */
2495 struct rx_connection **conn_ptr, **conn_end;
2498 if (rx_atomic_test_and_set_bit(&rxinit_status, 0))
2499 return; /* Already shutdown. */
2501 rxi_DeleteCachedConnections();
2502 if (rx_connHashTable) {
2503 MUTEX_ENTER(&rx_connHashTable_lock);
2504 for (conn_ptr = &rx_connHashTable[0], conn_end =
2505 &rx_connHashTable[rx_hashTableSize]; conn_ptr < conn_end;
2507 struct rx_connection *conn, *next;
2508 for (conn = *conn_ptr; conn; conn = next) {
2510 if (conn->type == RX_CLIENT_CONNECTION) {
2511 rx_GetConnection(conn);
2512 #ifdef RX_ENABLE_LOCKS
2513 rxi_DestroyConnectionNoLock(conn);
2514 #else /* RX_ENABLE_LOCKS */
2515 rxi_DestroyConnection(conn);
2516 #endif /* RX_ENABLE_LOCKS */
2520 #ifdef RX_ENABLE_LOCKS
2521 while (rx_connCleanup_list) {
2522 struct rx_connection *conn;
2523 conn = rx_connCleanup_list;
2524 rx_connCleanup_list = rx_connCleanup_list->next;
2525 MUTEX_EXIT(&rx_connHashTable_lock);
2526 rxi_CleanupConnection(conn);
2527 MUTEX_ENTER(&rx_connHashTable_lock);
2529 MUTEX_EXIT(&rx_connHashTable_lock);
2530 #endif /* RX_ENABLE_LOCKS */
2535 afs_winsockCleanup();
2541 /* if we wakeup packet waiter too often, can get in loop with two
2542 AllocSendPackets each waking each other up (from ReclaimPacket calls) */
2544 rxi_PacketsUnWait(void)
2546 if (!rx_waitingForPackets) {
2550 if (rxi_OverQuota(RX_PACKET_CLASS_SEND)) {
2551 return; /* still over quota */
2554 rx_waitingForPackets = 0;
2555 #ifdef RX_ENABLE_LOCKS
2556 CV_BROADCAST(&rx_waitingForPackets_cv);
2558 osi_rxWakeup(&rx_waitingForPackets);
2564 /* ------------------Internal interfaces------------------------- */
2566 /* Return this process's service structure for the
2567 * specified socket and service */
2568 static struct rx_service *
2569 rxi_FindService(osi_socket socket, u_short serviceId)
2571 struct rx_service **sp;
2572 for (sp = &rx_services[0]; *sp; sp++) {
2573 if ((*sp)->serviceId == serviceId && (*sp)->socket == socket)
2579 #ifdef RXDEBUG_PACKET
2580 #ifdef KDUMP_RX_LOCK
2581 static struct rx_call_rx_lock *rx_allCallsp = 0;
2583 static struct rx_call *rx_allCallsp = 0;
2585 #endif /* RXDEBUG_PACKET */
2587 /* Allocate a call structure, for the indicated channel of the
2588 * supplied connection. The mode and state of the call must be set by
2589 * the caller. Returns the call with mutex locked. */
2590 static struct rx_call *
2591 rxi_NewCall(struct rx_connection *conn, int channel)
2593 struct rx_call *call;
2594 #ifdef RX_ENABLE_LOCKS
2595 struct rx_call *cp; /* Call pointer temp */
2596 struct opr_queue *cursor;
2599 dpf(("rxi_NewCall(conn %"AFS_PTR_FMT", channel %d)\n", conn, channel));
2601 /* Grab an existing call structure, or allocate a new one.
2602 * Existing call structures are assumed to have been left reset by
2604 MUTEX_ENTER(&rx_freeCallQueue_lock);
2606 #ifdef RX_ENABLE_LOCKS
2608 * EXCEPT that the TQ might not yet be cleared out.
2609 * Skip over those with in-use TQs.
2612 for (opr_queue_Scan(&rx_freeCallQueue, cursor)) {
2613 cp = opr_queue_Entry(cursor, struct rx_call, entry);
2614 if (!(cp->flags & RX_CALL_TQ_BUSY)) {
2620 #else /* RX_ENABLE_LOCKS */
2621 if (!opr_queue_IsEmpty(&rx_freeCallQueue)) {
2622 call = opr_queue_First(&rx_freeCallQueue, struct rx_call, entry);
2623 #endif /* RX_ENABLE_LOCKS */
2624 opr_queue_Remove(&call->entry);
2625 if (rx_stats_active)
2626 rx_atomic_dec(&rx_stats.nFreeCallStructs);
2627 MUTEX_EXIT(&rx_freeCallQueue_lock);
2628 MUTEX_ENTER(&call->lock);
2629 CLEAR_CALL_QUEUE_LOCK(call);
2630 #ifdef RX_ENABLE_LOCKS
2631 /* Now, if TQ wasn't cleared earlier, do it now. */
2632 rxi_WaitforTQBusy(call);
2633 if (call->flags & RX_CALL_TQ_CLEARME) {
2634 rxi_ClearTransmitQueue(call, 1);
2635 /*queue_Init(&call->tq);*/
2637 #endif /* RX_ENABLE_LOCKS */
2638 /* Bind the call to its connection structure */
2640 rxi_ResetCall(call, 1);
2643 call = rxi_Alloc(sizeof(struct rx_call));
2644 #ifdef RXDEBUG_PACKET
2645 call->allNextp = rx_allCallsp;
2646 rx_allCallsp = call;
2648 rx_atomic_inc_and_read(&rx_stats.nCallStructs);
2649 #else /* RXDEBUG_PACKET */
2650 rx_atomic_inc(&rx_stats.nCallStructs);
2651 #endif /* RXDEBUG_PACKET */
2653 MUTEX_EXIT(&rx_freeCallQueue_lock);
2654 MUTEX_INIT(&call->lock, "call lock", MUTEX_DEFAULT, NULL);
2655 MUTEX_ENTER(&call->lock);
2656 CV_INIT(&call->cv_twind, "call twind", CV_DEFAULT, 0);
2657 CV_INIT(&call->cv_rq, "call rq", CV_DEFAULT, 0);
2658 CV_INIT(&call->cv_tq, "call tq", CV_DEFAULT, 0);
2660 /* Initialize once-only items */
2661 opr_queue_Init(&call->tq);
2662 opr_queue_Init(&call->rq);
2663 opr_queue_Init(&call->app.iovq);
2664 #ifdef RXDEBUG_PACKET
2665 call->rqc = call->tqc = call->iovqc = 0;
2666 #endif /* RXDEBUG_PACKET */
2667 /* Bind the call to its connection structure (prereq for reset) */
2669 rxi_ResetCall(call, 1);
2671 call->channel = channel;
2672 call->callNumber = &conn->callNumber[channel];
2673 call->rwind = conn->rwind[channel];
2674 call->twind = conn->twind[channel];
2675 /* Note that the next expected call number is retained (in
2676 * conn->callNumber[i]), even if we reallocate the call structure
2678 conn->call[channel] = call;
2679 /* if the channel's never been used (== 0), we should start at 1, otherwise
2680 * the call number is valid from the last time this channel was used */
2681 if (*call->callNumber == 0)
2682 *call->callNumber = 1;
2687 /* A call has been inactive long enough that so we can throw away
2688 * state, including the call structure, which is placed on the call
2691 * call->lock amd rx_refcnt_mutex are held upon entry.
2692 * haveCTLock is set when called from rxi_ReapConnections.
2694 * return 1 if the call is freed, 0 if not.
2697 rxi_FreeCall(struct rx_call *call, int haveCTLock)
2699 int channel = call->channel;
2700 struct rx_connection *conn = call->conn;
2701 u_char state = call->state;
2704 * We are setting the state to RX_STATE_RESET to
2705 * ensure that no one else will attempt to use this
2706 * call once we drop the refcnt lock. We must drop
2707 * the refcnt lock before calling rxi_ResetCall
2708 * because it cannot be held across acquiring the
2709 * freepktQ lock. NewCall does the same.
2711 call->state = RX_STATE_RESET;
2712 MUTEX_EXIT(&rx_refcnt_mutex);
2713 rxi_ResetCall(call, 0);
2715 if (MUTEX_TRYENTER(&conn->conn_call_lock))
2717 if (state == RX_STATE_DALLY || state == RX_STATE_HOLD)
2718 (*call->callNumber)++;
2720 if (call->conn->call[channel] == call)
2721 call->conn->call[channel] = 0;
2722 MUTEX_EXIT(&conn->conn_call_lock);
2725 * We couldn't obtain the conn_call_lock so we can't
2726 * disconnect the call from the connection. Set the
2727 * call state to dally so that the call can be reused.
2729 MUTEX_ENTER(&rx_refcnt_mutex);
2730 call->state = RX_STATE_DALLY;
2734 MUTEX_ENTER(&rx_freeCallQueue_lock);
2735 SET_CALL_QUEUE_LOCK(call, &rx_freeCallQueue_lock);
2736 #ifdef RX_ENABLE_LOCKS
2737 /* A call may be free even though its transmit queue is still in use.
2738 * Since we search the call list from head to tail, put busy calls at
2739 * the head of the list, and idle calls at the tail.
2741 if (call->flags & RX_CALL_TQ_BUSY)
2742 opr_queue_Prepend(&rx_freeCallQueue, &call->entry);
2744 opr_queue_Append(&rx_freeCallQueue, &call->entry);
2745 #else /* RX_ENABLE_LOCKS */
2746 opr_queue_Append(&rx_freeCallQueue, &call->entry);
2747 #endif /* RX_ENABLE_LOCKS */
2748 if (rx_stats_active)
2749 rx_atomic_inc(&rx_stats.nFreeCallStructs);
2750 MUTEX_EXIT(&rx_freeCallQueue_lock);
2752 /* Destroy the connection if it was previously slated for
2753 * destruction, i.e. the Rx client code previously called
2754 * rx_DestroyConnection (client connections), or
2755 * rxi_ReapConnections called the same routine (server
2756 * connections). Only do this, however, if there are no
2757 * outstanding calls. Note that for fine grain locking, there appears
2758 * to be a deadlock in that rxi_FreeCall has a call locked and
2759 * DestroyConnectionNoLock locks each call in the conn. But note a
2760 * few lines up where we have removed this call from the conn.
2761 * If someone else destroys a connection, they either have no
2762 * call lock held or are going through this section of code.
2764 MUTEX_ENTER(&conn->conn_data_lock);
2765 if (conn->flags & RX_CONN_DESTROY_ME && !(conn->flags & RX_CONN_MAKECALL_WAITING)) {
2766 rx_GetConnection(conn);
2767 MUTEX_EXIT(&conn->conn_data_lock);
2768 #ifdef RX_ENABLE_LOCKS
2770 rxi_DestroyConnectionNoLock(conn);
2772 rxi_DestroyConnection(conn);
2773 #else /* RX_ENABLE_LOCKS */
2774 rxi_DestroyConnection(conn);
2775 #endif /* RX_ENABLE_LOCKS */
2777 MUTEX_EXIT(&conn->conn_data_lock);
2779 MUTEX_ENTER(&rx_refcnt_mutex);
2783 rx_atomic_t rxi_Allocsize = RX_ATOMIC_INIT(0);
2784 rx_atomic_t rxi_Alloccnt = RX_ATOMIC_INIT(0);
2787 rxi_Alloc(size_t size)
2791 if (rx_stats_active) {
2792 rx_atomic_add(&rxi_Allocsize, (int) size);
2793 rx_atomic_inc(&rxi_Alloccnt);
2797 #if defined(KERNEL) && !defined(UKERNEL) && defined(AFS_FBSD80_ENV)
2798 afs_osi_Alloc_NoSleep(size);
2803 osi_Panic("rxi_Alloc error");
2809 rxi_Free(void *addr, size_t size)
2811 if (rx_stats_active) {
2812 rx_atomic_sub(&rxi_Allocsize, (int) size);
2813 rx_atomic_dec(&rxi_Alloccnt);
2815 osi_Free(addr, size);
2819 rxi_SetPeerMtu(struct rx_peer *peer, afs_uint32 host, afs_uint32 port, int mtu)
2821 struct rx_peer **peer_ptr = NULL, **peer_end = NULL;
2822 struct rx_peer *next = NULL;
2826 MUTEX_ENTER(&rx_peerHashTable_lock);
2828 peer_ptr = &rx_peerHashTable[0];
2829 peer_end = &rx_peerHashTable[rx_hashTableSize];
2832 for ( ; peer_ptr < peer_end; peer_ptr++) {
2835 for ( ; peer; peer = next) {
2837 if (host == peer->host)
2842 hashIndex = PEER_HASH(host, port);
2843 for (peer = rx_peerHashTable[hashIndex]; peer; peer = peer->next) {
2844 if ((peer->host == host) && (peer->port == port))
2849 MUTEX_ENTER(&rx_peerHashTable_lock);
2854 MUTEX_EXIT(&rx_peerHashTable_lock);
2856 MUTEX_ENTER(&peer->peer_lock);
2857 /* We don't handle dropping below min, so don't */
2858 mtu = MAX(mtu, RX_MIN_PACKET_SIZE);
2859 peer->ifMTU=MIN(mtu, peer->ifMTU);
2860 peer->natMTU = rxi_AdjustIfMTU(peer->ifMTU);
2861 /* if we tweaked this down, need to tune our peer MTU too */
2862 peer->MTU = MIN(peer->MTU, peer->natMTU);
2863 /* if we discovered a sub-1500 mtu, degrade */
2864 if (peer->ifMTU < OLD_MAX_PACKET_SIZE)
2865 peer->maxDgramPackets = 1;
2866 /* We no longer have valid peer packet information */
2867 if (peer->maxPacketSize + RX_HEADER_SIZE > peer->ifMTU)
2868 peer->maxPacketSize = 0;
2869 MUTEX_EXIT(&peer->peer_lock);
2871 MUTEX_ENTER(&rx_peerHashTable_lock);
2873 if (host && !port) {
2875 /* pick up where we left off */
2879 MUTEX_EXIT(&rx_peerHashTable_lock);
2882 #ifdef AFS_RXERRQ_ENV
2884 rxi_SetPeerDead(struct sock_extended_err *err, afs_uint32 host, afs_uint16 port)
2886 int hashIndex = PEER_HASH(host, port);
2887 struct rx_peer *peer;
2889 MUTEX_ENTER(&rx_peerHashTable_lock);
2891 for (peer = rx_peerHashTable[hashIndex]; peer; peer = peer->next) {
2892 if (peer->host == host && peer->port == port) {
2898 MUTEX_EXIT(&rx_peerHashTable_lock);
2901 rx_atomic_inc(&peer->neterrs);
2902 MUTEX_ENTER(&peer->peer_lock);
2903 peer->last_err_origin = RX_NETWORK_ERROR_ORIGIN_ICMP;
2904 peer->last_err_type = err->ee_type;
2905 peer->last_err_code = err->ee_code;
2906 MUTEX_EXIT(&peer->peer_lock);
2908 MUTEX_ENTER(&rx_peerHashTable_lock);
2910 MUTEX_EXIT(&rx_peerHashTable_lock);
2915 rxi_ProcessNetError(struct sock_extended_err *err, afs_uint32 addr, afs_uint16 port)
2917 # ifdef AFS_ADAPT_PMTU
2918 if (err->ee_errno == EMSGSIZE && err->ee_info >= 68) {
2919 rxi_SetPeerMtu(NULL, addr, port, err->ee_info - RX_IPUDP_SIZE);
2923 if (err->ee_origin == SO_EE_ORIGIN_ICMP && err->ee_type == ICMP_DEST_UNREACH) {
2924 switch (err->ee_code) {
2925 case ICMP_NET_UNREACH:
2926 case ICMP_HOST_UNREACH:
2927 case ICMP_PORT_UNREACH:
2930 rxi_SetPeerDead(err, addr, port);
2937 rxi_TranslateICMP(int type, int code)
2940 case ICMP_DEST_UNREACH:
2942 case ICMP_NET_UNREACH:
2943 return "Destination Net Unreachable";
2944 case ICMP_HOST_UNREACH:
2945 return "Destination Host Unreachable";
2946 case ICMP_PROT_UNREACH:
2947 return "Destination Protocol Unreachable";
2948 case ICMP_PORT_UNREACH:
2949 return "Destination Port Unreachable";
2951 return "Destination Net Prohibited";
2953 return "Destination Host Prohibited";
2959 #endif /* AFS_RXERRQ_ENV */
2962 * Get the last network error for a connection
2964 * A "network error" here means an error retrieved from ICMP, or some other
2965 * mechanism outside of Rx that informs us of errors in network reachability.
2967 * If a peer associated with the given Rx connection has received a network
2968 * error recently, this function allows the caller to know what error
2969 * specifically occurred. This can be useful to know, since e.g. ICMP errors
2970 * can cause calls to that peer to be quickly aborted. So, this function can
2971 * help see why a call was aborted due to network errors.
2973 * If we have received traffic from a peer since the last network error, we
2974 * treat that peer as if we had not received an network error for it.
2976 * @param[in] conn The Rx connection to examine
2977 * @param[out] err_origin The origin of the last network error (e.g. ICMP);
2978 * one of the RX_NETWORK_ERROR_ORIGIN_* constants
2979 * @param[out] err_type The type of the last error
2980 * @param[out] err_code The code of the last error
2981 * @param[out] msg Human-readable error message, if applicable; NULL otherwise
2983 * @return If we have an error
2984 * @retval -1 No error to get; 'out' params are undefined
2985 * @retval 0 We have an error; 'out' params contain the last error
2988 rx_GetNetworkError(struct rx_connection *conn, int *err_origin, int *err_type,
2989 int *err_code, const char **msg)
2991 #ifdef AFS_RXERRQ_ENV
2992 struct rx_peer *peer = conn->peer;
2993 if (rx_atomic_read(&peer->neterrs)) {
2994 MUTEX_ENTER(&peer->peer_lock);
2995 *err_origin = peer->last_err_origin;
2996 *err_type = peer->last_err_type;
2997 *err_code = peer->last_err_code;
2998 MUTEX_EXIT(&peer->peer_lock);
3001 if (*err_origin == RX_NETWORK_ERROR_ORIGIN_ICMP) {
3002 *msg = rxi_TranslateICMP(*err_type, *err_code);
3011 /* Find the peer process represented by the supplied (host,port)
3012 * combination. If there is no appropriate active peer structure, a
3013 * new one will be allocated and initialized
3016 rxi_FindPeer(afs_uint32 host, u_short port, int create)
3020 hashIndex = PEER_HASH(host, port);
3021 MUTEX_ENTER(&rx_peerHashTable_lock);
3022 for (pp = rx_peerHashTable[hashIndex]; pp; pp = pp->next) {
3023 if ((pp->host == host) && (pp->port == port))
3028 pp = rxi_AllocPeer(); /* This bzero's *pp */
3029 pp->host = host; /* set here or in InitPeerParams is zero */
3031 #ifdef AFS_RXERRQ_ENV
3032 rx_atomic_set(&pp->neterrs, 0);
3034 MUTEX_INIT(&pp->peer_lock, "peer_lock", MUTEX_DEFAULT, 0);
3035 opr_queue_Init(&pp->rpcStats);
3036 pp->next = rx_peerHashTable[hashIndex];
3037 rx_peerHashTable[hashIndex] = pp;
3038 rxi_InitPeerParams(pp);
3039 if (rx_stats_active)
3040 rx_atomic_inc(&rx_stats.nPeerStructs);
3046 MUTEX_EXIT(&rx_peerHashTable_lock);
3051 /* Find the connection at (host, port) started at epoch, and with the
3052 * given connection id. Creates the server connection if necessary.
3053 * The type specifies whether a client connection or a server
3054 * connection is desired. In both cases, (host, port) specify the
3055 * peer's (host, pair) pair. Client connections are not made
3056 * automatically by this routine. The parameter socket gives the
3057 * socket descriptor on which the packet was received. This is used,
3058 * in the case of server connections, to check that *new* connections
3059 * come via a valid (port, serviceId). Finally, the securityIndex
3060 * parameter must match the existing index for the connection. If a
3061 * server connection is created, it will be created using the supplied
3062 * index, if the index is valid for this service */
3063 static struct rx_connection *
3064 rxi_FindConnection(osi_socket socket, afs_uint32 host,
3065 u_short port, u_short serviceId, afs_uint32 cid,
3066 afs_uint32 epoch, int type, u_int securityIndex,
3067 int *unknownService)
3069 int hashindex, flag, i;
3070 struct rx_connection *conn;
3071 *unknownService = 0;
3072 hashindex = CONN_HASH(host, port, cid, epoch, type);
3073 MUTEX_ENTER(&rx_connHashTable_lock);
3074 rxLastConn ? (conn = rxLastConn, flag = 0) : (conn =
3075 rx_connHashTable[hashindex],
3078 if ((conn->type == type) && ((cid & RX_CIDMASK) == conn->cid)
3079 && (epoch == conn->epoch)) {
3080 struct rx_peer *pp = conn->peer;
3081 if (securityIndex != conn->securityIndex) {
3082 /* this isn't supposed to happen, but someone could forge a packet
3083 * like this, and there seems to be some CM bug that makes this
3084 * happen from time to time -- in which case, the fileserver
3086 MUTEX_EXIT(&rx_connHashTable_lock);
3087 return (struct rx_connection *)0;
3089 if (pp->host == host && pp->port == port)
3091 if (type == RX_CLIENT_CONNECTION && pp->port == port)
3093 /* So what happens when it's a callback connection? */
3094 if ( /*type == RX_CLIENT_CONNECTION && */
3095 (conn->epoch & 0x80000000))
3099 /* the connection rxLastConn that was used the last time is not the
3100 ** one we are looking for now. Hence, start searching in the hash */
3102 conn = rx_connHashTable[hashindex];
3107 struct rx_service *service;
3108 if (type == RX_CLIENT_CONNECTION) {
3109 MUTEX_EXIT(&rx_connHashTable_lock);
3110 return (struct rx_connection *)0;
3112 service = rxi_FindService(socket, serviceId);
3113 if (!service || (securityIndex >= service->nSecurityObjects)
3114 || (service->securityObjects[securityIndex] == 0)) {
3115 MUTEX_EXIT(&rx_connHashTable_lock);
3116 *unknownService = 1;
3117 return (struct rx_connection *)0;
3119 conn = rxi_AllocConnection(); /* This bzero's the connection */
3120 MUTEX_INIT(&conn->conn_call_lock, "conn call lock", MUTEX_DEFAULT, 0);
3121 MUTEX_INIT(&conn->conn_data_lock, "conn data lock", MUTEX_DEFAULT, 0);
3122 CV_INIT(&conn->conn_call_cv, "conn call cv", CV_DEFAULT, 0);
3123 conn->next = rx_connHashTable[hashindex];
3124 rx_connHashTable[hashindex] = conn;
3125 conn->peer = rxi_FindPeer(host, port, 1);
3126 conn->type = RX_SERVER_CONNECTION;
3127 conn->lastSendTime = clock_Sec(); /* don't GC immediately */
3128 conn->epoch = epoch;
3129 conn->cid = cid & RX_CIDMASK;
3130 conn->ackRate = RX_FAST_ACK_RATE;
3131 conn->service = service;
3132 conn->serviceId = serviceId;
3133 conn->securityIndex = securityIndex;
3134 conn->securityObject = service->securityObjects[securityIndex];
3135 conn->nSpecific = 0;
3136 conn->specific = NULL;
3137 rx_SetConnDeadTime(conn, service->connDeadTime);
3138 rx_SetConnIdleDeadTime(conn, service->idleDeadTime);
3139 for (i = 0; i < RX_MAXCALLS; i++) {
3140 conn->twind[i] = rx_initSendWindow;
3141 conn->rwind[i] = rx_initReceiveWindow;
3143 /* Notify security object of the new connection */
3144 RXS_NewConnection(conn->securityObject, conn);
3145 /* XXXX Connection timeout? */
3146 if (service->newConnProc)
3147 (*service->newConnProc) (conn);
3148 if (rx_stats_active)
3149 rx_atomic_inc(&rx_stats.nServerConns);
3152 rx_GetConnection(conn);
3154 rxLastConn = conn; /* store this connection as the last conn used */
3155 MUTEX_EXIT(&rx_connHashTable_lock);
3160 * Abort the call if the server is over the busy threshold. This
3161 * can be used without requiring a call structure be initialised,
3162 * or connected to a particular channel
3165 rxi_AbortIfServerBusy(osi_socket socket, struct rx_connection *conn,
3166 struct rx_packet *np)
3168 if ((rx_BusyThreshold > 0) &&
3169 (rx_atomic_read(&rx_nWaiting) > rx_BusyThreshold)) {
3170 rxi_SendRawAbort(socket, conn->peer->host, conn->peer->port,
3171 rx_BusyError, np, 0);
3172 if (rx_stats_active)
3173 rx_atomic_inc(&rx_stats.nBusies);
3180 static_inline struct rx_call *
3181 rxi_ReceiveClientCall(struct rx_packet *np, struct rx_connection *conn)
3184 struct rx_call *call;
3186 channel = np->header.cid & RX_CHANNELMASK;
3187 MUTEX_ENTER(&conn->conn_call_lock);
3188 call = conn->call[channel];
3189 if (np->header.type == RX_PACKET_TYPE_BUSY) {
3190 conn->lastBusy[channel] = clock_Sec();
3192 if (!call || conn->callNumber[channel] != np->header.callNumber) {
3193 MUTEX_EXIT(&conn->conn_call_lock);
3194 if (rx_stats_active)
3195 rx_atomic_inc(&rx_stats.spuriousPacketsRead);
3199 MUTEX_ENTER(&call->lock);
3200 MUTEX_EXIT(&conn->conn_call_lock);
3202 if ((call->state == RX_STATE_DALLY)
3203 && np->header.type == RX_PACKET_TYPE_ACK) {
3204 if (rx_stats_active)
3205 rx_atomic_inc(&rx_stats.ignorePacketDally);
3206 MUTEX_EXIT(&call->lock);
3213 static_inline struct rx_call *
3214 rxi_ReceiveServerCall(osi_socket socket, struct rx_packet *np,
3215 struct rx_connection *conn)
3218 struct rx_call *call;
3220 channel = np->header.cid & RX_CHANNELMASK;
3221 MUTEX_ENTER(&conn->conn_call_lock);
3222 call = conn->call[channel];
3225 if (rxi_AbortIfServerBusy(socket, conn, np)) {
3226 MUTEX_EXIT(&conn->conn_call_lock);
3230 call = rxi_NewCall(conn, channel); /* returns locked call */
3231 *call->callNumber = np->header.callNumber;
3232 MUTEX_EXIT(&conn->conn_call_lock);
3234 call->state = RX_STATE_PRECALL;
3235 clock_GetTime(&call->queueTime);
3236 call->app.bytesSent = 0;
3237 call->app.bytesRcvd = 0;
3238 rxi_KeepAliveOn(call);
3243 if (np->header.callNumber == conn->callNumber[channel]) {
3244 MUTEX_ENTER(&call->lock);
3245 MUTEX_EXIT(&conn->conn_call_lock);
3249 if (np->header.callNumber < conn->callNumber[channel]) {
3250 MUTEX_EXIT(&conn->conn_call_lock);
3251 if (rx_stats_active)
3252 rx_atomic_inc(&rx_stats.spuriousPacketsRead);
3256 MUTEX_ENTER(&call->lock);
3257 MUTEX_EXIT(&conn->conn_call_lock);
3259 /* Wait until the transmit queue is idle before deciding
3260 * whether to reset the current call. Chances are that the
3261 * call will be in ether DALLY or HOLD state once the TQ_BUSY
3264 #ifdef RX_ENABLE_LOCKS
3265 if (call->state == RX_STATE_ACTIVE && !call->error) {
3266 rxi_WaitforTQBusy(call);
3267 /* If we entered error state while waiting,
3268 * must call rxi_CallError to permit rxi_ResetCall
3269 * to processed when the tqWaiter count hits zero.
3272 rxi_CallError(call, call->error);
3273 MUTEX_EXIT(&call->lock);
3277 #endif /* RX_ENABLE_LOCKS */
3278 /* If the new call cannot be taken right now send a busy and set
3279 * the error condition in this call, so that it terminates as
3280 * quickly as possible */
3281 if (call->state == RX_STATE_ACTIVE) {
3282 rxi_CallError(call, RX_CALL_DEAD);
3283 rxi_SendSpecial(call, conn, NULL, RX_PACKET_TYPE_BUSY,
3285 MUTEX_EXIT(&call->lock);
3289 if (rxi_AbortIfServerBusy(socket, conn, np)) {
3290 MUTEX_EXIT(&call->lock);
3294 rxi_ResetCall(call, 0);
3295 /* The conn_call_lock is not held but no one else should be
3296 * using this call channel while we are processing this incoming
3297 * packet. This assignment should be safe.
3299 *call->callNumber = np->header.callNumber;
3300 call->state = RX_STATE_PRECALL;
3301 clock_GetTime(&call->queueTime);
3302 call->app.bytesSent = 0;
3303 call->app.bytesRcvd = 0;
3304 rxi_KeepAliveOn(call);
3310 /* There are two packet tracing routines available for testing and monitoring
3311 * Rx. One is called just after every packet is received and the other is
3312 * called just before every packet is sent. Received packets, have had their
3313 * headers decoded, and packets to be sent have not yet had their headers
3314 * encoded. Both take two parameters: a pointer to the packet and a sockaddr
3315 * containing the network address. Both can be modified. The return value, if
3316 * non-zero, indicates that the packet should be dropped. */
3318 int (*rx_justReceived) (struct rx_packet *, struct sockaddr_in *) = 0;
3319 int (*rx_almostSent) (struct rx_packet *, struct sockaddr_in *) = 0;
3321 /* A packet has been received off the interface. Np is the packet, socket is
3322 * the socket number it was received from (useful in determining which service
3323 * this packet corresponds to), and (host, port) reflect the host,port of the
3324 * sender. This call returns the packet to the caller if it is finished with
3325 * it, rather than de-allocating it, just as a small performance hack */
3328 rxi_ReceivePacket(struct rx_packet *np, osi_socket socket,
3329 afs_uint32 host, u_short port, int *tnop,
3330 struct rx_call **newcallp)
3332 struct rx_call *call;
3333 struct rx_connection *conn;
3335 int unknownService = 0;
3339 struct rx_packet *tnp;
3342 /* We don't print out the packet until now because (1) the time may not be
3343 * accurate enough until now in the lwp implementation (rx_Listener only gets
3344 * the time after the packet is read) and (2) from a protocol point of view,
3345 * this is the first time the packet has been seen */
3346 packetType = (np->header.type > 0 && np->header.type < RX_N_PACKET_TYPES)
3347 ? rx_packetTypes[np->header.type - 1] : "*UNKNOWN*";
3348 dpf(("R %d %s: %x.%d.%d.%d.%d.%d.%d flags %d, packet %"AFS_PTR_FMT"\n",
3349 np->header.serial, packetType, ntohl(host), ntohs(port), np->header.serviceId,
3350 np->header.epoch, np->header.cid, np->header.callNumber,
3351 np->header.seq, np->header.flags, np));
3354 /* Account for connectionless packets */
3355 if (rx_stats_active &&
3356 ((np->header.type == RX_PACKET_TYPE_VERSION) ||
3357 (np->header.type == RX_PACKET_TYPE_DEBUG))) {
3358 struct rx_peer *peer;
3360 /* Try to look up the peer structure, but don't create one */
3361 peer = rxi_FindPeer(host, port, 0);
3363 /* Since this may not be associated with a connection, it may have
3364 * no refCount, meaning we could race with ReapConnections
3367 if (peer && (peer->refCount > 0)) {
3368 #ifdef AFS_RXERRQ_ENV
3369 if (rx_atomic_read(&peer->neterrs)) {
3370 rx_atomic_set(&peer->neterrs, 0);
3373 MUTEX_ENTER(&peer->peer_lock);
3374 peer->bytesReceived += np->length;
3375 MUTEX_EXIT(&peer->peer_lock);
3379 if (np->header.type == RX_PACKET_TYPE_VERSION) {
3380 return rxi_ReceiveVersionPacket(np, socket, host, port, 1);
3383 if (np->header.type == RX_PACKET_TYPE_DEBUG) {
3384 return rxi_ReceiveDebugPacket(np, socket, host, port, 1);
3387 /* If an input tracer function is defined, call it with the packet and
3388 * network address. Note this function may modify its arguments. */
3389 if (rx_justReceived) {
3390 struct sockaddr_in addr;
3392 addr.sin_family = AF_INET;
3393 addr.sin_port = port;
3394 addr.sin_addr.s_addr = host;
3395 memset(&addr.sin_zero, 0, sizeof(addr.sin_zero));
3396 #ifdef STRUCT_SOCKADDR_HAS_SA_LEN
3397 addr.sin_len = sizeof(addr);
3398 #endif /* AFS_OSF_ENV */
3399 drop = (*rx_justReceived) (np, &addr);
3400 /* drop packet if return value is non-zero */
3403 port = addr.sin_port; /* in case fcn changed addr */
3404 host = addr.sin_addr.s_addr;
3408 /* If packet was not sent by the client, then *we* must be the client */
3409 type = ((np->header.flags & RX_CLIENT_INITIATED) != RX_CLIENT_INITIATED)
3410 ? RX_CLIENT_CONNECTION : RX_SERVER_CONNECTION;
3412 /* Find the connection (or fabricate one, if we're the server & if
3413 * necessary) associated with this packet */
3415 rxi_FindConnection(socket, host, port, np->header.serviceId,
3416 np->header.cid, np->header.epoch, type,
3417 np->header.securityIndex, &unknownService);
3419 /* To avoid having 2 connections just abort at each other,
3420 don't abort an abort. */
3422 if (unknownService && (np->header.type != RX_PACKET_TYPE_ABORT))
3423 rxi_SendRawAbort(socket, host, port, RX_INVALID_OPERATION,
3428 #ifdef AFS_RXERRQ_ENV
3429 if (rx_atomic_read(&conn->peer->neterrs)) {
3430 rx_atomic_set(&conn->peer->neterrs, 0);
3434 /* If we're doing statistics, then account for the incoming packet */
3435 if (rx_stats_active) {
3436 MUTEX_ENTER(&conn->peer->peer_lock);
3437 conn->peer->bytesReceived += np->length;
3438 MUTEX_EXIT(&conn->peer->peer_lock);
3441 /* If the connection is in an error state, send an abort packet and ignore
3442 * the incoming packet */
3444 /* Don't respond to an abort packet--we don't want loops! */
3445 MUTEX_ENTER(&conn->conn_data_lock);
3446 if (np->header.type != RX_PACKET_TYPE_ABORT)
3447 np = rxi_SendConnectionAbort(conn, np, 1, 0);
3448 putConnection(conn);
3449 MUTEX_EXIT(&conn->conn_data_lock);
3453 /* Check for connection-only requests (i.e. not call specific). */
3454 if (np->header.callNumber == 0) {
3455 switch (np->header.type) {
3456 case RX_PACKET_TYPE_ABORT: {
3457 /* What if the supplied error is zero? */
3458 afs_int32 errcode = ntohl(rx_GetInt32(np, 0));
3459 dpf(("rxi_ReceivePacket ABORT rx_GetInt32 = %d\n", errcode));
3460 rxi_ConnectionError(conn, errcode);
3461 putConnection(conn);
3464 case RX_PACKET_TYPE_CHALLENGE:
3465 tnp = rxi_ReceiveChallengePacket(conn, np, 1);
3466 putConnection(conn);
3468 case RX_PACKET_TYPE_RESPONSE:
3469 tnp = rxi_ReceiveResponsePacket(conn, np, 1);
3470 putConnection(conn);
3472 case RX_PACKET_TYPE_PARAMS:
3473 case RX_PACKET_TYPE_PARAMS + 1:
3474 case RX_PACKET_TYPE_PARAMS + 2:
3475 /* ignore these packet types for now */
3476 putConnection(conn);
3480 /* Should not reach here, unless the peer is broken: send an
3482 rxi_ConnectionError(conn, RX_PROTOCOL_ERROR);
3483 MUTEX_ENTER(&conn->conn_data_lock);
3484 tnp = rxi_SendConnectionAbort(conn, np, 1, 0);
3485 putConnection(conn);
3486 MUTEX_EXIT(&conn->conn_data_lock);
3491 if (type == RX_SERVER_CONNECTION)
3492 call = rxi_ReceiveServerCall(socket, np, conn);
3494 call = rxi_ReceiveClientCall(np, conn);
3497 putConnection(conn);
3501 MUTEX_ASSERT(&call->lock);
3502 /* Set remote user defined status from packet */
3503 call->remoteStatus = np->header.userStatus;
3505 /* Now do packet type-specific processing */
3506 switch (np->header.type) {
3507 case RX_PACKET_TYPE_DATA:
3508 /* If we're a client, and receiving a response, then all the packets
3509 * we transmitted packets are implicitly acknowledged. */
3510 if (type == RX_CLIENT_CONNECTION && !opr_queue_IsEmpty(&call->tq))
3511 rxi_AckAllInTransmitQueue(call);
3513 np = rxi_ReceiveDataPacket(call, np, 1, socket, host, port, tnop,
3516 case RX_PACKET_TYPE_ACK:
3517 /* Respond immediately to ack packets requesting acknowledgement
3519 if (np->header.flags & RX_REQUEST_ACK) {
3521 (void)rxi_SendCallAbort(call, 0, 1, 0);
3523 (void)rxi_SendAck(call, 0, np->header.serial,
3524 RX_ACK_PING_RESPONSE, 1);
3526 np = rxi_ReceiveAckPacket(call, np, 1);
3528 case RX_PACKET_TYPE_ABORT: {
3529 /* An abort packet: reset the call, passing the error up to the user. */
3530 /* What if error is zero? */
3531 /* What if the error is -1? the application will treat it as a timeout. */
3532 afs_int32 errdata = ntohl(*(afs_int32 *) rx_DataOf(np));
3533 dpf(("rxi_ReceivePacket ABORT rx_DataOf = %d\n", errdata));
3534 rxi_CallError(call, errdata);
3535 MUTEX_EXIT(&call->lock);
3536 putConnection(conn);
3537 return np; /* xmitting; drop packet */
3539 case RX_PACKET_TYPE_BUSY:
3540 /* Mostly ignore BUSY packets. We will update lastReceiveTime below,
3541 * so we don't think the endpoint is completely dead, but otherwise
3542 * just act as if we never saw anything. If all we get are BUSY packets
3543 * back, then we will eventually error out with RX_CALL_TIMEOUT if the
3544 * connection is configured with idle/hard timeouts. */
3547 case RX_PACKET_TYPE_ACKALL:
3548 /* All packets acknowledged, so we can drop all packets previously
3549 * readied for sending */
3550 rxi_AckAllInTransmitQueue(call);
3553 /* Should not reach here, unless the peer is broken: send an abort
3555 rxi_CallError(call, RX_PROTOCOL_ERROR);
3556 np = rxi_SendCallAbort(call, np, 1, 0);
3559 /* Note when this last legitimate packet was received, for keep-alive
3560 * processing. Note, we delay getting the time until now in the hope that
3561 * the packet will be delivered to the user before any get time is required
3562 * (if not, then the time won't actually be re-evaluated here). */
3563 call->lastReceiveTime = clock_Sec();
3564 MUTEX_EXIT(&call->lock);
3565 putConnection(conn);
3569 /* return true if this is an "interesting" connection from the point of view
3570 of someone trying to debug the system */
3572 rxi_IsConnInteresting(struct rx_connection *aconn)
3575 struct rx_call *tcall;
3577 if (aconn->flags & (RX_CONN_MAKECALL_WAITING | RX_CONN_DESTROY_ME))
3580 for (i = 0; i < RX_MAXCALLS; i++) {
3581 tcall = aconn->call[i];
3583 if ((tcall->state == RX_STATE_PRECALL)
3584 || (tcall->state == RX_STATE_ACTIVE))
3586 if ((tcall->app.mode == RX_MODE_SENDING)
3587 || (tcall->app.mode == RX_MODE_RECEIVING))
3595 /* if this is one of the last few packets AND it wouldn't be used by the
3596 receiving call to immediately satisfy a read request, then drop it on
3597 the floor, since accepting it might prevent a lock-holding thread from
3598 making progress in its reading. If a call has been cleared while in
3599 the precall state then ignore all subsequent packets until the call
3600 is assigned to a thread. */
3603 TooLow(struct rx_packet *ap, struct rx_call *acall)
3607 MUTEX_ENTER(&rx_quota_mutex);
3608 if (((ap->header.seq != 1) && (acall->flags & RX_CALL_CLEARED)
3609 && (acall->state == RX_STATE_PRECALL))
3610 || ((rx_nFreePackets < rxi_dataQuota + 2)
3611 && !((ap->header.seq < acall->rnext + rx_initSendWindow)
3612 && (acall->flags & RX_CALL_READER_WAIT)))) {
3615 MUTEX_EXIT(&rx_quota_mutex);
3621 * Clear the attach wait flag on a connection and proceed.
3623 * Any processing waiting for a connection to be attached should be
3624 * unblocked. We clear the flag and do any other needed tasks.
3627 * the conn to unmark waiting for attach
3629 * @pre conn's conn_data_lock must be locked before calling this function
3633 rxi_ConnClearAttachWait(struct rx_connection *conn)
3635 /* Indicate that rxi_CheckReachEvent is no longer running by
3636 * clearing the flag. Must be atomic under conn_data_lock to
3637 * avoid a new call slipping by: rxi_CheckConnReach holds
3638 * conn_data_lock while checking RX_CONN_ATTACHWAIT.
3640 conn->flags &= ~RX_CONN_ATTACHWAIT;
3641 if (conn->flags & RX_CONN_NAT_PING) {
3642 conn->flags &= ~RX_CONN_NAT_PING;
3643 rxi_ScheduleNatKeepAliveEvent(conn);
3648 * Event handler function for connection-specific events for checking
3649 * reachability. Also called directly from main code with |event| == NULL
3650 * in order to trigger the initial reachability check.
3652 * When |event| == NULL, must be called with the connection data lock held,
3653 * but returns with the lock unlocked.
3656 rxi_CheckReachEvent(struct rxevent *event, void *arg1, void *arg2, int dummy)
3658 struct rx_connection *conn = arg1;
3659 struct rx_call *acall = arg2;
3660 struct rx_call *call = acall;
3661 struct clock when, now;
3665 MUTEX_ENTER(&conn->conn_data_lock);
3667 MUTEX_ASSERT(&conn->conn_data_lock);
3669 if (event != NULL && event == conn->checkReachEvent)
3670 rxevent_Put(&conn->checkReachEvent);
3671 waiting = conn->flags & RX_CONN_ATTACHWAIT;
3672 MUTEX_EXIT(&conn->conn_data_lock);
3676 MUTEX_ENTER(&conn->conn_call_lock);
3677 MUTEX_ENTER(&conn->conn_data_lock);
3678 for (i = 0; i < RX_MAXCALLS; i++) {
3679 struct rx_call *tc = conn->call[i];
3680 if (tc && tc->state == RX_STATE_PRECALL) {
3686 rxi_ConnClearAttachWait(conn);
3687 MUTEX_EXIT(&conn->conn_data_lock);
3688 MUTEX_EXIT(&conn->conn_call_lock);
3693 MUTEX_ENTER(&call->lock);
3694 rxi_SendAck(call, NULL, 0, RX_ACK_PING, 0);
3696 MUTEX_EXIT(&call->lock);
3698 clock_GetTime(&now);
3700 when.sec += RX_CHECKREACH_TIMEOUT;
3701 MUTEX_ENTER(&conn->conn_data_lock);
3702 if (!conn->checkReachEvent) {
3703 rx_GetConnection(conn);
3704 conn->checkReachEvent = rxevent_Post(&when, &now,
3705 rxi_CheckReachEvent, conn,
3708 MUTEX_EXIT(&conn->conn_data_lock);
3711 /* If fired as an event handler, drop our refcount on the connection. */
3713 putConnection(conn);
3717 rxi_CheckConnReach(struct rx_connection *conn, struct rx_call *call)
3719 struct rx_service *service = conn->service;
3720 struct rx_peer *peer = conn->peer;
3721 afs_uint32 now, lastReach;
3723 if (service->checkReach == 0)
3727 MUTEX_ENTER(&peer->peer_lock);
3728 lastReach = peer->lastReachTime;
3729 MUTEX_EXIT(&peer->peer_lock);
3730 if (now - lastReach < RX_CHECKREACH_TTL)
3733 MUTEX_ENTER(&conn->conn_data_lock);
3734 if (conn->flags & RX_CONN_ATTACHWAIT) {
3735 MUTEX_EXIT(&conn->conn_data_lock);
3738 conn->flags |= RX_CONN_ATTACHWAIT;
3739 if (conn->checkReachEvent == NULL) {
3740 /* rxi_CheckReachEvent(NULL, ...) will drop the lock. */
3741 rxi_CheckReachEvent(NULL, conn, call, 0);
3743 MUTEX_EXIT(&conn->conn_data_lock);
3749 /* try to attach call, if authentication is complete */
3751 TryAttach(struct rx_call *acall, osi_socket socket,
3752 int *tnop, struct rx_call **newcallp,
3755 struct rx_connection *conn = acall->conn;
3757 if (conn->type == RX_SERVER_CONNECTION
3758 && acall->state == RX_STATE_PRECALL) {
3759 /* Don't attach until we have any req'd. authentication. */
3760 if (RXS_CheckAuthentication(conn->securityObject, conn) == 0) {
3761 if (reachOverride || rxi_CheckConnReach(conn, acall) == 0)
3762 rxi_AttachServerProc(acall, socket, tnop, newcallp);
3763 /* Note: this does not necessarily succeed; there
3764 * may not any proc available
3767 rxi_ChallengeOn(acall->conn);
3772 /* A data packet has been received off the interface. This packet is
3773 * appropriate to the call (the call is in the right state, etc.). This
3774 * routine can return a packet to the caller, for re-use */
3776 static struct rx_packet *
3777 rxi_ReceiveDataPacket(struct rx_call *call,
3778 struct rx_packet *np, int istack,
3779 osi_socket socket, afs_uint32 host, u_short port,
3780 int *tnop, struct rx_call **newcallp)
3782 int ackNeeded = 0; /* 0 means no, otherwise ack_reason */
3787 afs_uint32 serial=0, flags=0;
3789 struct rx_packet *tnp;
3790 if (rx_stats_active)
3791 rx_atomic_inc(&rx_stats.dataPacketsRead);
3794 /* If there are no packet buffers, drop this new packet, unless we can find
3795 * packet buffers from inactive calls */
3797 && (rxi_OverQuota(RX_PACKET_CLASS_RECEIVE) || TooLow(np, call))) {
3798 MUTEX_ENTER(&rx_freePktQ_lock);
3799 rxi_NeedMorePackets = TRUE;
3800 MUTEX_EXIT(&rx_freePktQ_lock);
3801 if (rx_stats_active)
3802 rx_atomic_inc(&rx_stats.noPacketBuffersOnRead);
3803 rxi_calltrace(RX_TRACE_DROP, call);
3804 dpf(("packet %"AFS_PTR_FMT" dropped on receipt - quota problems\n", np));
3805 /* We used to clear the receive queue here, in an attempt to free
3806 * packets. However this is unsafe if the queue has received a
3807 * soft ACK for the final packet */
3808 rxi_PostDelayedAckEvent(call, &rx_softAckDelay);
3814 * New in AFS 3.5, if the RX_JUMBO_PACKET flag is set then this
3815 * packet is one of several packets transmitted as a single
3816 * datagram. Do not send any soft or hard acks until all packets
3817 * in a jumbogram have been processed. Send negative acks right away.
3819 for (isFirst = 1, tnp = NULL; isFirst || tnp; isFirst = 0) {
3820 /* tnp is non-null when there are more packets in the
3821 * current jumbo gram */
3828 seq = np->header.seq;
3829 serial = np->header.serial;
3830 flags = np->header.flags;
3832 /* If the call is in an error state, send an abort message */
3834 return rxi_SendCallAbort(call, np, istack, 0);
3836 /* The RX_JUMBO_PACKET is set in all but the last packet in each
3837 * AFS 3.5 jumbogram. */
3838 if (flags & RX_JUMBO_PACKET) {
3839 tnp = rxi_SplitJumboPacket(np, host, port, isFirst);
3844 if (np->header.spare != 0) {
3845 MUTEX_ENTER(&call->conn->conn_data_lock);
3846 call->conn->flags |= RX_CONN_USING_PACKET_CKSUM;
3847 MUTEX_EXIT(&call->conn->conn_data_lock);
3850 /* The usual case is that this is the expected next packet */
3851 if (seq == call->rnext) {
3853 /* Check to make sure it is not a duplicate of one already queued */
3854 if (!opr_queue_IsEmpty(&call->rq)
3855 && opr_queue_First(&call->rq, struct rx_packet, entry)->header.seq == seq) {
3856 if (rx_stats_active)
3857 rx_atomic_inc(&rx_stats.dupPacketsRead);
3858 dpf(("packet %"AFS_PTR_FMT" dropped on receipt - duplicate\n", np));
3859 rxi_CancelDelayedAckEvent(call);
3860 np = rxi_SendAck(call, np, serial, RX_ACK_DUPLICATE, istack);
3866 /* It's the next packet. Stick it on the receive queue
3867 * for this call. Set newPackets to make sure we wake
3868 * the reader once all packets have been processed */
3869 #ifdef RX_TRACK_PACKETS
3870 np->flags |= RX_PKTFLAG_RQ;
3872 opr_queue_Prepend(&call->rq, &np->entry);
3873 #ifdef RXDEBUG_PACKET
3875 #endif /* RXDEBUG_PACKET */
3877 np = NULL; /* We can't use this anymore */
3880 /* If an ack is requested then set a flag to make sure we
3881 * send an acknowledgement for this packet */
3882 if (flags & RX_REQUEST_ACK) {
3883 ackNeeded = RX_ACK_REQUESTED;
3886 /* Keep track of whether we have received the last packet */
3887 if (flags & RX_LAST_PACKET) {
3888 call->flags |= RX_CALL_HAVE_LAST;
3892 /* Check whether we have all of the packets for this call */
3893 if (call->flags & RX_CALL_HAVE_LAST) {
3894 afs_uint32 tseq; /* temporary sequence number */
3895 struct opr_queue *cursor;
3897 for (tseq = seq, opr_queue_Scan(&call->rq, cursor)) {
3898 struct rx_packet *tp;
3900 tp = opr_queue_Entry(cursor, struct rx_packet, entry);
3901 if (tseq != tp->header.seq)
3903 if (tp->header.flags & RX_LAST_PACKET) {
3904 call->flags |= RX_CALL_RECEIVE_DONE;
3911 /* Provide asynchronous notification for those who want it
3912 * (e.g. multi rx) */
3913 if (call->arrivalProc) {
3914 (*call->arrivalProc) (call, call->arrivalProcHandle,
3915 call->arrivalProcArg);
3916 call->arrivalProc = (void (*)())0;
3919 /* Update last packet received */
3922 /* If there is no server process serving this call, grab
3923 * one, if available. We only need to do this once. If a
3924 * server thread is available, this thread becomes a server
3925 * thread and the server thread becomes a listener thread. */
3927 TryAttach(call, socket, tnop, newcallp, 0);
3930 /* This is not the expected next packet. */
3932 /* Determine whether this is a new or old packet, and if it's
3933 * a new one, whether it fits into the current receive window.
3934 * Also figure out whether the packet was delivered in sequence.
3935 * We use the prev variable to determine whether the new packet
3936 * is the successor of its immediate predecessor in the
3937 * receive queue, and the missing flag to determine whether
3938 * any of this packets predecessors are missing. */
3940 afs_uint32 prev; /* "Previous packet" sequence number */
3941 struct opr_queue *cursor;
3942 int missing; /* Are any predecessors missing? */
3944 /* If the new packet's sequence number has been sent to the
3945 * application already, then this is a duplicate */
3946 if (seq < call->rnext) {
3947 if (rx_stats_active)
3948 rx_atomic_inc(&rx_stats.dupPacketsRead);
3949 rxi_CancelDelayedAckEvent(call);
3950 np = rxi_SendAck(call, np, serial, RX_ACK_DUPLICATE, istack);
3956 /* If the sequence number is greater than what can be
3957 * accomodated by the current window, then send a negative
3958 * acknowledge and drop the packet */
3959 if ((call->rnext + call->rwind) <= seq) {
3960 rxi_CancelDelayedAckEvent(call);
3961 np = rxi_SendAck(call, np, serial, RX_ACK_EXCEEDS_WINDOW,
3968 /* Look for the packet in the queue of old received packets */
3969 prev = call->rnext - 1;
3971 for (opr_queue_Scan(&call->rq, cursor)) {
3972 struct rx_packet *tp
3973 = opr_queue_Entry(cursor, struct rx_packet, entry);
3975 /*Check for duplicate packet */
3976 if (seq == tp->header.seq) {
3977 if (rx_stats_active)
3978 rx_atomic_inc(&rx_stats.dupPacketsRead);
3979 rxi_CancelDelayedAckEvent(call);
3980 np = rxi_SendAck(call, np, serial, RX_ACK_DUPLICATE,
3986 /* If we find a higher sequence packet, break out and
3987 * insert the new packet here. */
3988 if (seq < tp->header.seq)
3990 /* Check for missing packet */
3991 if (tp->header.seq != prev + 1) {
3995 prev = tp->header.seq;
3998 /* Keep track of whether we have received the last packet. */
3999 if (flags & RX_LAST_PACKET) {
4000 call->flags |= RX_CALL_HAVE_LAST;
4003 /* It's within the window: add it to the the receive queue.
4004 * tp is left by the previous loop either pointing at the
4005 * packet before which to insert the new packet, or at the
4006 * queue head if the queue is empty or the packet should be
4008 #ifdef RX_TRACK_PACKETS
4009 np->flags |= RX_PKTFLAG_RQ;
4011 #ifdef RXDEBUG_PACKET
4013 #endif /* RXDEBUG_PACKET */
4014 opr_queue_InsertBefore(cursor, &np->entry);
4018 /* Check whether we have all of the packets for this call */
4019 if ((call->flags & RX_CALL_HAVE_LAST)
4020 && !(call->flags & RX_CALL_RECEIVE_DONE)) {
4021 afs_uint32 tseq; /* temporary sequence number */
4024 for (opr_queue_Scan(&call->rq, cursor)) {
4025 struct rx_packet *tp
4026 = opr_queue_Entry(cursor, struct rx_packet, entry);
4027 if (tseq != tp->header.seq)
4029 if (tp->header.flags & RX_LAST_PACKET) {
4030 call->flags |= RX_CALL_RECEIVE_DONE;
4037 /* We need to send an ack of the packet is out of sequence,
4038 * or if an ack was requested by the peer. */
4039 if (seq != prev + 1 || missing) {
4040 ackNeeded = RX_ACK_OUT_OF_SEQUENCE;
4041 } else if (flags & RX_REQUEST_ACK) {
4042 ackNeeded = RX_ACK_REQUESTED;
4045 /* Acknowledge the last packet for each call */
4046 if (flags & RX_LAST_PACKET) {
4057 * If the receiver is waiting for an iovec, fill the iovec
4058 * using the data from the receive queue */
4059 if (call->flags & RX_CALL_IOVEC_WAIT) {
4060 didHardAck = rxi_FillReadVec(call, serial);
4061 /* the call may have been aborted */
4070 /* Wakeup the reader if any */
4071 if ((call->flags & RX_CALL_READER_WAIT)
4072 && (!(call->flags & RX_CALL_IOVEC_WAIT) || !(call->iovNBytes)
4073 || (call->iovNext >= call->iovMax)
4074 || (call->flags & RX_CALL_RECEIVE_DONE))) {
4075 call->flags &= ~RX_CALL_READER_WAIT;
4076 #ifdef RX_ENABLE_LOCKS
4077 CV_BROADCAST(&call->cv_rq);
4079 osi_rxWakeup(&call->rq);
4085 * Send an ack when requested by the peer, or once every
4086 * rxi_SoftAckRate packets until the last packet has been
4087 * received. Always send a soft ack for the last packet in
4088 * the server's reply. */
4090 rxi_CancelDelayedAckEvent(call);
4091 np = rxi_SendAck(call, np, serial, ackNeeded, istack);
4092 } else if (call->nSoftAcks > (u_short) rxi_SoftAckRate) {
4093 rxi_CancelDelayedAckEvent(call);
4094 np = rxi_SendAck(call, np, serial, RX_ACK_IDLE, istack);
4095 } else if (call->nSoftAcks) {
4096 if (haveLast && !(flags & RX_CLIENT_INITIATED))
4097 rxi_PostDelayedAckEvent(call, &rx_lastAckDelay);
4099 rxi_PostDelayedAckEvent(call, &rx_softAckDelay);
4100 } else if (call->flags & RX_CALL_RECEIVE_DONE) {
4101 rxi_CancelDelayedAckEvent(call);
4108 rxi_UpdatePeerReach(struct rx_connection *conn, struct rx_call *acall)
4110 struct rx_peer *peer = conn->peer;
4112 MUTEX_ENTER(&peer->peer_lock);
4113 peer->lastReachTime = clock_Sec();
4114 MUTEX_EXIT(&peer->peer_lock);
4116 MUTEX_ENTER(&conn->conn_data_lock);
4117 if (conn->flags & RX_CONN_ATTACHWAIT) {
4120 rxi_ConnClearAttachWait(conn);
4121 MUTEX_EXIT(&conn->conn_data_lock);
4123 for (i = 0; i < RX_MAXCALLS; i++) {
4124 struct rx_call *call = conn->call[i];
4127 MUTEX_ENTER(&call->lock);
4128 /* tnop can be null if newcallp is null */
4129 TryAttach(call, (osi_socket) - 1, NULL, NULL, 1);
4131 MUTEX_EXIT(&call->lock);
4135 MUTEX_EXIT(&conn->conn_data_lock);
4138 #if defined(RXDEBUG) && defined(AFS_NT40_ENV)
4140 rx_ack_reason(int reason)
4143 case RX_ACK_REQUESTED:
4145 case RX_ACK_DUPLICATE:
4147 case RX_ACK_OUT_OF_SEQUENCE:
4149 case RX_ACK_EXCEEDS_WINDOW:
4151 case RX_ACK_NOSPACE:
4155 case RX_ACK_PING_RESPONSE:
4168 /* The real smarts of the whole thing. */
4169 static struct rx_packet *
4170 rxi_ReceiveAckPacket(struct rx_call *call, struct rx_packet *np,
4173 struct rx_ackPacket *ap;
4175 struct rx_packet *tp;
4176 struct rx_connection *conn = call->conn;
4177 struct rx_peer *peer = conn->peer;
4178 struct opr_queue *cursor;
4179 struct clock now; /* Current time, for RTT calculations */
4187 int newAckCount = 0;
4188 int maxDgramPackets = 0; /* Set if peer supports AFS 3.5 jumbo datagrams */
4189 int pktsize = 0; /* Set if we need to update the peer mtu */
4190 int conn_data_locked = 0;
4192 if (rx_stats_active)
4193 rx_atomic_inc(&rx_stats.ackPacketsRead);
4194 ap = (struct rx_ackPacket *)rx_DataOf(np);
4195 nbytes = rx_Contiguous(np) - (int)((ap->acks) - (u_char *) ap);
4197 return np; /* truncated ack packet */
4199 /* depends on ack packet struct */
4200 nAcks = MIN((unsigned)nbytes, (unsigned)ap->nAcks);
4201 first = ntohl(ap->firstPacket);
4202 prev = ntohl(ap->previousPacket);
4203 serial = ntohl(ap->serial);
4206 * Ignore ack packets received out of order while protecting
4207 * against peers that set the previousPacket field to a packet
4208 * serial number instead of a sequence number.
4210 if (first < call->tfirst ||
4211 (first == call->tfirst && prev < call->tprev && prev < call->tfirst
4218 if (np->header.flags & RX_SLOW_START_OK) {
4219 call->flags |= RX_CALL_SLOW_START_OK;
4222 if (ap->reason == RX_ACK_PING_RESPONSE)
4223 rxi_UpdatePeerReach(conn, call);
4225 if (conn->lastPacketSizeSeq) {
4226 MUTEX_ENTER(&conn->conn_data_lock);
4227 conn_data_locked = 1;
4228 if ((first > conn->lastPacketSizeSeq) && (conn->lastPacketSize)) {
4229 pktsize = conn->lastPacketSize;
4230 conn->lastPacketSize = conn->lastPacketSizeSeq = 0;
4233 if ((ap->reason == RX_ACK_PING_RESPONSE) && (conn->lastPingSizeSer)) {
4234 if (!conn_data_locked) {
4235 MUTEX_ENTER(&conn->conn_data_lock);
4236 conn_data_locked = 1;
4238 if ((conn->lastPingSizeSer == serial) && (conn->lastPingSize)) {
4239 /* process mtu ping ack */
4240 pktsize = conn->lastPingSize;
4241 conn->lastPingSizeSer = conn->lastPingSize = 0;
4245 if (conn_data_locked) {
4246 MUTEX_EXIT(&conn->conn_data_lock);
4247 conn_data_locked = 0;
4251 if (rxdebug_active) {
4255 len = _snprintf(msg, sizeof(msg),
4256 "tid[%d] RACK: reason %s serial %u previous %u seq %u first %u acks %u space %u ",
4257 GetCurrentThreadId(), rx_ack_reason(ap->reason),
4258 ntohl(ap->serial), ntohl(ap->previousPacket),
4259 (unsigned int)np->header.seq, ntohl(ap->firstPacket),
4260 ap->nAcks, ntohs(ap->bufferSpace) );
4264 for (offset = 0; offset < nAcks && len < sizeof(msg); offset++)
4265 msg[len++] = (ap->acks[offset] == RX_ACK_TYPE_NACK ? '-' : '*');
4269 OutputDebugString(msg);
4271 #else /* AFS_NT40_ENV */
4274 "RACK: reason %x previous %u seq %u serial %u first %u",
4275 ap->reason, ntohl(ap->previousPacket),
4276 (unsigned int)np->header.seq, (unsigned int)serial,
4277 ntohl(ap->firstPacket));
4280 for (offset = 0; offset < nAcks; offset++)
4281 putc(ap->acks[offset] == RX_ACK_TYPE_NACK ? '-' : '*',
4286 #endif /* AFS_NT40_ENV */
4289 MUTEX_ENTER(&peer->peer_lock);
4292 * Start somewhere. Can't assume we can send what we can receive,
4293 * but we are clearly receiving.
4295 if (!peer->maxPacketSize)
4296 peer->maxPacketSize = RX_MIN_PACKET_SIZE - RX_HEADER_SIZE;
4298 if (pktsize > peer->maxPacketSize) {
4299 peer->maxPacketSize = pktsize;
4300 if ((pktsize + RX_HEADER_SIZE > peer->ifMTU)) {
4301 peer->ifMTU = pktsize + RX_HEADER_SIZE;
4302 peer->natMTU = rxi_AdjustIfMTU(peer->ifMTU);
4303 rxi_ScheduleGrowMTUEvent(call, 1);
4308 clock_GetTime(&now);
4310 /* The transmit queue splits into 4 sections.
4312 * The first section is packets which have now been acknowledged
4313 * by a window size change in the ack. These have reached the
4314 * application layer, and may be discarded. These are packets
4315 * with sequence numbers < ap->firstPacket.
4317 * The second section is packets which have sequence numbers in
4318 * the range ap->firstPacket to ap->firstPacket + ap->nAcks. The
4319 * contents of the packet's ack array determines whether these
4320 * packets are acknowledged or not.
4322 * The third section is packets which fall above the range
4323 * addressed in the ack packet. These have not yet been received
4326 * The four section is packets which have not yet been transmitted.
4327 * These packets will have a header.serial of 0.
4330 /* First section - implicitly acknowledged packets that can be
4334 tp = opr_queue_First(&call->tq, struct rx_packet, entry);
4335 while(!opr_queue_IsEnd(&call->tq, &tp->entry) && tp->header.seq < first) {
4336 struct rx_packet *next;
4338 next = opr_queue_Next(&tp->entry, struct rx_packet, entry);
4339 call->tfirst = tp->header.seq + 1;
4341 if (!(tp->flags & RX_PKTFLAG_ACKED)) {
4343 rxi_ComputeRoundTripTime(tp, ap, call, peer, &now);
4346 #ifdef RX_ENABLE_LOCKS
4347 /* XXX Hack. Because we have to release the global call lock when sending
4348 * packets (osi_NetSend) we drop all acks while we're traversing the tq
4349 * in rxi_Start sending packets out because packets may move to the
4350 * freePacketQueue as result of being here! So we drop these packets until
4351 * we're safely out of the traversing. Really ugly!
4352 * To make it even uglier, if we're using fine grain locking, we can
4353 * set the ack bits in the packets and have rxi_Start remove the packets
4354 * when it's done transmitting.
4356 if (call->flags & RX_CALL_TQ_BUSY) {
4357 tp->flags |= RX_PKTFLAG_ACKED;
4358 call->flags |= RX_CALL_TQ_SOME_ACKED;
4360 #endif /* RX_ENABLE_LOCKS */
4362 opr_queue_Remove(&tp->entry);
4363 #ifdef RX_TRACK_PACKETS
4364 tp->flags &= ~RX_PKTFLAG_TQ;
4366 #ifdef RXDEBUG_PACKET
4368 #endif /* RXDEBUG_PACKET */
4369 rxi_FreePacket(tp); /* rxi_FreePacket mustn't wake up anyone, preemptively. */
4374 /* N.B. we don't turn off any timers here. They'll go away by themselves, anyway */
4376 /* Second section of the queue - packets for which we are receiving
4379 * Go through the explicit acks/nacks and record the results in
4380 * the waiting packets. These are packets that can't be released
4381 * yet, even with a positive acknowledge. This positive
4382 * acknowledge only means the packet has been received by the
4383 * peer, not that it will be retained long enough to be sent to
4384 * the peer's upper level. In addition, reset the transmit timers
4385 * of any missing packets (those packets that must be missing
4386 * because this packet was out of sequence) */
4388 call->nSoftAcked = 0;
4390 while (!opr_queue_IsEnd(&call->tq, &tp->entry)
4391 && tp->header.seq < first + nAcks) {
4392 /* Set the acknowledge flag per packet based on the
4393 * information in the ack packet. An acknowlegded packet can
4394 * be downgraded when the server has discarded a packet it
4395 * soacked previously, or when an ack packet is received
4396 * out of sequence. */
4397 if (ap->acks[tp->header.seq - first] == RX_ACK_TYPE_ACK) {
4398 if (!(tp->flags & RX_PKTFLAG_ACKED)) {
4400 tp->flags |= RX_PKTFLAG_ACKED;
4401 rxi_ComputeRoundTripTime(tp, ap, call, peer, &now);
4408 } else /* RX_ACK_TYPE_NACK */ {
4409 tp->flags &= ~RX_PKTFLAG_ACKED;
4413 tp = opr_queue_Next(&tp->entry, struct rx_packet, entry);
4416 /* We don't need to take any action with the 3rd or 4th section in the
4417 * queue - they're not addressed by the contents of this ACK packet.
4420 /* if the ack packet has a receivelen field hanging off it,
4421 * update our state */
4422 if (np->length >= rx_AckDataSize(ap->nAcks) + 2 * sizeof(afs_int32)) {
4425 /* If the ack packet has a "recommended" size that is less than
4426 * what I am using now, reduce my size to match */
4427 rx_packetread(np, rx_AckDataSize(ap->nAcks) + (int)sizeof(afs_int32),
4428 (int)sizeof(afs_int32), &tSize);
4429 tSize = (afs_uint32) ntohl(tSize);
4430 peer->natMTU = rxi_AdjustIfMTU(MIN(tSize, peer->ifMTU));
4432 /* Get the maximum packet size to send to this peer */
4433 rx_packetread(np, rx_AckDataSize(ap->nAcks), (int)sizeof(afs_int32),
4435 tSize = (afs_uint32) ntohl(tSize);
4436 tSize = (afs_uint32) MIN(tSize, rx_MyMaxSendSize);
4437 tSize = rxi_AdjustMaxMTU(peer->natMTU, tSize);
4439 /* sanity check - peer might have restarted with different params.
4440 * If peer says "send less", dammit, send less... Peer should never
4441 * be unable to accept packets of the size that prior AFS versions would
4442 * send without asking. */
4443 if (peer->maxMTU != tSize) {
4444 if (peer->maxMTU > tSize) /* possible cong., maxMTU decreased */
4446 peer->maxMTU = tSize;
4447 peer->MTU = MIN(tSize, peer->MTU);
4448 call->MTU = MIN(call->MTU, tSize);
4451 if (np->length == rx_AckDataSize(ap->nAcks) + 3 * sizeof(afs_int32)) {
4454 rx_AckDataSize(ap->nAcks) + 2 * (int)sizeof(afs_int32),
4455 (int)sizeof(afs_int32), &tSize);
4456 tSize = (afs_uint32) ntohl(tSize); /* peer's receive window, if it's */
4457 if (tSize < call->twind) { /* smaller than our send */
4458 call->twind = tSize; /* window, we must send less... */
4459 call->ssthresh = MIN(call->twind, call->ssthresh);
4460 call->conn->twind[call->channel] = call->twind;
4463 /* Only send jumbograms to 3.4a fileservers. 3.3a RX gets the
4464 * network MTU confused with the loopback MTU. Calculate the
4465 * maximum MTU here for use in the slow start code below.
4467 /* Did peer restart with older RX version? */
4468 if (peer->maxDgramPackets > 1) {
4469 peer->maxDgramPackets = 1;
4471 } else if (np->length >=
4472 rx_AckDataSize(ap->nAcks) + 4 * sizeof(afs_int32)) {
4475 rx_AckDataSize(ap->nAcks) + 2 * (int)sizeof(afs_int32),
4476 sizeof(afs_int32), &tSize);
4477 tSize = (afs_uint32) ntohl(tSize);
4479 * As of AFS 3.5 we set the send window to match the receive window.
4481 if (tSize < call->twind) {
4482 call->twind = tSize;
4483 call->conn->twind[call->channel] = call->twind;
4484 call->ssthresh = MIN(call->twind, call->ssthresh);
4485 } else if (tSize > call->twind) {
4486 call->twind = tSize;
4487 call->conn->twind[call->channel] = call->twind;
4491 * As of AFS 3.5, a jumbogram is more than one fixed size
4492 * packet transmitted in a single UDP datagram. If the remote
4493 * MTU is smaller than our local MTU then never send a datagram
4494 * larger than the natural MTU.
4497 rx_AckDataSize(ap->nAcks) + 3 * (int)sizeof(afs_int32),
4498 (int)sizeof(afs_int32), &tSize);
4499 maxDgramPackets = (afs_uint32) ntohl(tSize);
4500 maxDgramPackets = MIN(maxDgramPackets, rxi_nDgramPackets);
4502 MIN(maxDgramPackets, (int)(peer->ifDgramPackets));
4503 if (maxDgramPackets > 1) {
4504 peer->maxDgramPackets = maxDgramPackets;
4505 call->MTU = RX_JUMBOBUFFERSIZE + RX_HEADER_SIZE;
4507 peer->maxDgramPackets = 1;
4508 call->MTU = peer->natMTU;
4510 } else if (peer->maxDgramPackets > 1) {
4511 /* Restarted with lower version of RX */
4512 peer->maxDgramPackets = 1;
4514 } else if (peer->maxDgramPackets > 1
4515 || peer->maxMTU != OLD_MAX_PACKET_SIZE) {
4516 /* Restarted with lower version of RX */
4517 peer->maxMTU = OLD_MAX_PACKET_SIZE;
4518 peer->natMTU = OLD_MAX_PACKET_SIZE;
4519 peer->MTU = OLD_MAX_PACKET_SIZE;
4520 peer->maxDgramPackets = 1;
4521 peer->nDgramPackets = 1;
4523 call->MTU = OLD_MAX_PACKET_SIZE;
4526 /* If the window has been extended by this acknowledge packet,
4527 * then wakeup a sender waiting in alloc for window space, or try
4528 * sending packets now, if he's been sitting on packets due to
4529 * lack of window space */
4530 if (call->tnext < (call->tfirst + call->twind)) {
4531 #ifdef RX_ENABLE_LOCKS
4532 CV_SIGNAL(&call->cv_twind);
4534 if (call->flags & RX_CALL_WAIT_WINDOW_ALLOC) {
4535 call->flags &= ~RX_CALL_WAIT_WINDOW_ALLOC;
4536 osi_rxWakeup(&call->twind);
4539 if (call->flags & RX_CALL_WAIT_WINDOW_SEND) {
4540 call->flags &= ~RX_CALL_WAIT_WINDOW_SEND;
4546 * Calculate how many datagrams were successfully received after
4547 * the first missing packet and adjust the negative ack counter
4552 nNacked = (nNacked + call->nDgramPackets - 1) / call->nDgramPackets;
4553 if (call->nNacks < nNacked) {
4554 call->nNacks = nNacked;
4557 call->nAcks += newAckCount;
4561 /* If the packet contained new acknowledgements, rather than just
4562 * being a duplicate of one we have previously seen, then we can restart
4565 if (newAckCount > 0)
4566 rxi_rto_packet_acked(call, istack);
4568 if (call->flags & RX_CALL_FAST_RECOVER) {
4569 if (newAckCount == 0) {
4570 call->cwind = MIN((int)(call->cwind + 1), rx_maxSendWindow);
4572 call->flags &= ~RX_CALL_FAST_RECOVER;
4573 call->cwind = call->nextCwind;
4574 call->nextCwind = 0;
4577 call->nCwindAcks = 0;
4578 } else if (nNacked && call->nNacks >= (u_short) rx_nackThreshold) {
4579 /* Three negative acks in a row trigger congestion recovery */
4580 call->flags |= RX_CALL_FAST_RECOVER;
4581 call->ssthresh = MAX(4, MIN((int)call->cwind, (int)call->twind)) >> 1;
4583 MIN((int)(call->ssthresh + rx_nackThreshold), rx_maxSendWindow);
4584 call->nDgramPackets = MAX(2, (int)call->nDgramPackets) >> 1;
4585 call->nextCwind = call->ssthresh;
4588 peer->MTU = call->MTU;
4589 peer->cwind = call->nextCwind;
4590 peer->nDgramPackets = call->nDgramPackets;
4592 call->congestSeq = peer->congestSeq;
4594 /* Reset the resend times on the packets that were nacked
4595 * so we will retransmit as soon as the window permits
4599 for (opr_queue_ScanBackwards(&call->tq, cursor)) {
4600 struct rx_packet *tp =
4601 opr_queue_Entry(cursor, struct rx_packet, entry);
4603 if (!(tp->flags & RX_PKTFLAG_ACKED)) {
4604 tp->flags &= ~RX_PKTFLAG_SENT;
4606 } else if (tp->flags & RX_PKTFLAG_ACKED) {
4611 /* If cwind is smaller than ssthresh, then increase
4612 * the window one packet for each ack we receive (exponential
4614 * If cwind is greater than or equal to ssthresh then increase
4615 * the congestion window by one packet for each cwind acks we
4616 * receive (linear growth). */
4617 if (call->cwind < call->ssthresh) {
4619 MIN((int)call->ssthresh, (int)(call->cwind + newAckCount));
4620 call->nCwindAcks = 0;
4622 call->nCwindAcks += newAckCount;
4623 if (call->nCwindAcks >= call->cwind) {
4624 call->nCwindAcks = 0;
4625 call->cwind = MIN((int)(call->cwind + 1), rx_maxSendWindow);
4629 * If we have received several acknowledgements in a row then
4630 * it is time to increase the size of our datagrams
4632 if ((int)call->nAcks > rx_nDgramThreshold) {
4633 if (peer->maxDgramPackets > 1) {
4634 if (call->nDgramPackets < peer->maxDgramPackets) {
4635 call->nDgramPackets++;
4637 call->MTU = RX_HEADER_SIZE + RX_JUMBOBUFFERSIZE;
4638 } else if (call->MTU < peer->maxMTU) {
4639 /* don't upgrade if we can't handle it */
4640 if ((call->nDgramPackets == 1) && (call->MTU >= peer->ifMTU))
4641 call->MTU = peer->ifMTU;
4643 call->MTU += peer->natMTU;
4644 call->MTU = MIN(call->MTU, peer->maxMTU);
4651 MUTEX_EXIT(&peer->peer_lock); /* rxi_Start will lock peer. */
4653 /* Servers need to hold the call until all response packets have
4654 * been acknowledged. Soft acks are good enough since clients
4655 * are not allowed to clear their receive queues. */
4656 if (call->state == RX_STATE_HOLD
4657 && call->tfirst + call->nSoftAcked >= call->tnext) {
4658 call->state = RX_STATE_DALLY;
4659 rxi_ClearTransmitQueue(call, 0);
4660 rxi_CancelKeepAliveEvent(call);
4661 } else if (!opr_queue_IsEmpty(&call->tq)) {
4662 rxi_Start(call, istack);
4668 * Schedule a connection abort to be sent after some delay.
4670 * @param[in] conn The connection to send the abort on.
4671 * @param[in] msec The number of milliseconds to wait before sending.
4673 * @pre conn_data_lock must be held
4676 rxi_SendConnectionAbortLater(struct rx_connection *conn, int msec)
4678 struct clock when, now;
4680 MUTEX_ASSERT(&conn->conn_data_lock);
4684 if (!conn->delayedAbortEvent) {
4685 clock_GetTime(&now);
4687 clock_Addmsec(&when, msec);
4688 rx_GetConnection(conn);
4689 conn->delayedAbortEvent =
4690 rxevent_Post(&when, &now, rxi_SendDelayedConnAbort, conn, NULL, 0);
4694 /* Received a response to a challenge packet */
4695 static struct rx_packet *
4696 rxi_ReceiveResponsePacket(struct rx_connection *conn,
4697 struct rx_packet *np, int istack)
4701 /* Ignore the packet if we're the client */
4702 if (conn->type == RX_CLIENT_CONNECTION)
4705 /* If already authenticated, ignore the packet (it's probably a retry) */
4706 if (RXS_CheckAuthentication(conn->securityObject, conn) == 0)
4709 if (!conn->securityChallengeSent) {
4710 /* We've never sent out a challenge for this connection, so this
4711 * response cannot possibly be correct; ignore it. This can happen
4712 * if we sent a challenge to the client, then we were restarted, and
4713 * then the client sent us a response. If we ignore the response, the
4714 * client will eventually resend a data packet, causing us to send a
4715 * new challenge and the client to send a new response. */
4719 /* Otherwise, have the security object evaluate the response packet */
4720 error = RXS_CheckResponse(conn->securityObject, conn, np);
4722 /* If the response is invalid, reset the connection, sending
4723 * an abort to the peer. Send the abort with a 1 second delay,
4724 * to avoid a peer hammering us by constantly recreating a
4725 * connection with bad credentials. */
4726 rxi_ConnectionError(conn, error);
4727 MUTEX_ENTER(&conn->conn_data_lock);
4728 rxi_SendConnectionAbortLater(conn, 1000);
4729 MUTEX_EXIT(&conn->conn_data_lock);
4732 /* If the response is valid, any calls waiting to attach
4733 * servers can now do so */
4736 for (i = 0; i < RX_MAXCALLS; i++) {
4737 struct rx_call *call = conn->call[i];
4739 MUTEX_ENTER(&call->lock);
4740 if (call->state == RX_STATE_PRECALL)
4741 rxi_AttachServerProc(call, (osi_socket) - 1, NULL, NULL);
4742 /* tnop can be null if newcallp is null */
4743 MUTEX_EXIT(&call->lock);
4747 /* Update the peer reachability information, just in case
4748 * some calls went into attach-wait while we were waiting
4749 * for authentication..
4751 rxi_UpdatePeerReach(conn, NULL);
4756 /* A client has received an authentication challenge: the security
4757 * object is asked to cough up a respectable response packet to send
4758 * back to the server. The server is responsible for retrying the
4759 * challenge if it fails to get a response. */
4761 static struct rx_packet *
4762 rxi_ReceiveChallengePacket(struct rx_connection *conn,
4763 struct rx_packet *np, int istack)
4767 /* Ignore the challenge if we're the server */
4768 if (conn->type == RX_SERVER_CONNECTION)
4771 /* Ignore the challenge if the connection is otherwise idle; someone's
4772 * trying to use us as an oracle. */
4773 if (!rxi_HasActiveCalls(conn))
4776 /* Send the security object the challenge packet. It is expected to fill
4777 * in the response. */
4778 error = RXS_GetResponse(conn->securityObject, conn, np);
4780 /* If the security object is unable to return a valid response, reset the
4781 * connection and send an abort to the peer. Otherwise send the response
4782 * packet to the peer connection. */
4784 rxi_ConnectionError(conn, error);
4785 MUTEX_ENTER(&conn->conn_data_lock);
4786 np = rxi_SendConnectionAbort(conn, np, istack, 0);
4787 MUTEX_EXIT(&conn->conn_data_lock);
4789 np = rxi_SendSpecial((struct rx_call *)0, conn, np,
4790 RX_PACKET_TYPE_RESPONSE, NULL, -1, istack);
4796 /* Find an available server process to service the current request in
4797 * the given call structure. If one isn't available, queue up this
4798 * call so it eventually gets one */
4800 rxi_AttachServerProc(struct rx_call *call,
4801 osi_socket socket, int *tnop,
4802 struct rx_call **newcallp)
4804 struct rx_serverQueueEntry *sq;
4805 struct rx_service *service = call->conn->service;
4808 /* May already be attached */
4809 if (call->state == RX_STATE_ACTIVE)
4812 MUTEX_ENTER(&rx_serverPool_lock);
4814 haveQuota = QuotaOK(service);
4815 if ((!haveQuota) || opr_queue_IsEmpty(&rx_idleServerQueue)) {
4816 /* If there are no processes available to service this call,
4817 * put the call on the incoming call queue (unless it's
4818 * already on the queue).
4820 #ifdef RX_ENABLE_LOCKS
4822 ReturnToServerPool(service);
4823 #endif /* RX_ENABLE_LOCKS */
4825 if (!(call->flags & RX_CALL_WAIT_PROC)) {
4826 call->flags |= RX_CALL_WAIT_PROC;
4827 rx_atomic_inc(&rx_nWaiting);
4828 rx_atomic_inc(&rx_nWaited);
4829 rxi_calltrace(RX_CALL_ARRIVAL, call);
4830 SET_CALL_QUEUE_LOCK(call, &rx_serverPool_lock);
4831 opr_queue_Append(&rx_incomingCallQueue, &call->entry);
4834 sq = opr_queue_Last(&rx_idleServerQueue,
4835 struct rx_serverQueueEntry, entry);
4837 /* If hot threads are enabled, and both newcallp and sq->socketp
4838 * are non-null, then this thread will process the call, and the
4839 * idle server thread will start listening on this threads socket.
4841 opr_queue_Remove(&sq->entry);
4843 if (rx_enable_hot_thread && newcallp && sq->socketp) {
4846 *sq->socketp = socket;
4847 clock_GetTime(&call->startTime);
4848 CALL_HOLD(call, RX_CALL_REFCOUNT_BEGIN);
4852 if (call->flags & RX_CALL_WAIT_PROC) {
4853 /* Conservative: I don't think this should happen */
4854 call->flags &= ~RX_CALL_WAIT_PROC;
4855 rx_atomic_dec(&rx_nWaiting);
4856 if (opr_queue_IsOnQueue(&call->entry)) {
4857 opr_queue_Remove(&call->entry);
4860 call->state = RX_STATE_ACTIVE;
4861 call->app.mode = RX_MODE_RECEIVING;
4862 #ifdef RX_KERNEL_TRACE
4864 int glockOwner = ISAFS_GLOCK();
4867 afs_Trace3(afs_iclSetp, CM_TRACE_WASHERE, ICL_TYPE_STRING,
4868 __FILE__, ICL_TYPE_INT32, __LINE__, ICL_TYPE_POINTER,
4874 if (call->flags & RX_CALL_CLEARED) {
4875 /* send an ack now to start the packet flow up again */
4876 call->flags &= ~RX_CALL_CLEARED;
4877 rxi_SendAck(call, 0, 0, RX_ACK_DELAY, 0);
4879 #ifdef RX_ENABLE_LOCKS
4882 service->nRequestsRunning++;
4883 MUTEX_ENTER(&rx_quota_mutex);
4884 if (service->nRequestsRunning <= service->minProcs)
4887 MUTEX_EXIT(&rx_quota_mutex);
4891 MUTEX_EXIT(&rx_serverPool_lock);
4894 /* Delay the sending of an acknowledge event for a short while, while
4895 * a new call is being prepared (in the case of a client) or a reply
4896 * is being prepared (in the case of a server). Rather than sending
4897 * an ack packet, an ACKALL packet is sent. */
4899 rxi_AckAll(struct rx_call *call)
4901 rxi_SendSpecial(call, call->conn, NULL, RX_PACKET_TYPE_ACKALL,
4903 call->flags |= RX_CALL_ACKALL_SENT;
4907 * Event handler for per-call delayed acks.
4908 * Also called synchronously, with |event| == NULL, to send a "delayed" ack
4912 rxi_SendDelayedAck(struct rxevent *event, void *arg1, void *unused1,
4915 struct rx_call *call = arg1;
4916 #ifdef RX_ENABLE_LOCKS
4918 MUTEX_ENTER(&call->lock);
4919 if (event == call->delayedAckEvent)
4920 rxevent_Put(&call->delayedAckEvent);
4922 (void)rxi_SendAck(call, 0, 0, RX_ACK_DELAY, 0);
4924 MUTEX_EXIT(&call->lock);
4925 #else /* RX_ENABLE_LOCKS */
4927 rxevent_Put(&call->delayedAckEvent);
4928 (void)rxi_SendAck(call, 0, 0, RX_ACK_DELAY, 0);
4929 #endif /* RX_ENABLE_LOCKS */
4930 /* Release the call reference for the event that fired. */
4932 CALL_RELE(call, RX_CALL_REFCOUNT_DELAY);
4935 #ifdef RX_ENABLE_LOCKS
4936 /* Set ack in all packets in transmit queue. rxi_Start will deal with
4937 * clearing them out.
4940 rxi_SetAcksInTransmitQueue(struct rx_call *call)
4942 struct opr_queue *cursor;
4945 for (opr_queue_Scan(&call->tq, cursor)) {
4947 = opr_queue_Entry(cursor, struct rx_packet, entry);
4949 p->flags |= RX_PKTFLAG_ACKED;
4954 call->flags |= RX_CALL_TQ_CLEARME;
4955 call->flags |= RX_CALL_TQ_SOME_ACKED;
4958 rxi_rto_cancel(call);
4960 call->tfirst = call->tnext;
4961 call->nSoftAcked = 0;
4963 if (call->flags & RX_CALL_FAST_RECOVER) {
4964 call->flags &= ~RX_CALL_FAST_RECOVER;
4965 call->cwind = call->nextCwind;
4966 call->nextCwind = 0;
4969 CV_SIGNAL(&call->cv_twind);
4971 #endif /* RX_ENABLE_LOCKS */
4974 * Acknowledge the whole transmit queue.
4976 * If we're running without locks, or the transmit queue isn't busy, then
4977 * we can just clear the queue now. Otherwise, we have to mark all of the
4978 * packets as acknowledged, and let rxi_Start clear it later on
4981 rxi_AckAllInTransmitQueue(struct rx_call *call)
4983 #ifdef RX_ENABLE_LOCKS
4984 if (call->flags & RX_CALL_TQ_BUSY) {
4985 rxi_SetAcksInTransmitQueue(call);
4989 rxi_ClearTransmitQueue(call, 0);
4991 /* Clear out the transmit queue for the current call (all packets have
4992 * been received by peer) */
4994 rxi_ClearTransmitQueue(struct rx_call *call, int force)
4996 #ifdef RX_ENABLE_LOCKS
4997 struct opr_queue *cursor;
4998 if (!force && (call->flags & RX_CALL_TQ_BUSY)) {
5000 for (opr_queue_Scan(&call->tq, cursor)) {
5002 = opr_queue_Entry(cursor, struct rx_packet, entry);
5004 p->flags |= RX_PKTFLAG_ACKED;
5008 call->flags |= RX_CALL_TQ_CLEARME;
5009 call->flags |= RX_CALL_TQ_SOME_ACKED;
5012 #endif /* RX_ENABLE_LOCKS */
5013 #ifdef RXDEBUG_PACKET
5015 #endif /* RXDEBUG_PACKET */
5016 rxi_FreePackets(0, &call->tq);
5017 rxi_WakeUpTransmitQueue(call);
5018 #ifdef RX_ENABLE_LOCKS
5019 call->flags &= ~RX_CALL_TQ_CLEARME;
5023 rxi_rto_cancel(call);
5024 call->tfirst = call->tnext; /* implicitly acknowledge all data already sent */
5025 call->nSoftAcked = 0;
5027 if (call->flags & RX_CALL_FAST_RECOVER) {
5028 call->flags &= ~RX_CALL_FAST_RECOVER;
5029 call->cwind = call->nextCwind;
5031 #ifdef RX_ENABLE_LOCKS
5032 CV_SIGNAL(&call->cv_twind);
5034 osi_rxWakeup(&call->twind);
5039 rxi_ClearReceiveQueue(struct rx_call *call)
5041 if (!opr_queue_IsEmpty(&call->rq)) {
5044 count = rxi_FreePackets(0, &call->rq);
5045 rx_packetReclaims += count;
5046 #ifdef RXDEBUG_PACKET
5048 if ( call->rqc != 0 )
5049 dpf(("rxi_ClearReceiveQueue call %"AFS_PTR_FMT" rqc %u != 0\n", call, call->rqc));
5051 call->flags &= ~(RX_CALL_RECEIVE_DONE | RX_CALL_HAVE_LAST);
5053 if (call->state == RX_STATE_PRECALL) {
5054 call->flags |= RX_CALL_CLEARED;
5058 /* Send an abort packet for the specified call */
5059 static struct rx_packet *
5060 rxi_SendCallAbort(struct rx_call *call, struct rx_packet *packet,
5061 int istack, int force)
5064 struct clock when, now;
5069 /* Clients should never delay abort messages */
5070 if (rx_IsClientConn(call->conn))
5073 if (call->abortCode != call->error) {
5074 call->abortCode = call->error;
5075 call->abortCount = 0;
5078 if (force || rxi_callAbortThreshhold == 0
5079 || call->abortCount < rxi_callAbortThreshhold) {
5080 rxi_CancelDelayedAbortEvent(call);
5081 error = htonl(call->error);
5084 rxi_SendSpecial(call, call->conn, packet, RX_PACKET_TYPE_ABORT,
5085 (char *)&error, sizeof(error), istack);
5086 } else if (!call->delayedAbortEvent) {
5087 clock_GetTime(&now);
5089 clock_Addmsec(&when, rxi_callAbortDelay);
5090 CALL_HOLD(call, RX_CALL_REFCOUNT_ABORT);
5091 call->delayedAbortEvent =
5092 rxevent_Post(&when, &now, rxi_SendDelayedCallAbort, call, 0, 0);
5098 rxi_CancelDelayedAbortEvent(struct rx_call *call)
5100 MUTEX_ASSERT(&call->lock);
5101 if (rxevent_Cancel(&call->delayedAbortEvent))
5102 CALL_RELE(call, RX_CALL_REFCOUNT_ABORT);
5105 /* Send an abort packet for the specified connection. Packet is an
5106 * optional pointer to a packet that can be used to send the abort.
5107 * Once the number of abort messages reaches the threshhold, an
5108 * event is scheduled to send the abort. Setting the force flag
5109 * overrides sending delayed abort messages.
5111 * NOTE: Called with conn_data_lock held. conn_data_lock is dropped
5112 * to send the abort packet.
5115 rxi_SendConnectionAbort(struct rx_connection *conn,
5116 struct rx_packet *packet, int istack, int force)
5123 /* Clients should never delay abort messages */
5124 if (rx_IsClientConn(conn))
5127 if (force || rxi_connAbortThreshhold == 0
5128 || conn->abortCount < rxi_connAbortThreshhold) {
5130 if (rxevent_Cancel(&conn->delayedAbortEvent))
5131 putConnection(conn);
5132 error = htonl(conn->error);
5134 MUTEX_EXIT(&conn->conn_data_lock);
5136 rxi_SendSpecial((struct rx_call *)0, conn, packet,
5137 RX_PACKET_TYPE_ABORT, (char *)&error,
5138 sizeof(error), istack);
5139 MUTEX_ENTER(&conn->conn_data_lock);
5141 rxi_SendConnectionAbortLater(conn, rxi_connAbortDelay);
5146 /* Associate an error all of the calls owned by a connection. Called
5147 * with error non-zero. This is only for really fatal things, like
5148 * bad authentication responses. The connection itself is set in
5149 * error at this point, so that future packets received will be
5152 rxi_ConnectionError(struct rx_connection *conn,
5158 dpf(("rxi_ConnectionError conn %"AFS_PTR_FMT" error %d\n", conn, error));
5160 MUTEX_ENTER(&conn->conn_data_lock);
5161 if (rxevent_Cancel(&conn->challengeEvent))
5162 putConnection(conn);
5163 if (rxevent_Cancel(&conn->natKeepAliveEvent))
5164 putConnection(conn);
5165 if (rxevent_Cancel(&conn->checkReachEvent)) {
5166 conn->flags &= ~(RX_CONN_ATTACHWAIT|RX_CONN_NAT_PING);
5167 putConnection(conn);
5169 MUTEX_EXIT(&conn->conn_data_lock);
5170 for (i = 0; i < RX_MAXCALLS; i++) {
5171 struct rx_call *call = conn->call[i];
5173 MUTEX_ENTER(&call->lock);
5174 rxi_CallError(call, error);
5175 MUTEX_EXIT(&call->lock);
5178 conn->error = error;
5179 if (rx_stats_active)
5180 rx_atomic_inc(&rx_stats.fatalErrors);
5185 * Interrupt an in-progress call with the specified error and wakeup waiters.
5187 * @param[in] call The call to interrupt
5188 * @param[in] error The error code to send to the peer
5191 rx_InterruptCall(struct rx_call *call, afs_int32 error)
5193 MUTEX_ENTER(&call->lock);
5194 rxi_CallError(call, error);
5195 rxi_SendCallAbort(call, NULL, 0, 1);
5196 MUTEX_EXIT(&call->lock);
5200 rxi_CallError(struct rx_call *call, afs_int32 error)
5202 MUTEX_ASSERT(&call->lock);
5203 dpf(("rxi_CallError call %"AFS_PTR_FMT" error %d call->error %d\n", call, error, call->error));
5205 error = call->error;
5207 #ifdef RX_ENABLE_LOCKS
5208 if (!((call->flags & RX_CALL_TQ_BUSY) || (call->tqWaiters > 0))) {
5209 rxi_ResetCall(call, 0);
5212 rxi_ResetCall(call, 0);
5214 call->error = error;
5217 /* Reset various fields in a call structure, and wakeup waiting
5218 * processes. Some fields aren't changed: state & mode are not
5219 * touched (these must be set by the caller), and bufptr, nLeft, and
5220 * nFree are not reset, since these fields are manipulated by
5221 * unprotected macros, and may only be reset by non-interrupting code.
5225 rxi_ResetCall(struct rx_call *call, int newcall)
5228 struct rx_peer *peer;
5229 struct rx_packet *packet;
5231 MUTEX_ASSERT(&call->lock);
5232 dpf(("rxi_ResetCall(call %"AFS_PTR_FMT", newcall %d)\n", call, newcall));
5234 /* Notify anyone who is waiting for asynchronous packet arrival */
5235 if (call->arrivalProc) {
5236 (*call->arrivalProc) (call, call->arrivalProcHandle,
5237 call->arrivalProcArg);
5238 call->arrivalProc = (void (*)())0;
5242 rxi_CancelGrowMTUEvent(call);
5244 if (call->delayedAbortEvent) {
5245 rxi_CancelDelayedAbortEvent(call);
5246 packet = rxi_AllocPacket(RX_PACKET_CLASS_SPECIAL);
5248 rxi_SendCallAbort(call, packet, 0, 1);
5249 rxi_FreePacket(packet);
5254 * Update the peer with the congestion information in this call
5255 * so other calls on this connection can pick up where this call
5256 * left off. If the congestion sequence numbers don't match then
5257 * another call experienced a retransmission.
5259 peer = call->conn->peer;
5260 MUTEX_ENTER(&peer->peer_lock);
5262 if (call->congestSeq == peer->congestSeq) {
5263 peer->cwind = MAX(peer->cwind, call->cwind);
5264 peer->MTU = MAX(peer->MTU, call->MTU);
5265 peer->nDgramPackets =
5266 MAX(peer->nDgramPackets, call->nDgramPackets);
5269 call->abortCode = 0;
5270 call->abortCount = 0;
5272 if (peer->maxDgramPackets > 1) {
5273 call->MTU = RX_HEADER_SIZE + RX_JUMBOBUFFERSIZE;
5275 call->MTU = peer->MTU;
5277 call->cwind = MIN((int)peer->cwind, (int)peer->nDgramPackets);
5278 call->ssthresh = rx_maxSendWindow;
5279 call->nDgramPackets = peer->nDgramPackets;
5280 call->congestSeq = peer->congestSeq;
5281 call->rtt = peer->rtt;
5282 call->rtt_dev = peer->rtt_dev;
5283 clock_Zero(&call->rto);
5284 clock_Addmsec(&call->rto,
5285 MAX(((call->rtt >> 3) + call->rtt_dev), rx_minPeerTimeout) + 200);
5286 MUTEX_EXIT(&peer->peer_lock);
5288 flags = call->flags;
5289 rxi_WaitforTQBusy(call);
5291 rxi_ClearTransmitQueue(call, 1);
5292 if (call->tqWaiters || (flags & RX_CALL_TQ_WAIT)) {
5293 dpf(("rcall %"AFS_PTR_FMT" has %d waiters and flags %d\n", call, call->tqWaiters, call->flags));
5297 rxi_ClearReceiveQueue(call);
5298 /* why init the queue if you just emptied it? queue_Init(&call->rq); */
5302 call->twind = call->conn->twind[call->channel];
5303 call->rwind = call->conn->rwind[call->channel];
5304 call->nSoftAcked = 0;
5305 call->nextCwind = 0;
5308 call->nCwindAcks = 0;
5309 call->nSoftAcks = 0;
5310 call->nHardAcks = 0;
5312 call->tfirst = call->rnext = call->tnext = 1;
5315 call->lastAcked = 0;
5316 call->localStatus = call->remoteStatus = 0;
5318 if (flags & RX_CALL_READER_WAIT) {
5319 #ifdef RX_ENABLE_LOCKS
5320 CV_BROADCAST(&call->cv_rq);
5322 osi_rxWakeup(&call->rq);
5325 if (flags & RX_CALL_WAIT_PACKETS) {
5326 MUTEX_ENTER(&rx_freePktQ_lock);
5327 rxi_PacketsUnWait(); /* XXX */
5328 MUTEX_EXIT(&rx_freePktQ_lock);
5330 #ifdef RX_ENABLE_LOCKS
5331 CV_SIGNAL(&call->cv_twind);
5333 if (flags & RX_CALL_WAIT_WINDOW_ALLOC)
5334 osi_rxWakeup(&call->twind);
5337 if (flags & RX_CALL_WAIT_PROC) {
5338 rx_atomic_dec(&rx_nWaiting);
5340 #ifdef RX_ENABLE_LOCKS
5341 /* The following ensures that we don't mess with any queue while some
5342 * other thread might also be doing so. The call_queue_lock field is
5343 * is only modified under the call lock. If the call is in the process
5344 * of being removed from a queue, the call is not locked until the
5345 * the queue lock is dropped and only then is the call_queue_lock field
5346 * zero'd out. So it's safe to lock the queue if call_queue_lock is set.
5347 * Note that any other routine which removes a call from a queue has to
5348 * obtain the queue lock before examing the queue and removing the call.
5350 if (call->call_queue_lock) {
5351 MUTEX_ENTER(call->call_queue_lock);
5352 if (opr_queue_IsOnQueue(&call->entry)) {
5353 opr_queue_Remove(&call->entry);
5355 MUTEX_EXIT(call->call_queue_lock);
5356 CLEAR_CALL_QUEUE_LOCK(call);
5358 #else /* RX_ENABLE_LOCKS */
5359 if (opr_queue_IsOnQueue(&call->entry)) {
5360 opr_queue_Remove(&call->entry);
5362 #endif /* RX_ENABLE_LOCKS */
5364 rxi_CancelKeepAliveEvent(call);
5365 rxi_CancelDelayedAckEvent(call);
5368 /* Send an acknowledge for the indicated packet (seq,serial) of the
5369 * indicated call, for the indicated reason (reason). This
5370 * acknowledge will specifically acknowledge receiving the packet, and
5371 * will also specify which other packets for this call have been
5372 * received. This routine returns the packet that was used to the
5373 * caller. The caller is responsible for freeing it or re-using it.
5374 * This acknowledgement also returns the highest sequence number
5375 * actually read out by the higher level to the sender; the sender
5376 * promises to keep around packets that have not been read by the
5377 * higher level yet (unless, of course, the sender decides to abort
5378 * the call altogether). Any of p, seq, serial, pflags, or reason may
5379 * be set to zero without ill effect. That is, if they are zero, they
5380 * will not convey any information.
5381 * NOW there is a trailer field, after the ack where it will safely be
5382 * ignored by mundanes, which indicates the maximum size packet this
5383 * host can swallow. */
5385 struct rx_packet *optionalPacket; use to send ack (or null)
5386 int seq; Sequence number of the packet we are acking
5387 int serial; Serial number of the packet
5388 int pflags; Flags field from packet header
5389 int reason; Reason an acknowledge was prompted
5392 #define RX_ZEROS 1024
5393 static char rx_zeros[RX_ZEROS];
5396 rxi_SendAck(struct rx_call *call,
5397 struct rx_packet *optionalPacket, int serial, int reason,
5400 struct rx_ackPacket *ap;
5401 struct rx_packet *p;
5402 struct opr_queue *cursor;
5405 afs_uint32 padbytes = 0;
5406 #ifdef RX_ENABLE_TSFPQ
5407 struct rx_ts_info_t * rx_ts_info;
5411 * Open the receive window once a thread starts reading packets
5413 if (call->rnext > 1) {
5414 call->conn->rwind[call->channel] = call->rwind = rx_maxReceiveWindow;
5417 /* Don't attempt to grow MTU if this is a critical ping */
5418 if (reason == RX_ACK_MTU) {
5419 /* keep track of per-call attempts, if we're over max, do in small
5420 * otherwise in larger? set a size to increment by, decrease
5423 if (call->conn->peer->maxPacketSize &&
5424 (call->conn->peer->maxPacketSize < OLD_MAX_PACKET_SIZE
5426 padbytes = call->conn->peer->maxPacketSize+16;
5428 padbytes = call->conn->peer->maxMTU + 128;
5430 /* do always try a minimum size ping */
5431 padbytes = MAX(padbytes, RX_MIN_PACKET_SIZE+RX_IPUDP_SIZE+4);
5433 /* subtract the ack payload */
5434 padbytes -= (rx_AckDataSize(call->rwind) + 4 * sizeof(afs_int32));
5435 reason = RX_ACK_PING;
5438 call->nHardAcks = 0;
5439 call->nSoftAcks = 0;
5440 if (call->rnext > call->lastAcked)
5441 call->lastAcked = call->rnext;
5445 rx_computelen(p, p->length); /* reset length, you never know */
5446 } /* where that's been... */
5447 #ifdef RX_ENABLE_TSFPQ
5449 RX_TS_INFO_GET(rx_ts_info);
5450 if ((p = rx_ts_info->local_special_packet)) {
5451 rx_computelen(p, p->length);
5452 } else if ((p = rxi_AllocPacket(RX_PACKET_CLASS_SPECIAL))) {
5453 rx_ts_info->local_special_packet = p;
5454 } else { /* We won't send the ack, but don't panic. */
5455 return optionalPacket;
5459 else if (!(p = rxi_AllocPacket(RX_PACKET_CLASS_SPECIAL))) {
5460 /* We won't send the ack, but don't panic. */
5461 return optionalPacket;
5466 rx_AckDataSize(call->rwind) + 4 * sizeof(afs_int32) -
5469 if (rxi_AllocDataBuf(p, templ, RX_PACKET_CLASS_SPECIAL) > 0) {
5470 #ifndef RX_ENABLE_TSFPQ
5471 if (!optionalPacket)
5474 return optionalPacket;
5476 templ = rx_AckDataSize(call->rwind) + 2 * sizeof(afs_int32);
5477 if (rx_Contiguous(p) < templ) {
5478 #ifndef RX_ENABLE_TSFPQ
5479 if (!optionalPacket)
5482 return optionalPacket;
5487 /* MTUXXX failing to send an ack is very serious. We should */
5488 /* try as hard as possible to send even a partial ack; it's */
5489 /* better than nothing. */
5490 ap = (struct rx_ackPacket *)rx_DataOf(p);
5491 ap->bufferSpace = htonl(0); /* Something should go here, sometime */
5492 ap->reason = reason;
5494 /* The skew computation used to be bogus, I think it's better now. */
5495 /* We should start paying attention to skew. XXX */
5496 ap->serial = htonl(serial);
5497 ap->maxSkew = 0; /* used to be peer->inPacketSkew */
5500 * First packet not yet forwarded to reader. When ACKALL has been
5501 * sent the peer has been told that all received packets will be
5502 * delivered to the reader. The value 'rnext' is used internally
5503 * to refer to the next packet in the receive queue that must be
5504 * delivered to the reader. From the perspective of the peer it
5505 * already has so report the last sequence number plus one if there
5506 * are packets in the receive queue awaiting processing.
5508 if ((call->flags & RX_CALL_ACKALL_SENT) &&
5509 !opr_queue_IsEmpty(&call->rq)) {
5510 ap->firstPacket = htonl(opr_queue_Last(&call->rq, struct rx_packet, entry)->header.seq + 1);
5512 ap->firstPacket = htonl(call->rnext);
5514 ap->previousPacket = htonl(call->rprev); /* Previous packet received */
5516 /* No fear of running out of ack packet here because there can only
5517 * be at most one window full of unacknowledged packets. The window
5518 * size must be constrained to be less than the maximum ack size,
5519 * of course. Also, an ack should always fit into a single packet
5520 * -- it should not ever be fragmented. */
5522 for (opr_queue_Scan(&call->rq, cursor)) {
5523 struct rx_packet *rqp
5524 = opr_queue_Entry(cursor, struct rx_packet, entry);
5526 if (!rqp || !call->rq.next
5527 || (rqp->header.seq > (call->rnext + call->rwind))) {
5528 #ifndef RX_ENABLE_TSFPQ
5529 if (!optionalPacket)
5532 rxi_CallError(call, RX_CALL_DEAD);
5533 return optionalPacket;
5536 while (rqp->header.seq > call->rnext + offset)
5537 ap->acks[offset++] = RX_ACK_TYPE_NACK;
5538 ap->acks[offset++] = RX_ACK_TYPE_ACK;
5540 if ((offset > (u_char) rx_maxReceiveWindow) || (offset > call->rwind)) {
5541 #ifndef RX_ENABLE_TSFPQ
5542 if (!optionalPacket)
5545 rxi_CallError(call, RX_CALL_DEAD);
5546 return optionalPacket;
5552 p->length = rx_AckDataSize(offset) + 4 * sizeof(afs_int32);
5554 /* Must zero the 3 octets that rx_AckDataSize skips at the end of the
5557 rx_packetwrite(p, rx_AckDataSize(offset) - 3, 3, rx_zeros);
5559 /* these are new for AFS 3.3 */
5560 templ = rxi_AdjustMaxMTU(call->conn->peer->ifMTU, rx_maxReceiveSize);
5561 templ = htonl(templ);
5562 rx_packetwrite(p, rx_AckDataSize(offset), sizeof(afs_int32), &templ);
5563 templ = htonl(call->conn->peer->ifMTU);
5564 rx_packetwrite(p, rx_AckDataSize(offset) + sizeof(afs_int32),
5565 sizeof(afs_int32), &templ);
5567 /* new for AFS 3.4 */
5568 templ = htonl(call->rwind);
5569 rx_packetwrite(p, rx_AckDataSize(offset) + 2 * sizeof(afs_int32),
5570 sizeof(afs_int32), &templ);
5572 /* new for AFS 3.5 */
5573 templ = htonl(call->conn->peer->ifDgramPackets);
5574 rx_packetwrite(p, rx_AckDataSize(offset) + 3 * sizeof(afs_int32),
5575 sizeof(afs_int32), &templ);
5577 p->length = rx_AckDataSize(offset) + 4 * sizeof(afs_int32);
5579 p->header.serviceId = call->conn->serviceId;
5580 p->header.cid = (call->conn->cid | call->channel);
5581 p->header.callNumber = *call->callNumber;
5583 p->header.securityIndex = call->conn->securityIndex;
5584 p->header.epoch = call->conn->epoch;
5585 p->header.type = RX_PACKET_TYPE_ACK;
5586 p->header.flags = RX_SLOW_START_OK;
5587 if (reason == RX_ACK_PING)
5588 p->header.flags |= RX_REQUEST_ACK;
5590 while (padbytes > 0) {
5591 if (padbytes > RX_ZEROS) {
5592 rx_packetwrite(p, p->length, RX_ZEROS, rx_zeros);
5593 p->length += RX_ZEROS;
5594 padbytes -= RX_ZEROS;
5596 rx_packetwrite(p, p->length, padbytes, rx_zeros);
5597 p->length += padbytes;
5602 if (call->conn->type == RX_CLIENT_CONNECTION)
5603 p->header.flags |= RX_CLIENT_INITIATED;
5607 if (rxdebug_active) {
5611 len = _snprintf(msg, sizeof(msg),
5612 "tid[%d] SACK: reason %s serial %u previous %u seq %u first %u acks %u space %u ",
5613 GetCurrentThreadId(), rx_ack_reason(ap->reason),
5614 ntohl(ap->serial), ntohl(ap->previousPacket),
5615 (unsigned int)p->header.seq, ntohl(ap->firstPacket),
5616 ap->nAcks, ntohs(ap->bufferSpace) );
5620 for (offset = 0; offset < ap->nAcks && len < sizeof(msg); offset++)
5621 msg[len++] = (ap->acks[offset] == RX_ACK_TYPE_NACK ? '-' : '*');
5625 OutputDebugString(msg);
5627 #else /* AFS_NT40_ENV */
5629 fprintf(rx_Log, "SACK: reason %x previous %u seq %u first %u ",
5630 ap->reason, ntohl(ap->previousPacket),
5631 (unsigned int)p->header.seq, ntohl(ap->firstPacket));
5633 for (offset = 0; offset < ap->nAcks; offset++)
5634 putc(ap->acks[offset] == RX_ACK_TYPE_NACK ? '-' : '*',
5639 #endif /* AFS_NT40_ENV */
5642 int i, nbytes = p->length;
5644 for (i = 1; i < p->niovecs; i++) { /* vec 0 is ALWAYS header */
5645 if (nbytes <= p->wirevec[i].iov_len) {
5648 savelen = p->wirevec[i].iov_len;
5650 p->wirevec[i].iov_len = nbytes;
5652 rxi_Send(call, p, istack);
5653 p->wirevec[i].iov_len = savelen;
5657 nbytes -= p->wirevec[i].iov_len;
5660 if (rx_stats_active)
5661 rx_atomic_inc(&rx_stats.ackPacketsSent);
5662 #ifndef RX_ENABLE_TSFPQ
5663 if (!optionalPacket)
5666 return optionalPacket; /* Return packet for re-use by caller */
5670 struct rx_packet **list;
5675 /* Send all of the packets in the list in single datagram */
5677 rxi_SendList(struct rx_call *call, struct xmitlist *xmit,
5678 int istack, int moreFlag)
5684 struct rx_connection *conn = call->conn;
5685 struct rx_peer *peer = conn->peer;
5687 MUTEX_ENTER(&peer->peer_lock);
5688 peer->nSent += xmit->len;
5689 if (xmit->resending)
5690 peer->reSends += xmit->len;
5691 MUTEX_EXIT(&peer->peer_lock);
5693 if (rx_stats_active) {
5694 if (xmit->resending)
5695 rx_atomic_add(&rx_stats.dataPacketsReSent, xmit->len);
5697 rx_atomic_add(&rx_stats.dataPacketsSent, xmit->len);
5700 clock_GetTime(&now);
5702 if (xmit->list[xmit->len - 1]->header.flags & RX_LAST_PACKET) {
5706 /* Set the packet flags and schedule the resend events */
5707 /* Only request an ack for the last packet in the list */
5708 for (i = 0; i < xmit->len; i++) {
5709 struct rx_packet *packet = xmit->list[i];
5711 /* Record the time sent */
5712 packet->timeSent = now;
5713 packet->flags |= RX_PKTFLAG_SENT;
5715 /* Ask for an ack on retransmitted packets, on every other packet
5716 * if the peer doesn't support slow start. Ask for an ack on every
5717 * packet until the congestion window reaches the ack rate. */
5718 if (packet->header.serial) {
5721 packet->firstSent = now;
5722 if (!lastPacket && (call->cwind <= (u_short) (conn->ackRate + 1)
5723 || (!(call->flags & RX_CALL_SLOW_START_OK)
5724 && (packet->header.seq & 1)))) {
5729 /* Tag this packet as not being the last in this group,
5730 * for the receiver's benefit */
5731 if (i < xmit->len - 1 || moreFlag) {
5732 packet->header.flags |= RX_MORE_PACKETS;
5737 xmit->list[xmit->len - 1]->header.flags |= RX_REQUEST_ACK;
5740 /* Since we're about to send a data packet to the peer, it's
5741 * safe to nuke any scheduled end-of-packets ack */
5742 rxi_CancelDelayedAckEvent(call);
5744 MUTEX_EXIT(&call->lock);
5745 CALL_HOLD(call, RX_CALL_REFCOUNT_SEND);
5746 if (xmit->len > 1) {
5747 rxi_SendPacketList(call, conn, xmit->list, xmit->len, istack);
5749 rxi_SendPacket(call, conn, xmit->list[0], istack);
5751 MUTEX_ENTER(&call->lock);
5752 CALL_RELE(call, RX_CALL_REFCOUNT_SEND);
5754 /* Tell the RTO calculation engine that we have sent a packet, and
5755 * if it was the last one */
5756 rxi_rto_packet_sent(call, lastPacket, istack);
5758 /* Update last send time for this call (for keep-alive
5759 * processing), and for the connection (so that we can discover
5760 * idle connections) */
5761 conn->lastSendTime = call->lastSendTime = clock_Sec();
5764 /* When sending packets we need to follow these rules:
5765 * 1. Never send more than maxDgramPackets in a jumbogram.
5766 * 2. Never send a packet with more than two iovecs in a jumbogram.
5767 * 3. Never send a retransmitted packet in a jumbogram.
5768 * 4. Never send more than cwind/4 packets in a jumbogram
5769 * We always keep the last list we should have sent so we
5770 * can set the RX_MORE_PACKETS flags correctly.
5774 rxi_SendXmitList(struct rx_call *call, struct rx_packet **list, int len,
5779 struct xmitlist working;
5780 struct xmitlist last;
5782 struct rx_peer *peer = call->conn->peer;
5783 int morePackets = 0;
5785 memset(&last, 0, sizeof(struct xmitlist));
5786 working.list = &list[0];
5788 working.resending = 0;
5790 recovery = call->flags & RX_CALL_FAST_RECOVER;
5792 for (i = 0; i < len; i++) {
5793 /* Does the current packet force us to flush the current list? */
5795 && (list[i]->header.serial || (list[i]->flags & RX_PKTFLAG_ACKED)
5796 || list[i]->length > RX_JUMBOBUFFERSIZE)) {
5798 /* This sends the 'last' list and then rolls the current working
5799 * set into the 'last' one, and resets the working set */
5802 rxi_SendList(call, &last, istack, 1);
5803 /* If the call enters an error state stop sending, or if
5804 * we entered congestion recovery mode, stop sending */
5806 || (!recovery && (call->flags & RX_CALL_FAST_RECOVER)))
5811 working.resending = 0;
5812 working.list = &list[i];
5814 /* Add the current packet to the list if it hasn't been acked.
5815 * Otherwise adjust the list pointer to skip the current packet. */
5816 if (!(list[i]->flags & RX_PKTFLAG_ACKED)) {
5819 if (list[i]->header.serial)
5820 working.resending = 1;
5822 /* Do we need to flush the list? */
5823 if (working.len >= (int)peer->maxDgramPackets
5824 || working.len >= (int)call->nDgramPackets
5825 || working.len >= (int)call->cwind
5826 || list[i]->header.serial
5827 || list[i]->length != RX_JUMBOBUFFERSIZE) {
5829 rxi_SendList(call, &last, istack, 1);
5830 /* If the call enters an error state stop sending, or if
5831 * we entered congestion recovery mode, stop sending */
5833 || (!recovery && (call->flags & RX_CALL_FAST_RECOVER)))
5838 working.resending = 0;
5839 working.list = &list[i + 1];
5842 if (working.len != 0) {
5843 osi_Panic("rxi_SendList error");
5845 working.list = &list[i + 1];
5849 /* Send the whole list when the call is in receive mode, when
5850 * the call is in eof mode, when we are in fast recovery mode,
5851 * and when we have the last packet */
5852 /* XXX - The accesses to app.mode aren't safe, as this may be called by
5853 * the listener or event threads
5855 if ((list[len - 1]->header.flags & RX_LAST_PACKET)
5856 || (call->flags & RX_CALL_FLUSH)
5857 || (call->flags & RX_CALL_FAST_RECOVER)) {
5858 /* Check for the case where the current list contains
5859 * an acked packet. Since we always send retransmissions
5860 * in a separate packet, we only need to check the first
5861 * packet in the list */
5862 if (working.len > 0 && !(working.list[0]->flags & RX_PKTFLAG_ACKED)) {
5866 rxi_SendList(call, &last, istack, morePackets);
5867 /* If the call enters an error state stop sending, or if
5868 * we entered congestion recovery mode, stop sending */
5870 || (!recovery && (call->flags & RX_CALL_FAST_RECOVER)))
5874 rxi_SendList(call, &working, istack, 0);
5876 } else if (last.len > 0) {
5877 rxi_SendList(call, &last, istack, 0);
5878 /* Packets which are in 'working' are not sent by this call */
5883 * Check if the peer for the given call is known to be dead
5885 * If the call's peer appears dead (it has encountered fatal network errors
5886 * since the call started) the call is killed with RX_CALL_DEAD if the call
5887 * is active. Otherwise, we do nothing.
5889 * @param[in] call The call to check
5892 * @retval 0 The call is fine, and we haven't done anything to the call
5893 * @retval nonzero The call's peer appears dead, and the call has been
5894 * terminated if it was active
5896 * @pre call->lock must be locked
5899 rxi_CheckPeerDead(struct rx_call *call)
5901 #ifdef AFS_RXERRQ_ENV
5904 if (call->state == RX_STATE_DALLY) {
5908 peererrs = rx_atomic_read(&call->conn->peer->neterrs);
5909 if (call->neterr_gen < peererrs) {
5910 /* we have received network errors since this call started; kill
5912 if (call->state == RX_STATE_ACTIVE) {
5913 rxi_CallError(call, RX_CALL_DEAD);
5917 if (call->neterr_gen > peererrs) {
5918 /* someone has reset the number of peer errors; set the call error gen
5919 * so we can detect if more errors are encountered */
5920 call->neterr_gen = peererrs;
5927 rxi_Resend(struct rxevent *event, void *arg0, void *arg1, int istack)
5929 struct rx_call *call = arg0;
5930 struct rx_peer *peer;
5931 struct opr_queue *cursor;
5932 struct clock maxTimeout = { 60, 0 };
5934 MUTEX_ENTER(&call->lock);
5936 peer = call->conn->peer;
5938 /* Make sure that the event pointer is removed from the call
5939 * structure, since there is no longer a per-call retransmission
5941 if (event == call->resendEvent)
5942 rxevent_Put(&call->resendEvent);
5944 rxi_CheckPeerDead(call);
5946 if (opr_queue_IsEmpty(&call->tq)) {
5947 /* Nothing to do. This means that we've been raced, and that an
5948 * ACK has come in between when we were triggered, and when we
5949 * actually got to run. */
5953 /* We're in loss recovery */
5954 call->flags |= RX_CALL_FAST_RECOVER;
5956 /* Mark all of the pending packets in the queue as being lost */
5957 for (opr_queue_Scan(&call->tq, cursor)) {
5958 struct rx_packet *p = opr_queue_Entry(cursor, struct rx_packet, entry);
5959 if (!(p->flags & RX_PKTFLAG_ACKED))
5960 p->flags &= ~RX_PKTFLAG_SENT;
5963 /* We're resending, so we double the timeout of the call. This will be
5964 * dropped back down by the first successful ACK that we receive.
5966 * We apply a maximum value here of 60 seconds
5968 clock_Add(&call->rto, &call->rto);
5969 if (clock_Gt(&call->rto, &maxTimeout))
5970 call->rto = maxTimeout;
5972 /* Packet loss is most likely due to congestion, so drop our window size
5973 * and start again from the beginning */
5974 if (peer->maxDgramPackets >1) {
5975 call->MTU = RX_JUMBOBUFFERSIZE + RX_HEADER_SIZE;
5976 call->MTU = MIN(peer->natMTU, peer->maxMTU);
5978 call->ssthresh = MAX(4, MIN((int)call->cwind, (int)call->twind)) >> 1;
5979 call->nDgramPackets = 1;
5981 call->nextCwind = 1;
5984 MUTEX_ENTER(&peer->peer_lock);
5985 peer->MTU = call->MTU;
5986 peer->cwind = call->cwind;
5987 peer->nDgramPackets = 1;
5989 call->congestSeq = peer->congestSeq;
5990 MUTEX_EXIT(&peer->peer_lock);
5992 rxi_Start(call, istack);
5995 CALL_RELE(call, RX_CALL_REFCOUNT_RESEND);
5996 MUTEX_EXIT(&call->lock);
5999 /* This routine is called when new packets are readied for
6000 * transmission and when retransmission may be necessary, or when the
6001 * transmission window or burst count are favourable. This should be
6002 * better optimized for new packets, the usual case, now that we've
6003 * got rid of queues of send packets. XXXXXXXXXXX */
6005 rxi_Start(struct rx_call *call, int istack)
6007 struct opr_queue *cursor;
6008 #ifdef RX_ENABLE_LOCKS
6009 struct opr_queue *store;
6015 #ifdef RX_ENABLE_LOCKS
6016 if (rx_stats_active)
6017 rx_atomic_inc(&rx_tq_debug.rxi_start_in_error);
6022 if (!opr_queue_IsEmpty(&call->tq)) { /* If we have anything to send */
6023 /* Send (or resend) any packets that need it, subject to
6024 * window restrictions and congestion burst control
6025 * restrictions. Ask for an ack on the last packet sent in
6026 * this burst. For now, we're relying upon the window being
6027 * considerably bigger than the largest number of packets that
6028 * are typically sent at once by one initial call to
6029 * rxi_Start. This is probably bogus (perhaps we should ask
6030 * for an ack when we're half way through the current
6031 * window?). Also, for non file transfer applications, this
6032 * may end up asking for an ack for every packet. Bogus. XXXX
6035 * But check whether we're here recursively, and let the other guy
6038 #ifdef RX_ENABLE_LOCKS
6039 if (!(call->flags & RX_CALL_TQ_BUSY)) {
6040 call->flags |= RX_CALL_TQ_BUSY;
6042 #endif /* RX_ENABLE_LOCKS */
6044 #ifdef RX_ENABLE_LOCKS
6045 call->flags &= ~RX_CALL_NEED_START;
6046 #endif /* RX_ENABLE_LOCKS */
6048 maxXmitPackets = MIN(call->twind, call->cwind);
6049 for (opr_queue_Scan(&call->tq, cursor)) {
6051 = opr_queue_Entry(cursor, struct rx_packet, entry);
6053 if (p->flags & RX_PKTFLAG_ACKED) {
6054 /* Since we may block, don't trust this */
6055 if (rx_stats_active)
6056 rx_atomic_inc(&rx_stats.ignoreAckedPacket);
6057 continue; /* Ignore this packet if it has been acknowledged */
6060 /* Turn off all flags except these ones, which are the same
6061 * on each transmission */
6062 p->header.flags &= RX_PRESET_FLAGS;
6064 if (p->header.seq >=
6065 call->tfirst + MIN((int)call->twind,
6066 (int)(call->nSoftAcked +
6068 call->flags |= RX_CALL_WAIT_WINDOW_SEND; /* Wait for transmit window */
6069 /* Note: if we're waiting for more window space, we can
6070 * still send retransmits; hence we don't return here, but
6071 * break out to schedule a retransmit event */
6072 dpf(("call %d waiting for window (seq %d, twind %d, nSoftAcked %d, cwind %d)\n",
6073 *(call->callNumber), p->header.seq, call->twind, call->nSoftAcked,
6078 /* Transmit the packet if it needs to be sent. */
6079 if (!(p->flags & RX_PKTFLAG_SENT)) {
6080 if (nXmitPackets == maxXmitPackets) {
6081 rxi_SendXmitList(call, call->xmitList,
6082 nXmitPackets, istack);
6085 dpf(("call %d xmit packet %"AFS_PTR_FMT"\n",
6086 *(call->callNumber), p));
6087 call->xmitList[nXmitPackets++] = p;
6089 } /* end of the queue_Scan */
6091 /* xmitList now hold pointers to all of the packets that are
6092 * ready to send. Now we loop to send the packets */
6093 if (nXmitPackets > 0) {
6094 rxi_SendXmitList(call, call->xmitList, nXmitPackets,
6098 #ifdef RX_ENABLE_LOCKS
6100 /* We went into the error state while sending packets. Now is
6101 * the time to reset the call. This will also inform the using
6102 * process that the call is in an error state.
6104 if (rx_stats_active)
6105 rx_atomic_inc(&rx_tq_debug.rxi_start_aborted);
6106 call->flags &= ~RX_CALL_TQ_BUSY;
6107 rxi_WakeUpTransmitQueue(call);
6108 rxi_CallError(call, call->error);
6112 if (call->flags & RX_CALL_TQ_SOME_ACKED) {
6114 call->flags &= ~RX_CALL_TQ_SOME_ACKED;
6115 /* Some packets have received acks. If they all have, we can clear
6116 * the transmit queue.
6119 for (opr_queue_ScanSafe(&call->tq, cursor, store)) {
6121 = opr_queue_Entry(cursor, struct rx_packet, entry);
6123 if (p->header.seq < call->tfirst
6124 && (p->flags & RX_PKTFLAG_ACKED)) {
6125 opr_queue_Remove(&p->entry);
6126 #ifdef RX_TRACK_PACKETS
6127 p->flags &= ~RX_PKTFLAG_TQ;
6129 #ifdef RXDEBUG_PACKET
6137 call->flags |= RX_CALL_TQ_CLEARME;
6139 if (call->flags & RX_CALL_TQ_CLEARME)
6140 rxi_ClearTransmitQueue(call, 1);
6141 } while (call->flags & RX_CALL_NEED_START);
6143 * TQ references no longer protected by this flag; they must remain
6144 * protected by the call lock.
6146 call->flags &= ~RX_CALL_TQ_BUSY;
6147 rxi_WakeUpTransmitQueue(call);
6149 call->flags |= RX_CALL_NEED_START;
6151 #endif /* RX_ENABLE_LOCKS */
6153 rxi_rto_cancel(call);
6157 /* Also adjusts the keep alive parameters for the call, to reflect
6158 * that we have just sent a packet (so keep alives aren't sent
6161 rxi_Send(struct rx_call *call, struct rx_packet *p,
6164 struct rx_connection *conn = call->conn;
6166 /* Stamp each packet with the user supplied status */
6167 p->header.userStatus = call->localStatus;
6169 /* Allow the security object controlling this call's security to
6170 * make any last-minute changes to the packet */
6171 RXS_SendPacket(conn->securityObject, call, p);
6173 /* Since we're about to send SOME sort of packet to the peer, it's
6174 * safe to nuke any scheduled end-of-packets ack */
6175 rxi_CancelDelayedAckEvent(call);
6177 /* Actually send the packet, filling in more connection-specific fields */
6178 MUTEX_EXIT(&call->lock);
6179 CALL_HOLD(call, RX_CALL_REFCOUNT_SEND);
6180 rxi_SendPacket(call, conn, p, istack);
6181 CALL_RELE(call, RX_CALL_REFCOUNT_SEND);
6182 MUTEX_ENTER(&call->lock);
6184 /* Update last send time for this call (for keep-alive
6185 * processing), and for the connection (so that we can discover
6186 * idle connections) */
6187 if ((p->header.type != RX_PACKET_TYPE_ACK) ||
6188 (((struct rx_ackPacket *)rx_DataOf(p))->reason == RX_ACK_PING) ||
6189 (p->length <= (rx_AckDataSize(call->rwind) + 4 * sizeof(afs_int32))))
6191 conn->lastSendTime = call->lastSendTime = clock_Sec();
6195 /* Check if a call needs to be destroyed. Called by keep-alive code to ensure
6196 * that things are fine. Also called periodically to guarantee that nothing
6197 * falls through the cracks (e.g. (error + dally) connections have keepalive
6198 * turned off. Returns 0 if conn is well, -1 otherwise. If otherwise, call
6200 * haveCTLock Set if calling from rxi_ReapConnections
6203 rxi_CheckCall(struct rx_call *call, int haveCTLock)
6205 struct rx_connection *conn = call->conn;
6207 afs_uint32 deadTime, idleDeadTime = 0, hardDeadTime = 0;
6208 afs_uint32 fudgeFactor;
6211 int idle_timeout = 0;
6212 afs_int32 clock_diff = 0;
6214 if (rxi_CheckPeerDead(call)) {
6220 /* Large swings in the clock can have a significant impact on
6221 * the performance of RX call processing. Forward clock shifts
6222 * will result in premature event triggering or timeouts.
6223 * Backward shifts can result in calls not completing until
6224 * the clock catches up with the original start clock value.
6226 * If a backward clock shift of more than five minutes is noticed,
6227 * just fail the call.
6229 if (now < call->lastSendTime)
6230 clock_diff = call->lastSendTime - now;
6231 if (now < call->startWait)
6232 clock_diff = MAX(clock_diff, call->startWait - now);
6233 if (now < call->lastReceiveTime)
6234 clock_diff = MAX(clock_diff, call->lastReceiveTime - now);
6235 if (clock_diff > 5 * 60)
6237 if (call->state == RX_STATE_ACTIVE)
6238 rxi_CallError(call, RX_CALL_TIMEOUT);
6242 #ifdef RX_ENABLE_LOCKS
6243 if (call->flags & RX_CALL_TQ_BUSY) {
6244 /* Call is active and will be reset by rxi_Start if it's
6245 * in an error state.
6250 /* RTT + 8*MDEV, rounded up to the next second. */
6251 fudgeFactor = (((afs_uint32) call->rtt >> 3) +
6252 ((afs_uint32) call->rtt_dev << 1) + 1023) >> 10;
6254 deadTime = conn->secondsUntilDead + fudgeFactor;
6255 /* These are computed to the second (+- 1 second). But that's
6256 * good enough for these values, which should be a significant
6257 * number of seconds. */
6258 if (now > (call->lastReceiveTime + deadTime)) {
6259 if (call->state == RX_STATE_ACTIVE) {
6260 cerror = RX_CALL_DEAD;
6263 #ifdef RX_ENABLE_LOCKS
6264 /* Cancel pending events */
6265 rxi_CancelDelayedAckEvent(call);
6266 rxi_rto_cancel(call);
6267 rxi_CancelKeepAliveEvent(call);
6268 rxi_CancelGrowMTUEvent(call);
6269 MUTEX_ENTER(&rx_refcnt_mutex);
6270 /* if rxi_FreeCall returns 1 it has freed the call */
6271 if (call->refCount == 0 &&
6272 rxi_FreeCall(call, haveCTLock))
6274 MUTEX_EXIT(&rx_refcnt_mutex);
6277 MUTEX_EXIT(&rx_refcnt_mutex);
6279 #else /* RX_ENABLE_LOCKS */
6280 rxi_FreeCall(call, 0);
6282 #endif /* RX_ENABLE_LOCKS */
6284 /* Non-active calls are destroyed if they are not responding
6285 * to pings; active calls are simply flagged in error, so the
6286 * attached process can die reasonably gracefully. */
6289 if (conn->idleDeadTime) {
6290 idleDeadTime = conn->idleDeadTime + fudgeFactor;
6294 /* see if we have a non-activity timeout */
6295 if (call->startWait && ((call->startWait + idleDeadTime) < now)) {
6296 if (call->state == RX_STATE_ACTIVE) {
6297 cerror = RX_CALL_TIMEOUT;
6303 if (conn->hardDeadTime) {
6304 hardDeadTime = conn->hardDeadTime + fudgeFactor;
6307 /* see if we have a hard timeout */
6309 && (now > (hardDeadTime + call->startTime.sec))) {
6310 if (call->state == RX_STATE_ACTIVE)
6311 rxi_CallError(call, RX_CALL_TIMEOUT);
6316 if (conn->msgsizeRetryErr && cerror != RX_CALL_TIMEOUT && !idle_timeout &&
6317 call->lastReceiveTime) {
6318 int oldMTU = conn->peer->ifMTU;
6320 /* If we thought we could send more, perhaps things got worse.
6321 * Shrink by 128 bytes and try again. */
6322 if (conn->peer->maxPacketSize < conn->lastPacketSize)
6323 /* maxPacketSize will be cleared in rxi_SetPeerMtu */
6324 newmtu = MAX(conn->peer->maxPacketSize + RX_HEADER_SIZE,
6325 conn->lastPacketSize - 128 + RX_HEADER_SIZE);
6327 newmtu = conn->lastPacketSize - 128 + RX_HEADER_SIZE;
6329 /* minimum capped in SetPeerMtu */
6330 rxi_SetPeerMtu(conn->peer, 0, 0, newmtu);
6333 conn->lastPacketSize = conn->lastPacketSizeSeq = 0;
6335 /* needed so ResetCall doesn't clobber us. */
6336 call->MTU = conn->peer->ifMTU;
6338 /* if we never succeeded, let the error pass out as-is */
6339 if (conn->peer->maxPacketSize && oldMTU != conn->peer->ifMTU)
6340 cerror = conn->msgsizeRetryErr;
6343 rxi_CallError(call, cerror);
6348 rxi_NatKeepAliveEvent(struct rxevent *event, void *arg1,
6349 void *dummy, int dummy2)
6351 struct rx_connection *conn = arg1;
6352 struct rx_header theader;
6353 char tbuffer[1 + sizeof(struct rx_header)];
6354 struct sockaddr_in taddr;
6358 struct iovec tmpiov[2];
6361 RX_CLIENT_CONNECTION ? rx_socket : conn->service->socket);
6364 tp = &tbuffer[sizeof(struct rx_header)];
6365 taddr.sin_family = AF_INET;
6366 taddr.sin_port = rx_PortOf(rx_PeerOf(conn));
6367 taddr.sin_addr.s_addr = rx_HostOf(rx_PeerOf(conn));
6368 memset(&taddr.sin_zero, 0, sizeof(taddr.sin_zero));
6369 #ifdef STRUCT_SOCKADDR_HAS_SA_LEN
6370 taddr.sin_len = sizeof(struct sockaddr_in);
6372 memset(&theader, 0, sizeof(theader));
6373 theader.epoch = htonl(999);
6375 theader.callNumber = 0;
6378 theader.type = RX_PACKET_TYPE_VERSION;
6379 theader.flags = RX_LAST_PACKET;
6380 theader.serviceId = 0;
6382 memcpy(tbuffer, &theader, sizeof(theader));
6383 memcpy(tp, &a, sizeof(a));
6384 tmpiov[0].iov_base = tbuffer;
6385 tmpiov[0].iov_len = 1 + sizeof(struct rx_header);
6387 osi_NetSend(socket, &taddr, tmpiov, 1, 1 + sizeof(struct rx_header), 1);
6389 MUTEX_ENTER(&conn->conn_data_lock);
6390 /* We ran, so the handle is no longer needed to try to cancel ourselves. */
6391 if (event == conn->natKeepAliveEvent)
6392 rxevent_Put(&conn->natKeepAliveEvent);
6393 MUTEX_ENTER(&rx_refcnt_mutex);
6394 /* Only reschedule ourselves if the connection would not be destroyed */
6395 if (conn->refCount > 1)
6397 if (conn->refCount <= 0) {
6398 #ifdef RX_REFCOUNT_CHECK
6399 osi_Assert(conn->refCount == 0);
6401 if (rx_stats_active) {
6402 MUTEX_ENTER(&rx_stats_mutex);
6403 rxi_lowConnRefCount++;
6404 MUTEX_EXIT(&rx_stats_mutex);
6407 MUTEX_EXIT(&rx_refcnt_mutex);
6409 rxi_ScheduleNatKeepAliveEvent(conn);
6410 MUTEX_EXIT(&conn->conn_data_lock);
6411 putConnection(conn);
6415 rxi_ScheduleNatKeepAliveEvent(struct rx_connection *conn)
6417 MUTEX_ASSERT(&conn->conn_data_lock);
6418 if (!conn->natKeepAliveEvent && conn->secondsUntilNatPing) {
6419 struct clock when, now;
6420 clock_GetTime(&now);
6422 when.sec += conn->secondsUntilNatPing;
6423 rx_GetConnection(conn);
6424 conn->natKeepAliveEvent =
6425 rxevent_Post(&when, &now, rxi_NatKeepAliveEvent, conn, NULL, 0);
6430 rx_SetConnSecondsUntilNatPing(struct rx_connection *conn, afs_int32 seconds)
6432 MUTEX_ENTER(&conn->conn_data_lock);
6433 conn->secondsUntilNatPing = seconds;
6435 if (!(conn->flags & RX_CONN_ATTACHWAIT))
6436 rxi_ScheduleNatKeepAliveEvent(conn);
6438 conn->flags |= RX_CONN_NAT_PING;
6440 MUTEX_EXIT(&conn->conn_data_lock);
6443 /* When a call is in progress, this routine is called occasionally to
6444 * make sure that some traffic has arrived (or been sent to) the peer.
6445 * If nothing has arrived in a reasonable amount of time, the call is
6446 * declared dead; if nothing has been sent for a while, we send a
6447 * keep-alive packet (if we're actually trying to keep the call alive)
6450 rxi_KeepAliveEvent(struct rxevent *event, void *arg1, void *dummy,
6453 struct rx_call *call = arg1;
6454 struct rx_connection *conn;
6457 MUTEX_ENTER(&call->lock);
6459 if (event == call->keepAliveEvent)
6460 rxevent_Put(&call->keepAliveEvent);
6464 if (rxi_CheckCall(call, 0)) {
6465 MUTEX_EXIT(&call->lock);
6469 /* Don't try to keep alive dallying calls */
6470 if (call->state == RX_STATE_DALLY) {
6471 MUTEX_EXIT(&call->lock);
6472 CALL_RELE(call, RX_CALL_REFCOUNT_ALIVE);
6477 if ((now - call->lastSendTime) > conn->secondsUntilPing) {
6478 /* Don't try to send keepalives if there is unacknowledged data */
6479 /* the rexmit code should be good enough, this little hack
6480 * doesn't quite work XXX */
6481 (void)rxi_SendAck(call, NULL, 0, RX_ACK_PING, 0);
6483 rxi_ScheduleKeepAliveEvent(call);
6484 MUTEX_EXIT(&call->lock);
6485 CALL_RELE(call, RX_CALL_REFCOUNT_ALIVE);
6488 /* Does what's on the nameplate. */
6490 rxi_GrowMTUEvent(struct rxevent *event, void *arg1, void *dummy, int dummy2)
6492 struct rx_call *call = arg1;
6493 struct rx_connection *conn;
6495 MUTEX_ENTER(&call->lock);
6497 if (event == call->growMTUEvent)
6498 rxevent_Put(&call->growMTUEvent);
6500 if (rxi_CheckCall(call, 0))
6503 /* Don't bother with dallying calls */
6504 if (call->state == RX_STATE_DALLY)
6510 * keep being scheduled, just don't do anything if we're at peak,
6511 * or we're not set up to be properly handled (idle timeout required)
6513 if ((conn->peer->maxPacketSize != 0) &&
6514 (conn->peer->natMTU < RX_MAX_PACKET_SIZE) &&
6516 (void)rxi_SendAck(call, NULL, 0, RX_ACK_MTU, 0);
6517 rxi_ScheduleGrowMTUEvent(call, 0);
6519 MUTEX_EXIT(&call->lock);
6520 CALL_RELE(call, RX_CALL_REFCOUNT_MTU);
6524 rxi_ScheduleKeepAliveEvent(struct rx_call *call)
6526 MUTEX_ASSERT(&call->lock);
6527 if (!call->keepAliveEvent) {
6528 struct clock when, now;
6529 clock_GetTime(&now);
6531 when.sec += call->conn->secondsUntilPing;
6532 CALL_HOLD(call, RX_CALL_REFCOUNT_ALIVE);
6533 call->keepAliveEvent =
6534 rxevent_Post(&when, &now, rxi_KeepAliveEvent, call, NULL, 0);
6539 rxi_CancelKeepAliveEvent(struct rx_call *call) {
6540 MUTEX_ASSERT(&call->lock);
6541 if (rxevent_Cancel(&call->keepAliveEvent))
6542 CALL_RELE(call, RX_CALL_REFCOUNT_ALIVE);
6546 rxi_ScheduleGrowMTUEvent(struct rx_call *call, int secs)
6548 MUTEX_ASSERT(&call->lock);
6549 if (!call->growMTUEvent) {
6550 struct clock when, now;
6552 clock_GetTime(&now);
6555 if (call->conn->secondsUntilPing)
6556 secs = (6*call->conn->secondsUntilPing)-1;
6558 if (call->conn->secondsUntilDead)
6559 secs = MIN(secs, (call->conn->secondsUntilDead-1));
6563 CALL_HOLD(call, RX_CALL_REFCOUNT_MTU);
6564 call->growMTUEvent =
6565 rxevent_Post(&when, &now, rxi_GrowMTUEvent, call, NULL, 0);
6570 rxi_CancelGrowMTUEvent(struct rx_call *call)
6572 MUTEX_ASSERT(&call->lock);
6573 if (rxevent_Cancel(&call->growMTUEvent))
6574 CALL_RELE(call, RX_CALL_REFCOUNT_MTU);
6578 * Increment the counter for the next connection ID, handling overflow.
6581 update_nextCid(void)
6583 /* Overflow is technically undefined behavior; avoid it. */
6584 if (rx_nextCid > MAX_AFS_INT32 - (1 << RX_CIDSHIFT))
6585 rx_nextCid = -1 * ((MAX_AFS_INT32 / RX_CIDSHIFT) * RX_CIDSHIFT);
6587 rx_nextCid += 1 << RX_CIDSHIFT;
6591 rxi_KeepAliveOn(struct rx_call *call)
6593 /* Pretend last packet received was received now--i.e. if another
6594 * packet isn't received within the keep alive time, then the call
6595 * will die; Initialize last send time to the current time--even
6596 * if a packet hasn't been sent yet. This will guarantee that a
6597 * keep-alive is sent within the ping time */
6598 call->lastReceiveTime = call->lastSendTime = clock_Sec();
6599 rxi_ScheduleKeepAliveEvent(call);
6603 rxi_GrowMTUOn(struct rx_call *call)
6605 struct rx_connection *conn = call->conn;
6606 MUTEX_ENTER(&conn->conn_data_lock);
6607 conn->lastPingSizeSer = conn->lastPingSize = 0;
6608 MUTEX_EXIT(&conn->conn_data_lock);
6609 rxi_ScheduleGrowMTUEvent(call, 1);
6612 /* This routine is called to send connection abort messages
6613 * that have been delayed to throttle looping clients. */
6615 rxi_SendDelayedConnAbort(struct rxevent *event, void *arg1, void *unused,
6618 struct rx_connection *conn = arg1;
6621 struct rx_packet *packet;
6623 MUTEX_ENTER(&conn->conn_data_lock);
6624 if (event == conn->delayedAbortEvent)
6625 rxevent_Put(&conn->delayedAbortEvent);
6626 error = htonl(conn->error);
6628 MUTEX_EXIT(&conn->conn_data_lock);
6629 packet = rxi_AllocPacket(RX_PACKET_CLASS_SPECIAL);
6632 rxi_SendSpecial((struct rx_call *)0, conn, packet,
6633 RX_PACKET_TYPE_ABORT, (char *)&error,
6635 rxi_FreePacket(packet);
6637 putConnection(conn);
6640 /* This routine is called to send call abort messages
6641 * that have been delayed to throttle looping clients. */
6643 rxi_SendDelayedCallAbort(struct rxevent *event, void *arg1, void *dummy,
6646 struct rx_call *call = arg1;
6649 struct rx_packet *packet;
6651 MUTEX_ENTER(&call->lock);
6652 if (event == call->delayedAbortEvent)
6653 rxevent_Put(&call->delayedAbortEvent);
6654 error = htonl(call->error);
6656 packet = rxi_AllocPacket(RX_PACKET_CLASS_SPECIAL);
6659 rxi_SendSpecial(call, call->conn, packet, RX_PACKET_TYPE_ABORT,
6660 (char *)&error, sizeof(error), 0);
6661 rxi_FreePacket(packet);
6663 MUTEX_EXIT(&call->lock);
6664 CALL_RELE(call, RX_CALL_REFCOUNT_ABORT);
6668 * This routine is called periodically (every RX_AUTH_REQUEST_TIMEOUT
6669 * seconds) to ask the client to authenticate itself. The routine
6670 * issues a challenge to the client, which is obtained from the
6671 * security object associated with the connection
6673 * This routine is both an event handler and a function called directly;
6674 * when called directly the passed |event| is NULL and the
6675 * conn->conn->data>lock must must not be held.
6678 rxi_ChallengeEvent(struct rxevent *event,
6679 void *arg0, void *arg1, int tries)
6681 struct rx_connection *conn = arg0;
6683 MUTEX_ENTER(&conn->conn_data_lock);
6684 if (event != NULL && event == conn->challengeEvent)
6685 rxevent_Put(&conn->challengeEvent);
6686 MUTEX_EXIT(&conn->conn_data_lock);
6688 /* If there are no active calls it is not worth re-issuing the
6689 * challenge. If the client issues another call on this connection
6690 * the challenge can be requested at that time.
6692 if (!rxi_HasActiveCalls(conn)) {
6693 putConnection(conn);
6697 if (RXS_CheckAuthentication(conn->securityObject, conn) != 0) {
6698 struct rx_packet *packet;
6699 struct clock when, now;
6702 /* We've failed to authenticate for too long.
6703 * Reset any calls waiting for authentication;
6704 * they are all in RX_STATE_PRECALL.
6708 MUTEX_ENTER(&conn->conn_call_lock);
6709 for (i = 0; i < RX_MAXCALLS; i++) {
6710 struct rx_call *call = conn->call[i];
6712 MUTEX_ENTER(&call->lock);
6713 if (call->state == RX_STATE_PRECALL) {
6714 rxi_CallError(call, RX_CALL_DEAD);
6715 rxi_SendCallAbort(call, NULL, 0, 0);
6717 MUTEX_EXIT(&call->lock);
6720 MUTEX_EXIT(&conn->conn_call_lock);
6721 putConnection(conn);
6725 packet = rxi_AllocPacket(RX_PACKET_CLASS_SPECIAL);
6727 /* If there's no packet available, do this later. */
6728 RXS_GetChallenge(conn->securityObject, conn, packet);
6729 rxi_SendSpecial((struct rx_call *)0, conn, packet,
6730 RX_PACKET_TYPE_CHALLENGE, NULL, -1, 0);
6731 rxi_FreePacket(packet);
6732 conn->securityChallengeSent = 1;
6734 clock_GetTime(&now);
6736 when.sec += RX_CHALLENGE_TIMEOUT;
6737 MUTEX_ENTER(&conn->conn_data_lock);
6738 /* Only reschedule ourselves if not already pending. */
6739 if (conn->challengeEvent == NULL) {
6740 rx_GetConnection(conn);
6741 conn->challengeEvent =
6742 rxevent_Post(&when, &now, rxi_ChallengeEvent, conn, 0,
6745 MUTEX_EXIT(&conn->conn_data_lock);
6747 putConnection(conn);
6750 /* Call this routine to start requesting the client to authenticate
6751 * itself. This will continue until authentication is established,
6752 * the call times out, or an invalid response is returned. The
6753 * security object associated with the connection is asked to create
6754 * the challenge at this time. */
6756 rxi_ChallengeOn(struct rx_connection *conn)
6759 MUTEX_ENTER(&conn->conn_data_lock);
6760 if (!conn->challengeEvent)
6762 MUTEX_EXIT(&conn->conn_data_lock);
6764 RXS_CreateChallenge(conn->securityObject, conn);
6765 rxi_ChallengeEvent(NULL, conn, 0, RX_CHALLENGE_MAXTRIES);
6770 /* rxi_ComputeRoundTripTime is called with peer locked. */
6771 /* peer may be null */
6773 rxi_ComputeRoundTripTime(struct rx_packet *p,
6774 struct rx_ackPacket *ack,
6775 struct rx_call *call,
6776 struct rx_peer *peer,
6779 struct clock thisRtt, *sentp;
6783 /* If the ACK is delayed, then do nothing */
6784 if (ack->reason == RX_ACK_DELAY)
6787 /* On the wire, jumbograms are a single UDP packet. We shouldn't count
6788 * their RTT multiple times, so only include the RTT of the last packet
6790 if (p->flags & RX_JUMBO_PACKET)
6793 /* Use the serial number to determine which transmission the ACK is for,
6794 * and set the sent time to match this. If we have no serial number, then
6795 * only use the ACK for RTT calculations if the packet has not been
6799 serial = ntohl(ack->serial);
6801 if (serial == p->header.serial) {
6802 sentp = &p->timeSent;
6803 } else if (serial == p->firstSerial) {
6804 sentp = &p->firstSent;
6805 } else if (clock_Eq(&p->timeSent, &p->firstSent)) {
6806 sentp = &p->firstSent;
6810 if (clock_Eq(&p->timeSent, &p->firstSent)) {
6811 sentp = &p->firstSent;
6818 if (clock_Lt(&thisRtt, sentp))
6819 return; /* somebody set the clock back, don't count this time. */
6821 clock_Sub(&thisRtt, sentp);
6822 dpf(("rxi_ComputeRoundTripTime(call=%d packet=%"AFS_PTR_FMT" rttp=%d.%06d sec)\n",
6823 p->header.callNumber, p, thisRtt.sec, thisRtt.usec));
6825 if (clock_IsZero(&thisRtt)) {
6827 * The actual round trip time is shorter than the
6828 * clock_GetTime resolution. It is most likely 1ms or 100ns.
6829 * Since we can't tell which at the moment we will assume 1ms.
6831 thisRtt.usec = 1000;
6834 if (rx_stats_active) {
6835 MUTEX_ENTER(&rx_stats_mutex);
6836 if (clock_Lt(&thisRtt, &rx_stats.minRtt))
6837 rx_stats.minRtt = thisRtt;
6838 if (clock_Gt(&thisRtt, &rx_stats.maxRtt)) {
6839 if (thisRtt.sec > 60) {
6840 MUTEX_EXIT(&rx_stats_mutex);
6841 return; /* somebody set the clock ahead */
6843 rx_stats.maxRtt = thisRtt;
6845 clock_Add(&rx_stats.totalRtt, &thisRtt);
6846 rx_atomic_inc(&rx_stats.nRttSamples);
6847 MUTEX_EXIT(&rx_stats_mutex);
6850 /* better rtt calculation courtesy of UMich crew (dave,larry,peter,?) */
6852 /* Apply VanJacobson round-trip estimations */
6857 * srtt (call->rtt) is in units of one-eighth-milliseconds.
6858 * srtt is stored as fixed point with 3 bits after the binary
6859 * point (i.e., scaled by 8). The following magic is
6860 * equivalent to the smoothing algorithm in rfc793 with an
6861 * alpha of .875 (srtt' = rtt/8 + srtt*7/8 in fixed point).
6862 * srtt'*8 = rtt + srtt*7
6863 * srtt'*8 = srtt*8 + rtt - srtt
6864 * srtt' = srtt + rtt/8 - srtt/8
6865 * srtt' = srtt + (rtt - srtt)/8
6868 delta = _8THMSEC(&thisRtt) - call->rtt;
6869 call->rtt += (delta >> 3);
6872 * We accumulate a smoothed rtt variance (actually, a smoothed
6873 * mean difference), then set the retransmit timer to smoothed
6874 * rtt + 4 times the smoothed variance (was 2x in van's original
6875 * paper, but 4x works better for me, and apparently for him as
6877 * rttvar is stored as
6878 * fixed point with 2 bits after the binary point (scaled by
6879 * 4). The following is equivalent to rfc793 smoothing with
6880 * an alpha of .75 (rttvar' = rttvar*3/4 + |delta| / 4).
6881 * rttvar'*4 = rttvar*3 + |delta|
6882 * rttvar'*4 = rttvar*4 + |delta| - rttvar
6883 * rttvar' = rttvar + |delta|/4 - rttvar/4
6884 * rttvar' = rttvar + (|delta| - rttvar)/4
6885 * This replaces rfc793's wired-in beta.
6886 * dev*4 = dev*4 + (|actual - expected| - dev)
6892 delta -= (call->rtt_dev << 1);
6893 call->rtt_dev += (delta >> 3);
6895 /* I don't have a stored RTT so I start with this value. Since I'm
6896 * probably just starting a call, and will be pushing more data down
6897 * this, I expect congestion to increase rapidly. So I fudge a
6898 * little, and I set deviance to half the rtt. In practice,
6899 * deviance tends to approach something a little less than
6900 * half the smoothed rtt. */
6901 call->rtt = _8THMSEC(&thisRtt) + 8;
6902 call->rtt_dev = call->rtt >> 2; /* rtt/2: they're scaled differently */
6904 /* the smoothed RTT time is RTT + 4*MDEV
6906 * We allow a user specified minimum to be set for this, to allow clamping
6907 * at a minimum value in the same way as TCP. In addition, we have to allow
6908 * for the possibility that this packet is answered by a delayed ACK, so we
6909 * add on a fixed 200ms to account for that timer expiring.
6912 rtt_timeout = MAX(((call->rtt >> 3) + call->rtt_dev),
6913 rx_minPeerTimeout) + 200;
6914 clock_Zero(&call->rto);
6915 clock_Addmsec(&call->rto, rtt_timeout);
6917 /* Update the peer, so any new calls start with our values */
6918 peer->rtt_dev = call->rtt_dev;
6919 peer->rtt = call->rtt;
6921 dpf(("rxi_ComputeRoundTripTime(call=%d packet=%"AFS_PTR_FMT" rtt=%d ms, srtt=%d ms, rtt_dev=%d ms, timeout=%d.%06d sec)\n",
6922 p->header.callNumber, p, MSEC(&thisRtt), call->rtt >> 3, call->rtt_dev >> 2, (call->rto.sec), (call->rto.usec)));
6926 /* Find all server connections that have not been active for a long time, and
6929 rxi_ReapConnections(struct rxevent *unused, void *unused1, void *unused2,
6932 struct clock now, when;
6933 struct rxevent *event;
6934 clock_GetTime(&now);
6936 /* Find server connection structures that haven't been used for
6937 * greater than rx_idleConnectionTime */
6939 struct rx_connection **conn_ptr, **conn_end;
6940 int i, havecalls = 0;
6941 MUTEX_ENTER(&rx_connHashTable_lock);
6942 for (conn_ptr = &rx_connHashTable[0], conn_end =
6943 &rx_connHashTable[rx_hashTableSize]; conn_ptr < conn_end;
6945 struct rx_connection *conn, *next;
6946 struct rx_call *call;
6950 for (conn = *conn_ptr; conn; conn = next) {
6951 /* XXX -- Shouldn't the connection be locked? */
6954 for (i = 0; i < RX_MAXCALLS; i++) {
6955 call = conn->call[i];
6959 code = MUTEX_TRYENTER(&call->lock);
6962 result = rxi_CheckCall(call, 1);
6963 MUTEX_EXIT(&call->lock);
6965 /* If CheckCall freed the call, it might
6966 * have destroyed the connection as well,
6967 * which screws up the linked lists.
6973 if (conn->type == RX_SERVER_CONNECTION) {
6974 /* This only actually destroys the connection if
6975 * there are no outstanding calls */
6976 MUTEX_ENTER(&conn->conn_data_lock);
6977 MUTEX_ENTER(&rx_refcnt_mutex);
6978 if (!havecalls && !conn->refCount
6979 && ((conn->lastSendTime + rx_idleConnectionTime) <
6981 conn->refCount++; /* it will be decr in rx_DestroyConn */
6982 MUTEX_EXIT(&rx_refcnt_mutex);
6983 MUTEX_EXIT(&conn->conn_data_lock);
6984 #ifdef RX_ENABLE_LOCKS
6985 rxi_DestroyConnectionNoLock(conn);
6986 #else /* RX_ENABLE_LOCKS */
6987 rxi_DestroyConnection(conn);
6988 #endif /* RX_ENABLE_LOCKS */
6990 #ifdef RX_ENABLE_LOCKS
6992 MUTEX_EXIT(&rx_refcnt_mutex);
6993 MUTEX_EXIT(&conn->conn_data_lock);
6995 #endif /* RX_ENABLE_LOCKS */
6999 #ifdef RX_ENABLE_LOCKS
7000 while (rx_connCleanup_list) {
7001 struct rx_connection *conn;
7002 conn = rx_connCleanup_list;
7003 rx_connCleanup_list = rx_connCleanup_list->next;
7004 MUTEX_EXIT(&rx_connHashTable_lock);
7005 rxi_CleanupConnection(conn);
7006 MUTEX_ENTER(&rx_connHashTable_lock);
7008 MUTEX_EXIT(&rx_connHashTable_lock);
7009 #endif /* RX_ENABLE_LOCKS */
7012 /* Find any peer structures that haven't been used (haven't had an
7013 * associated connection) for greater than rx_idlePeerTime */
7015 struct rx_peer **peer_ptr, **peer_end;
7019 * Why do we need to hold the rx_peerHashTable_lock across
7020 * the incrementing of peer_ptr since the rx_peerHashTable
7021 * array is not changing? We don't.
7023 * By dropping the lock periodically we can permit other
7024 * activities to be performed while a rxi_ReapConnections
7025 * call is in progress. The goal of reap connections
7026 * is to clean up quickly without causing large amounts
7027 * of contention. Therefore, it is important that global
7028 * mutexes not be held for extended periods of time.
7030 for (peer_ptr = &rx_peerHashTable[0], peer_end =
7031 &rx_peerHashTable[rx_hashTableSize]; peer_ptr < peer_end;
7033 struct rx_peer *peer, *next, *prev;
7035 MUTEX_ENTER(&rx_peerHashTable_lock);
7036 for (prev = peer = *peer_ptr; peer; peer = next) {
7038 code = MUTEX_TRYENTER(&peer->peer_lock);
7039 if ((code) && (peer->refCount == 0)
7040 && ((peer->idleWhen + rx_idlePeerTime) < now.sec)) {
7041 struct opr_queue *cursor, *store;
7045 * now know that this peer object is one to be
7046 * removed from the hash table. Once it is removed
7047 * it can't be referenced by other threads.
7048 * Lets remove it first and decrement the struct
7049 * nPeerStructs count.
7051 if (peer == *peer_ptr) {
7057 if (rx_stats_active)
7058 rx_atomic_dec(&rx_stats.nPeerStructs);
7061 * Now if we hold references on 'prev' and 'next'
7062 * we can safely drop the rx_peerHashTable_lock
7063 * while we destroy this 'peer' object.
7069 MUTEX_EXIT(&rx_peerHashTable_lock);
7071 MUTEX_EXIT(&peer->peer_lock);
7072 MUTEX_DESTROY(&peer->peer_lock);
7074 for (opr_queue_ScanSafe(&peer->rpcStats, cursor, store)) {
7075 unsigned int num_funcs;
7076 struct rx_interface_stat *rpc_stat
7077 = opr_queue_Entry(cursor, struct rx_interface_stat,
7082 opr_queue_Remove(&rpc_stat->entry);
7083 opr_queue_Remove(&rpc_stat->entryPeers);
7085 num_funcs = rpc_stat->stats[0].func_total;
7087 sizeof(rx_interface_stat_t) +
7088 rpc_stat->stats[0].func_total *
7089 sizeof(rx_function_entry_v1_t);
7091 rxi_Free(rpc_stat, space);
7093 MUTEX_ENTER(&rx_rpc_stats);
7094 rxi_rpc_peer_stat_cnt -= num_funcs;
7095 MUTEX_EXIT(&rx_rpc_stats);
7100 * Regain the rx_peerHashTable_lock and
7101 * decrement the reference count on 'prev'
7104 MUTEX_ENTER(&rx_peerHashTable_lock);
7111 MUTEX_EXIT(&peer->peer_lock);
7116 MUTEX_EXIT(&rx_peerHashTable_lock);
7120 /* THIS HACK IS A TEMPORARY HACK. The idea is that the race condition in
7121 * rxi_AllocSendPacket, if it hits, will be handled at the next conn
7122 * GC, just below. Really, we shouldn't have to keep moving packets from
7123 * one place to another, but instead ought to always know if we can
7124 * afford to hold onto a packet in its particular use. */
7125 MUTEX_ENTER(&rx_freePktQ_lock);
7126 if (rx_waitingForPackets) {
7127 rx_waitingForPackets = 0;
7128 #ifdef RX_ENABLE_LOCKS
7129 CV_BROADCAST(&rx_waitingForPackets_cv);
7131 osi_rxWakeup(&rx_waitingForPackets);
7134 MUTEX_EXIT(&rx_freePktQ_lock);
7137 when.sec += RX_REAP_TIME; /* Check every RX_REAP_TIME seconds */
7138 event = rxevent_Post(&when, &now, rxi_ReapConnections, 0, NULL, 0);
7139 rxevent_Put(&event);
7143 /* rxs_Release - This isn't strictly necessary but, since the macro name from
7144 * rx.h is sort of strange this is better. This is called with a security
7145 * object before it is discarded. Each connection using a security object has
7146 * its own refcount to the object so it won't actually be freed until the last
7147 * connection is destroyed.
7149 * This is the only rxs module call. A hold could also be written but no one
7153 rxs_Release(struct rx_securityClass *aobj)
7155 return RXS_Close(aobj);
7163 #define TRACE_OPTION_RX_DEBUG 16
7171 code = RegOpenKeyEx(HKEY_LOCAL_MACHINE, AFSREG_CLT_SVC_PARAM_SUBKEY,
7172 0, KEY_QUERY_VALUE, &parmKey);
7173 if (code != ERROR_SUCCESS)
7176 dummyLen = sizeof(TraceOption);
7177 code = RegQueryValueEx(parmKey, "TraceOption", NULL, NULL,
7178 (BYTE *) &TraceOption, &dummyLen);
7179 if (code == ERROR_SUCCESS) {
7180 rxdebug_active = (TraceOption & TRACE_OPTION_RX_DEBUG) ? 1 : 0;
7182 RegCloseKey (parmKey);
7183 #endif /* AFS_NT40_ENV */
7188 rx_DebugOnOff(int on)
7192 rxdebug_active = on;
7198 rx_StatsOnOff(int on)
7200 rx_stats_active = on;
7204 /* Don't call this debugging routine directly; use dpf */
7206 rxi_DebugPrint(char *format, ...)
7215 va_start(ap, format);
7217 len = _snprintf(tformat, sizeof(tformat), "tid[%d] %s", GetCurrentThreadId(), format);
7220 len = _vsnprintf(msg, sizeof(msg)-2, tformat, ap);
7222 OutputDebugString(msg);
7228 va_start(ap, format);
7230 clock_GetTime(&now);
7231 fprintf(rx_Log, " %d.%06d:", (unsigned int)now.sec,
7232 (unsigned int)now.usec);
7233 vfprintf(rx_Log, format, ap);
7241 * This function is used to process the rx_stats structure that is local
7242 * to a process as well as an rx_stats structure received from a remote
7243 * process (via rxdebug). Therefore, it needs to do minimal version
7247 rx_PrintTheseStats(FILE * file, struct rx_statistics *s, int size,
7248 afs_int32 freePackets, char version)
7252 if (size != sizeof(struct rx_statistics)) {
7254 "Unexpected size of stats structure: was %d, expected %" AFS_SIZET_FMT "\n",
7255 size, sizeof(struct rx_statistics));
7258 fprintf(file, "rx stats: free packets %d, allocs %d, ", (int)freePackets,
7261 if (version >= RX_DEBUGI_VERSION_W_NEWPACKETTYPES) {
7262 fprintf(file, "alloc-failures(rcv %u/%u,send %u/%u,ack %u)\n",
7263 s->receivePktAllocFailures, s->receiveCbufPktAllocFailures,
7264 s->sendPktAllocFailures, s->sendCbufPktAllocFailures,
7265 s->specialPktAllocFailures);
7267 fprintf(file, "alloc-failures(rcv %u,send %u,ack %u)\n",
7268 s->receivePktAllocFailures, s->sendPktAllocFailures,
7269 s->specialPktAllocFailures);
7273 " greedy %u, " "bogusReads %u (last from host %x), "
7274 "noPackets %u, " "noBuffers %u, " "selects %u, "
7275 "sendSelects %u\n", s->socketGreedy, s->bogusPacketOnRead,
7276 s->bogusHost, s->noPacketOnRead, s->noPacketBuffersOnRead,
7277 s->selects, s->sendSelects);
7279 fprintf(file, " packets read: ");
7280 for (i = 0; i < RX_N_PACKET_TYPES; i++) {
7281 fprintf(file, "%s %u ", rx_packetTypes[i], s->packetsRead[i]);
7283 fprintf(file, "\n");
7286 " other read counters: data %u, " "ack %u, " "dup %u "
7287 "spurious %u " "dally %u\n", s->dataPacketsRead,
7288 s->ackPacketsRead, s->dupPacketsRead, s->spuriousPacketsRead,
7289 s->ignorePacketDally);
7291 fprintf(file, " packets sent: ");
7292 for (i = 0; i < RX_N_PACKET_TYPES; i++) {
7293 fprintf(file, "%s %u ", rx_packetTypes[i], s->packetsSent[i]);
7295 fprintf(file, "\n");
7298 " other send counters: ack %u, " "data %u (not resends), "
7299 "resends %u, " "pushed %u, " "acked&ignored %u\n",
7300 s->ackPacketsSent, s->dataPacketsSent, s->dataPacketsReSent,
7301 s->dataPacketsPushed, s->ignoreAckedPacket);
7304 " \t(these should be small) sendFailed %u, " "fatalErrors %u\n",
7305 s->netSendFailures, (int)s->fatalErrors);
7307 if (s->nRttSamples) {
7308 fprintf(file, " Average rtt is %0.3f, with %d samples\n",
7309 clock_Float(&s->totalRtt) / s->nRttSamples, s->nRttSamples);
7311 fprintf(file, " Minimum rtt is %0.3f, maximum is %0.3f\n",
7312 clock_Float(&s->minRtt), clock_Float(&s->maxRtt));
7316 " %d server connections, " "%d client connections, "
7317 "%d peer structs, " "%d call structs, " "%d free call structs\n",
7318 s->nServerConns, s->nClientConns, s->nPeerStructs,
7319 s->nCallStructs, s->nFreeCallStructs);
7321 #if !defined(AFS_PTHREAD_ENV) && !defined(AFS_USE_GETTIMEOFDAY)
7322 fprintf(file, " %d clock updates\n", clock_nUpdates);
7326 /* for backward compatibility */
7328 rx_PrintStats(FILE * file)
7330 MUTEX_ENTER(&rx_stats_mutex);
7331 rx_PrintTheseStats(file, (struct rx_statistics *) &rx_stats,
7332 sizeof(rx_stats), rx_nFreePackets,
7334 MUTEX_EXIT(&rx_stats_mutex);
7338 rx_PrintPeerStats(FILE * file, struct rx_peer *peer)
7340 fprintf(file, "Peer %x.%d.\n",
7341 ntohl(peer->host), (int)ntohs(peer->port));
7344 " Rtt %d, " "total sent %d, " "resent %d\n",
7345 peer->rtt, peer->nSent, peer->reSends);
7347 fprintf(file, " Packet size %d\n", peer->ifMTU);
7351 #if defined(AFS_PTHREAD_ENV) && defined(RXDEBUG)
7353 * This mutex protects the following static variables:
7357 #define LOCK_RX_DEBUG MUTEX_ENTER(&rx_debug_mutex)
7358 #define UNLOCK_RX_DEBUG MUTEX_EXIT(&rx_debug_mutex)
7360 #define LOCK_RX_DEBUG
7361 #define UNLOCK_RX_DEBUG
7362 #endif /* AFS_PTHREAD_ENV */
7364 #if defined(RXDEBUG) || defined(MAKEDEBUGCALL)
7366 MakeDebugCall(osi_socket socket, afs_uint32 remoteAddr, afs_uint16 remotePort,
7367 u_char type, void *inputData, size_t inputLength,
7368 void *outputData, size_t outputLength)
7370 static afs_int32 counter = 100;
7371 time_t waitTime, waitCount;
7372 struct rx_header theader;
7375 struct timeval tv_now, tv_wake, tv_delta;
7376 struct sockaddr_in taddr, faddr;
7390 tp = &tbuffer[sizeof(struct rx_header)];
7391 taddr.sin_family = AF_INET;
7392 taddr.sin_port = remotePort;
7393 taddr.sin_addr.s_addr = remoteAddr;
7394 memset(&taddr.sin_zero, 0, sizeof(taddr.sin_zero));
7395 #ifdef STRUCT_SOCKADDR_HAS_SA_LEN
7396 taddr.sin_len = sizeof(struct sockaddr_in);
7399 memset(&theader, 0, sizeof(theader));
7400 theader.epoch = htonl(999);
7402 theader.callNumber = htonl(counter);
7405 theader.type = type;
7406 theader.flags = RX_CLIENT_INITIATED | RX_LAST_PACKET;
7407 theader.serviceId = 0;
7409 memcpy(tbuffer, &theader, sizeof(theader));
7410 memcpy(tp, inputData, inputLength);
7412 sendto(socket, tbuffer, inputLength + sizeof(struct rx_header), 0,
7413 (struct sockaddr *)&taddr, sizeof(struct sockaddr_in));
7415 /* see if there's a packet available */
7416 gettimeofday(&tv_wake, NULL);
7417 tv_wake.tv_sec += waitTime;
7420 FD_SET(socket, &imask);
7421 tv_delta.tv_sec = tv_wake.tv_sec;
7422 tv_delta.tv_usec = tv_wake.tv_usec;
7423 gettimeofday(&tv_now, NULL);
7425 if (tv_delta.tv_usec < tv_now.tv_usec) {
7427 tv_delta.tv_usec += 1000000;
7430 tv_delta.tv_usec -= tv_now.tv_usec;
7432 if (tv_delta.tv_sec < tv_now.tv_sec) {
7436 tv_delta.tv_sec -= tv_now.tv_sec;
7439 code = select(0, &imask, 0, 0, &tv_delta);
7440 #else /* AFS_NT40_ENV */
7441 code = select(socket + 1, &imask, 0, 0, &tv_delta);
7442 #endif /* AFS_NT40_ENV */
7443 if (code == 1 && FD_ISSET(socket, &imask)) {
7444 /* now receive a packet */
7445 faddrLen = sizeof(struct sockaddr_in);
7447 recvfrom(socket, tbuffer, sizeof(tbuffer), 0,
7448 (struct sockaddr *)&faddr, &faddrLen);
7451 memcpy(&theader, tbuffer, sizeof(struct rx_header));
7452 if (counter == ntohl(theader.callNumber))
7460 /* see if we've timed out */
7468 code -= sizeof(struct rx_header);
7469 if (code > outputLength)
7470 code = outputLength;
7471 memcpy(outputData, tp, code);
7474 #endif /* RXDEBUG */
7477 rx_GetServerDebug(osi_socket socket, afs_uint32 remoteAddr,
7478 afs_uint16 remotePort, struct rx_debugStats * stat,
7479 afs_uint32 * supportedValues)
7481 #if defined(RXDEBUG) || defined(MAKEDEBUGCALL)
7483 struct rx_debugIn in;
7485 *supportedValues = 0;
7486 in.type = htonl(RX_DEBUGI_GETSTATS);
7489 rc = MakeDebugCall(socket, remoteAddr, remotePort, RX_PACKET_TYPE_DEBUG,
7490 &in, sizeof(in), stat, sizeof(*stat));
7493 * If the call was successful, fixup the version and indicate
7494 * what contents of the stat structure are valid.
7495 * Also do net to host conversion of fields here.
7499 if (stat->version >= RX_DEBUGI_VERSION_W_SECSTATS) {
7500 *supportedValues |= RX_SERVER_DEBUG_SEC_STATS;
7502 if (stat->version >= RX_DEBUGI_VERSION_W_GETALLCONN) {
7503 *supportedValues |= RX_SERVER_DEBUG_ALL_CONN;
7505 if (stat->version >= RX_DEBUGI_VERSION_W_RXSTATS) {
7506 *supportedValues |= RX_SERVER_DEBUG_RX_STATS;
7508 if (stat->version >= RX_DEBUGI_VERSION_W_WAITERS) {
7509 *supportedValues |= RX_SERVER_DEBUG_WAITER_CNT;
7511 if (stat->version >= RX_DEBUGI_VERSION_W_IDLETHREADS) {
7512 *supportedValues |= RX_SERVER_DEBUG_IDLE_THREADS;
7514 if (stat->version >= RX_DEBUGI_VERSION_W_NEWPACKETTYPES) {
7515 *supportedValues |= RX_SERVER_DEBUG_NEW_PACKETS;
7517 if (stat->version >= RX_DEBUGI_VERSION_W_GETPEER) {
7518 *supportedValues |= RX_SERVER_DEBUG_ALL_PEER;
7520 if (stat->version >= RX_DEBUGI_VERSION_W_WAITED) {
7521 *supportedValues |= RX_SERVER_DEBUG_WAITED_CNT;
7523 if (stat->version >= RX_DEBUGI_VERSION_W_PACKETS) {
7524 *supportedValues |= RX_SERVER_DEBUG_PACKETS_CNT;
7526 stat->nFreePackets = ntohl(stat->nFreePackets);
7527 stat->packetReclaims = ntohl(stat->packetReclaims);
7528 stat->callsExecuted = ntohl(stat->callsExecuted);
7529 stat->nWaiting = ntohl(stat->nWaiting);
7530 stat->idleThreads = ntohl(stat->idleThreads);
7531 stat->nWaited = ntohl(stat->nWaited);
7532 stat->nPackets = ntohl(stat->nPackets);
7541 rx_GetServerStats(osi_socket socket, afs_uint32 remoteAddr,
7542 afs_uint16 remotePort, struct rx_statistics * stat,
7543 afs_uint32 * supportedValues)
7545 #if defined(RXDEBUG) || defined(MAKEDEBUGCALL)
7547 struct rx_debugIn in;
7548 afs_int32 *lp = (afs_int32 *) stat;
7552 * supportedValues is currently unused, but added to allow future
7553 * versioning of this function.
7556 *supportedValues = 0;
7557 in.type = htonl(RX_DEBUGI_RXSTATS);
7559 memset(stat, 0, sizeof(*stat));
7561 rc = MakeDebugCall(socket, remoteAddr, remotePort, RX_PACKET_TYPE_DEBUG,
7562 &in, sizeof(in), stat, sizeof(*stat));
7567 * Do net to host conversion here
7570 for (i = 0; i < sizeof(*stat) / sizeof(afs_int32); i++, lp++) {
7581 rx_GetServerVersion(osi_socket socket, afs_uint32 remoteAddr,
7582 afs_uint16 remotePort, size_t version_length,
7585 #if defined(RXDEBUG) || defined(MAKEDEBUGCALL)
7587 return MakeDebugCall(socket, remoteAddr, remotePort,
7588 RX_PACKET_TYPE_VERSION, a, 1, version,
7596 rx_GetServerConnections(osi_socket socket, afs_uint32 remoteAddr,
7597 afs_uint16 remotePort, afs_int32 * nextConnection,
7598 int allConnections, afs_uint32 debugSupportedValues,
7599 struct rx_debugConn * conn,
7600 afs_uint32 * supportedValues)
7602 #if defined(RXDEBUG) || defined(MAKEDEBUGCALL)
7604 struct rx_debugIn in;
7608 * supportedValues is currently unused, but added to allow future
7609 * versioning of this function.
7612 *supportedValues = 0;
7613 if (allConnections) {
7614 in.type = htonl(RX_DEBUGI_GETALLCONN);
7616 in.type = htonl(RX_DEBUGI_GETCONN);
7618 in.index = htonl(*nextConnection);
7619 memset(conn, 0, sizeof(*conn));
7621 rc = MakeDebugCall(socket, remoteAddr, remotePort, RX_PACKET_TYPE_DEBUG,
7622 &in, sizeof(in), conn, sizeof(*conn));
7625 *nextConnection += 1;
7628 * Convert old connection format to new structure.
7631 if (debugSupportedValues & RX_SERVER_DEBUG_OLD_CONN) {
7632 struct rx_debugConn_vL *vL = (struct rx_debugConn_vL *)conn;
7633 #define MOVEvL(a) (conn->a = vL->a)
7635 /* any old or unrecognized version... */
7636 for (i = 0; i < RX_MAXCALLS; i++) {
7637 MOVEvL(callState[i]);
7638 MOVEvL(callMode[i]);
7639 MOVEvL(callFlags[i]);
7640 MOVEvL(callOther[i]);
7642 if (debugSupportedValues & RX_SERVER_DEBUG_SEC_STATS) {
7643 MOVEvL(secStats.type);
7644 MOVEvL(secStats.level);
7645 MOVEvL(secStats.flags);
7646 MOVEvL(secStats.expires);
7647 MOVEvL(secStats.packetsReceived);
7648 MOVEvL(secStats.packetsSent);
7649 MOVEvL(secStats.bytesReceived);
7650 MOVEvL(secStats.bytesSent);
7655 * Do net to host conversion here
7657 * I don't convert host or port since we are most likely
7658 * going to want these in NBO.
7660 conn->cid = ntohl(conn->cid);
7661 conn->serial = ntohl(conn->serial);
7662 for (i = 0; i < RX_MAXCALLS; i++) {
7663 conn->callNumber[i] = ntohl(conn->callNumber[i]);
7665 conn->error = ntohl(conn->error);
7666 conn->secStats.flags = ntohl(conn->secStats.flags);
7667 conn->secStats.expires = ntohl(conn->secStats.expires);
7668 conn->secStats.packetsReceived =
7669 ntohl(conn->secStats.packetsReceived);
7670 conn->secStats.packetsSent = ntohl(conn->secStats.packetsSent);
7671 conn->secStats.bytesReceived = ntohl(conn->secStats.bytesReceived);
7672 conn->secStats.bytesSent = ntohl(conn->secStats.bytesSent);
7673 conn->epoch = ntohl(conn->epoch);
7674 conn->natMTU = ntohl(conn->natMTU);
7683 rx_GetServerPeers(osi_socket socket, afs_uint32 remoteAddr,
7684 afs_uint16 remotePort, afs_int32 * nextPeer,
7685 afs_uint32 debugSupportedValues, struct rx_debugPeer * peer,
7686 afs_uint32 * supportedValues)
7688 #if defined(RXDEBUG) || defined(MAKEDEBUGCALL)
7690 struct rx_debugIn in;
7693 * supportedValues is currently unused, but added to allow future
7694 * versioning of this function.
7697 *supportedValues = 0;
7698 in.type = htonl(RX_DEBUGI_GETPEER);
7699 in.index = htonl(*nextPeer);
7700 memset(peer, 0, sizeof(*peer));
7702 rc = MakeDebugCall(socket, remoteAddr, remotePort, RX_PACKET_TYPE_DEBUG,
7703 &in, sizeof(in), peer, sizeof(*peer));
7709 * Do net to host conversion here
7711 * I don't convert host or port since we are most likely
7712 * going to want these in NBO.
7714 peer->ifMTU = ntohs(peer->ifMTU);
7715 peer->idleWhen = ntohl(peer->idleWhen);
7716 peer->refCount = ntohs(peer->refCount);
7717 peer->rtt = ntohl(peer->rtt);
7718 peer->rtt_dev = ntohl(peer->rtt_dev);
7719 peer->timeout.sec = 0;
7720 peer->timeout.usec = 0;
7721 peer->nSent = ntohl(peer->nSent);
7722 peer->reSends = ntohl(peer->reSends);
7723 peer->natMTU = ntohs(peer->natMTU);
7724 peer->maxMTU = ntohs(peer->maxMTU);
7725 peer->maxDgramPackets = ntohs(peer->maxDgramPackets);
7726 peer->ifDgramPackets = ntohs(peer->ifDgramPackets);
7727 peer->MTU = ntohs(peer->MTU);
7728 peer->cwind = ntohs(peer->cwind);
7729 peer->nDgramPackets = ntohs(peer->nDgramPackets);
7730 peer->congestSeq = ntohs(peer->congestSeq);
7731 peer->bytesSent.high = ntohl(peer->bytesSent.high);
7732 peer->bytesSent.low = ntohl(peer->bytesSent.low);
7733 peer->bytesReceived.high = ntohl(peer->bytesReceived.high);
7734 peer->bytesReceived.low = ntohl(peer->bytesReceived.low);
7743 rx_GetLocalPeers(afs_uint32 peerHost, afs_uint16 peerPort,
7744 struct rx_debugPeer * peerStats)
7747 afs_int32 error = 1; /* default to "did not succeed" */
7748 afs_uint32 hashValue = PEER_HASH(peerHost, peerPort);
7750 MUTEX_ENTER(&rx_peerHashTable_lock);
7751 for(tp = rx_peerHashTable[hashValue];
7752 tp != NULL; tp = tp->next) {
7753 if (tp->host == peerHost)
7759 MUTEX_EXIT(&rx_peerHashTable_lock);
7763 MUTEX_ENTER(&tp->peer_lock);
7764 peerStats->host = tp->host;
7765 peerStats->port = tp->port;
7766 peerStats->ifMTU = tp->ifMTU;
7767 peerStats->idleWhen = tp->idleWhen;
7768 peerStats->refCount = tp->refCount;
7769 peerStats->burstSize = 0;
7770 peerStats->burst = 0;
7771 peerStats->burstWait.sec = 0;
7772 peerStats->burstWait.usec = 0;
7773 peerStats->rtt = tp->rtt;
7774 peerStats->rtt_dev = tp->rtt_dev;
7775 peerStats->timeout.sec = 0;
7776 peerStats->timeout.usec = 0;
7777 peerStats->nSent = tp->nSent;
7778 peerStats->reSends = tp->reSends;
7779 peerStats->natMTU = tp->natMTU;
7780 peerStats->maxMTU = tp->maxMTU;
7781 peerStats->maxDgramPackets = tp->maxDgramPackets;
7782 peerStats->ifDgramPackets = tp->ifDgramPackets;
7783 peerStats->MTU = tp->MTU;
7784 peerStats->cwind = tp->cwind;
7785 peerStats->nDgramPackets = tp->nDgramPackets;
7786 peerStats->congestSeq = tp->congestSeq;
7787 peerStats->bytesSent.high = tp->bytesSent >> 32;
7788 peerStats->bytesSent.low = tp->bytesSent & MAX_AFS_UINT32;
7789 peerStats->bytesReceived.high = tp->bytesReceived >> 32;
7790 peerStats->bytesReceived.low
7791 = tp->bytesReceived & MAX_AFS_UINT32;
7792 MUTEX_EXIT(&tp->peer_lock);
7794 MUTEX_ENTER(&rx_peerHashTable_lock);
7797 MUTEX_EXIT(&rx_peerHashTable_lock);
7805 struct rx_serverQueueEntry *np;
7808 struct rx_call *call;
7809 struct rx_serverQueueEntry *sq;
7812 if (rx_atomic_test_and_set_bit(&rxinit_status, 0))
7813 return; /* Already shutdown. */
7817 #ifndef AFS_PTHREAD_ENV
7818 FD_ZERO(&rx_selectMask);
7819 #endif /* AFS_PTHREAD_ENV */
7820 rxi_dataQuota = RX_MAX_QUOTA;
7821 #ifndef AFS_PTHREAD_ENV
7823 #endif /* AFS_PTHREAD_ENV */
7826 #ifndef AFS_PTHREAD_ENV
7827 #ifndef AFS_USE_GETTIMEOFDAY
7829 #endif /* AFS_USE_GETTIMEOFDAY */
7830 #endif /* AFS_PTHREAD_ENV */
7832 while (!opr_queue_IsEmpty(&rx_freeCallQueue)) {
7833 call = opr_queue_First(&rx_freeCallQueue, struct rx_call, entry);
7834 opr_queue_Remove(&call->entry);
7835 rxi_Free(call, sizeof(struct rx_call));
7838 while (!opr_queue_IsEmpty(&rx_idleServerQueue)) {
7839 sq = opr_queue_First(&rx_idleServerQueue, struct rx_serverQueueEntry,
7841 opr_queue_Remove(&sq->entry);
7846 struct rx_peer **peer_ptr, **peer_end;
7847 for (peer_ptr = &rx_peerHashTable[0], peer_end =
7848 &rx_peerHashTable[rx_hashTableSize]; peer_ptr < peer_end;
7850 struct rx_peer *peer, *next;
7852 MUTEX_ENTER(&rx_peerHashTable_lock);
7853 for (peer = *peer_ptr; peer; peer = next) {
7854 struct opr_queue *cursor, *store;
7857 MUTEX_ENTER(&rx_rpc_stats);
7858 MUTEX_ENTER(&peer->peer_lock);
7859 for (opr_queue_ScanSafe(&peer->rpcStats, cursor, store)) {
7860 unsigned int num_funcs;
7861 struct rx_interface_stat *rpc_stat
7862 = opr_queue_Entry(cursor, struct rx_interface_stat,
7866 opr_queue_Remove(&rpc_stat->entry);
7867 opr_queue_Remove(&rpc_stat->entryPeers);
7868 num_funcs = rpc_stat->stats[0].func_total;
7870 sizeof(rx_interface_stat_t) +
7871 rpc_stat->stats[0].func_total *
7872 sizeof(rx_function_entry_v1_t);
7874 rxi_Free(rpc_stat, space);
7876 /* rx_rpc_stats must be held */
7877 rxi_rpc_peer_stat_cnt -= num_funcs;
7879 MUTEX_EXIT(&peer->peer_lock);
7880 MUTEX_EXIT(&rx_rpc_stats);
7884 if (rx_stats_active)
7885 rx_atomic_dec(&rx_stats.nPeerStructs);
7887 MUTEX_EXIT(&rx_peerHashTable_lock);
7890 for (i = 0; i < RX_MAX_SERVICES; i++) {
7892 rxi_Free(rx_services[i], sizeof(*rx_services[i]));
7894 for (i = 0; i < rx_hashTableSize; i++) {
7895 struct rx_connection *tc, *ntc;
7896 MUTEX_ENTER(&rx_connHashTable_lock);
7897 for (tc = rx_connHashTable[i]; tc; tc = ntc) {
7899 for (j = 0; j < RX_MAXCALLS; j++) {
7901 rxi_Free(tc->call[j], sizeof(*tc->call[j]));
7904 rxi_Free(tc, sizeof(*tc));
7906 MUTEX_EXIT(&rx_connHashTable_lock);
7909 MUTEX_ENTER(&freeSQEList_lock);
7911 while ((np = rx_FreeSQEList)) {
7912 rx_FreeSQEList = *(struct rx_serverQueueEntry **)np;
7913 MUTEX_DESTROY(&np->lock);
7914 rxi_Free(np, sizeof(*np));
7917 MUTEX_EXIT(&freeSQEList_lock);
7918 MUTEX_DESTROY(&freeSQEList_lock);
7919 MUTEX_DESTROY(&rx_freeCallQueue_lock);
7920 MUTEX_DESTROY(&rx_connHashTable_lock);
7921 MUTEX_DESTROY(&rx_peerHashTable_lock);
7922 MUTEX_DESTROY(&rx_serverPool_lock);
7924 osi_Free(rx_connHashTable,
7925 rx_hashTableSize * sizeof(struct rx_connection *));
7926 osi_Free(rx_peerHashTable, rx_hashTableSize * sizeof(struct rx_peer *));
7928 UNPIN(rx_connHashTable,
7929 rx_hashTableSize * sizeof(struct rx_connection *));
7930 UNPIN(rx_peerHashTable, rx_hashTableSize * sizeof(struct rx_peer *));
7932 MUTEX_ENTER(&rx_quota_mutex);
7933 rxi_dataQuota = RX_MAX_QUOTA;
7934 rxi_availProcs = rxi_totalMin = rxi_minDeficit = 0;
7935 MUTEX_EXIT(&rx_quota_mutex);
7941 * Routines to implement connection specific data.
7945 rx_KeyCreate(rx_destructor_t rtn)
7948 MUTEX_ENTER(&rxi_keyCreate_lock);
7949 key = rxi_keyCreate_counter++;
7950 rxi_keyCreate_destructor = (rx_destructor_t *)
7951 realloc((void *)rxi_keyCreate_destructor,
7952 (key + 1) * sizeof(rx_destructor_t));
7953 rxi_keyCreate_destructor[key] = rtn;
7954 MUTEX_EXIT(&rxi_keyCreate_lock);
7959 rx_SetSpecific(struct rx_connection *conn, int key, void *ptr)
7962 MUTEX_ENTER(&conn->conn_data_lock);
7963 if (!conn->specific) {
7964 conn->specific = malloc((key + 1) * sizeof(void *));
7965 for (i = 0; i < key; i++)
7966 conn->specific[i] = NULL;
7967 conn->nSpecific = key + 1;
7968 conn->specific[key] = ptr;
7969 } else if (key >= conn->nSpecific) {
7970 conn->specific = (void **)
7971 realloc(conn->specific, (key + 1) * sizeof(void *));
7972 for (i = conn->nSpecific; i < key; i++)
7973 conn->specific[i] = NULL;
7974 conn->nSpecific = key + 1;
7975 conn->specific[key] = ptr;
7977 if (conn->specific[key] && rxi_keyCreate_destructor[key])
7978 (*rxi_keyCreate_destructor[key]) (conn->specific[key]);
7979 conn->specific[key] = ptr;
7981 MUTEX_EXIT(&conn->conn_data_lock);
7985 rx_SetServiceSpecific(struct rx_service *svc, int key, void *ptr)
7988 MUTEX_ENTER(&svc->svc_data_lock);
7989 if (!svc->specific) {
7990 svc->specific = malloc((key + 1) * sizeof(void *));
7991 for (i = 0; i < key; i++)
7992 svc->specific[i] = NULL;
7993 svc->nSpecific = key + 1;
7994 svc->specific[key] = ptr;
7995 } else if (key >= svc->nSpecific) {
7996 svc->specific = (void **)
7997 realloc(svc->specific, (key + 1) * sizeof(void *));
7998 for (i = svc->nSpecific; i < key; i++)
7999 svc->specific[i] = NULL;
8000 svc->nSpecific = key + 1;
8001 svc->specific[key] = ptr;
8003 if (svc->specific[key] && rxi_keyCreate_destructor[key])
8004 (*rxi_keyCreate_destructor[key]) (svc->specific[key]);
8005 svc->specific[key] = ptr;
8007 MUTEX_EXIT(&svc->svc_data_lock);
8011 rx_GetSpecific(struct rx_connection *conn, int key)
8014 MUTEX_ENTER(&conn->conn_data_lock);
8015 if (key >= conn->nSpecific)
8018 ptr = conn->specific[key];
8019 MUTEX_EXIT(&conn->conn_data_lock);
8024 rx_GetServiceSpecific(struct rx_service *svc, int key)
8027 MUTEX_ENTER(&svc->svc_data_lock);
8028 if (key >= svc->nSpecific)
8031 ptr = svc->specific[key];
8032 MUTEX_EXIT(&svc->svc_data_lock);
8037 #endif /* !KERNEL */
8040 * processStats is a queue used to store the statistics for the local
8041 * process. Its contents are similar to the contents of the rpcStats
8042 * queue on a rx_peer structure, but the actual data stored within
8043 * this queue contains totals across the lifetime of the process (assuming
8044 * the stats have not been reset) - unlike the per peer structures
8045 * which can come and go based upon the peer lifetime.
8048 static struct opr_queue processStats = { &processStats, &processStats };
8051 * peerStats is a queue used to store the statistics for all peer structs.
8052 * Its contents are the union of all the peer rpcStats queues.
8055 static struct opr_queue peerStats = { &peerStats, &peerStats };
8058 * rxi_monitor_processStats is used to turn process wide stat collection
8062 static int rxi_monitor_processStats = 0;
8065 * rxi_monitor_peerStats is used to turn per peer stat collection on and off
8068 static int rxi_monitor_peerStats = 0;
8072 rxi_ClearRPCOpStat(rx_function_entry_v1_p rpc_stat)
8074 rpc_stat->invocations = 0;
8075 rpc_stat->bytes_sent = 0;
8076 rpc_stat->bytes_rcvd = 0;
8077 rpc_stat->queue_time_sum.sec = 0;
8078 rpc_stat->queue_time_sum.usec = 0;
8079 rpc_stat->queue_time_sum_sqr.sec = 0;
8080 rpc_stat->queue_time_sum_sqr.usec = 0;
8081 rpc_stat->queue_time_min.sec = 9999999;
8082 rpc_stat->queue_time_min.usec = 9999999;
8083 rpc_stat->queue_time_max.sec = 0;
8084 rpc_stat->queue_time_max.usec = 0;
8085 rpc_stat->execution_time_sum.sec = 0;
8086 rpc_stat->execution_time_sum.usec = 0;
8087 rpc_stat->execution_time_sum_sqr.sec = 0;
8088 rpc_stat->execution_time_sum_sqr.usec = 0;
8089 rpc_stat->execution_time_min.sec = 9999999;
8090 rpc_stat->execution_time_min.usec = 9999999;
8091 rpc_stat->execution_time_max.sec = 0;
8092 rpc_stat->execution_time_max.usec = 0;
8096 * Given all of the information for a particular rpc
8097 * call, find or create (if requested) the stat structure for the rpc.
8100 * the queue of stats that will be updated with the new value
8102 * @param rxInterface
8103 * a unique number that identifies the rpc interface
8106 * the total number of functions in this interface. this is only
8107 * required if create is true
8110 * if true, this invocation was made to a server
8113 * the ip address of the remote host. this is only required if create
8114 * and addToPeerList are true
8117 * the port of the remote host. this is only required if create
8118 * and addToPeerList are true
8120 * @param addToPeerList
8121 * if != 0, add newly created stat to the global peer list
8124 * if a new stats structure is allocated, the counter will
8125 * be updated with the new number of allocated stat structures.
8126 * only required if create is true
8129 * if no stats structure exists, allocate one
8133 static rx_interface_stat_p
8134 rxi_FindRpcStat(struct opr_queue *stats, afs_uint32 rxInterface,
8135 afs_uint32 totalFunc, int isServer, afs_uint32 remoteHost,
8136 afs_uint32 remotePort, int addToPeerList,
8137 unsigned int *counter, int create)
8139 rx_interface_stat_p rpc_stat = NULL;
8140 struct opr_queue *cursor;
8143 * See if there's already a structure for this interface
8146 for (opr_queue_Scan(stats, cursor)) {
8147 rpc_stat = opr_queue_Entry(cursor, struct rx_interface_stat, entry);
8149 if ((rpc_stat->stats[0].interfaceId == rxInterface)
8150 && (rpc_stat->stats[0].remote_is_server == isServer))
8154 /* if they didn't ask us to create, we're done */
8156 if (opr_queue_IsEnd(stats, cursor))
8162 /* can't proceed without these */
8163 if (!totalFunc || !counter)
8167 * Didn't find a match so allocate a new structure and add it to the
8171 if (opr_queue_IsEnd(stats, cursor) || (rpc_stat == NULL)
8172 || (rpc_stat->stats[0].interfaceId != rxInterface)
8173 || (rpc_stat->stats[0].remote_is_server != isServer)) {
8178 sizeof(rx_interface_stat_t) +
8179 totalFunc * sizeof(rx_function_entry_v1_t);
8181 rpc_stat = rxi_Alloc(space);
8182 if (rpc_stat == NULL)
8185 *counter += totalFunc;
8186 for (i = 0; i < totalFunc; i++) {
8187 rxi_ClearRPCOpStat(&(rpc_stat->stats[i]));
8188 rpc_stat->stats[i].remote_peer = remoteHost;
8189 rpc_stat->stats[i].remote_port = remotePort;
8190 rpc_stat->stats[i].remote_is_server = isServer;
8191 rpc_stat->stats[i].interfaceId = rxInterface;
8192 rpc_stat->stats[i].func_total = totalFunc;
8193 rpc_stat->stats[i].func_index = i;
8195 opr_queue_Prepend(stats, &rpc_stat->entry);
8196 if (addToPeerList) {
8197 opr_queue_Prepend(&peerStats, &rpc_stat->entryPeers);
8204 rx_ClearProcessRPCStats(afs_int32 rxInterface)
8206 rx_interface_stat_p rpc_stat;
8209 if (rxInterface == -1)
8212 MUTEX_ENTER(&rx_rpc_stats);
8213 rpc_stat = rxi_FindRpcStat(&processStats, rxInterface, 0, 0,
8216 totalFunc = rpc_stat->stats[0].func_total;
8217 for (i = 0; i < totalFunc; i++)
8218 rxi_ClearRPCOpStat(&(rpc_stat->stats[i]));
8220 MUTEX_EXIT(&rx_rpc_stats);
8225 rx_ClearPeerRPCStats(afs_int32 rxInterface, afs_uint32 peerHost, afs_uint16 peerPort)
8227 rx_interface_stat_p rpc_stat;
8229 struct rx_peer * peer;
8231 if (rxInterface == -1)
8234 peer = rxi_FindPeer(peerHost, peerPort, 0);
8238 MUTEX_ENTER(&rx_rpc_stats);
8239 rpc_stat = rxi_FindRpcStat(&peer->rpcStats, rxInterface, 0, 1,
8242 totalFunc = rpc_stat->stats[0].func_total;
8243 for (i = 0; i < totalFunc; i++)
8244 rxi_ClearRPCOpStat(&(rpc_stat->stats[i]));
8246 MUTEX_EXIT(&rx_rpc_stats);
8251 rx_CopyProcessRPCStats(afs_uint64 op)
8253 rx_interface_stat_p rpc_stat;
8254 rx_function_entry_v1_p rpcop_stat =
8255 rxi_Alloc(sizeof(rx_function_entry_v1_t));
8256 int currentFunc = (op & MAX_AFS_UINT32);
8257 afs_int32 rxInterface = (op >> 32);
8259 if (!rxi_monitor_processStats)
8262 if (rxInterface == -1)
8265 if (rpcop_stat == NULL)
8268 MUTEX_ENTER(&rx_rpc_stats);
8269 rpc_stat = rxi_FindRpcStat(&processStats, rxInterface, 0, 0,
8272 memcpy(rpcop_stat, &(rpc_stat->stats[currentFunc]),
8273 sizeof(rx_function_entry_v1_t));
8274 MUTEX_EXIT(&rx_rpc_stats);
8276 rxi_Free(rpcop_stat, sizeof(rx_function_entry_v1_t));
8283 rx_CopyPeerRPCStats(afs_uint64 op, afs_uint32 peerHost, afs_uint16 peerPort)
8285 rx_interface_stat_p rpc_stat;
8286 rx_function_entry_v1_p rpcop_stat =
8287 rxi_Alloc(sizeof(rx_function_entry_v1_t));
8288 int currentFunc = (op & MAX_AFS_UINT32);
8289 afs_int32 rxInterface = (op >> 32);
8290 struct rx_peer *peer;
8292 if (!rxi_monitor_peerStats)
8295 if (rxInterface == -1)
8298 if (rpcop_stat == NULL)
8301 peer = rxi_FindPeer(peerHost, peerPort, 0);
8305 MUTEX_ENTER(&rx_rpc_stats);
8306 rpc_stat = rxi_FindRpcStat(&peer->rpcStats, rxInterface, 0, 1,
8309 memcpy(rpcop_stat, &(rpc_stat->stats[currentFunc]),
8310 sizeof(rx_function_entry_v1_t));
8311 MUTEX_EXIT(&rx_rpc_stats);
8313 rxi_Free(rpcop_stat, sizeof(rx_function_entry_v1_t));
8320 rx_ReleaseRPCStats(void *stats)
8323 rxi_Free(stats, sizeof(rx_function_entry_v1_t));
8327 * Given all of the information for a particular rpc
8328 * call, create (if needed) and update the stat totals for the rpc.
8331 * the queue of stats that will be updated with the new value
8333 * @param rxInterface
8334 * a unique number that identifies the rpc interface
8336 * @param currentFunc
8337 * the index of the function being invoked
8340 * the total number of functions in this interface
8343 * the amount of time this function waited for a thread
8346 * the amount of time this function invocation took to execute
8349 * the number bytes sent by this invocation
8352 * the number bytes received by this invocation
8355 * if true, this invocation was made to a server
8358 * the ip address of the remote host
8361 * the port of the remote host
8363 * @param addToPeerList
8364 * if != 0, add newly created stat to the global peer list
8367 * if a new stats structure is allocated, the counter will
8368 * be updated with the new number of allocated stat structures
8373 rxi_AddRpcStat(struct opr_queue *stats, afs_uint32 rxInterface,
8374 afs_uint32 currentFunc, afs_uint32 totalFunc,
8375 struct clock *queueTime, struct clock *execTime,
8376 afs_uint64 bytesSent, afs_uint64 bytesRcvd, int isServer,
8377 afs_uint32 remoteHost, afs_uint32 remotePort,
8378 int addToPeerList, unsigned int *counter)
8381 rx_interface_stat_p rpc_stat;
8383 rpc_stat = rxi_FindRpcStat(stats, rxInterface, totalFunc, isServer,
8384 remoteHost, remotePort, addToPeerList, counter,
8392 * Increment the stats for this function
8395 rpc_stat->stats[currentFunc].invocations++;
8396 rpc_stat->stats[currentFunc].bytes_sent += bytesSent;
8397 rpc_stat->stats[currentFunc].bytes_rcvd += bytesRcvd;
8398 clock_Add(&rpc_stat->stats[currentFunc].queue_time_sum, queueTime);
8399 clock_AddSq(&rpc_stat->stats[currentFunc].queue_time_sum_sqr, queueTime);
8400 if (clock_Lt(queueTime, &rpc_stat->stats[currentFunc].queue_time_min)) {
8401 rpc_stat->stats[currentFunc].queue_time_min = *queueTime;
8403 if (clock_Gt(queueTime, &rpc_stat->stats[currentFunc].queue_time_max)) {
8404 rpc_stat->stats[currentFunc].queue_time_max = *queueTime;
8406 clock_Add(&rpc_stat->stats[currentFunc].execution_time_sum, execTime);
8407 clock_AddSq(&rpc_stat->stats[currentFunc].execution_time_sum_sqr,
8409 if (clock_Lt(execTime, &rpc_stat->stats[currentFunc].execution_time_min)) {
8410 rpc_stat->stats[currentFunc].execution_time_min = *execTime;
8412 if (clock_Gt(execTime, &rpc_stat->stats[currentFunc].execution_time_max)) {
8413 rpc_stat->stats[currentFunc].execution_time_max = *execTime;
8421 rxi_IncrementTimeAndCount(struct rx_peer *peer, afs_uint32 rxInterface,
8422 afs_uint32 currentFunc, afs_uint32 totalFunc,
8423 struct clock *queueTime, struct clock *execTime,
8424 afs_uint64 bytesSent, afs_uint64 bytesRcvd,
8428 if (!(rxi_monitor_peerStats || rxi_monitor_processStats))
8431 MUTEX_ENTER(&rx_rpc_stats);
8433 if (rxi_monitor_peerStats) {
8434 MUTEX_ENTER(&peer->peer_lock);
8435 rxi_AddRpcStat(&peer->rpcStats, rxInterface, currentFunc, totalFunc,
8436 queueTime, execTime, bytesSent, bytesRcvd, isServer,
8437 peer->host, peer->port, 1, &rxi_rpc_peer_stat_cnt);
8438 MUTEX_EXIT(&peer->peer_lock);
8441 if (rxi_monitor_processStats) {
8442 rxi_AddRpcStat(&processStats, rxInterface, currentFunc, totalFunc,
8443 queueTime, execTime, bytesSent, bytesRcvd, isServer,
8444 0xffffffff, 0xffffffff, 0, &rxi_rpc_process_stat_cnt);
8447 MUTEX_EXIT(&rx_rpc_stats);
8451 * Increment the times and count for a particular rpc function.
8453 * Traditionally this call was invoked from rxgen stubs. Modern stubs
8454 * call rx_RecordCallStatistics instead, so the public version of this
8455 * function is left purely for legacy callers.
8458 * The peer who invoked the rpc
8460 * @param rxInterface
8461 * A unique number that identifies the rpc interface
8463 * @param currentFunc
8464 * The index of the function being invoked
8467 * The total number of functions in this interface
8470 * The amount of time this function waited for a thread
8473 * The amount of time this function invocation took to execute
8476 * The number bytes sent by this invocation
8479 * The number bytes received by this invocation
8482 * If true, this invocation was made to a server
8486 rx_IncrementTimeAndCount(struct rx_peer *peer, afs_uint32 rxInterface,
8487 afs_uint32 currentFunc, afs_uint32 totalFunc,
8488 struct clock *queueTime, struct clock *execTime,
8489 afs_hyper_t * bytesSent, afs_hyper_t * bytesRcvd,
8495 sent64 = ((afs_uint64)bytesSent->high << 32) + bytesSent->low;
8496 rcvd64 = ((afs_uint64)bytesRcvd->high << 32) + bytesRcvd->low;
8498 rxi_IncrementTimeAndCount(peer, rxInterface, currentFunc, totalFunc,
8499 queueTime, execTime, sent64, rcvd64,
8506 * rx_MarshallProcessRPCStats - marshall an array of rpc statistics
8510 * IN callerVersion - the rpc stat version of the caller.
8512 * IN count - the number of entries to marshall.
8514 * IN stats - pointer to stats to be marshalled.
8516 * OUT ptr - Where to store the marshalled data.
8523 rx_MarshallProcessRPCStats(afs_uint32 callerVersion, int count,
8524 rx_function_entry_v1_t * stats, afs_uint32 ** ptrP)
8530 * We only support the first version
8532 for (ptr = *ptrP, i = 0; i < count; i++, stats++) {
8533 *(ptr++) = stats->remote_peer;
8534 *(ptr++) = stats->remote_port;
8535 *(ptr++) = stats->remote_is_server;
8536 *(ptr++) = stats->interfaceId;
8537 *(ptr++) = stats->func_total;
8538 *(ptr++) = stats->func_index;
8539 *(ptr++) = stats->invocations >> 32;
8540 *(ptr++) = stats->invocations & MAX_AFS_UINT32;
8541 *(ptr++) = stats->bytes_sent >> 32;
8542 *(ptr++) = stats->bytes_sent & MAX_AFS_UINT32;
8543 *(ptr++) = stats->bytes_rcvd >> 32;
8544 *(ptr++) = stats->bytes_rcvd & MAX_AFS_UINT32;
8545 *(ptr++) = stats->queue_time_sum.sec;
8546 *(ptr++) = stats->queue_time_sum.usec;
8547 *(ptr++) = stats->queue_time_sum_sqr.sec;
8548 *(ptr++) = stats->queue_time_sum_sqr.usec;
8549 *(ptr++) = stats->queue_time_min.sec;
8550 *(ptr++) = stats->queue_time_min.usec;
8551 *(ptr++) = stats->queue_time_max.sec;
8552 *(ptr++) = stats->queue_time_max.usec;
8553 *(ptr++) = stats->execution_time_sum.sec;
8554 *(ptr++) = stats->execution_time_sum.usec;
8555 *(ptr++) = stats->execution_time_sum_sqr.sec;
8556 *(ptr++) = stats->execution_time_sum_sqr.usec;
8557 *(ptr++) = stats->execution_time_min.sec;
8558 *(ptr++) = stats->execution_time_min.usec;
8559 *(ptr++) = stats->execution_time_max.sec;
8560 *(ptr++) = stats->execution_time_max.usec;
8566 * rx_RetrieveProcessRPCStats - retrieve all of the rpc statistics for
8571 * IN callerVersion - the rpc stat version of the caller
8573 * OUT myVersion - the rpc stat version of this function
8575 * OUT clock_sec - local time seconds
8577 * OUT clock_usec - local time microseconds
8579 * OUT allocSize - the number of bytes allocated to contain stats
8581 * OUT statCount - the number stats retrieved from this process.
8583 * OUT stats - the actual stats retrieved from this process.
8587 * Returns void. If successful, stats will != NULL.
8591 rx_RetrieveProcessRPCStats(afs_uint32 callerVersion, afs_uint32 * myVersion,
8592 afs_uint32 * clock_sec, afs_uint32 * clock_usec,
8593 size_t * allocSize, afs_uint32 * statCount,
8594 afs_uint32 ** stats)
8604 *myVersion = RX_STATS_RETRIEVAL_VERSION;
8607 * Check to see if stats are enabled
8610 MUTEX_ENTER(&rx_rpc_stats);
8611 if (!rxi_monitor_processStats) {
8612 MUTEX_EXIT(&rx_rpc_stats);
8616 clock_GetTime(&now);
8617 *clock_sec = now.sec;
8618 *clock_usec = now.usec;
8621 * Allocate the space based upon the caller version
8623 * If the client is at an older version than we are,
8624 * we return the statistic data in the older data format, but
8625 * we still return our version number so the client knows we
8626 * are maintaining more data than it can retrieve.
8629 if (callerVersion >= RX_STATS_RETRIEVAL_FIRST_EDITION) {
8630 space = rxi_rpc_process_stat_cnt * sizeof(rx_function_entry_v1_t);
8631 *statCount = rxi_rpc_process_stat_cnt;
8634 * This can't happen yet, but in the future version changes
8635 * can be handled by adding additional code here
8639 if (space > (size_t) 0) {
8641 ptr = *stats = rxi_Alloc(space);
8644 struct opr_queue *cursor;
8646 for (opr_queue_Scan(&processStats, cursor)) {
8647 struct rx_interface_stat *rpc_stat =
8648 opr_queue_Entry(cursor, struct rx_interface_stat, entry);
8650 * Copy the data based upon the caller version
8652 rx_MarshallProcessRPCStats(callerVersion,
8653 rpc_stat->stats[0].func_total,
8654 rpc_stat->stats, &ptr);
8660 MUTEX_EXIT(&rx_rpc_stats);
8665 * rx_RetrievePeerRPCStats - retrieve all of the rpc statistics for the peers
8669 * IN callerVersion - the rpc stat version of the caller
8671 * OUT myVersion - the rpc stat version of this function
8673 * OUT clock_sec - local time seconds
8675 * OUT clock_usec - local time microseconds
8677 * OUT allocSize - the number of bytes allocated to contain stats
8679 * OUT statCount - the number of stats retrieved from the individual
8682 * OUT stats - the actual stats retrieved from the individual peer structures.
8686 * Returns void. If successful, stats will != NULL.
8690 rx_RetrievePeerRPCStats(afs_uint32 callerVersion, afs_uint32 * myVersion,
8691 afs_uint32 * clock_sec, afs_uint32 * clock_usec,
8692 size_t * allocSize, afs_uint32 * statCount,
8693 afs_uint32 ** stats)
8703 *myVersion = RX_STATS_RETRIEVAL_VERSION;
8706 * Check to see if stats are enabled
8709 MUTEX_ENTER(&rx_rpc_stats);
8710 if (!rxi_monitor_peerStats) {
8711 MUTEX_EXIT(&rx_rpc_stats);
8715 clock_GetTime(&now);
8716 *clock_sec = now.sec;
8717 *clock_usec = now.usec;
8720 * Allocate the space based upon the caller version
8722 * If the client is at an older version than we are,
8723 * we return the statistic data in the older data format, but
8724 * we still return our version number so the client knows we
8725 * are maintaining more data than it can retrieve.
8728 if (callerVersion >= RX_STATS_RETRIEVAL_FIRST_EDITION) {
8729 space = rxi_rpc_peer_stat_cnt * sizeof(rx_function_entry_v1_t);
8730 *statCount = rxi_rpc_peer_stat_cnt;
8733 * This can't happen yet, but in the future version changes
8734 * can be handled by adding additional code here
8738 if (space > (size_t) 0) {
8740 ptr = *stats = rxi_Alloc(space);
8743 struct opr_queue *cursor;
8745 for (opr_queue_Scan(&peerStats, cursor)) {
8746 struct rx_interface_stat *rpc_stat
8747 = opr_queue_Entry(cursor, struct rx_interface_stat,
8751 * Copy the data based upon the caller version
8753 rx_MarshallProcessRPCStats(callerVersion,
8754 rpc_stat->stats[0].func_total,
8755 rpc_stat->stats, &ptr);
8761 MUTEX_EXIT(&rx_rpc_stats);
8766 * rx_FreeRPCStats - free memory allocated by
8767 * rx_RetrieveProcessRPCStats and rx_RetrievePeerRPCStats
8771 * IN stats - stats previously returned by rx_RetrieveProcessRPCStats or
8772 * rx_RetrievePeerRPCStats
8774 * IN allocSize - the number of bytes in stats.
8782 rx_FreeRPCStats(afs_uint32 * stats, size_t allocSize)
8784 rxi_Free(stats, allocSize);
8788 * rx_queryProcessRPCStats - see if process rpc stat collection is
8789 * currently enabled.
8795 * Returns 0 if stats are not enabled != 0 otherwise
8799 rx_queryProcessRPCStats(void)
8802 MUTEX_ENTER(&rx_rpc_stats);
8803 rc = rxi_monitor_processStats;
8804 MUTEX_EXIT(&rx_rpc_stats);
8809 * rx_queryPeerRPCStats - see if peer stat collection is currently enabled.
8815 * Returns 0 if stats are not enabled != 0 otherwise
8819 rx_queryPeerRPCStats(void)
8822 MUTEX_ENTER(&rx_rpc_stats);
8823 rc = rxi_monitor_peerStats;
8824 MUTEX_EXIT(&rx_rpc_stats);
8829 * rx_enableProcessRPCStats - begin rpc stat collection for entire process
8839 rx_enableProcessRPCStats(void)
8841 MUTEX_ENTER(&rx_rpc_stats);
8842 rx_enable_stats = 1;
8843 rxi_monitor_processStats = 1;
8844 MUTEX_EXIT(&rx_rpc_stats);
8848 * rx_enablePeerRPCStats - begin rpc stat collection per peer structure
8858 rx_enablePeerRPCStats(void)
8860 MUTEX_ENTER(&rx_rpc_stats);
8861 rx_enable_stats = 1;
8862 rxi_monitor_peerStats = 1;
8863 MUTEX_EXIT(&rx_rpc_stats);
8867 * rx_disableProcessRPCStats - stop rpc stat collection for entire process
8877 rx_disableProcessRPCStats(void)
8879 struct opr_queue *cursor, *store;
8882 MUTEX_ENTER(&rx_rpc_stats);
8885 * Turn off process statistics and if peer stats is also off, turn
8889 rxi_monitor_processStats = 0;
8890 if (rxi_monitor_peerStats == 0) {
8891 rx_enable_stats = 0;
8894 for (opr_queue_ScanSafe(&processStats, cursor, store)) {
8895 unsigned int num_funcs = 0;
8896 struct rx_interface_stat *rpc_stat
8897 = opr_queue_Entry(cursor, struct rx_interface_stat, entry);
8899 opr_queue_Remove(&rpc_stat->entry);
8901 num_funcs = rpc_stat->stats[0].func_total;
8903 sizeof(rx_interface_stat_t) +
8904 rpc_stat->stats[0].func_total * sizeof(rx_function_entry_v1_t);
8906 rxi_Free(rpc_stat, space);
8907 rxi_rpc_process_stat_cnt -= num_funcs;
8909 MUTEX_EXIT(&rx_rpc_stats);
8913 * rx_disablePeerRPCStats - stop rpc stat collection for peers
8923 rx_disablePeerRPCStats(void)
8925 struct rx_peer **peer_ptr, **peer_end;
8929 * Turn off peer statistics and if process stats is also off, turn
8933 rxi_monitor_peerStats = 0;
8934 if (rxi_monitor_processStats == 0) {
8935 rx_enable_stats = 0;
8938 for (peer_ptr = &rx_peerHashTable[0], peer_end =
8939 &rx_peerHashTable[rx_hashTableSize]; peer_ptr < peer_end;
8941 struct rx_peer *peer, *next, *prev;
8943 MUTEX_ENTER(&rx_peerHashTable_lock);
8944 MUTEX_ENTER(&rx_rpc_stats);
8945 for (prev = peer = *peer_ptr; peer; peer = next) {
8947 code = MUTEX_TRYENTER(&peer->peer_lock);
8950 struct opr_queue *cursor, *store;
8952 if (prev == *peer_ptr) {
8963 MUTEX_EXIT(&rx_peerHashTable_lock);
8965 for (opr_queue_ScanSafe(&peer->rpcStats, cursor, store)) {
8966 unsigned int num_funcs = 0;
8967 struct rx_interface_stat *rpc_stat
8968 = opr_queue_Entry(cursor, struct rx_interface_stat,
8971 opr_queue_Remove(&rpc_stat->entry);
8972 opr_queue_Remove(&rpc_stat->entryPeers);
8973 num_funcs = rpc_stat->stats[0].func_total;
8975 sizeof(rx_interface_stat_t) +
8976 rpc_stat->stats[0].func_total *
8977 sizeof(rx_function_entry_v1_t);
8979 rxi_Free(rpc_stat, space);
8980 rxi_rpc_peer_stat_cnt -= num_funcs;
8982 MUTEX_EXIT(&peer->peer_lock);
8984 MUTEX_ENTER(&rx_peerHashTable_lock);
8994 MUTEX_EXIT(&rx_rpc_stats);
8995 MUTEX_EXIT(&rx_peerHashTable_lock);
9000 * rx_clearProcessRPCStats - clear the contents of the rpc stats according
9005 * IN clearFlag - flag indicating which stats to clear
9013 rx_clearProcessRPCStats(afs_uint32 clearFlag)
9015 struct opr_queue *cursor;
9017 MUTEX_ENTER(&rx_rpc_stats);
9019 for (opr_queue_Scan(&processStats, cursor)) {
9020 unsigned int num_funcs = 0, i;
9021 struct rx_interface_stat *rpc_stat
9022 = opr_queue_Entry(cursor, struct rx_interface_stat, entry);
9024 num_funcs = rpc_stat->stats[0].func_total;
9025 for (i = 0; i < num_funcs; i++) {
9026 if (clearFlag & AFS_RX_STATS_CLEAR_INVOCATIONS) {
9027 rpc_stat->stats[i].invocations = 0;
9029 if (clearFlag & AFS_RX_STATS_CLEAR_BYTES_SENT) {
9030 rpc_stat->stats[i].bytes_sent = 0;
9032 if (clearFlag & AFS_RX_STATS_CLEAR_BYTES_RCVD) {
9033 rpc_stat->stats[i].bytes_rcvd = 0;
9035 if (clearFlag & AFS_RX_STATS_CLEAR_QUEUE_TIME_SUM) {
9036 rpc_stat->stats[i].queue_time_sum.sec = 0;
9037 rpc_stat->stats[i].queue_time_sum.usec = 0;
9039 if (clearFlag & AFS_RX_STATS_CLEAR_QUEUE_TIME_SQUARE) {
9040 rpc_stat->stats[i].queue_time_sum_sqr.sec = 0;
9041 rpc_stat->stats[i].queue_time_sum_sqr.usec = 0;
9043 if (clearFlag & AFS_RX_STATS_CLEAR_QUEUE_TIME_MIN) {
9044 rpc_stat->stats[i].queue_time_min.sec = 9999999;
9045 rpc_stat->stats[i].queue_time_min.usec = 9999999;
9047 if (clearFlag & AFS_RX_STATS_CLEAR_QUEUE_TIME_MAX) {
9048 rpc_stat->stats[i].queue_time_max.sec = 0;
9049 rpc_stat->stats[i].queue_time_max.usec = 0;
9051 if (clearFlag & AFS_RX_STATS_CLEAR_EXEC_TIME_SUM) {
9052 rpc_stat->stats[i].execution_time_sum.sec = 0;
9053 rpc_stat->stats[i].execution_time_sum.usec = 0;
9055 if (clearFlag & AFS_RX_STATS_CLEAR_EXEC_TIME_SQUARE) {
9056 rpc_stat->stats[i].execution_time_sum_sqr.sec = 0;
9057 rpc_stat->stats[i].execution_time_sum_sqr.usec = 0;
9059 if (clearFlag & AFS_RX_STATS_CLEAR_EXEC_TIME_MIN) {
9060 rpc_stat->stats[i].execution_time_min.sec = 9999999;
9061 rpc_stat->stats[i].execution_time_min.usec = 9999999;
9063 if (clearFlag & AFS_RX_STATS_CLEAR_EXEC_TIME_MAX) {
9064 rpc_stat->stats[i].execution_time_max.sec = 0;
9065 rpc_stat->stats[i].execution_time_max.usec = 0;
9070 MUTEX_EXIT(&rx_rpc_stats);
9074 * rx_clearPeerRPCStats - clear the contents of the rpc stats according
9079 * IN clearFlag - flag indicating which stats to clear
9087 rx_clearPeerRPCStats(afs_uint32 clearFlag)
9089 struct opr_queue *cursor;
9091 MUTEX_ENTER(&rx_rpc_stats);
9093 for (opr_queue_Scan(&peerStats, cursor)) {
9094 unsigned int num_funcs, i;
9095 struct rx_interface_stat *rpc_stat
9096 = opr_queue_Entry(cursor, struct rx_interface_stat, entryPeers);
9098 num_funcs = rpc_stat->stats[0].func_total;
9099 for (i = 0; i < num_funcs; i++) {
9100 if (clearFlag & AFS_RX_STATS_CLEAR_INVOCATIONS) {
9101 rpc_stat->stats[i].invocations = 0;
9103 if (clearFlag & AFS_RX_STATS_CLEAR_BYTES_SENT) {
9104 rpc_stat->stats[i].bytes_sent = 0;
9106 if (clearFlag & AFS_RX_STATS_CLEAR_BYTES_RCVD) {
9107 rpc_stat->stats[i].bytes_rcvd = 0;
9109 if (clearFlag & AFS_RX_STATS_CLEAR_QUEUE_TIME_SUM) {
9110 rpc_stat->stats[i].queue_time_sum.sec = 0;
9111 rpc_stat->stats[i].queue_time_sum.usec = 0;
9113 if (clearFlag & AFS_RX_STATS_CLEAR_QUEUE_TIME_SQUARE) {
9114 rpc_stat->stats[i].queue_time_sum_sqr.sec = 0;
9115 rpc_stat->stats[i].queue_time_sum_sqr.usec = 0;
9117 if (clearFlag & AFS_RX_STATS_CLEAR_QUEUE_TIME_MIN) {
9118 rpc_stat->stats[i].queue_time_min.sec = 9999999;
9119 rpc_stat->stats[i].queue_time_min.usec = 9999999;
9121 if (clearFlag & AFS_RX_STATS_CLEAR_QUEUE_TIME_MAX) {
9122 rpc_stat->stats[i].queue_time_max.sec = 0;
9123 rpc_stat->stats[i].queue_time_max.usec = 0;
9125 if (clearFlag & AFS_RX_STATS_CLEAR_EXEC_TIME_SUM) {
9126 rpc_stat->stats[i].execution_time_sum.sec = 0;
9127 rpc_stat->stats[i].execution_time_sum.usec = 0;
9129 if (clearFlag & AFS_RX_STATS_CLEAR_EXEC_TIME_SQUARE) {
9130 rpc_stat->stats[i].execution_time_sum_sqr.sec = 0;
9131 rpc_stat->stats[i].execution_time_sum_sqr.usec = 0;
9133 if (clearFlag & AFS_RX_STATS_CLEAR_EXEC_TIME_MIN) {
9134 rpc_stat->stats[i].execution_time_min.sec = 9999999;
9135 rpc_stat->stats[i].execution_time_min.usec = 9999999;
9137 if (clearFlag & AFS_RX_STATS_CLEAR_EXEC_TIME_MAX) {
9138 rpc_stat->stats[i].execution_time_max.sec = 0;
9139 rpc_stat->stats[i].execution_time_max.usec = 0;
9144 MUTEX_EXIT(&rx_rpc_stats);
9148 * rxi_rxstat_userok points to a routine that returns 1 if the caller
9149 * is authorized to enable/disable/clear RX statistics.
9151 static int (*rxi_rxstat_userok) (struct rx_call * call) = NULL;
9154 rx_SetRxStatUserOk(int (*proc) (struct rx_call * call))
9156 rxi_rxstat_userok = proc;
9160 rx_RxStatUserOk(struct rx_call *call)
9162 if (!rxi_rxstat_userok)
9164 return rxi_rxstat_userok(call);
9169 * DllMain() -- Entry-point function called by the DllMainCRTStartup()
9170 * function in the MSVC runtime DLL (msvcrt.dll).
9172 * Note: the system serializes calls to this function.
9175 DllMain(HINSTANCE dllInstHandle, /* instance handle for this DLL module */
9176 DWORD reason, /* reason function is being called */
9177 LPVOID reserved) /* reserved for future use */
9180 case DLL_PROCESS_ATTACH:
9181 /* library is being attached to a process */
9185 case DLL_PROCESS_DETACH:
9192 #endif /* AFS_NT40_ENV */
9195 int rx_DumpCalls(FILE *outputFile, char *cookie)
9197 #ifdef RXDEBUG_PACKET
9198 #ifdef KDUMP_RX_LOCK
9199 struct rx_call_rx_lock *c;
9206 #define RXDPRINTF sprintf
9207 #define RXDPRINTOUT output
9209 #define RXDPRINTF fprintf
9210 #define RXDPRINTOUT outputFile
9213 RXDPRINTF(RXDPRINTOUT, "%s - Start dumping all Rx Calls - count=%u\r\n", cookie, rx_stats.nCallStructs);
9215 WriteFile(outputFile, output, (DWORD)strlen(output), &zilch, NULL);
9218 for (c = rx_allCallsp; c; c = c->allNextp) {
9219 u_short rqc, tqc, iovqc;
9221 MUTEX_ENTER(&c->lock);
9222 rqc = opr_queue_Count(&c->rq);
9223 tqc = opr_queue_Count(&c->tq);
9224 iovqc = opr_queue_Count(&c->app.iovq);
9226 RXDPRINTF(RXDPRINTOUT, "%s - call=0x%p, id=%u, state=%u, mode=%u, conn=%p, epoch=%u, cid=%u, callNum=%u, connFlags=0x%x, flags=0x%x, "
9227 "rqc=%u,%u, tqc=%u,%u, iovqc=%u,%u, "
9228 "lstatus=%u, rstatus=%u, error=%d, timeout=%u, "
9229 "resendEvent=%d, keepAliveEvt=%d, delayedAckEvt=%d, delayedAbortEvt=%d, abortCode=%d, abortCount=%d, "
9230 "lastSendTime=%u, lastRecvTime=%u"
9231 #ifdef RX_ENABLE_LOCKS
9234 #ifdef RX_REFCOUNT_CHECK
9235 ", refCountBegin=%u, refCountResend=%u, refCountDelay=%u, "
9236 "refCountAlive=%u, refCountPacket=%u, refCountSend=%u, refCountAckAll=%u, refCountAbort=%u"
9239 cookie, c, c->call_id, (afs_uint32)c->state, (afs_uint32)c->app.mode, c->conn, c->conn?c->conn->epoch:0, c->conn?c->conn->cid:0,
9240 c->callNumber?*c->callNumber:0, c->conn?c->conn->flags:0, c->flags,
9241 (afs_uint32)c->rqc, (afs_uint32)rqc, (afs_uint32)c->tqc, (afs_uint32)tqc, (afs_uint32)c->iovqc, (afs_uint32)iovqc,
9242 (afs_uint32)c->localStatus, (afs_uint32)c->remoteStatus, c->error, c->timeout,
9243 c->resendEvent?1:0, c->keepAliveEvent?1:0, c->delayedAckEvent?1:0, c->delayedAbortEvent?1:0,
9244 c->abortCode, c->abortCount, c->lastSendTime, c->lastReceiveTime
9245 #ifdef RX_ENABLE_LOCKS
9246 , (afs_uint32)c->refCount
9248 #ifdef RX_REFCOUNT_CHECK
9249 , c->refCDebug[0],c->refCDebug[1],c->refCDebug[2],c->refCDebug[3],c->refCDebug[4],c->refCDebug[5],c->refCDebug[6],c->refCDebug[7]
9252 MUTEX_EXIT(&c->lock);
9255 WriteFile(outputFile, output, (DWORD)strlen(output), &zilch, NULL);
9258 RXDPRINTF(RXDPRINTOUT, "%s - End dumping all Rx Calls\r\n", cookie);
9260 WriteFile(outputFile, output, (DWORD)strlen(output), &zilch, NULL);
9262 #endif /* RXDEBUG_PACKET */