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>
14 #include "afs/param.h"
16 #include <afs/param.h>
23 #include "afs/sysincludes.h"
24 #include "afsincludes.h"
30 #include <net/net_globals.h>
31 #endif /* AFS_OSF_ENV */
32 #ifdef AFS_LINUX20_ENV
35 #include "netinet/in.h"
36 #include "afs/afs_args.h"
37 #include "afs/afs_osi.h"
38 #ifdef RX_KERNEL_TRACE
39 #include "rx_kcommon.h"
41 #if (defined(AFS_AUX_ENV) || defined(AFS_AIX_ENV))
45 #undef RXDEBUG /* turn off debugging */
47 #if defined(AFS_SGI_ENV)
48 #include "sys/debug.h"
57 #endif /* AFS_OSF_ENV */
59 #include "afs/sysincludes.h"
60 #include "afsincludes.h"
63 #include "rx_kmutex.h"
64 #include "rx_kernel.h"
68 #include "rx_globals.h"
70 #define AFSOP_STOP_RXCALLBACK 210 /* Stop CALLBACK process */
71 #define AFSOP_STOP_AFS 211 /* Stop AFS process */
72 #define AFSOP_STOP_BKG 212 /* Stop BKG process */
74 extern afs_int32 afs_termState;
76 #include "sys/lockl.h"
77 #include "sys/lock_def.h"
78 #endif /* AFS_AIX41_ENV */
79 # include "rxgen_consts.h"
81 # include <sys/types.h>
87 # include <afs/afsutil.h>
88 # include <WINNT\afsreg.h>
90 # include <sys/socket.h>
91 # include <sys/file.h>
93 # include <sys/stat.h>
94 # include <netinet/in.h>
95 # include <sys/time.h>
99 # include "rx_clock.h"
100 # include "rx_queue.h"
101 # include "rx_globals.h"
102 # include "rx_trace.h"
103 # include <afs/rxgen_consts.h>
106 int (*registerProgram) () = 0;
107 int (*swapNameProgram) () = 0;
109 /* Local static routines */
110 static void rxi_DestroyConnectionNoLock(register struct rx_connection *conn);
111 #ifdef RX_ENABLE_LOCKS
112 static void rxi_SetAcksInTransmitQueue(register struct rx_call *call);
115 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
117 afs_int32 rxi_start_aborted; /* rxi_start awoke after rxi_Send in error. */
118 afs_int32 rxi_start_in_error;
120 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
123 * rxi_rpc_peer_stat_cnt counts the total number of peer stat structures
124 * currently allocated within rx. This number is used to allocate the
125 * memory required to return the statistics when queried.
128 static unsigned int rxi_rpc_peer_stat_cnt;
131 * rxi_rpc_process_stat_cnt counts the total number of local process stat
132 * structures currently allocated within rx. The number is used to allocate
133 * the memory required to return the statistics when queried.
136 static unsigned int rxi_rpc_process_stat_cnt;
138 #if !defined(offsetof)
139 #include <stddef.h> /* for definition of offsetof() */
142 #ifdef AFS_PTHREAD_ENV
146 * Use procedural initialization of mutexes/condition variables
150 extern pthread_mutex_t rx_stats_mutex;
151 extern pthread_mutex_t des_init_mutex;
152 extern pthread_mutex_t des_random_mutex;
153 extern pthread_mutex_t rx_clock_mutex;
154 extern pthread_mutex_t rxi_connCacheMutex;
155 extern pthread_mutex_t rx_event_mutex;
156 extern pthread_mutex_t osi_malloc_mutex;
157 extern pthread_mutex_t event_handler_mutex;
158 extern pthread_mutex_t listener_mutex;
159 extern pthread_mutex_t rx_if_init_mutex;
160 extern pthread_mutex_t rx_if_mutex;
161 extern pthread_mutex_t rxkad_client_uid_mutex;
162 extern pthread_mutex_t rxkad_random_mutex;
164 extern pthread_cond_t rx_event_handler_cond;
165 extern pthread_cond_t rx_listener_cond;
167 static pthread_mutex_t epoch_mutex;
168 static pthread_mutex_t rx_init_mutex;
169 static pthread_mutex_t rx_debug_mutex;
172 rxi_InitPthread(void)
174 assert(pthread_mutex_init(&rx_clock_mutex, (const pthread_mutexattr_t *)0)
176 assert(pthread_mutex_init(&rx_stats_mutex, (const pthread_mutexattr_t *)0)
178 assert(pthread_mutex_init
179 (&rxi_connCacheMutex, (const pthread_mutexattr_t *)0) == 0);
180 assert(pthread_mutex_init(&rx_init_mutex, (const pthread_mutexattr_t *)0)
182 assert(pthread_mutex_init(&epoch_mutex, (const pthread_mutexattr_t *)0) ==
184 assert(pthread_mutex_init(&rx_event_mutex, (const pthread_mutexattr_t *)0)
186 assert(pthread_mutex_init(&des_init_mutex, (const pthread_mutexattr_t *)0)
188 assert(pthread_mutex_init
189 (&des_random_mutex, (const pthread_mutexattr_t *)0) == 0);
190 assert(pthread_mutex_init
191 (&osi_malloc_mutex, (const pthread_mutexattr_t *)0) == 0);
192 assert(pthread_mutex_init
193 (&event_handler_mutex, (const pthread_mutexattr_t *)0) == 0);
194 assert(pthread_mutex_init(&listener_mutex, (const pthread_mutexattr_t *)0)
196 assert(pthread_mutex_init
197 (&rx_if_init_mutex, (const pthread_mutexattr_t *)0) == 0);
198 assert(pthread_mutex_init(&rx_if_mutex, (const pthread_mutexattr_t *)0) ==
200 assert(pthread_mutex_init
201 (&rxkad_client_uid_mutex, (const pthread_mutexattr_t *)0) == 0);
202 assert(pthread_mutex_init
203 (&rxkad_random_mutex, (const pthread_mutexattr_t *)0) == 0);
204 assert(pthread_mutex_init(&rx_debug_mutex, (const pthread_mutexattr_t *)0)
207 assert(pthread_cond_init
208 (&rx_event_handler_cond, (const pthread_condattr_t *)0) == 0);
209 assert(pthread_cond_init(&rx_listener_cond, (const pthread_condattr_t *)0)
211 assert(pthread_key_create(&rx_thread_id_key, NULL) == 0);
212 assert(pthread_key_create(&rx_ts_info_key, NULL) == 0);
214 rxkad_global_stats_init();
217 pthread_once_t rx_once_init = PTHREAD_ONCE_INIT;
218 #define INIT_PTHREAD_LOCKS \
219 assert(pthread_once(&rx_once_init, rxi_InitPthread)==0)
221 * The rx_stats_mutex mutex protects the following global variables:
226 * rxi_lowConnRefCount
227 * rxi_lowPeerRefCount
236 #define INIT_PTHREAD_LOCKS
240 /* Variables for handling the minProcs implementation. availProcs gives the
241 * number of threads available in the pool at this moment (not counting dudes
242 * executing right now). totalMin gives the total number of procs required
243 * for handling all minProcs requests. minDeficit is a dynamic variable
244 * tracking the # of procs required to satisfy all of the remaining minProcs
246 * For fine grain locking to work, the quota check and the reservation of
247 * a server thread has to come while rxi_availProcs and rxi_minDeficit
248 * are locked. To this end, the code has been modified under #ifdef
249 * RX_ENABLE_LOCKS so that quota checks and reservation occur at the
250 * same time. A new function, ReturnToServerPool() returns the allocation.
252 * A call can be on several queue's (but only one at a time). When
253 * rxi_ResetCall wants to remove the call from a queue, it has to ensure
254 * that no one else is touching the queue. To this end, we store the address
255 * of the queue lock in the call structure (under the call lock) when we
256 * put the call on a queue, and we clear the call_queue_lock when the
257 * call is removed from a queue (once the call lock has been obtained).
258 * This allows rxi_ResetCall to safely synchronize with others wishing
259 * to manipulate the queue.
262 #ifdef RX_ENABLE_LOCKS
263 static afs_kmutex_t rx_rpc_stats;
264 void rxi_StartUnlocked();
267 /* We keep a "last conn pointer" in rxi_FindConnection. The odds are
268 ** pretty good that the next packet coming in is from the same connection
269 ** as the last packet, since we're send multiple packets in a transmit window.
271 struct rx_connection *rxLastConn = 0;
273 #ifdef RX_ENABLE_LOCKS
274 /* The locking hierarchy for rx fine grain locking is composed of these
277 * rx_connHashTable_lock - synchronizes conn creation, rx_connHashTable access
278 * conn_call_lock - used to synchonize rx_EndCall and rx_NewCall
279 * call->lock - locks call data fields.
280 * These are independent of each other:
281 * rx_freeCallQueue_lock
286 * serverQueueEntry->lock
288 * rx_peerHashTable_lock - locked under rx_connHashTable_lock
289 * peer->lock - locks peer data fields.
290 * conn_data_lock - that more than one thread is not updating a conn data
291 * field at the same time.
299 * Do we need a lock to protect the peer field in the conn structure?
300 * conn->peer was previously a constant for all intents and so has no
301 * lock protecting this field. The multihomed client delta introduced
302 * a RX code change : change the peer field in the connection structure
303 * to that remote inetrface from which the last packet for this
304 * connection was sent out. This may become an issue if further changes
307 #define SET_CALL_QUEUE_LOCK(C, L) (C)->call_queue_lock = (L)
308 #define CLEAR_CALL_QUEUE_LOCK(C) (C)->call_queue_lock = NULL
310 /* rxdb_fileID is used to identify the lock location, along with line#. */
311 static int rxdb_fileID = RXDB_FILE_RX;
312 #endif /* RX_LOCKS_DB */
313 #else /* RX_ENABLE_LOCKS */
314 #define SET_CALL_QUEUE_LOCK(C, L)
315 #define CLEAR_CALL_QUEUE_LOCK(C)
316 #endif /* RX_ENABLE_LOCKS */
317 struct rx_serverQueueEntry *rx_waitForPacket = 0;
318 struct rx_serverQueueEntry *rx_waitingForPacket = 0;
320 /* ------------Exported Interfaces------------- */
322 /* This function allows rxkad to set the epoch to a suitably random number
323 * which rx_NewConnection will use in the future. The principle purpose is to
324 * get rxnull connections to use the same epoch as the rxkad connections do, at
325 * least once the first rxkad connection is established. This is important now
326 * that the host/port addresses aren't used in FindConnection: the uniqueness
327 * of epoch/cid matters and the start time won't do. */
329 #ifdef AFS_PTHREAD_ENV
331 * This mutex protects the following global variables:
335 #define LOCK_EPOCH assert(pthread_mutex_lock(&epoch_mutex)==0)
336 #define UNLOCK_EPOCH assert(pthread_mutex_unlock(&epoch_mutex)==0)
340 #endif /* AFS_PTHREAD_ENV */
343 rx_SetEpoch(afs_uint32 epoch)
350 /* Initialize rx. A port number may be mentioned, in which case this
351 * becomes the default port number for any service installed later.
352 * If 0 is provided for the port number, a random port will be chosen
353 * by the kernel. Whether this will ever overlap anything in
354 * /etc/services is anybody's guess... Returns 0 on success, -1 on
356 static int rxinit_status = 1;
357 #ifdef AFS_PTHREAD_ENV
359 * This mutex protects the following global variables:
363 #define LOCK_RX_INIT assert(pthread_mutex_lock(&rx_init_mutex)==0)
364 #define UNLOCK_RX_INIT assert(pthread_mutex_unlock(&rx_init_mutex)==0)
367 #define UNLOCK_RX_INIT
371 rx_InitHost(u_int host, u_int port)
378 char *htable, *ptable;
385 if (rxinit_status == 0) {
386 tmp_status = rxinit_status;
388 return tmp_status; /* Already started; return previous error code. */
394 if (afs_winsockInit() < 0)
400 * Initialize anything necessary to provide a non-premptive threading
403 rxi_InitializeThreadSupport();
406 /* Allocate and initialize a socket for client and perhaps server
409 rx_socket = rxi_GetHostUDPSocket(host, (u_short) port);
410 if (rx_socket == OSI_NULLSOCKET) {
414 #ifdef RX_ENABLE_LOCKS
417 #endif /* RX_LOCKS_DB */
418 MUTEX_INIT(&rx_stats_mutex, "rx_stats_mutex", MUTEX_DEFAULT, 0);
419 MUTEX_INIT(&rx_rpc_stats, "rx_rpc_stats", MUTEX_DEFAULT, 0);
420 MUTEX_INIT(&rx_freePktQ_lock, "rx_freePktQ_lock", MUTEX_DEFAULT, 0);
421 MUTEX_INIT(&freeSQEList_lock, "freeSQEList lock", MUTEX_DEFAULT, 0);
422 MUTEX_INIT(&rx_freeCallQueue_lock, "rx_freeCallQueue_lock", MUTEX_DEFAULT,
424 CV_INIT(&rx_waitingForPackets_cv, "rx_waitingForPackets_cv", CV_DEFAULT,
426 MUTEX_INIT(&rx_peerHashTable_lock, "rx_peerHashTable_lock", MUTEX_DEFAULT,
428 MUTEX_INIT(&rx_connHashTable_lock, "rx_connHashTable_lock", MUTEX_DEFAULT,
430 MUTEX_INIT(&rx_serverPool_lock, "rx_serverPool_lock", MUTEX_DEFAULT, 0);
432 MUTEX_INIT(&rxi_keyCreate_lock, "rxi_keyCreate_lock", MUTEX_DEFAULT, 0);
434 #if defined(KERNEL) && defined(AFS_HPUX110_ENV)
436 rx_sleepLock = alloc_spinlock(LAST_HELD_ORDER - 10, "rx_sleepLock");
437 #endif /* KERNEL && AFS_HPUX110_ENV */
438 #endif /* RX_ENABLE_LOCKS */
441 rx_connDeadTime = 12;
442 rx_tranquil = 0; /* reset flag */
443 memset((char *)&rx_stats, 0, sizeof(struct rx_stats));
445 osi_Alloc(rx_hashTableSize * sizeof(struct rx_connection *));
446 PIN(htable, rx_hashTableSize * sizeof(struct rx_connection *)); /* XXXXX */
447 memset(htable, 0, rx_hashTableSize * sizeof(struct rx_connection *));
448 ptable = (char *)osi_Alloc(rx_hashTableSize * sizeof(struct rx_peer *));
449 PIN(ptable, rx_hashTableSize * sizeof(struct rx_peer *)); /* XXXXX */
450 memset(ptable, 0, rx_hashTableSize * sizeof(struct rx_peer *));
452 /* Malloc up a bunch of packets & buffers */
454 queue_Init(&rx_freePacketQueue);
455 rxi_NeedMorePackets = FALSE;
456 #ifdef RX_ENABLE_TSFPQ
457 rx_nPackets = 0; /* in TSFPQ version, rx_nPackets is managed by rxi_MorePackets* */
458 rxi_MorePacketsTSFPQ(rx_extraPackets + RX_MAX_QUOTA + 2, RX_TS_FPQ_FLUSH_GLOBAL, 0);
459 #else /* RX_ENABLE_TSFPQ */
460 rx_nPackets = rx_extraPackets + RX_MAX_QUOTA + 2; /* fudge */
461 rxi_MorePackets(rx_nPackets);
462 #endif /* RX_ENABLE_TSFPQ */
469 #if defined(AFS_NT40_ENV) && !defined(AFS_PTHREAD_ENV)
470 tv.tv_sec = clock_now.sec;
471 tv.tv_usec = clock_now.usec;
472 srand((unsigned int)tv.tv_usec);
479 #if defined(KERNEL) && !defined(UKERNEL)
480 /* Really, this should never happen in a real kernel */
483 struct sockaddr_in addr;
484 int addrlen = sizeof(addr);
485 if (getsockname((int)rx_socket, (struct sockaddr *)&addr, &addrlen)) {
489 rx_port = addr.sin_port;
492 rx_stats.minRtt.sec = 9999999;
494 rx_SetEpoch(tv.tv_sec | 0x80000000);
496 rx_SetEpoch(tv.tv_sec); /* Start time of this package, rxkad
497 * will provide a randomer value. */
499 MUTEX_ENTER(&rx_stats_mutex);
500 rxi_dataQuota += rx_extraQuota; /* + extra pkts caller asked to rsrv */
501 MUTEX_EXIT(&rx_stats_mutex);
502 /* *Slightly* random start time for the cid. This is just to help
503 * out with the hashing function at the peer */
504 rx_nextCid = ((tv.tv_sec ^ tv.tv_usec) << RX_CIDSHIFT);
505 rx_connHashTable = (struct rx_connection **)htable;
506 rx_peerHashTable = (struct rx_peer **)ptable;
508 rx_lastAckDelay.sec = 0;
509 rx_lastAckDelay.usec = 400000; /* 400 milliseconds */
510 rx_hardAckDelay.sec = 0;
511 rx_hardAckDelay.usec = 100000; /* 100 milliseconds */
512 rx_softAckDelay.sec = 0;
513 rx_softAckDelay.usec = 100000; /* 100 milliseconds */
515 rxevent_Init(20, rxi_ReScheduleEvents);
517 /* Initialize various global queues */
518 queue_Init(&rx_idleServerQueue);
519 queue_Init(&rx_incomingCallQueue);
520 queue_Init(&rx_freeCallQueue);
522 #if defined(AFS_NT40_ENV) && !defined(KERNEL)
523 /* Initialize our list of usable IP addresses. */
527 /* Start listener process (exact function is dependent on the
528 * implementation environment--kernel or user space) */
532 tmp_status = rxinit_status = 0;
540 return rx_InitHost(htonl(INADDR_ANY), port);
543 /* called with unincremented nRequestsRunning to see if it is OK to start
544 * a new thread in this service. Could be "no" for two reasons: over the
545 * max quota, or would prevent others from reaching their min quota.
547 #ifdef RX_ENABLE_LOCKS
548 /* This verion of QuotaOK reserves quota if it's ok while the
549 * rx_serverPool_lock is held. Return quota using ReturnToServerPool().
552 QuotaOK(register struct rx_service *aservice)
554 /* check if over max quota */
555 if (aservice->nRequestsRunning >= aservice->maxProcs) {
559 /* under min quota, we're OK */
560 /* otherwise, can use only if there are enough to allow everyone
561 * to go to their min quota after this guy starts.
563 MUTEX_ENTER(&rx_stats_mutex);
564 if ((aservice->nRequestsRunning < aservice->minProcs)
565 || (rxi_availProcs > rxi_minDeficit)) {
566 aservice->nRequestsRunning++;
567 /* just started call in minProcs pool, need fewer to maintain
569 if (aservice->nRequestsRunning <= aservice->minProcs)
572 MUTEX_EXIT(&rx_stats_mutex);
575 MUTEX_EXIT(&rx_stats_mutex);
581 ReturnToServerPool(register struct rx_service *aservice)
583 aservice->nRequestsRunning--;
584 MUTEX_ENTER(&rx_stats_mutex);
585 if (aservice->nRequestsRunning < aservice->minProcs)
588 MUTEX_EXIT(&rx_stats_mutex);
591 #else /* RX_ENABLE_LOCKS */
593 QuotaOK(register struct rx_service *aservice)
596 /* under min quota, we're OK */
597 if (aservice->nRequestsRunning < aservice->minProcs)
600 /* check if over max quota */
601 if (aservice->nRequestsRunning >= aservice->maxProcs)
604 /* otherwise, can use only if there are enough to allow everyone
605 * to go to their min quota after this guy starts.
607 if (rxi_availProcs > rxi_minDeficit)
611 #endif /* RX_ENABLE_LOCKS */
614 /* Called by rx_StartServer to start up lwp's to service calls.
615 NExistingProcs gives the number of procs already existing, and which
616 therefore needn't be created. */
618 rxi_StartServerProcs(int nExistingProcs)
620 register struct rx_service *service;
625 /* For each service, reserve N processes, where N is the "minimum"
626 * number of processes that MUST be able to execute a request in parallel,
627 * at any time, for that process. Also compute the maximum difference
628 * between any service's maximum number of processes that can run
629 * (i.e. the maximum number that ever will be run, and a guarantee
630 * that this number will run if other services aren't running), and its
631 * minimum number. The result is the extra number of processes that
632 * we need in order to provide the latter guarantee */
633 for (i = 0; i < RX_MAX_SERVICES; i++) {
635 service = rx_services[i];
636 if (service == (struct rx_service *)0)
638 nProcs += service->minProcs;
639 diff = service->maxProcs - service->minProcs;
643 nProcs += maxdiff; /* Extra processes needed to allow max number requested to run in any given service, under good conditions */
644 nProcs -= nExistingProcs; /* Subtract the number of procs that were previously created for use as server procs */
645 for (i = 0; i < nProcs; i++) {
646 rxi_StartServerProc(rx_ServerProc, rx_stackSize);
652 /* This routine is only required on Windows */
654 rx_StartClientThread(void)
656 #ifdef AFS_PTHREAD_ENV
658 pid = pthread_self();
659 #endif /* AFS_PTHREAD_ENV */
661 #endif /* AFS_NT40_ENV */
663 /* This routine must be called if any services are exported. If the
664 * donateMe flag is set, the calling process is donated to the server
667 rx_StartServer(int donateMe)
669 register struct rx_service *service;
675 /* Start server processes, if necessary (exact function is dependent
676 * on the implementation environment--kernel or user space). DonateMe
677 * will be 1 if there is 1 pre-existing proc, i.e. this one. In this
678 * case, one less new proc will be created rx_StartServerProcs.
680 rxi_StartServerProcs(donateMe);
682 /* count up the # of threads in minProcs, and add set the min deficit to
683 * be that value, too.
685 for (i = 0; i < RX_MAX_SERVICES; i++) {
686 service = rx_services[i];
687 if (service == (struct rx_service *)0)
689 MUTEX_ENTER(&rx_stats_mutex);
690 rxi_totalMin += service->minProcs;
691 /* below works even if a thread is running, since minDeficit would
692 * still have been decremented and later re-incremented.
694 rxi_minDeficit += service->minProcs;
695 MUTEX_EXIT(&rx_stats_mutex);
698 /* Turn on reaping of idle server connections */
699 rxi_ReapConnections();
708 #ifdef AFS_PTHREAD_ENV
710 pid = (pid_t) pthread_self();
711 #else /* AFS_PTHREAD_ENV */
713 LWP_CurrentProcess(&pid);
714 #endif /* AFS_PTHREAD_ENV */
716 sprintf(name, "srv_%d", ++nProcs);
718 (*registerProgram) (pid, name);
720 #endif /* AFS_NT40_ENV */
721 rx_ServerProc(NULL); /* Never returns */
723 #ifdef RX_ENABLE_TSFPQ
724 /* no use leaving packets around in this thread's local queue if
725 * it isn't getting donated to the server thread pool.
727 rxi_FlushLocalPacketsTSFPQ();
728 #endif /* RX_ENABLE_TSFPQ */
732 /* Create a new client connection to the specified service, using the
733 * specified security object to implement the security model for this
735 struct rx_connection *
736 rx_NewConnection(register afs_uint32 shost, u_short sport, u_short sservice,
737 register struct rx_securityClass *securityObject,
738 int serviceSecurityIndex)
742 register struct rx_connection *conn;
747 dpf(("rx_NewConnection(host %x, port %u, service %u, securityObject %x, serviceSecurityIndex %d)\n", ntohl(shost), ntohs(sport), sservice, securityObject, serviceSecurityIndex));
749 /* Vasilsi said: "NETPRI protects Cid and Alloc", but can this be true in
750 * the case of kmem_alloc? */
751 conn = rxi_AllocConnection();
752 #ifdef RX_ENABLE_LOCKS
753 MUTEX_INIT(&conn->conn_call_lock, "conn call lock", MUTEX_DEFAULT, 0);
754 MUTEX_INIT(&conn->conn_data_lock, "conn call lock", MUTEX_DEFAULT, 0);
755 CV_INIT(&conn->conn_call_cv, "conn call cv", CV_DEFAULT, 0);
758 MUTEX_ENTER(&rx_connHashTable_lock);
759 cid = (rx_nextCid += RX_MAXCALLS);
760 conn->type = RX_CLIENT_CONNECTION;
762 conn->epoch = rx_epoch;
763 conn->peer = rxi_FindPeer(shost, sport, 0, 1);
764 conn->serviceId = sservice;
765 conn->securityObject = securityObject;
766 conn->securityData = (void *) 0;
767 conn->securityIndex = serviceSecurityIndex;
768 rx_SetConnDeadTime(conn, rx_connDeadTime);
769 conn->ackRate = RX_FAST_ACK_RATE;
771 conn->specific = NULL;
772 conn->challengeEvent = NULL;
773 conn->delayedAbortEvent = NULL;
774 conn->abortCount = 0;
777 RXS_NewConnection(securityObject, conn);
779 CONN_HASH(shost, sport, conn->cid, conn->epoch, RX_CLIENT_CONNECTION);
781 conn->refCount++; /* no lock required since only this thread knows... */
782 conn->next = rx_connHashTable[hashindex];
783 rx_connHashTable[hashindex] = conn;
784 rx_MutexIncrement(rx_stats.nClientConns, rx_stats_mutex);
785 MUTEX_EXIT(&rx_connHashTable_lock);
791 rx_SetConnDeadTime(register struct rx_connection *conn, register int seconds)
793 /* The idea is to set the dead time to a value that allows several
794 * keepalives to be dropped without timing out the connection. */
795 conn->secondsUntilDead = MAX(seconds, 6);
796 conn->secondsUntilPing = conn->secondsUntilDead / 6;
799 int rxi_lowPeerRefCount = 0;
800 int rxi_lowConnRefCount = 0;
803 * Cleanup a connection that was destroyed in rxi_DestroyConnectioNoLock.
804 * NOTE: must not be called with rx_connHashTable_lock held.
807 rxi_CleanupConnection(struct rx_connection *conn)
809 /* Notify the service exporter, if requested, that this connection
810 * is being destroyed */
811 if (conn->type == RX_SERVER_CONNECTION && conn->service->destroyConnProc)
812 (*conn->service->destroyConnProc) (conn);
814 /* Notify the security module that this connection is being destroyed */
815 RXS_DestroyConnection(conn->securityObject, conn);
817 /* If this is the last connection using the rx_peer struct, set its
818 * idle time to now. rxi_ReapConnections will reap it if it's still
819 * idle (refCount == 0) after rx_idlePeerTime (60 seconds) have passed.
821 MUTEX_ENTER(&rx_peerHashTable_lock);
822 if (conn->peer->refCount < 2) {
823 conn->peer->idleWhen = clock_Sec();
824 if (conn->peer->refCount < 1) {
825 conn->peer->refCount = 1;
826 MUTEX_ENTER(&rx_stats_mutex);
827 rxi_lowPeerRefCount++;
828 MUTEX_EXIT(&rx_stats_mutex);
831 conn->peer->refCount--;
832 MUTEX_EXIT(&rx_peerHashTable_lock);
834 if (conn->type == RX_SERVER_CONNECTION)
835 rx_MutexDecrement(rx_stats.nServerConns, rx_stats_mutex);
837 rx_MutexDecrement(rx_stats.nClientConns, rx_stats_mutex);
839 if (conn->specific) {
841 for (i = 0; i < conn->nSpecific; i++) {
842 if (conn->specific[i] && rxi_keyCreate_destructor[i])
843 (*rxi_keyCreate_destructor[i]) (conn->specific[i]);
844 conn->specific[i] = NULL;
846 free(conn->specific);
848 conn->specific = NULL;
852 MUTEX_DESTROY(&conn->conn_call_lock);
853 MUTEX_DESTROY(&conn->conn_data_lock);
854 CV_DESTROY(&conn->conn_call_cv);
856 rxi_FreeConnection(conn);
859 /* Destroy the specified connection */
861 rxi_DestroyConnection(register struct rx_connection *conn)
863 MUTEX_ENTER(&rx_connHashTable_lock);
864 rxi_DestroyConnectionNoLock(conn);
865 /* conn should be at the head of the cleanup list */
866 if (conn == rx_connCleanup_list) {
867 rx_connCleanup_list = rx_connCleanup_list->next;
868 MUTEX_EXIT(&rx_connHashTable_lock);
869 rxi_CleanupConnection(conn);
871 #ifdef RX_ENABLE_LOCKS
873 MUTEX_EXIT(&rx_connHashTable_lock);
875 #endif /* RX_ENABLE_LOCKS */
879 rxi_DestroyConnectionNoLock(register struct rx_connection *conn)
881 register struct rx_connection **conn_ptr;
882 register int havecalls = 0;
883 struct rx_packet *packet;
890 MUTEX_ENTER(&conn->conn_data_lock);
891 if (conn->refCount > 0)
894 MUTEX_ENTER(&rx_stats_mutex);
895 rxi_lowConnRefCount++;
896 MUTEX_EXIT(&rx_stats_mutex);
899 if ((conn->refCount > 0) || (conn->flags & RX_CONN_BUSY)) {
900 /* Busy; wait till the last guy before proceeding */
901 MUTEX_EXIT(&conn->conn_data_lock);
906 /* If the client previously called rx_NewCall, but it is still
907 * waiting, treat this as a running call, and wait to destroy the
908 * connection later when the call completes. */
909 if ((conn->type == RX_CLIENT_CONNECTION)
910 && (conn->flags & RX_CONN_MAKECALL_WAITING)) {
911 conn->flags |= RX_CONN_DESTROY_ME;
912 MUTEX_EXIT(&conn->conn_data_lock);
916 MUTEX_EXIT(&conn->conn_data_lock);
918 /* Check for extant references to this connection */
919 for (i = 0; i < RX_MAXCALLS; i++) {
920 register struct rx_call *call = conn->call[i];
923 if (conn->type == RX_CLIENT_CONNECTION) {
924 MUTEX_ENTER(&call->lock);
925 if (call->delayedAckEvent) {
926 /* Push the final acknowledgment out now--there
927 * won't be a subsequent call to acknowledge the
928 * last reply packets */
929 rxevent_Cancel(call->delayedAckEvent, call,
930 RX_CALL_REFCOUNT_DELAY);
931 if (call->state == RX_STATE_PRECALL
932 || call->state == RX_STATE_ACTIVE) {
933 rxi_SendAck(call, 0, 0, RX_ACK_DELAY, 0);
935 rxi_AckAll(NULL, call, 0);
938 MUTEX_EXIT(&call->lock);
942 #ifdef RX_ENABLE_LOCKS
944 if (MUTEX_TRYENTER(&conn->conn_data_lock)) {
945 MUTEX_EXIT(&conn->conn_data_lock);
947 /* Someone is accessing a packet right now. */
951 #endif /* RX_ENABLE_LOCKS */
954 /* Don't destroy the connection if there are any call
955 * structures still in use */
956 MUTEX_ENTER(&conn->conn_data_lock);
957 conn->flags |= RX_CONN_DESTROY_ME;
958 MUTEX_EXIT(&conn->conn_data_lock);
963 if (conn->delayedAbortEvent) {
964 rxevent_Cancel(conn->delayedAbortEvent, (struct rx_call *)0, 0);
965 packet = rxi_AllocPacket(RX_PACKET_CLASS_SPECIAL);
967 MUTEX_ENTER(&conn->conn_data_lock);
968 rxi_SendConnectionAbort(conn, packet, 0, 1);
969 MUTEX_EXIT(&conn->conn_data_lock);
970 rxi_FreePacket(packet);
974 /* Remove from connection hash table before proceeding */
976 &rx_connHashTable[CONN_HASH
977 (peer->host, peer->port, conn->cid, conn->epoch,
979 for (; *conn_ptr; conn_ptr = &(*conn_ptr)->next) {
980 if (*conn_ptr == conn) {
981 *conn_ptr = conn->next;
985 /* if the conn that we are destroying was the last connection, then we
986 * clear rxLastConn as well */
987 if (rxLastConn == conn)
990 /* Make sure the connection is completely reset before deleting it. */
991 /* get rid of pending events that could zap us later */
992 if (conn->challengeEvent)
993 rxevent_Cancel(conn->challengeEvent, (struct rx_call *)0, 0);
994 if (conn->checkReachEvent)
995 rxevent_Cancel(conn->checkReachEvent, (struct rx_call *)0, 0);
997 /* Add the connection to the list of destroyed connections that
998 * need to be cleaned up. This is necessary to avoid deadlocks
999 * in the routines we call to inform others that this connection is
1000 * being destroyed. */
1001 conn->next = rx_connCleanup_list;
1002 rx_connCleanup_list = conn;
1005 /* Externally available version */
1007 rx_DestroyConnection(register struct rx_connection *conn)
1012 rxi_DestroyConnection(conn);
1017 rx_GetConnection(register struct rx_connection *conn)
1022 MUTEX_ENTER(&conn->conn_data_lock);
1024 MUTEX_EXIT(&conn->conn_data_lock);
1028 /* Wait for the transmit queue to no longer be busy.
1029 * requires the call->lock to be held */
1030 static void rxi_WaitforTQBusy(struct rx_call *call) {
1031 while (call->flags & RX_CALL_TQ_BUSY) {
1032 call->flags |= RX_CALL_TQ_WAIT;
1034 #ifdef RX_ENABLE_LOCKS
1035 osirx_AssertMine(&call->lock, "rxi_WaitforTQ lock");
1036 CV_WAIT(&call->cv_tq, &call->lock);
1037 #else /* RX_ENABLE_LOCKS */
1038 osi_rxSleep(&call->tq);
1039 #endif /* RX_ENABLE_LOCKS */
1041 if (call->tqWaiters == 0) {
1042 call->flags &= ~RX_CALL_TQ_WAIT;
1046 /* Start a new rx remote procedure call, on the specified connection.
1047 * If wait is set to 1, wait for a free call channel; otherwise return
1048 * 0. Maxtime gives the maximum number of seconds this call may take,
1049 * after rx_NewCall returns. After this time interval, a call to any
1050 * of rx_SendData, rx_ReadData, etc. will fail with RX_CALL_TIMEOUT.
1051 * For fine grain locking, we hold the conn_call_lock in order to
1052 * to ensure that we don't get signalle after we found a call in an active
1053 * state and before we go to sleep.
1056 rx_NewCall(register struct rx_connection *conn)
1059 register struct rx_call *call;
1060 struct clock queueTime;
1064 dpf(("rx_NewCall(conn %x)\n", conn));
1067 clock_GetTime(&queueTime);
1068 MUTEX_ENTER(&conn->conn_call_lock);
1071 * Check if there are others waiting for a new call.
1072 * If so, let them go first to avoid starving them.
1073 * This is a fairly simple scheme, and might not be
1074 * a complete solution for large numbers of waiters.
1076 * makeCallWaiters keeps track of the number of
1077 * threads waiting to make calls and the
1078 * RX_CONN_MAKECALL_WAITING flag bit is used to
1079 * indicate that there are indeed calls waiting.
1080 * The flag is set when the waiter is incremented.
1081 * It is only cleared in rx_EndCall when
1082 * makeCallWaiters is 0. This prevents us from
1083 * accidently destroying the connection while it
1084 * is potentially about to be used.
1086 MUTEX_ENTER(&conn->conn_data_lock);
1087 if (conn->makeCallWaiters) {
1088 conn->flags |= RX_CONN_MAKECALL_WAITING;
1089 conn->makeCallWaiters++;
1090 MUTEX_EXIT(&conn->conn_data_lock);
1092 #ifdef RX_ENABLE_LOCKS
1093 CV_WAIT(&conn->conn_call_cv, &conn->conn_call_lock);
1097 MUTEX_ENTER(&conn->conn_data_lock);
1098 conn->makeCallWaiters--;
1100 MUTEX_EXIT(&conn->conn_data_lock);
1103 for (i = 0; i < RX_MAXCALLS; i++) {
1104 call = conn->call[i];
1106 MUTEX_ENTER(&call->lock);
1107 if (call->state == RX_STATE_DALLY) {
1108 rxi_ResetCall(call, 0);
1109 (*call->callNumber)++;
1112 MUTEX_EXIT(&call->lock);
1114 call = rxi_NewCall(conn, i);
1118 if (i < RX_MAXCALLS) {
1121 MUTEX_ENTER(&conn->conn_data_lock);
1122 conn->flags |= RX_CONN_MAKECALL_WAITING;
1123 conn->makeCallWaiters++;
1124 MUTEX_EXIT(&conn->conn_data_lock);
1126 #ifdef RX_ENABLE_LOCKS
1127 CV_WAIT(&conn->conn_call_cv, &conn->conn_call_lock);
1131 MUTEX_ENTER(&conn->conn_data_lock);
1132 conn->makeCallWaiters--;
1133 MUTEX_EXIT(&conn->conn_data_lock);
1136 * Wake up anyone else who might be giving us a chance to
1137 * run (see code above that avoids resource starvation).
1139 #ifdef RX_ENABLE_LOCKS
1140 CV_BROADCAST(&conn->conn_call_cv);
1145 CALL_HOLD(call, RX_CALL_REFCOUNT_BEGIN);
1147 /* Client is initially in send mode */
1148 call->state = RX_STATE_ACTIVE;
1149 call->error = conn->error;
1151 call->mode = RX_MODE_ERROR;
1153 call->mode = RX_MODE_SENDING;
1155 /* remember start time for call in case we have hard dead time limit */
1156 call->queueTime = queueTime;
1157 clock_GetTime(&call->startTime);
1158 hzero(call->bytesSent);
1159 hzero(call->bytesRcvd);
1161 /* Turn on busy protocol. */
1162 rxi_KeepAliveOn(call);
1164 MUTEX_EXIT(&call->lock);
1165 MUTEX_EXIT(&conn->conn_call_lock);
1168 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
1169 /* Now, if TQ wasn't cleared earlier, do it now. */
1170 MUTEX_ENTER(&call->lock);
1171 rxi_WaitforTQBusy(call);
1172 if (call->flags & RX_CALL_TQ_CLEARME) {
1173 rxi_ClearTransmitQueue(call, 0);
1174 queue_Init(&call->tq);
1176 MUTEX_EXIT(&call->lock);
1177 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
1179 dpf(("rx_NewCall(call %x)\n", call));
1184 rxi_HasActiveCalls(register struct rx_connection *aconn)
1187 register struct rx_call *tcall;
1191 for (i = 0; i < RX_MAXCALLS; i++) {
1192 if ((tcall = aconn->call[i])) {
1193 if ((tcall->state == RX_STATE_ACTIVE)
1194 || (tcall->state == RX_STATE_PRECALL)) {
1205 rxi_GetCallNumberVector(register struct rx_connection *aconn,
1206 register afs_int32 * aint32s)
1209 register struct rx_call *tcall;
1213 for (i = 0; i < RX_MAXCALLS; i++) {
1214 if ((tcall = aconn->call[i]) && (tcall->state == RX_STATE_DALLY))
1215 aint32s[i] = aconn->callNumber[i] + 1;
1217 aint32s[i] = aconn->callNumber[i];
1224 rxi_SetCallNumberVector(register struct rx_connection *aconn,
1225 register afs_int32 * aint32s)
1228 register struct rx_call *tcall;
1232 for (i = 0; i < RX_MAXCALLS; i++) {
1233 if ((tcall = aconn->call[i]) && (tcall->state == RX_STATE_DALLY))
1234 aconn->callNumber[i] = aint32s[i] - 1;
1236 aconn->callNumber[i] = aint32s[i];
1242 /* Advertise a new service. A service is named locally by a UDP port
1243 * number plus a 16-bit service id. Returns (struct rx_service *) 0
1246 char *serviceName; Name for identification purposes (e.g. the
1247 service name might be used for probing for
1250 rx_NewServiceHost(afs_uint32 host, u_short port, u_short serviceId,
1251 char *serviceName, struct rx_securityClass **securityObjects,
1252 int nSecurityObjects,
1253 afs_int32(*serviceProc) (struct rx_call * acall))
1255 osi_socket socket = OSI_NULLSOCKET;
1256 register struct rx_service *tservice;
1262 if (serviceId == 0) {
1264 "rx_NewService: service id for service %s is not non-zero.\n",
1271 "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",
1279 tservice = rxi_AllocService();
1281 for (i = 0; i < RX_MAX_SERVICES; i++) {
1282 register struct rx_service *service = rx_services[i];
1284 if (port == service->servicePort && host == service->serviceHost) {
1285 if (service->serviceId == serviceId) {
1286 /* The identical service has already been
1287 * installed; if the caller was intending to
1288 * change the security classes used by this
1289 * service, he/she loses. */
1291 "rx_NewService: tried to install service %s with service id %d, which is already in use for service %s\n",
1292 serviceName, serviceId, service->serviceName);
1294 rxi_FreeService(tservice);
1297 /* Different service, same port: re-use the socket
1298 * which is bound to the same port */
1299 socket = service->socket;
1302 if (socket == OSI_NULLSOCKET) {
1303 /* If we don't already have a socket (from another
1304 * service on same port) get a new one */
1305 socket = rxi_GetHostUDPSocket(htonl(INADDR_ANY), port);
1306 if (socket == OSI_NULLSOCKET) {
1308 rxi_FreeService(tservice);
1313 service->socket = socket;
1314 service->serviceHost = host;
1315 service->servicePort = port;
1316 service->serviceId = serviceId;
1317 service->serviceName = serviceName;
1318 service->nSecurityObjects = nSecurityObjects;
1319 service->securityObjects = securityObjects;
1320 service->minProcs = 0;
1321 service->maxProcs = 1;
1322 service->idleDeadTime = 60;
1323 service->connDeadTime = rx_connDeadTime;
1324 service->executeRequestProc = serviceProc;
1325 service->checkReach = 0;
1326 rx_services[i] = service; /* not visible until now */
1332 rxi_FreeService(tservice);
1333 (osi_Msg "rx_NewService: cannot support > %d services\n",
1338 /* Set configuration options for all of a service's security objects */
1341 rx_SetSecurityConfiguration(struct rx_service *service,
1342 rx_securityConfigVariables type,
1346 for (i = 0; i<service->nSecurityObjects; i++) {
1347 if (service->securityObjects[i]) {
1348 RXS_SetConfiguration(service->securityObjects[i], NULL, type,
1356 rx_NewService(u_short port, u_short serviceId, char *serviceName,
1357 struct rx_securityClass **securityObjects, int nSecurityObjects,
1358 afs_int32(*serviceProc) (struct rx_call * acall))
1360 return rx_NewServiceHost(htonl(INADDR_ANY), port, serviceId, serviceName, securityObjects, nSecurityObjects, serviceProc);
1363 /* Generic request processing loop. This routine should be called
1364 * by the implementation dependent rx_ServerProc. If socketp is
1365 * non-null, it will be set to the file descriptor that this thread
1366 * is now listening on. If socketp is null, this routine will never
1369 rxi_ServerProc(int threadID, struct rx_call *newcall, osi_socket * socketp)
1371 register struct rx_call *call;
1372 register afs_int32 code;
1373 register struct rx_service *tservice = NULL;
1380 call = rx_GetCall(threadID, tservice, socketp);
1381 if (socketp && *socketp != OSI_NULLSOCKET) {
1382 /* We are now a listener thread */
1387 /* if server is restarting( typically smooth shutdown) then do not
1388 * allow any new calls.
1391 if (rx_tranquil && (call != NULL)) {
1395 MUTEX_ENTER(&call->lock);
1397 rxi_CallError(call, RX_RESTARTING);
1398 rxi_SendCallAbort(call, (struct rx_packet *)0, 0, 0);
1400 MUTEX_EXIT(&call->lock);
1404 if (afs_termState == AFSOP_STOP_RXCALLBACK) {
1405 #ifdef RX_ENABLE_LOCKS
1407 #endif /* RX_ENABLE_LOCKS */
1408 afs_termState = AFSOP_STOP_AFS;
1409 afs_osi_Wakeup(&afs_termState);
1410 #ifdef RX_ENABLE_LOCKS
1412 #endif /* RX_ENABLE_LOCKS */
1417 tservice = call->conn->service;
1419 if (tservice->beforeProc)
1420 (*tservice->beforeProc) (call);
1422 code = call->conn->service->executeRequestProc(call);
1424 if (tservice->afterProc)
1425 (*tservice->afterProc) (call, code);
1427 rx_EndCall(call, code);
1428 MUTEX_ENTER(&rx_stats_mutex);
1430 MUTEX_EXIT(&rx_stats_mutex);
1436 rx_WakeupServerProcs(void)
1438 struct rx_serverQueueEntry *np, *tqp;
1442 MUTEX_ENTER(&rx_serverPool_lock);
1444 #ifdef RX_ENABLE_LOCKS
1445 if (rx_waitForPacket)
1446 CV_BROADCAST(&rx_waitForPacket->cv);
1447 #else /* RX_ENABLE_LOCKS */
1448 if (rx_waitForPacket)
1449 osi_rxWakeup(rx_waitForPacket);
1450 #endif /* RX_ENABLE_LOCKS */
1451 MUTEX_ENTER(&freeSQEList_lock);
1452 for (np = rx_FreeSQEList; np; np = tqp) {
1453 tqp = *(struct rx_serverQueueEntry **)np;
1454 #ifdef RX_ENABLE_LOCKS
1455 CV_BROADCAST(&np->cv);
1456 #else /* RX_ENABLE_LOCKS */
1458 #endif /* RX_ENABLE_LOCKS */
1460 MUTEX_EXIT(&freeSQEList_lock);
1461 for (queue_Scan(&rx_idleServerQueue, np, tqp, rx_serverQueueEntry)) {
1462 #ifdef RX_ENABLE_LOCKS
1463 CV_BROADCAST(&np->cv);
1464 #else /* RX_ENABLE_LOCKS */
1466 #endif /* RX_ENABLE_LOCKS */
1468 MUTEX_EXIT(&rx_serverPool_lock);
1473 * One thing that seems to happen is that all the server threads get
1474 * tied up on some empty or slow call, and then a whole bunch of calls
1475 * arrive at once, using up the packet pool, so now there are more
1476 * empty calls. The most critical resources here are server threads
1477 * and the free packet pool. The "doreclaim" code seems to help in
1478 * general. I think that eventually we arrive in this state: there
1479 * are lots of pending calls which do have all their packets present,
1480 * so they won't be reclaimed, are multi-packet calls, so they won't
1481 * be scheduled until later, and thus are tying up most of the free
1482 * packet pool for a very long time.
1484 * 1. schedule multi-packet calls if all the packets are present.
1485 * Probably CPU-bound operation, useful to return packets to pool.
1486 * Do what if there is a full window, but the last packet isn't here?
1487 * 3. preserve one thread which *only* runs "best" calls, otherwise
1488 * it sleeps and waits for that type of call.
1489 * 4. Don't necessarily reserve a whole window for each thread. In fact,
1490 * the current dataquota business is badly broken. The quota isn't adjusted
1491 * to reflect how many packets are presently queued for a running call.
1492 * So, when we schedule a queued call with a full window of packets queued
1493 * up for it, that *should* free up a window full of packets for other 2d-class
1494 * calls to be able to use from the packet pool. But it doesn't.
1496 * NB. Most of the time, this code doesn't run -- since idle server threads
1497 * sit on the idle server queue and are assigned by "...ReceivePacket" as soon
1498 * as a new call arrives.
1500 /* Sleep until a call arrives. Returns a pointer to the call, ready
1501 * for an rx_Read. */
1502 #ifdef RX_ENABLE_LOCKS
1504 rx_GetCall(int tno, struct rx_service *cur_service, osi_socket * socketp)
1506 struct rx_serverQueueEntry *sq;
1507 register struct rx_call *call = (struct rx_call *)0;
1508 struct rx_service *service = NULL;
1511 MUTEX_ENTER(&freeSQEList_lock);
1513 if ((sq = rx_FreeSQEList)) {
1514 rx_FreeSQEList = *(struct rx_serverQueueEntry **)sq;
1515 MUTEX_EXIT(&freeSQEList_lock);
1516 } else { /* otherwise allocate a new one and return that */
1517 MUTEX_EXIT(&freeSQEList_lock);
1518 sq = (struct rx_serverQueueEntry *)
1519 rxi_Alloc(sizeof(struct rx_serverQueueEntry));
1520 MUTEX_INIT(&sq->lock, "server Queue lock", MUTEX_DEFAULT, 0);
1521 CV_INIT(&sq->cv, "server Queue lock", CV_DEFAULT, 0);
1524 MUTEX_ENTER(&rx_serverPool_lock);
1525 if (cur_service != NULL) {
1526 ReturnToServerPool(cur_service);
1529 if (queue_IsNotEmpty(&rx_incomingCallQueue)) {
1530 register struct rx_call *tcall, *ncall, *choice2 = NULL;
1532 /* Scan for eligible incoming calls. A call is not eligible
1533 * if the maximum number of calls for its service type are
1534 * already executing */
1535 /* One thread will process calls FCFS (to prevent starvation),
1536 * while the other threads may run ahead looking for calls which
1537 * have all their input data available immediately. This helps
1538 * keep threads from blocking, waiting for data from the client. */
1539 for (queue_Scan(&rx_incomingCallQueue, tcall, ncall, rx_call)) {
1540 service = tcall->conn->service;
1541 if (!QuotaOK(service)) {
1544 if (tno == rxi_fcfs_thread_num
1545 || !tcall->queue_item_header.next) {
1546 /* If we're the fcfs thread , then we'll just use
1547 * this call. If we haven't been able to find an optimal
1548 * choice, and we're at the end of the list, then use a
1549 * 2d choice if one has been identified. Otherwise... */
1550 call = (choice2 ? choice2 : tcall);
1551 service = call->conn->service;
1552 } else if (!queue_IsEmpty(&tcall->rq)) {
1553 struct rx_packet *rp;
1554 rp = queue_First(&tcall->rq, rx_packet);
1555 if (rp->header.seq == 1) {
1557 || (rp->header.flags & RX_LAST_PACKET)) {
1559 } else if (rxi_2dchoice && !choice2
1560 && !(tcall->flags & RX_CALL_CLEARED)
1561 && (tcall->rprev > rxi_HardAckRate)) {
1570 ReturnToServerPool(service);
1577 MUTEX_EXIT(&rx_serverPool_lock);
1578 MUTEX_ENTER(&call->lock);
1580 if (call->flags & RX_CALL_WAIT_PROC) {
1581 call->flags &= ~RX_CALL_WAIT_PROC;
1582 MUTEX_ENTER(&rx_stats_mutex);
1584 MUTEX_EXIT(&rx_stats_mutex);
1587 if (call->state != RX_STATE_PRECALL || call->error) {
1588 MUTEX_EXIT(&call->lock);
1589 MUTEX_ENTER(&rx_serverPool_lock);
1590 ReturnToServerPool(service);
1595 if (queue_IsEmpty(&call->rq)
1596 || queue_First(&call->rq, rx_packet)->header.seq != 1)
1597 rxi_SendAck(call, 0, 0, RX_ACK_DELAY, 0);
1599 CLEAR_CALL_QUEUE_LOCK(call);
1602 /* If there are no eligible incoming calls, add this process
1603 * to the idle server queue, to wait for one */
1607 *socketp = OSI_NULLSOCKET;
1609 sq->socketp = socketp;
1610 queue_Append(&rx_idleServerQueue, sq);
1611 #ifndef AFS_AIX41_ENV
1612 rx_waitForPacket = sq;
1614 rx_waitingForPacket = sq;
1615 #endif /* AFS_AIX41_ENV */
1617 CV_WAIT(&sq->cv, &rx_serverPool_lock);
1619 if (afs_termState == AFSOP_STOP_RXCALLBACK) {
1620 MUTEX_EXIT(&rx_serverPool_lock);
1621 return (struct rx_call *)0;
1624 } while (!(call = sq->newcall)
1625 && !(socketp && *socketp != OSI_NULLSOCKET));
1626 MUTEX_EXIT(&rx_serverPool_lock);
1628 MUTEX_ENTER(&call->lock);
1634 MUTEX_ENTER(&freeSQEList_lock);
1635 *(struct rx_serverQueueEntry **)sq = rx_FreeSQEList;
1636 rx_FreeSQEList = sq;
1637 MUTEX_EXIT(&freeSQEList_lock);
1640 clock_GetTime(&call->startTime);
1641 call->state = RX_STATE_ACTIVE;
1642 call->mode = RX_MODE_RECEIVING;
1643 #ifdef RX_KERNEL_TRACE
1644 if (ICL_SETACTIVE(afs_iclSetp)) {
1645 int glockOwner = ISAFS_GLOCK();
1648 afs_Trace3(afs_iclSetp, CM_TRACE_WASHERE, ICL_TYPE_STRING,
1649 __FILE__, ICL_TYPE_INT32, __LINE__, ICL_TYPE_POINTER,
1656 rxi_calltrace(RX_CALL_START, call);
1657 dpf(("rx_GetCall(port=%d, service=%d) ==> call %x\n",
1658 call->conn->service->servicePort, call->conn->service->serviceId,
1661 CALL_HOLD(call, RX_CALL_REFCOUNT_BEGIN);
1662 MUTEX_EXIT(&call->lock);
1664 dpf(("rx_GetCall(socketp=0x%x, *socketp=0x%x)\n", socketp, *socketp));
1669 #else /* RX_ENABLE_LOCKS */
1671 rx_GetCall(int tno, struct rx_service *cur_service, osi_socket * socketp)
1673 struct rx_serverQueueEntry *sq;
1674 register struct rx_call *call = (struct rx_call *)0, *choice2;
1675 struct rx_service *service = NULL;
1679 MUTEX_ENTER(&freeSQEList_lock);
1681 if ((sq = rx_FreeSQEList)) {
1682 rx_FreeSQEList = *(struct rx_serverQueueEntry **)sq;
1683 MUTEX_EXIT(&freeSQEList_lock);
1684 } else { /* otherwise allocate a new one and return that */
1685 MUTEX_EXIT(&freeSQEList_lock);
1686 sq = (struct rx_serverQueueEntry *)
1687 rxi_Alloc(sizeof(struct rx_serverQueueEntry));
1688 MUTEX_INIT(&sq->lock, "server Queue lock", MUTEX_DEFAULT, 0);
1689 CV_INIT(&sq->cv, "server Queue lock", CV_DEFAULT, 0);
1691 MUTEX_ENTER(&sq->lock);
1693 if (cur_service != NULL) {
1694 cur_service->nRequestsRunning--;
1695 if (cur_service->nRequestsRunning < cur_service->minProcs)
1699 if (queue_IsNotEmpty(&rx_incomingCallQueue)) {
1700 register struct rx_call *tcall, *ncall;
1701 /* Scan for eligible incoming calls. A call is not eligible
1702 * if the maximum number of calls for its service type are
1703 * already executing */
1704 /* One thread will process calls FCFS (to prevent starvation),
1705 * while the other threads may run ahead looking for calls which
1706 * have all their input data available immediately. This helps
1707 * keep threads from blocking, waiting for data from the client. */
1708 choice2 = (struct rx_call *)0;
1709 for (queue_Scan(&rx_incomingCallQueue, tcall, ncall, rx_call)) {
1710 service = tcall->conn->service;
1711 if (QuotaOK(service)) {
1712 if (tno == rxi_fcfs_thread_num
1713 || !tcall->queue_item_header.next) {
1714 /* If we're the fcfs thread, then we'll just use
1715 * this call. If we haven't been able to find an optimal
1716 * choice, and we're at the end of the list, then use a
1717 * 2d choice if one has been identified. Otherwise... */
1718 call = (choice2 ? choice2 : tcall);
1719 service = call->conn->service;
1720 } else if (!queue_IsEmpty(&tcall->rq)) {
1721 struct rx_packet *rp;
1722 rp = queue_First(&tcall->rq, rx_packet);
1723 if (rp->header.seq == 1
1725 || (rp->header.flags & RX_LAST_PACKET))) {
1727 } else if (rxi_2dchoice && !choice2
1728 && !(tcall->flags & RX_CALL_CLEARED)
1729 && (tcall->rprev > rxi_HardAckRate)) {
1742 /* we can't schedule a call if there's no data!!! */
1743 /* send an ack if there's no data, if we're missing the
1744 * first packet, or we're missing something between first
1745 * and last -- there's a "hole" in the incoming data. */
1746 if (queue_IsEmpty(&call->rq)
1747 || queue_First(&call->rq, rx_packet)->header.seq != 1
1748 || call->rprev != queue_Last(&call->rq, rx_packet)->header.seq)
1749 rxi_SendAck(call, 0, 0, RX_ACK_DELAY, 0);
1751 call->flags &= (~RX_CALL_WAIT_PROC);
1752 service->nRequestsRunning++;
1753 /* just started call in minProcs pool, need fewer to maintain
1755 if (service->nRequestsRunning <= service->minProcs)
1759 /* MUTEX_EXIT(&call->lock); */
1761 /* If there are no eligible incoming calls, add this process
1762 * to the idle server queue, to wait for one */
1765 *socketp = OSI_NULLSOCKET;
1767 sq->socketp = socketp;
1768 queue_Append(&rx_idleServerQueue, sq);
1772 if (afs_termState == AFSOP_STOP_RXCALLBACK) {
1774 rxi_Free(sq, sizeof(struct rx_serverQueueEntry));
1775 return (struct rx_call *)0;
1778 } while (!(call = sq->newcall)
1779 && !(socketp && *socketp != OSI_NULLSOCKET));
1781 MUTEX_EXIT(&sq->lock);
1783 MUTEX_ENTER(&freeSQEList_lock);
1784 *(struct rx_serverQueueEntry **)sq = rx_FreeSQEList;
1785 rx_FreeSQEList = sq;
1786 MUTEX_EXIT(&freeSQEList_lock);
1789 clock_GetTime(&call->startTime);
1790 call->state = RX_STATE_ACTIVE;
1791 call->mode = RX_MODE_RECEIVING;
1792 #ifdef RX_KERNEL_TRACE
1793 if (ICL_SETACTIVE(afs_iclSetp)) {
1794 int glockOwner = ISAFS_GLOCK();
1797 afs_Trace3(afs_iclSetp, CM_TRACE_WASHERE, ICL_TYPE_STRING,
1798 __FILE__, ICL_TYPE_INT32, __LINE__, ICL_TYPE_POINTER,
1805 rxi_calltrace(RX_CALL_START, call);
1806 dpf(("rx_GetCall(port=%d, service=%d) ==> call %x\n",
1807 call->conn->service->servicePort, call->conn->service->serviceId,
1810 dpf(("rx_GetCall(socketp=0x%x, *socketp=0x%x)\n", socketp, *socketp));
1817 #endif /* RX_ENABLE_LOCKS */
1821 /* Establish a procedure to be called when a packet arrives for a
1822 * call. This routine will be called at most once after each call,
1823 * and will also be called if there is an error condition on the or
1824 * the call is complete. Used by multi rx to build a selection
1825 * function which determines which of several calls is likely to be a
1826 * good one to read from.
1827 * NOTE: the way this is currently implemented it is probably only a
1828 * good idea to (1) use it immediately after a newcall (clients only)
1829 * and (2) only use it once. Other uses currently void your warranty
1832 rx_SetArrivalProc(register struct rx_call *call,
1833 register void (*proc) (register struct rx_call * call,
1835 register int index),
1836 register void * handle, register int arg)
1838 call->arrivalProc = proc;
1839 call->arrivalProcHandle = handle;
1840 call->arrivalProcArg = arg;
1843 /* Call is finished (possibly prematurely). Return rc to the peer, if
1844 * appropriate, and return the final error code from the conversation
1848 rx_EndCall(register struct rx_call *call, afs_int32 rc)
1850 register struct rx_connection *conn = call->conn;
1851 register struct rx_service *service;
1857 dpf(("rx_EndCall(call %x rc %d error %d abortCode %d)\n", call, rc, call->error, call->abortCode));
1860 MUTEX_ENTER(&call->lock);
1862 if (rc == 0 && call->error == 0) {
1863 call->abortCode = 0;
1864 call->abortCount = 0;
1867 call->arrivalProc = (void (*)())0;
1868 if (rc && call->error == 0) {
1869 rxi_CallError(call, rc);
1870 /* Send an abort message to the peer if this error code has
1871 * only just been set. If it was set previously, assume the
1872 * peer has already been sent the error code or will request it
1874 rxi_SendCallAbort(call, (struct rx_packet *)0, 0, 0);
1876 if (conn->type == RX_SERVER_CONNECTION) {
1877 /* Make sure reply or at least dummy reply is sent */
1878 if (call->mode == RX_MODE_RECEIVING) {
1879 rxi_WriteProc(call, 0, 0);
1881 if (call->mode == RX_MODE_SENDING) {
1882 rxi_FlushWrite(call);
1884 service = conn->service;
1885 rxi_calltrace(RX_CALL_END, call);
1886 /* Call goes to hold state until reply packets are acknowledged */
1887 if (call->tfirst + call->nSoftAcked < call->tnext) {
1888 call->state = RX_STATE_HOLD;
1890 call->state = RX_STATE_DALLY;
1891 rxi_ClearTransmitQueue(call, 0);
1892 rxevent_Cancel(call->resendEvent, call, RX_CALL_REFCOUNT_RESEND);
1893 rxevent_Cancel(call->keepAliveEvent, call,
1894 RX_CALL_REFCOUNT_ALIVE);
1896 } else { /* Client connection */
1898 /* Make sure server receives input packets, in the case where
1899 * no reply arguments are expected */
1900 if ((call->mode == RX_MODE_SENDING)
1901 || (call->mode == RX_MODE_RECEIVING && call->rnext == 1)) {
1902 (void)rxi_ReadProc(call, &dummy, 1);
1905 /* If we had an outstanding delayed ack, be nice to the server
1906 * and force-send it now.
1908 if (call->delayedAckEvent) {
1909 rxevent_Cancel(call->delayedAckEvent, call,
1910 RX_CALL_REFCOUNT_DELAY);
1911 call->delayedAckEvent = NULL;
1912 rxi_SendDelayedAck(NULL, call, NULL);
1915 /* We need to release the call lock since it's lower than the
1916 * conn_call_lock and we don't want to hold the conn_call_lock
1917 * over the rx_ReadProc call. The conn_call_lock needs to be held
1918 * here for the case where rx_NewCall is perusing the calls on
1919 * the connection structure. We don't want to signal until
1920 * rx_NewCall is in a stable state. Otherwise, rx_NewCall may
1921 * have checked this call, found it active and by the time it
1922 * goes to sleep, will have missed the signal.
1924 * Do not clear the RX_CONN_MAKECALL_WAITING flag as long as
1925 * there are threads waiting to use the conn object.
1927 MUTEX_EXIT(&call->lock);
1928 MUTEX_ENTER(&conn->conn_call_lock);
1929 MUTEX_ENTER(&call->lock);
1930 MUTEX_ENTER(&conn->conn_data_lock);
1931 conn->flags |= RX_CONN_BUSY;
1932 if (conn->flags & RX_CONN_MAKECALL_WAITING) {
1933 if (conn->makeCallWaiters == 0)
1934 conn->flags &= (~RX_CONN_MAKECALL_WAITING);
1935 MUTEX_EXIT(&conn->conn_data_lock);
1936 #ifdef RX_ENABLE_LOCKS
1937 CV_BROADCAST(&conn->conn_call_cv);
1942 #ifdef RX_ENABLE_LOCKS
1944 MUTEX_EXIT(&conn->conn_data_lock);
1946 #endif /* RX_ENABLE_LOCKS */
1947 call->state = RX_STATE_DALLY;
1949 error = call->error;
1951 /* currentPacket, nLeft, and NFree must be zeroed here, because
1952 * ResetCall cannot: ResetCall may be called at splnet(), in the
1953 * kernel version, and may interrupt the macros rx_Read or
1954 * rx_Write, which run at normal priority for efficiency. */
1955 if (call->currentPacket) {
1956 queue_Prepend(&call->iovq, call->currentPacket);
1957 call->currentPacket = (struct rx_packet *)0;
1960 call->nLeft = call->nFree = call->curlen = 0;
1962 /* Free any packets from the last call to ReadvProc/WritevProc */
1963 rxi_FreePackets(0, &call->iovq);
1965 CALL_RELE(call, RX_CALL_REFCOUNT_BEGIN);
1966 MUTEX_EXIT(&call->lock);
1967 if (conn->type == RX_CLIENT_CONNECTION) {
1968 MUTEX_EXIT(&conn->conn_call_lock);
1969 conn->flags &= ~RX_CONN_BUSY;
1973 * Map errors to the local host's errno.h format.
1975 error = ntoh_syserr_conv(error);
1979 #if !defined(KERNEL)
1981 /* Call this routine when shutting down a server or client (especially
1982 * clients). This will allow Rx to gracefully garbage collect server
1983 * connections, and reduce the number of retries that a server might
1984 * make to a dead client.
1985 * This is not quite right, since some calls may still be ongoing and
1986 * we can't lock them to destroy them. */
1990 register struct rx_connection **conn_ptr, **conn_end;
1994 if (rxinit_status == 1) {
1996 return; /* Already shutdown. */
1998 rxi_DeleteCachedConnections();
1999 if (rx_connHashTable) {
2000 MUTEX_ENTER(&rx_connHashTable_lock);
2001 for (conn_ptr = &rx_connHashTable[0], conn_end =
2002 &rx_connHashTable[rx_hashTableSize]; conn_ptr < conn_end;
2004 struct rx_connection *conn, *next;
2005 for (conn = *conn_ptr; conn; conn = next) {
2007 if (conn->type == RX_CLIENT_CONNECTION) {
2008 /* MUTEX_ENTER(&conn->conn_data_lock); when used in kernel */
2010 /* MUTEX_EXIT(&conn->conn_data_lock); when used in kernel */
2011 #ifdef RX_ENABLE_LOCKS
2012 rxi_DestroyConnectionNoLock(conn);
2013 #else /* RX_ENABLE_LOCKS */
2014 rxi_DestroyConnection(conn);
2015 #endif /* RX_ENABLE_LOCKS */
2019 #ifdef RX_ENABLE_LOCKS
2020 while (rx_connCleanup_list) {
2021 struct rx_connection *conn;
2022 conn = rx_connCleanup_list;
2023 rx_connCleanup_list = rx_connCleanup_list->next;
2024 MUTEX_EXIT(&rx_connHashTable_lock);
2025 rxi_CleanupConnection(conn);
2026 MUTEX_ENTER(&rx_connHashTable_lock);
2028 MUTEX_EXIT(&rx_connHashTable_lock);
2029 #endif /* RX_ENABLE_LOCKS */
2034 afs_winsockCleanup();
2042 /* if we wakeup packet waiter too often, can get in loop with two
2043 AllocSendPackets each waking each other up (from ReclaimPacket calls) */
2045 rxi_PacketsUnWait(void)
2047 if (!rx_waitingForPackets) {
2051 if (rxi_OverQuota(RX_PACKET_CLASS_SEND)) {
2052 return; /* still over quota */
2055 rx_waitingForPackets = 0;
2056 #ifdef RX_ENABLE_LOCKS
2057 CV_BROADCAST(&rx_waitingForPackets_cv);
2059 osi_rxWakeup(&rx_waitingForPackets);
2065 /* ------------------Internal interfaces------------------------- */
2067 /* Return this process's service structure for the
2068 * specified socket and service */
2070 rxi_FindService(register osi_socket socket, register u_short serviceId)
2072 register struct rx_service **sp;
2073 for (sp = &rx_services[0]; *sp; sp++) {
2074 if ((*sp)->serviceId == serviceId && (*sp)->socket == socket)
2080 /* Allocate a call structure, for the indicated channel of the
2081 * supplied connection. The mode and state of the call must be set by
2082 * the caller. Returns the call with mutex locked. */
2084 rxi_NewCall(register struct rx_connection *conn, register int channel)
2086 register struct rx_call *call;
2087 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
2088 register struct rx_call *cp; /* Call pointer temp */
2089 register struct rx_call *nxp; /* Next call pointer, for queue_Scan */
2090 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
2092 dpf(("rxi_NewCall(conn %x, channel %d)\n", conn, channel));
2094 /* Grab an existing call structure, or allocate a new one.
2095 * Existing call structures are assumed to have been left reset by
2097 MUTEX_ENTER(&rx_freeCallQueue_lock);
2099 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
2101 * EXCEPT that the TQ might not yet be cleared out.
2102 * Skip over those with in-use TQs.
2105 for (queue_Scan(&rx_freeCallQueue, cp, nxp, rx_call)) {
2106 if (!(cp->flags & RX_CALL_TQ_BUSY)) {
2112 #else /* AFS_GLOBAL_RXLOCK_KERNEL */
2113 if (queue_IsNotEmpty(&rx_freeCallQueue)) {
2114 call = queue_First(&rx_freeCallQueue, rx_call);
2115 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
2117 rx_MutexDecrement(rx_stats.nFreeCallStructs, rx_stats_mutex);
2118 MUTEX_EXIT(&rx_freeCallQueue_lock);
2119 MUTEX_ENTER(&call->lock);
2120 CLEAR_CALL_QUEUE_LOCK(call);
2121 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
2122 /* Now, if TQ wasn't cleared earlier, do it now. */
2123 if (call->flags & RX_CALL_TQ_CLEARME) {
2124 rxi_ClearTransmitQueue(call, 0);
2125 queue_Init(&call->tq);
2127 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
2128 /* Bind the call to its connection structure */
2130 rxi_ResetCall(call, 1);
2132 call = (struct rx_call *)rxi_Alloc(sizeof(struct rx_call));
2134 MUTEX_EXIT(&rx_freeCallQueue_lock);
2135 MUTEX_INIT(&call->lock, "call lock", MUTEX_DEFAULT, NULL);
2136 MUTEX_ENTER(&call->lock);
2137 CV_INIT(&call->cv_twind, "call twind", CV_DEFAULT, 0);
2138 CV_INIT(&call->cv_rq, "call rq", CV_DEFAULT, 0);
2139 CV_INIT(&call->cv_tq, "call tq", CV_DEFAULT, 0);
2141 rx_MutexIncrement(rx_stats.nFreeCallStructs, rx_stats_mutex);
2142 /* Initialize once-only items */
2143 queue_Init(&call->tq);
2144 queue_Init(&call->rq);
2145 queue_Init(&call->iovq);
2146 /* Bind the call to its connection structure (prereq for reset) */
2148 rxi_ResetCall(call, 1);
2150 call->channel = channel;
2151 call->callNumber = &conn->callNumber[channel];
2152 /* Note that the next expected call number is retained (in
2153 * conn->callNumber[i]), even if we reallocate the call structure
2155 conn->call[channel] = call;
2156 /* if the channel's never been used (== 0), we should start at 1, otherwise
2157 * the call number is valid from the last time this channel was used */
2158 if (*call->callNumber == 0)
2159 *call->callNumber = 1;
2164 /* A call has been inactive long enough that so we can throw away
2165 * state, including the call structure, which is placed on the call
2167 * Call is locked upon entry.
2168 * haveCTLock set if called from rxi_ReapConnections
2170 #ifdef RX_ENABLE_LOCKS
2172 rxi_FreeCall(register struct rx_call *call, int haveCTLock)
2173 #else /* RX_ENABLE_LOCKS */
2175 rxi_FreeCall(register struct rx_call *call)
2176 #endif /* RX_ENABLE_LOCKS */
2178 register int channel = call->channel;
2179 register struct rx_connection *conn = call->conn;
2182 if (call->state == RX_STATE_DALLY || call->state == RX_STATE_HOLD)
2183 (*call->callNumber)++;
2184 rxi_ResetCall(call, 0);
2185 call->conn->call[channel] = (struct rx_call *)0;
2187 MUTEX_ENTER(&rx_freeCallQueue_lock);
2188 SET_CALL_QUEUE_LOCK(call, &rx_freeCallQueue_lock);
2189 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
2190 /* A call may be free even though its transmit queue is still in use.
2191 * Since we search the call list from head to tail, put busy calls at
2192 * the head of the list, and idle calls at the tail.
2194 if (call->flags & RX_CALL_TQ_BUSY)
2195 queue_Prepend(&rx_freeCallQueue, call);
2197 queue_Append(&rx_freeCallQueue, call);
2198 #else /* AFS_GLOBAL_RXLOCK_KERNEL */
2199 queue_Append(&rx_freeCallQueue, call);
2200 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
2201 rx_MutexIncrement(rx_stats.nFreeCallStructs, rx_stats_mutex);
2202 MUTEX_EXIT(&rx_freeCallQueue_lock);
2204 /* Destroy the connection if it was previously slated for
2205 * destruction, i.e. the Rx client code previously called
2206 * rx_DestroyConnection (client connections), or
2207 * rxi_ReapConnections called the same routine (server
2208 * connections). Only do this, however, if there are no
2209 * outstanding calls. Note that for fine grain locking, there appears
2210 * to be a deadlock in that rxi_FreeCall has a call locked and
2211 * DestroyConnectionNoLock locks each call in the conn. But note a
2212 * few lines up where we have removed this call from the conn.
2213 * If someone else destroys a connection, they either have no
2214 * call lock held or are going through this section of code.
2216 if (conn->flags & RX_CONN_DESTROY_ME && !(conn->flags & RX_CONN_MAKECALL_WAITING)) {
2217 MUTEX_ENTER(&conn->conn_data_lock);
2219 MUTEX_EXIT(&conn->conn_data_lock);
2220 #ifdef RX_ENABLE_LOCKS
2222 rxi_DestroyConnectionNoLock(conn);
2224 rxi_DestroyConnection(conn);
2225 #else /* RX_ENABLE_LOCKS */
2226 rxi_DestroyConnection(conn);
2227 #endif /* RX_ENABLE_LOCKS */
2231 afs_int32 rxi_Alloccnt = 0, rxi_Allocsize = 0;
2233 rxi_Alloc(register size_t size)
2237 rx_MutexAdd1Increment2(rxi_Allocsize, (afs_int32)size, rxi_Alloccnt, rx_stats_mutex);
2238 p = (char *)osi_Alloc(size);
2241 osi_Panic("rxi_Alloc error");
2247 rxi_Free(void *addr, register size_t size)
2249 rx_MutexAdd1Decrement2(rxi_Allocsize, -(afs_int32)size, rxi_Alloccnt, rx_stats_mutex);
2250 osi_Free(addr, size);
2253 /* Find the peer process represented by the supplied (host,port)
2254 * combination. If there is no appropriate active peer structure, a
2255 * new one will be allocated and initialized
2256 * The origPeer, if set, is a pointer to a peer structure on which the
2257 * refcount will be be decremented. This is used to replace the peer
2258 * structure hanging off a connection structure */
2260 rxi_FindPeer(register afs_uint32 host, register u_short port,
2261 struct rx_peer *origPeer, int create)
2263 register struct rx_peer *pp;
2265 hashIndex = PEER_HASH(host, port);
2266 MUTEX_ENTER(&rx_peerHashTable_lock);
2267 for (pp = rx_peerHashTable[hashIndex]; pp; pp = pp->next) {
2268 if ((pp->host == host) && (pp->port == port))
2273 pp = rxi_AllocPeer(); /* This bzero's *pp */
2274 pp->host = host; /* set here or in InitPeerParams is zero */
2276 MUTEX_INIT(&pp->peer_lock, "peer_lock", MUTEX_DEFAULT, 0);
2277 queue_Init(&pp->congestionQueue);
2278 queue_Init(&pp->rpcStats);
2279 pp->next = rx_peerHashTable[hashIndex];
2280 rx_peerHashTable[hashIndex] = pp;
2281 rxi_InitPeerParams(pp);
2282 rx_MutexIncrement(rx_stats.nPeerStructs, rx_stats_mutex);
2289 origPeer->refCount--;
2290 MUTEX_EXIT(&rx_peerHashTable_lock);
2295 /* Find the connection at (host, port) started at epoch, and with the
2296 * given connection id. Creates the server connection if necessary.
2297 * The type specifies whether a client connection or a server
2298 * connection is desired. In both cases, (host, port) specify the
2299 * peer's (host, pair) pair. Client connections are not made
2300 * automatically by this routine. The parameter socket gives the
2301 * socket descriptor on which the packet was received. This is used,
2302 * in the case of server connections, to check that *new* connections
2303 * come via a valid (port, serviceId). Finally, the securityIndex
2304 * parameter must match the existing index for the connection. If a
2305 * server connection is created, it will be created using the supplied
2306 * index, if the index is valid for this service */
2307 struct rx_connection *
2308 rxi_FindConnection(osi_socket socket, register afs_int32 host,
2309 register u_short port, u_short serviceId, afs_uint32 cid,
2310 afs_uint32 epoch, int type, u_int securityIndex)
2312 int hashindex, flag;
2313 register struct rx_connection *conn;
2314 hashindex = CONN_HASH(host, port, cid, epoch, type);
2315 MUTEX_ENTER(&rx_connHashTable_lock);
2316 rxLastConn ? (conn = rxLastConn, flag = 0) : (conn =
2317 rx_connHashTable[hashindex],
2320 if ((conn->type == type) && ((cid & RX_CIDMASK) == conn->cid)
2321 && (epoch == conn->epoch)) {
2322 register struct rx_peer *pp = conn->peer;
2323 if (securityIndex != conn->securityIndex) {
2324 /* this isn't supposed to happen, but someone could forge a packet
2325 * like this, and there seems to be some CM bug that makes this
2326 * happen from time to time -- in which case, the fileserver
2328 MUTEX_EXIT(&rx_connHashTable_lock);
2329 return (struct rx_connection *)0;
2331 if (pp->host == host && pp->port == port)
2333 if (type == RX_CLIENT_CONNECTION && pp->port == port)
2335 /* So what happens when it's a callback connection? */
2336 if ( /*type == RX_CLIENT_CONNECTION && */
2337 (conn->epoch & 0x80000000))
2341 /* the connection rxLastConn that was used the last time is not the
2342 ** one we are looking for now. Hence, start searching in the hash */
2344 conn = rx_connHashTable[hashindex];
2349 struct rx_service *service;
2350 if (type == RX_CLIENT_CONNECTION) {
2351 MUTEX_EXIT(&rx_connHashTable_lock);
2352 return (struct rx_connection *)0;
2354 service = rxi_FindService(socket, serviceId);
2355 if (!service || (securityIndex >= service->nSecurityObjects)
2356 || (service->securityObjects[securityIndex] == 0)) {
2357 MUTEX_EXIT(&rx_connHashTable_lock);
2358 return (struct rx_connection *)0;
2360 conn = rxi_AllocConnection(); /* This bzero's the connection */
2361 MUTEX_INIT(&conn->conn_call_lock, "conn call lock", MUTEX_DEFAULT, 0);
2362 MUTEX_INIT(&conn->conn_data_lock, "conn data lock", MUTEX_DEFAULT, 0);
2363 CV_INIT(&conn->conn_call_cv, "conn call cv", CV_DEFAULT, 0);
2364 conn->next = rx_connHashTable[hashindex];
2365 rx_connHashTable[hashindex] = conn;
2366 conn->peer = rxi_FindPeer(host, port, 0, 1);
2367 conn->type = RX_SERVER_CONNECTION;
2368 conn->lastSendTime = clock_Sec(); /* don't GC immediately */
2369 conn->epoch = epoch;
2370 conn->cid = cid & RX_CIDMASK;
2371 /* conn->serial = conn->lastSerial = 0; */
2372 /* conn->timeout = 0; */
2373 conn->ackRate = RX_FAST_ACK_RATE;
2374 conn->service = service;
2375 conn->serviceId = serviceId;
2376 conn->securityIndex = securityIndex;
2377 conn->securityObject = service->securityObjects[securityIndex];
2378 conn->nSpecific = 0;
2379 conn->specific = NULL;
2380 rx_SetConnDeadTime(conn, service->connDeadTime);
2381 rx_SetConnIdleDeadTime(conn, service->idleDeadTime);
2382 /* Notify security object of the new connection */
2383 RXS_NewConnection(conn->securityObject, conn);
2384 /* XXXX Connection timeout? */
2385 if (service->newConnProc)
2386 (*service->newConnProc) (conn);
2387 rx_MutexIncrement(rx_stats.nServerConns, rx_stats_mutex);
2390 MUTEX_ENTER(&conn->conn_data_lock);
2392 MUTEX_EXIT(&conn->conn_data_lock);
2394 rxLastConn = conn; /* store this connection as the last conn used */
2395 MUTEX_EXIT(&rx_connHashTable_lock);
2399 /* There are two packet tracing routines available for testing and monitoring
2400 * Rx. One is called just after every packet is received and the other is
2401 * called just before every packet is sent. Received packets, have had their
2402 * headers decoded, and packets to be sent have not yet had their headers
2403 * encoded. Both take two parameters: a pointer to the packet and a sockaddr
2404 * containing the network address. Both can be modified. The return value, if
2405 * non-zero, indicates that the packet should be dropped. */
2407 int (*rx_justReceived) () = 0;
2408 int (*rx_almostSent) () = 0;
2410 /* A packet has been received off the interface. Np is the packet, socket is
2411 * the socket number it was received from (useful in determining which service
2412 * this packet corresponds to), and (host, port) reflect the host,port of the
2413 * sender. This call returns the packet to the caller if it is finished with
2414 * it, rather than de-allocating it, just as a small performance hack */
2417 rxi_ReceivePacket(register struct rx_packet *np, osi_socket socket,
2418 afs_uint32 host, u_short port, int *tnop,
2419 struct rx_call **newcallp)
2421 register struct rx_call *call;
2422 register struct rx_connection *conn;
2424 afs_uint32 currentCallNumber;
2430 struct rx_packet *tnp;
2433 /* We don't print out the packet until now because (1) the time may not be
2434 * accurate enough until now in the lwp implementation (rx_Listener only gets
2435 * the time after the packet is read) and (2) from a protocol point of view,
2436 * this is the first time the packet has been seen */
2437 packetType = (np->header.type > 0 && np->header.type < RX_N_PACKET_TYPES)
2438 ? rx_packetTypes[np->header.type - 1] : "*UNKNOWN*";
2439 dpf(("R %d %s: %x.%d.%d.%d.%d.%d.%d flags %d, packet %x",
2440 np->header.serial, packetType, ntohl(host), ntohs(port), np->header.serviceId,
2441 np->header.epoch, np->header.cid, np->header.callNumber,
2442 np->header.seq, np->header.flags, np));
2445 if (np->header.type == RX_PACKET_TYPE_VERSION) {
2446 return rxi_ReceiveVersionPacket(np, socket, host, port, 1);
2449 if (np->header.type == RX_PACKET_TYPE_DEBUG) {
2450 return rxi_ReceiveDebugPacket(np, socket, host, port, 1);
2453 /* If an input tracer function is defined, call it with the packet and
2454 * network address. Note this function may modify its arguments. */
2455 if (rx_justReceived) {
2456 struct sockaddr_in addr;
2458 addr.sin_family = AF_INET;
2459 addr.sin_port = port;
2460 addr.sin_addr.s_addr = host;
2461 #ifdef STRUCT_SOCKADDR_HAS_SA_LEN
2462 addr.sin_len = sizeof(addr);
2463 #endif /* AFS_OSF_ENV */
2464 drop = (*rx_justReceived) (np, &addr);
2465 /* drop packet if return value is non-zero */
2468 port = addr.sin_port; /* in case fcn changed addr */
2469 host = addr.sin_addr.s_addr;
2473 /* If packet was not sent by the client, then *we* must be the client */
2474 type = ((np->header.flags & RX_CLIENT_INITIATED) != RX_CLIENT_INITIATED)
2475 ? RX_CLIENT_CONNECTION : RX_SERVER_CONNECTION;
2477 /* Find the connection (or fabricate one, if we're the server & if
2478 * necessary) associated with this packet */
2480 rxi_FindConnection(socket, host, port, np->header.serviceId,
2481 np->header.cid, np->header.epoch, type,
2482 np->header.securityIndex);
2485 /* If no connection found or fabricated, just ignore the packet.
2486 * (An argument could be made for sending an abort packet for
2491 MUTEX_ENTER(&conn->conn_data_lock);
2492 if (conn->maxSerial < np->header.serial)
2493 conn->maxSerial = np->header.serial;
2494 MUTEX_EXIT(&conn->conn_data_lock);
2496 /* If the connection is in an error state, send an abort packet and ignore
2497 * the incoming packet */
2499 /* Don't respond to an abort packet--we don't want loops! */
2500 MUTEX_ENTER(&conn->conn_data_lock);
2501 if (np->header.type != RX_PACKET_TYPE_ABORT)
2502 np = rxi_SendConnectionAbort(conn, np, 1, 0);
2504 MUTEX_EXIT(&conn->conn_data_lock);
2508 /* Check for connection-only requests (i.e. not call specific). */
2509 if (np->header.callNumber == 0) {
2510 switch (np->header.type) {
2511 case RX_PACKET_TYPE_ABORT: {
2512 /* What if the supplied error is zero? */
2513 afs_int32 errcode = ntohl(rx_GetInt32(np, 0));
2514 dpf(("rxi_ReceivePacket ABORT rx_GetInt32 = %d", errcode));
2515 rxi_ConnectionError(conn, errcode);
2516 MUTEX_ENTER(&conn->conn_data_lock);
2518 MUTEX_EXIT(&conn->conn_data_lock);
2521 case RX_PACKET_TYPE_CHALLENGE:
2522 tnp = rxi_ReceiveChallengePacket(conn, np, 1);
2523 MUTEX_ENTER(&conn->conn_data_lock);
2525 MUTEX_EXIT(&conn->conn_data_lock);
2527 case RX_PACKET_TYPE_RESPONSE:
2528 tnp = rxi_ReceiveResponsePacket(conn, np, 1);
2529 MUTEX_ENTER(&conn->conn_data_lock);
2531 MUTEX_EXIT(&conn->conn_data_lock);
2533 case RX_PACKET_TYPE_PARAMS:
2534 case RX_PACKET_TYPE_PARAMS + 1:
2535 case RX_PACKET_TYPE_PARAMS + 2:
2536 /* ignore these packet types for now */
2537 MUTEX_ENTER(&conn->conn_data_lock);
2539 MUTEX_EXIT(&conn->conn_data_lock);
2544 /* Should not reach here, unless the peer is broken: send an
2546 rxi_ConnectionError(conn, RX_PROTOCOL_ERROR);
2547 MUTEX_ENTER(&conn->conn_data_lock);
2548 tnp = rxi_SendConnectionAbort(conn, np, 1, 0);
2550 MUTEX_EXIT(&conn->conn_data_lock);
2555 channel = np->header.cid & RX_CHANNELMASK;
2556 call = conn->call[channel];
2557 #ifdef RX_ENABLE_LOCKS
2559 MUTEX_ENTER(&call->lock);
2560 /* Test to see if call struct is still attached to conn. */
2561 if (call != conn->call[channel]) {
2563 MUTEX_EXIT(&call->lock);
2564 if (type == RX_SERVER_CONNECTION) {
2565 call = conn->call[channel];
2566 /* If we started with no call attached and there is one now,
2567 * another thread is also running this routine and has gotten
2568 * the connection channel. We should drop this packet in the tests
2569 * below. If there was a call on this connection and it's now
2570 * gone, then we'll be making a new call below.
2571 * If there was previously a call and it's now different then
2572 * the old call was freed and another thread running this routine
2573 * has created a call on this channel. One of these two threads
2574 * has a packet for the old call and the code below handles those
2578 MUTEX_ENTER(&call->lock);
2580 /* This packet can't be for this call. If the new call address is
2581 * 0 then no call is running on this channel. If there is a call
2582 * then, since this is a client connection we're getting data for
2583 * it must be for the previous call.
2585 rx_MutexIncrement(rx_stats.spuriousPacketsRead, rx_stats_mutex);
2586 MUTEX_ENTER(&conn->conn_data_lock);
2588 MUTEX_EXIT(&conn->conn_data_lock);
2593 currentCallNumber = conn->callNumber[channel];
2595 if (type == RX_SERVER_CONNECTION) { /* We're the server */
2596 if (np->header.callNumber < currentCallNumber) {
2597 rx_MutexIncrement(rx_stats.spuriousPacketsRead, rx_stats_mutex);
2598 #ifdef RX_ENABLE_LOCKS
2600 MUTEX_EXIT(&call->lock);
2602 MUTEX_ENTER(&conn->conn_data_lock);
2604 MUTEX_EXIT(&conn->conn_data_lock);
2608 MUTEX_ENTER(&conn->conn_call_lock);
2609 call = rxi_NewCall(conn, channel);
2610 MUTEX_EXIT(&conn->conn_call_lock);
2611 *call->callNumber = np->header.callNumber;
2612 if (np->header.callNumber == 0)
2613 dpf(("RecPacket call 0 %d %s: %x.%u.%u.%u.%u.%u.%u flags %d, packet %lx resend %d.%0.3d len %d", np->header.serial, rx_packetTypes[np->header.type - 1], ntohl(conn->peer->host), ntohs(conn->peer->port), np->header.serial, np->header.epoch, np->header.cid, np->header.callNumber, np->header.seq, np->header.flags, (unsigned long)np, np->retryTime.sec, np->retryTime.usec / 1000, np->length));
2615 call->state = RX_STATE_PRECALL;
2616 clock_GetTime(&call->queueTime);
2617 hzero(call->bytesSent);
2618 hzero(call->bytesRcvd);
2620 * If the number of queued calls exceeds the overload
2621 * threshold then abort this call.
2623 if ((rx_BusyThreshold > 0) && (rx_nWaiting > rx_BusyThreshold)) {
2624 struct rx_packet *tp;
2626 rxi_CallError(call, rx_BusyError);
2627 tp = rxi_SendCallAbort(call, np, 1, 0);
2628 MUTEX_EXIT(&call->lock);
2629 MUTEX_ENTER(&conn->conn_data_lock);
2631 MUTEX_EXIT(&conn->conn_data_lock);
2632 rx_MutexIncrement(rx_stats.nBusies, rx_stats_mutex);
2635 rxi_KeepAliveOn(call);
2636 } else if (np->header.callNumber != currentCallNumber) {
2637 /* Wait until the transmit queue is idle before deciding
2638 * whether to reset the current call. Chances are that the
2639 * call will be in ether DALLY or HOLD state once the TQ_BUSY
2642 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
2643 while ((call->state == RX_STATE_ACTIVE)
2644 && (call->flags & RX_CALL_TQ_BUSY)) {
2645 call->flags |= RX_CALL_TQ_WAIT;
2647 #ifdef RX_ENABLE_LOCKS
2648 osirx_AssertMine(&call->lock, "rxi_Start lock3");
2649 CV_WAIT(&call->cv_tq, &call->lock);
2650 #else /* RX_ENABLE_LOCKS */
2651 osi_rxSleep(&call->tq);
2652 #endif /* RX_ENABLE_LOCKS */
2654 if (call->tqWaiters == 0)
2655 call->flags &= ~RX_CALL_TQ_WAIT;
2657 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
2658 /* If the new call cannot be taken right now send a busy and set
2659 * the error condition in this call, so that it terminates as
2660 * quickly as possible */
2661 if (call->state == RX_STATE_ACTIVE) {
2662 struct rx_packet *tp;
2664 rxi_CallError(call, RX_CALL_DEAD);
2665 tp = rxi_SendSpecial(call, conn, np, RX_PACKET_TYPE_BUSY,
2667 MUTEX_EXIT(&call->lock);
2668 MUTEX_ENTER(&conn->conn_data_lock);
2670 MUTEX_EXIT(&conn->conn_data_lock);
2673 rxi_ResetCall(call, 0);
2674 *call->callNumber = np->header.callNumber;
2675 if (np->header.callNumber == 0)
2676 dpf(("RecPacket call 0 %d %s: %x.%u.%u.%u.%u.%u.%u flags %d, packet %lx resend %d.%0.3d len %d", np->header.serial, rx_packetTypes[np->header.type - 1], ntohl(conn->peer->host), ntohs(conn->peer->port), np->header.serial, np->header.epoch, np->header.cid, np->header.callNumber, np->header.seq, np->header.flags, (unsigned long)np, np->retryTime.sec, np->retryTime.usec / 1000, np->length));
2678 call->state = RX_STATE_PRECALL;
2679 clock_GetTime(&call->queueTime);
2680 hzero(call->bytesSent);
2681 hzero(call->bytesRcvd);
2683 * If the number of queued calls exceeds the overload
2684 * threshold then abort this call.
2686 if ((rx_BusyThreshold > 0) && (rx_nWaiting > rx_BusyThreshold)) {
2687 struct rx_packet *tp;
2689 rxi_CallError(call, rx_BusyError);
2690 tp = rxi_SendCallAbort(call, np, 1, 0);
2691 MUTEX_EXIT(&call->lock);
2692 MUTEX_ENTER(&conn->conn_data_lock);
2694 MUTEX_EXIT(&conn->conn_data_lock);
2695 rx_MutexIncrement(rx_stats.nBusies, rx_stats_mutex);
2698 rxi_KeepAliveOn(call);
2700 /* Continuing call; do nothing here. */
2702 } else { /* we're the client */
2703 /* Ignore all incoming acknowledgements for calls in DALLY state */
2704 if (call && (call->state == RX_STATE_DALLY)
2705 && (np->header.type == RX_PACKET_TYPE_ACK)) {
2706 rx_MutexIncrement(rx_stats.ignorePacketDally, rx_stats_mutex);
2707 #ifdef RX_ENABLE_LOCKS
2709 MUTEX_EXIT(&call->lock);
2712 MUTEX_ENTER(&conn->conn_data_lock);
2714 MUTEX_EXIT(&conn->conn_data_lock);
2718 /* Ignore anything that's not relevant to the current call. If there
2719 * isn't a current call, then no packet is relevant. */
2720 if (!call || (np->header.callNumber != currentCallNumber)) {
2721 rx_MutexIncrement(rx_stats.spuriousPacketsRead, rx_stats_mutex);
2722 #ifdef RX_ENABLE_LOCKS
2724 MUTEX_EXIT(&call->lock);
2727 MUTEX_ENTER(&conn->conn_data_lock);
2729 MUTEX_EXIT(&conn->conn_data_lock);
2732 /* If the service security object index stamped in the packet does not
2733 * match the connection's security index, ignore the packet */
2734 if (np->header.securityIndex != conn->securityIndex) {
2735 #ifdef RX_ENABLE_LOCKS
2736 MUTEX_EXIT(&call->lock);
2738 MUTEX_ENTER(&conn->conn_data_lock);
2740 MUTEX_EXIT(&conn->conn_data_lock);
2744 /* If we're receiving the response, then all transmit packets are
2745 * implicitly acknowledged. Get rid of them. */
2746 if (np->header.type == RX_PACKET_TYPE_DATA) {
2747 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
2748 /* XXX Hack. Because we must release the global rx lock when
2749 * sending packets (osi_NetSend) we drop all acks while we're
2750 * traversing the tq in rxi_Start sending packets out because
2751 * packets may move to the freePacketQueue as result of being here!
2752 * So we drop these packets until we're safely out of the
2753 * traversing. Really ugly!
2754 * For fine grain RX locking, we set the acked field in the
2755 * packets and let rxi_Start remove them from the transmit queue.
2757 if (call->flags & RX_CALL_TQ_BUSY) {
2758 #ifdef RX_ENABLE_LOCKS
2759 rxi_SetAcksInTransmitQueue(call);
2762 return np; /* xmitting; drop packet */
2765 rxi_ClearTransmitQueue(call, 0);
2767 #else /* AFS_GLOBAL_RXLOCK_KERNEL */
2768 rxi_ClearTransmitQueue(call, 0);
2769 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
2771 if (np->header.type == RX_PACKET_TYPE_ACK) {
2772 /* now check to see if this is an ack packet acknowledging that the
2773 * server actually *lost* some hard-acked data. If this happens we
2774 * ignore this packet, as it may indicate that the server restarted in
2775 * the middle of a call. It is also possible that this is an old ack
2776 * packet. We don't abort the connection in this case, because this
2777 * *might* just be an old ack packet. The right way to detect a server
2778 * restart in the midst of a call is to notice that the server epoch
2780 /* XXX I'm not sure this is exactly right, since tfirst **IS**
2781 * XXX unacknowledged. I think that this is off-by-one, but
2782 * XXX I don't dare change it just yet, since it will
2783 * XXX interact badly with the server-restart detection
2784 * XXX code in receiveackpacket. */
2785 if (ntohl(rx_GetInt32(np, FIRSTACKOFFSET)) < call->tfirst) {
2786 rx_MutexIncrement(rx_stats.spuriousPacketsRead, rx_stats_mutex);
2787 MUTEX_EXIT(&call->lock);
2788 MUTEX_ENTER(&conn->conn_data_lock);
2790 MUTEX_EXIT(&conn->conn_data_lock);
2794 } /* else not a data packet */
2797 osirx_AssertMine(&call->lock, "rxi_ReceivePacket middle");
2798 /* Set remote user defined status from packet */
2799 call->remoteStatus = np->header.userStatus;
2801 /* Note the gap between the expected next packet and the actual
2802 * packet that arrived, when the new packet has a smaller serial number
2803 * than expected. Rioses frequently reorder packets all by themselves,
2804 * so this will be quite important with very large window sizes.
2805 * Skew is checked against 0 here to avoid any dependence on the type of
2806 * inPacketSkew (which may be unsigned). In C, -1 > (unsigned) 0 is always
2808 * The inPacketSkew should be a smoothed running value, not just a maximum. MTUXXX
2809 * see CalculateRoundTripTime for an example of how to keep smoothed values.
2810 * I think using a beta of 1/8 is probably appropriate. 93.04.21
2812 MUTEX_ENTER(&conn->conn_data_lock);
2813 skew = conn->lastSerial - np->header.serial;
2814 conn->lastSerial = np->header.serial;
2815 MUTEX_EXIT(&conn->conn_data_lock);
2817 register struct rx_peer *peer;
2819 if (skew > peer->inPacketSkew) {
2820 dpf(("*** In skew changed from %d to %d\n", peer->inPacketSkew,
2822 peer->inPacketSkew = skew;
2826 /* Now do packet type-specific processing */
2827 switch (np->header.type) {
2828 case RX_PACKET_TYPE_DATA:
2829 np = rxi_ReceiveDataPacket(call, np, 1, socket, host, port, tnop,
2832 case RX_PACKET_TYPE_ACK:
2833 /* Respond immediately to ack packets requesting acknowledgement
2835 if (np->header.flags & RX_REQUEST_ACK) {
2837 (void)rxi_SendCallAbort(call, 0, 1, 0);
2839 (void)rxi_SendAck(call, 0, np->header.serial,
2840 RX_ACK_PING_RESPONSE, 1);
2842 np = rxi_ReceiveAckPacket(call, np, 1);
2844 case RX_PACKET_TYPE_ABORT: {
2845 /* An abort packet: reset the call, passing the error up to the user. */
2846 /* What if error is zero? */
2847 /* What if the error is -1? the application will treat it as a timeout. */
2848 afs_int32 errdata = ntohl(*(afs_int32 *) rx_DataOf(np));
2849 dpf(("rxi_ReceivePacket ABORT rx_DataOf = %d", errdata));
2850 rxi_CallError(call, errdata);
2851 MUTEX_EXIT(&call->lock);
2852 MUTEX_ENTER(&conn->conn_data_lock);
2854 MUTEX_EXIT(&conn->conn_data_lock);
2855 return np; /* xmitting; drop packet */
2857 case RX_PACKET_TYPE_BUSY:
2860 case RX_PACKET_TYPE_ACKALL:
2861 /* All packets acknowledged, so we can drop all packets previously
2862 * readied for sending */
2863 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
2864 /* XXX Hack. We because we can't release the global rx lock when
2865 * sending packets (osi_NetSend) we drop all ack pkts while we're
2866 * traversing the tq in rxi_Start sending packets out because
2867 * packets may move to the freePacketQueue as result of being
2868 * here! So we drop these packets until we're safely out of the
2869 * traversing. Really ugly!
2870 * For fine grain RX locking, we set the acked field in the packets
2871 * and let rxi_Start remove the packets from the transmit queue.
2873 if (call->flags & RX_CALL_TQ_BUSY) {
2874 #ifdef RX_ENABLE_LOCKS
2875 rxi_SetAcksInTransmitQueue(call);
2877 #else /* RX_ENABLE_LOCKS */
2878 MUTEX_EXIT(&call->lock);
2879 MUTEX_ENTER(&conn->conn_data_lock);
2881 MUTEX_EXIT(&conn->conn_data_lock);
2882 return np; /* xmitting; drop packet */
2883 #endif /* RX_ENABLE_LOCKS */
2885 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
2886 rxi_ClearTransmitQueue(call, 0);
2889 /* Should not reach here, unless the peer is broken: send an abort
2891 rxi_CallError(call, RX_PROTOCOL_ERROR);
2892 np = rxi_SendCallAbort(call, np, 1, 0);
2895 /* Note when this last legitimate packet was received, for keep-alive
2896 * processing. Note, we delay getting the time until now in the hope that
2897 * the packet will be delivered to the user before any get time is required
2898 * (if not, then the time won't actually be re-evaluated here). */
2899 call->lastReceiveTime = clock_Sec();
2900 MUTEX_EXIT(&call->lock);
2901 MUTEX_ENTER(&conn->conn_data_lock);
2903 MUTEX_EXIT(&conn->conn_data_lock);
2907 /* return true if this is an "interesting" connection from the point of view
2908 of someone trying to debug the system */
2910 rxi_IsConnInteresting(struct rx_connection *aconn)
2913 register struct rx_call *tcall;
2915 if (aconn->flags & (RX_CONN_MAKECALL_WAITING | RX_CONN_DESTROY_ME))
2917 for (i = 0; i < RX_MAXCALLS; i++) {
2918 tcall = aconn->call[i];
2920 if ((tcall->state == RX_STATE_PRECALL)
2921 || (tcall->state == RX_STATE_ACTIVE))
2923 if ((tcall->mode == RX_MODE_SENDING)
2924 || (tcall->mode == RX_MODE_RECEIVING))
2932 /* if this is one of the last few packets AND it wouldn't be used by the
2933 receiving call to immediately satisfy a read request, then drop it on
2934 the floor, since accepting it might prevent a lock-holding thread from
2935 making progress in its reading. If a call has been cleared while in
2936 the precall state then ignore all subsequent packets until the call
2937 is assigned to a thread. */
2940 TooLow(struct rx_packet *ap, struct rx_call *acall)
2943 MUTEX_ENTER(&rx_stats_mutex);
2944 if (((ap->header.seq != 1) && (acall->flags & RX_CALL_CLEARED)
2945 && (acall->state == RX_STATE_PRECALL))
2946 || ((rx_nFreePackets < rxi_dataQuota + 2)
2947 && !((ap->header.seq < acall->rnext + rx_initSendWindow)
2948 && (acall->flags & RX_CALL_READER_WAIT)))) {
2951 MUTEX_EXIT(&rx_stats_mutex);
2957 rxi_CheckReachEvent(struct rxevent *event, struct rx_connection *conn,
2958 struct rx_call *acall)
2960 struct rx_call *call = acall;
2961 struct clock when, now;
2964 MUTEX_ENTER(&conn->conn_data_lock);
2965 conn->checkReachEvent = NULL;
2966 waiting = conn->flags & RX_CONN_ATTACHWAIT;
2969 MUTEX_EXIT(&conn->conn_data_lock);
2973 MUTEX_ENTER(&conn->conn_call_lock);
2974 MUTEX_ENTER(&conn->conn_data_lock);
2975 for (i = 0; i < RX_MAXCALLS; i++) {
2976 struct rx_call *tc = conn->call[i];
2977 if (tc && tc->state == RX_STATE_PRECALL) {
2983 /* Indicate that rxi_CheckReachEvent is no longer running by
2984 * clearing the flag. Must be atomic under conn_data_lock to
2985 * avoid a new call slipping by: rxi_CheckConnReach holds
2986 * conn_data_lock while checking RX_CONN_ATTACHWAIT.
2988 conn->flags &= ~RX_CONN_ATTACHWAIT;
2989 MUTEX_EXIT(&conn->conn_data_lock);
2990 MUTEX_EXIT(&conn->conn_call_lock);
2995 MUTEX_ENTER(&call->lock);
2996 rxi_SendAck(call, NULL, 0, RX_ACK_PING, 0);
2998 MUTEX_EXIT(&call->lock);
3000 clock_GetTime(&now);
3002 when.sec += RX_CHECKREACH_TIMEOUT;
3003 MUTEX_ENTER(&conn->conn_data_lock);
3004 if (!conn->checkReachEvent) {
3006 conn->checkReachEvent =
3007 rxevent_PostNow(&when, &now, rxi_CheckReachEvent, conn,
3010 MUTEX_EXIT(&conn->conn_data_lock);
3016 rxi_CheckConnReach(struct rx_connection *conn, struct rx_call *call)
3018 struct rx_service *service = conn->service;
3019 struct rx_peer *peer = conn->peer;
3020 afs_uint32 now, lastReach;
3022 if (service->checkReach == 0)
3026 MUTEX_ENTER(&peer->peer_lock);
3027 lastReach = peer->lastReachTime;
3028 MUTEX_EXIT(&peer->peer_lock);
3029 if (now - lastReach < RX_CHECKREACH_TTL)
3032 MUTEX_ENTER(&conn->conn_data_lock);
3033 if (conn->flags & RX_CONN_ATTACHWAIT) {
3034 MUTEX_EXIT(&conn->conn_data_lock);
3037 conn->flags |= RX_CONN_ATTACHWAIT;
3038 MUTEX_EXIT(&conn->conn_data_lock);
3039 if (!conn->checkReachEvent)
3040 rxi_CheckReachEvent(NULL, conn, call);
3045 /* try to attach call, if authentication is complete */
3047 TryAttach(register struct rx_call *acall, register osi_socket socket,
3048 register int *tnop, register struct rx_call **newcallp,
3051 struct rx_connection *conn = acall->conn;
3053 if (conn->type == RX_SERVER_CONNECTION
3054 && acall->state == RX_STATE_PRECALL) {
3055 /* Don't attach until we have any req'd. authentication. */
3056 if (RXS_CheckAuthentication(conn->securityObject, conn) == 0) {
3057 if (reachOverride || rxi_CheckConnReach(conn, acall) == 0)
3058 rxi_AttachServerProc(acall, socket, tnop, newcallp);
3059 /* Note: this does not necessarily succeed; there
3060 * may not any proc available
3063 rxi_ChallengeOn(acall->conn);
3068 /* A data packet has been received off the interface. This packet is
3069 * appropriate to the call (the call is in the right state, etc.). This
3070 * routine can return a packet to the caller, for re-use */
3073 rxi_ReceiveDataPacket(register struct rx_call *call,
3074 register struct rx_packet *np, int istack,
3075 osi_socket socket, afs_uint32 host, u_short port,
3076 int *tnop, struct rx_call **newcallp)
3078 int ackNeeded = 0; /* 0 means no, otherwise ack_reason */
3082 afs_uint32 seq, serial, flags;
3084 struct rx_packet *tnp;
3085 struct clock when, now;
3086 rx_MutexIncrement(rx_stats.dataPacketsRead, rx_stats_mutex);
3089 /* If there are no packet buffers, drop this new packet, unless we can find
3090 * packet buffers from inactive calls */
3092 && (rxi_OverQuota(RX_PACKET_CLASS_RECEIVE) || TooLow(np, call))) {
3093 MUTEX_ENTER(&rx_freePktQ_lock);
3094 rxi_NeedMorePackets = TRUE;
3095 MUTEX_EXIT(&rx_freePktQ_lock);
3096 rx_MutexIncrement(rx_stats.noPacketBuffersOnRead, rx_stats_mutex);
3097 call->rprev = np->header.serial;
3098 rxi_calltrace(RX_TRACE_DROP, call);
3099 dpf(("packet %x dropped on receipt - quota problems", np));
3101 rxi_ClearReceiveQueue(call);
3102 clock_GetTime(&now);
3104 clock_Add(&when, &rx_softAckDelay);
3105 if (!call->delayedAckEvent
3106 || clock_Gt(&call->delayedAckEvent->eventTime, &when)) {
3107 rxevent_Cancel(call->delayedAckEvent, call,
3108 RX_CALL_REFCOUNT_DELAY);
3109 CALL_HOLD(call, RX_CALL_REFCOUNT_DELAY);
3110 call->delayedAckEvent =
3111 rxevent_PostNow(&when, &now, rxi_SendDelayedAck, call, 0);
3113 /* we've damaged this call already, might as well do it in. */
3119 * New in AFS 3.5, if the RX_JUMBO_PACKET flag is set then this
3120 * packet is one of several packets transmitted as a single
3121 * datagram. Do not send any soft or hard acks until all packets
3122 * in a jumbogram have been processed. Send negative acks right away.
3124 for (isFirst = 1, tnp = NULL; isFirst || tnp; isFirst = 0) {
3125 /* tnp is non-null when there are more packets in the
3126 * current jumbo gram */
3133 seq = np->header.seq;
3134 serial = np->header.serial;
3135 flags = np->header.flags;
3137 /* If the call is in an error state, send an abort message */
3139 return rxi_SendCallAbort(call, np, istack, 0);
3141 /* The RX_JUMBO_PACKET is set in all but the last packet in each
3142 * AFS 3.5 jumbogram. */
3143 if (flags & RX_JUMBO_PACKET) {
3144 tnp = rxi_SplitJumboPacket(np, host, port, isFirst);
3149 if (np->header.spare != 0) {
3150 MUTEX_ENTER(&call->conn->conn_data_lock);
3151 call->conn->flags |= RX_CONN_USING_PACKET_CKSUM;
3152 MUTEX_EXIT(&call->conn->conn_data_lock);
3155 /* The usual case is that this is the expected next packet */
3156 if (seq == call->rnext) {
3158 /* Check to make sure it is not a duplicate of one already queued */
3159 if (queue_IsNotEmpty(&call->rq)
3160 && queue_First(&call->rq, rx_packet)->header.seq == seq) {
3161 rx_MutexIncrement(rx_stats.dupPacketsRead, rx_stats_mutex);
3162 dpf(("packet %x dropped on receipt - duplicate", np));
3163 rxevent_Cancel(call->delayedAckEvent, call,
3164 RX_CALL_REFCOUNT_DELAY);
3165 np = rxi_SendAck(call, np, serial, RX_ACK_DUPLICATE, istack);
3171 /* It's the next packet. Stick it on the receive queue
3172 * for this call. Set newPackets to make sure we wake
3173 * the reader once all packets have been processed */
3174 queue_Prepend(&call->rq, np);
3176 np = NULL; /* We can't use this anymore */
3179 /* If an ack is requested then set a flag to make sure we
3180 * send an acknowledgement for this packet */
3181 if (flags & RX_REQUEST_ACK) {
3182 ackNeeded = RX_ACK_REQUESTED;
3185 /* Keep track of whether we have received the last packet */
3186 if (flags & RX_LAST_PACKET) {
3187 call->flags |= RX_CALL_HAVE_LAST;
3191 /* Check whether we have all of the packets for this call */
3192 if (call->flags & RX_CALL_HAVE_LAST) {
3193 afs_uint32 tseq; /* temporary sequence number */
3194 struct rx_packet *tp; /* Temporary packet pointer */
3195 struct rx_packet *nxp; /* Next pointer, for queue_Scan */
3197 for (tseq = seq, queue_Scan(&call->rq, tp, nxp, rx_packet)) {
3198 if (tseq != tp->header.seq)
3200 if (tp->header.flags & RX_LAST_PACKET) {
3201 call->flags |= RX_CALL_RECEIVE_DONE;
3208 /* Provide asynchronous notification for those who want it
3209 * (e.g. multi rx) */
3210 if (call->arrivalProc) {
3211 (*call->arrivalProc) (call, call->arrivalProcHandle,
3212 call->arrivalProcArg);
3213 call->arrivalProc = (void (*)())0;
3216 /* Update last packet received */
3219 /* If there is no server process serving this call, grab
3220 * one, if available. We only need to do this once. If a
3221 * server thread is available, this thread becomes a server
3222 * thread and the server thread becomes a listener thread. */
3224 TryAttach(call, socket, tnop, newcallp, 0);
3227 /* This is not the expected next packet. */
3229 /* Determine whether this is a new or old packet, and if it's
3230 * a new one, whether it fits into the current receive window.
3231 * Also figure out whether the packet was delivered in sequence.
3232 * We use the prev variable to determine whether the new packet
3233 * is the successor of its immediate predecessor in the
3234 * receive queue, and the missing flag to determine whether
3235 * any of this packets predecessors are missing. */
3237 afs_uint32 prev; /* "Previous packet" sequence number */
3238 struct rx_packet *tp; /* Temporary packet pointer */
3239 struct rx_packet *nxp; /* Next pointer, for queue_Scan */
3240 int missing; /* Are any predecessors missing? */
3242 /* If the new packet's sequence number has been sent to the
3243 * application already, then this is a duplicate */
3244 if (seq < call->rnext) {
3245 rx_MutexIncrement(rx_stats.dupPacketsRead, rx_stats_mutex);
3246 rxevent_Cancel(call->delayedAckEvent, call,
3247 RX_CALL_REFCOUNT_DELAY);
3248 np = rxi_SendAck(call, np, serial, RX_ACK_DUPLICATE, istack);
3254 /* If the sequence number is greater than what can be
3255 * accomodated by the current window, then send a negative
3256 * acknowledge and drop the packet */
3257 if ((call->rnext + call->rwind) <= seq) {
3258 rxevent_Cancel(call->delayedAckEvent, call,
3259 RX_CALL_REFCOUNT_DELAY);
3260 np = rxi_SendAck(call, np, serial, RX_ACK_EXCEEDS_WINDOW,
3267 /* Look for the packet in the queue of old received packets */
3268 for (prev = call->rnext - 1, missing =
3269 0, queue_Scan(&call->rq, tp, nxp, rx_packet)) {
3270 /*Check for duplicate packet */
3271 if (seq == tp->header.seq) {
3272 rx_MutexIncrement(rx_stats.dupPacketsRead, rx_stats_mutex);
3273 rxevent_Cancel(call->delayedAckEvent, call,
3274 RX_CALL_REFCOUNT_DELAY);
3275 np = rxi_SendAck(call, np, serial, RX_ACK_DUPLICATE,
3281 /* If we find a higher sequence packet, break out and
3282 * insert the new packet here. */
3283 if (seq < tp->header.seq)
3285 /* Check for missing packet */
3286 if (tp->header.seq != prev + 1) {
3290 prev = tp->header.seq;
3293 /* Keep track of whether we have received the last packet. */
3294 if (flags & RX_LAST_PACKET) {
3295 call->flags |= RX_CALL_HAVE_LAST;
3298 /* It's within the window: add it to the the receive queue.
3299 * tp is left by the previous loop either pointing at the
3300 * packet before which to insert the new packet, or at the
3301 * queue head if the queue is empty or the packet should be
3303 queue_InsertBefore(tp, np);
3307 /* Check whether we have all of the packets for this call */
3308 if ((call->flags & RX_CALL_HAVE_LAST)
3309 && !(call->flags & RX_CALL_RECEIVE_DONE)) {
3310 afs_uint32 tseq; /* temporary sequence number */
3313 call->rnext, queue_Scan(&call->rq, tp, nxp, rx_packet)) {
3314 if (tseq != tp->header.seq)
3316 if (tp->header.flags & RX_LAST_PACKET) {
3317 call->flags |= RX_CALL_RECEIVE_DONE;
3324 /* We need to send an ack of the packet is out of sequence,
3325 * or if an ack was requested by the peer. */
3326 if (seq != prev + 1 || missing) {
3327 ackNeeded = RX_ACK_OUT_OF_SEQUENCE;
3328 } else if (flags & RX_REQUEST_ACK) {
3329 ackNeeded = RX_ACK_REQUESTED;
3332 /* Acknowledge the last packet for each call */
3333 if (flags & RX_LAST_PACKET) {
3344 * If the receiver is waiting for an iovec, fill the iovec
3345 * using the data from the receive queue */
3346 if (call->flags & RX_CALL_IOVEC_WAIT) {
3347 didHardAck = rxi_FillReadVec(call, serial);
3348 /* the call may have been aborted */
3357 /* Wakeup the reader if any */
3358 if ((call->flags & RX_CALL_READER_WAIT)
3359 && (!(call->flags & RX_CALL_IOVEC_WAIT) || !(call->iovNBytes)
3360 || (call->iovNext >= call->iovMax)
3361 || (call->flags & RX_CALL_RECEIVE_DONE))) {
3362 call->flags &= ~RX_CALL_READER_WAIT;
3363 #ifdef RX_ENABLE_LOCKS
3364 CV_BROADCAST(&call->cv_rq);
3366 osi_rxWakeup(&call->rq);
3372 * Send an ack when requested by the peer, or once every
3373 * rxi_SoftAckRate packets until the last packet has been
3374 * received. Always send a soft ack for the last packet in
3375 * the server's reply. */
3377 rxevent_Cancel(call->delayedAckEvent, call, RX_CALL_REFCOUNT_DELAY);
3378 np = rxi_SendAck(call, np, serial, ackNeeded, istack);
3379 } else if (call->nSoftAcks > (u_short) rxi_SoftAckRate) {
3380 rxevent_Cancel(call->delayedAckEvent, call, RX_CALL_REFCOUNT_DELAY);
3381 np = rxi_SendAck(call, np, serial, RX_ACK_IDLE, istack);
3382 } else if (call->nSoftAcks) {
3383 clock_GetTime(&now);
3385 if (haveLast && !(flags & RX_CLIENT_INITIATED)) {
3386 clock_Add(&when, &rx_lastAckDelay);
3388 clock_Add(&when, &rx_softAckDelay);
3390 if (!call->delayedAckEvent
3391 || clock_Gt(&call->delayedAckEvent->eventTime, &when)) {
3392 rxevent_Cancel(call->delayedAckEvent, call,
3393 RX_CALL_REFCOUNT_DELAY);
3394 CALL_HOLD(call, RX_CALL_REFCOUNT_DELAY);
3395 call->delayedAckEvent =
3396 rxevent_PostNow(&when, &now, rxi_SendDelayedAck, call, 0);
3398 } else if (call->flags & RX_CALL_RECEIVE_DONE) {
3399 rxevent_Cancel(call->delayedAckEvent, call, RX_CALL_REFCOUNT_DELAY);
3406 static void rxi_ComputeRate();
3410 rxi_UpdatePeerReach(struct rx_connection *conn, struct rx_call *acall)
3412 struct rx_peer *peer = conn->peer;
3414 MUTEX_ENTER(&peer->peer_lock);
3415 peer->lastReachTime = clock_Sec();
3416 MUTEX_EXIT(&peer->peer_lock);
3418 MUTEX_ENTER(&conn->conn_data_lock);
3419 if (conn->flags & RX_CONN_ATTACHWAIT) {
3422 conn->flags &= ~RX_CONN_ATTACHWAIT;
3423 MUTEX_EXIT(&conn->conn_data_lock);
3425 for (i = 0; i < RX_MAXCALLS; i++) {
3426 struct rx_call *call = conn->call[i];
3429 MUTEX_ENTER(&call->lock);
3430 /* tnop can be null if newcallp is null */
3431 TryAttach(call, (osi_socket) - 1, NULL, NULL, 1);
3433 MUTEX_EXIT(&call->lock);
3437 MUTEX_EXIT(&conn->conn_data_lock);
3441 rx_ack_reason(int reason)
3444 case RX_ACK_REQUESTED:
3446 case RX_ACK_DUPLICATE:
3448 case RX_ACK_OUT_OF_SEQUENCE:
3450 case RX_ACK_EXCEEDS_WINDOW:
3452 case RX_ACK_NOSPACE:
3456 case RX_ACK_PING_RESPONSE:
3468 /* rxi_ComputePeerNetStats
3470 * Called exclusively by rxi_ReceiveAckPacket to compute network link
3471 * estimates (like RTT and throughput) based on ack packets. Caller
3472 * must ensure that the packet in question is the right one (i.e.
3473 * serial number matches).
3476 rxi_ComputePeerNetStats(struct rx_call *call, struct rx_packet *p,
3477 struct rx_ackPacket *ap, struct rx_packet *np)
3479 struct rx_peer *peer = call->conn->peer;
3481 /* Use RTT if not delayed by client. */
3482 if (ap->reason != RX_ACK_DELAY)
3483 rxi_ComputeRoundTripTime(p, &p->timeSent, peer);
3485 rxi_ComputeRate(peer, call, p, np, ap->reason);
3489 /* The real smarts of the whole thing. */
3491 rxi_ReceiveAckPacket(register struct rx_call *call, struct rx_packet *np,
3494 struct rx_ackPacket *ap;
3496 register struct rx_packet *tp;
3497 register struct rx_packet *nxp; /* Next packet pointer for queue_Scan */
3498 register struct rx_connection *conn = call->conn;
3499 struct rx_peer *peer = conn->peer;
3502 /* because there are CM's that are bogus, sending weird values for this. */
3503 afs_uint32 skew = 0;
3508 int newAckCount = 0;
3509 u_short maxMTU = 0; /* Set if peer supports AFS 3.4a jumbo datagrams */
3510 int maxDgramPackets = 0; /* Set if peer supports AFS 3.5 jumbo datagrams */
3512 rx_MutexIncrement(rx_stats.ackPacketsRead, rx_stats_mutex);
3513 ap = (struct rx_ackPacket *)rx_DataOf(np);
3514 nbytes = rx_Contiguous(np) - (int)((ap->acks) - (u_char *) ap);
3516 return np; /* truncated ack packet */
3518 /* depends on ack packet struct */
3519 nAcks = MIN((unsigned)nbytes, (unsigned)ap->nAcks);
3520 first = ntohl(ap->firstPacket);
3521 serial = ntohl(ap->serial);
3522 /* temporarily disabled -- needs to degrade over time
3523 * skew = ntohs(ap->maxSkew); */
3525 /* Ignore ack packets received out of order */
3526 if (first < call->tfirst) {
3530 if (np->header.flags & RX_SLOW_START_OK) {
3531 call->flags |= RX_CALL_SLOW_START_OK;
3534 if (ap->reason == RX_ACK_PING_RESPONSE)
3535 rxi_UpdatePeerReach(conn, call);
3539 if (rxdebug_active) {
3543 len = _snprintf(msg, sizeof(msg),
3544 "tid[%d] RACK: reason %s serial %u previous %u seq %u skew %d first %u acks %u space %u ",
3545 GetCurrentThreadId(), rx_ack_reason(ap->reason),
3546 ntohl(ap->serial), ntohl(ap->previousPacket),
3547 (unsigned int)np->header.seq, (unsigned int)skew,
3548 ntohl(ap->firstPacket), ap->nAcks, ntohs(ap->bufferSpace) );
3552 for (offset = 0; offset < nAcks && len < sizeof(msg); offset++)
3553 msg[len++] = (ap->acks[offset] == RX_ACK_TYPE_NACK ? '-' : '*');
3557 OutputDebugString(msg);
3559 #else /* AFS_NT40_ENV */
3562 "RACK: reason %x previous %u seq %u serial %u skew %d first %u",
3563 ap->reason, ntohl(ap->previousPacket),
3564 (unsigned int)np->header.seq, (unsigned int)serial,
3565 (unsigned int)skew, ntohl(ap->firstPacket));
3568 for (offset = 0; offset < nAcks; offset++)
3569 putc(ap->acks[offset] == RX_ACK_TYPE_NACK ? '-' : '*',
3574 #endif /* AFS_NT40_ENV */
3577 /* Update the outgoing packet skew value to the latest value of
3578 * the peer's incoming packet skew value. The ack packet, of
3579 * course, could arrive out of order, but that won't affect things
3581 MUTEX_ENTER(&peer->peer_lock);
3582 peer->outPacketSkew = skew;
3584 /* Check for packets that no longer need to be transmitted, and
3585 * discard them. This only applies to packets positively
3586 * acknowledged as having been sent to the peer's upper level.
3587 * All other packets must be retained. So only packets with
3588 * sequence numbers < ap->firstPacket are candidates. */
3589 for (queue_Scan(&call->tq, tp, nxp, rx_packet)) {
3590 if (tp->header.seq >= first)
3592 call->tfirst = tp->header.seq + 1;
3594 && (tp->header.serial == serial || tp->firstSerial == serial))
3595 rxi_ComputePeerNetStats(call, tp, ap, np);
3596 if (!(tp->flags & RX_PKTFLAG_ACKED)) {
3599 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
3600 /* XXX Hack. Because we have to release the global rx lock when sending
3601 * packets (osi_NetSend) we drop all acks while we're traversing the tq
3602 * in rxi_Start sending packets out because packets may move to the
3603 * freePacketQueue as result of being here! So we drop these packets until
3604 * we're safely out of the traversing. Really ugly!
3605 * To make it even uglier, if we're using fine grain locking, we can
3606 * set the ack bits in the packets and have rxi_Start remove the packets
3607 * when it's done transmitting.
3609 if (call->flags & RX_CALL_TQ_BUSY) {
3610 #ifdef RX_ENABLE_LOCKS
3611 tp->flags |= RX_PKTFLAG_ACKED;
3612 call->flags |= RX_CALL_TQ_SOME_ACKED;
3613 #else /* RX_ENABLE_LOCKS */
3615 #endif /* RX_ENABLE_LOCKS */
3617 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
3620 rxi_FreePacket(tp); /* rxi_FreePacket mustn't wake up anyone, preemptively. */
3625 /* Give rate detector a chance to respond to ping requests */
3626 if (ap->reason == RX_ACK_PING_RESPONSE) {
3627 rxi_ComputeRate(peer, call, 0, np, ap->reason);
3631 /* N.B. we don't turn off any timers here. They'll go away by themselves, anyway */
3633 /* Now go through explicit acks/nacks and record the results in
3634 * the waiting packets. These are packets that can't be released
3635 * yet, even with a positive acknowledge. This positive
3636 * acknowledge only means the packet has been received by the
3637 * peer, not that it will be retained long enough to be sent to
3638 * the peer's upper level. In addition, reset the transmit timers
3639 * of any missing packets (those packets that must be missing
3640 * because this packet was out of sequence) */
3642 call->nSoftAcked = 0;
3643 for (missing = 0, queue_Scan(&call->tq, tp, nxp, rx_packet)) {
3644 /* Update round trip time if the ack was stimulated on receipt
3646 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
3647 #ifdef RX_ENABLE_LOCKS
3648 if (tp->header.seq >= first)
3649 #endif /* RX_ENABLE_LOCKS */
3650 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
3652 && (tp->header.serial == serial || tp->firstSerial == serial))
3653 rxi_ComputePeerNetStats(call, tp, ap, np);
3655 /* Set the acknowledge flag per packet based on the
3656 * information in the ack packet. An acknowlegded packet can
3657 * be downgraded when the server has discarded a packet it
3658 * soacked previously, or when an ack packet is received
3659 * out of sequence. */
3660 if (tp->header.seq < first) {
3661 /* Implicit ack information */
3662 if (!(tp->flags & RX_PKTFLAG_ACKED)) {
3665 tp->flags |= RX_PKTFLAG_ACKED;
3666 } else if (tp->header.seq < first + nAcks) {
3667 /* Explicit ack information: set it in the packet appropriately */
3668 if (ap->acks[tp->header.seq - first] == RX_ACK_TYPE_ACK) {
3669 if (!(tp->flags & RX_PKTFLAG_ACKED)) {
3671 tp->flags |= RX_PKTFLAG_ACKED;
3678 } else /* RX_ACK_TYPE_NACK */ {
3679 tp->flags &= ~RX_PKTFLAG_ACKED;
3683 tp->flags &= ~RX_PKTFLAG_ACKED;
3687 /* If packet isn't yet acked, and it has been transmitted at least
3688 * once, reset retransmit time using latest timeout
3689 * ie, this should readjust the retransmit timer for all outstanding
3690 * packets... So we don't just retransmit when we should know better*/
3692 if (!(tp->flags & RX_PKTFLAG_ACKED) && !clock_IsZero(&tp->retryTime)) {
3693 tp->retryTime = tp->timeSent;
3694 clock_Add(&tp->retryTime, &peer->timeout);
3695 /* shift by eight because one quarter-sec ~ 256 milliseconds */
3696 clock_Addmsec(&(tp->retryTime), ((afs_uint32) tp->backoff) << 8);
3700 /* If the window has been extended by this acknowledge packet,
3701 * then wakeup a sender waiting in alloc for window space, or try
3702 * sending packets now, if he's been sitting on packets due to
3703 * lack of window space */
3704 if (call->tnext < (call->tfirst + call->twind)) {
3705 #ifdef RX_ENABLE_LOCKS
3706 CV_SIGNAL(&call->cv_twind);
3708 if (call->flags & RX_CALL_WAIT_WINDOW_ALLOC) {
3709 call->flags &= ~RX_CALL_WAIT_WINDOW_ALLOC;
3710 osi_rxWakeup(&call->twind);
3713 if (call->flags & RX_CALL_WAIT_WINDOW_SEND) {
3714 call->flags &= ~RX_CALL_WAIT_WINDOW_SEND;
3718 /* if the ack packet has a receivelen field hanging off it,
3719 * update our state */
3720 if (np->length >= rx_AckDataSize(ap->nAcks) + 2 * sizeof(afs_int32)) {
3723 /* If the ack packet has a "recommended" size that is less than
3724 * what I am using now, reduce my size to match */
3725 rx_packetread(np, rx_AckDataSize(ap->nAcks) + sizeof(afs_int32),
3726 (int)sizeof(afs_int32), &tSize);
3727 tSize = (afs_uint32) ntohl(tSize);
3728 peer->natMTU = rxi_AdjustIfMTU(MIN(tSize, peer->ifMTU));
3730 /* Get the maximum packet size to send to this peer */
3731 rx_packetread(np, rx_AckDataSize(ap->nAcks), (int)sizeof(afs_int32),
3733 tSize = (afs_uint32) ntohl(tSize);
3734 tSize = (afs_uint32) MIN(tSize, rx_MyMaxSendSize);
3735 tSize = rxi_AdjustMaxMTU(peer->natMTU, tSize);
3737 /* sanity check - peer might have restarted with different params.
3738 * If peer says "send less", dammit, send less... Peer should never
3739 * be unable to accept packets of the size that prior AFS versions would
3740 * send without asking. */
3741 if (peer->maxMTU != tSize) {
3742 if (peer->maxMTU > tSize) /* possible cong., maxMTU decreased */
3744 peer->maxMTU = tSize;
3745 peer->MTU = MIN(tSize, peer->MTU);
3746 call->MTU = MIN(call->MTU, tSize);
3749 if (np->length == rx_AckDataSize(ap->nAcks) + 3 * sizeof(afs_int32)) {
3752 rx_AckDataSize(ap->nAcks) + 2 * sizeof(afs_int32),
3753 (int)sizeof(afs_int32), &tSize);
3754 tSize = (afs_uint32) ntohl(tSize); /* peer's receive window, if it's */
3755 if (tSize < call->twind) { /* smaller than our send */
3756 call->twind = tSize; /* window, we must send less... */
3757 call->ssthresh = MIN(call->twind, call->ssthresh);
3760 /* Only send jumbograms to 3.4a fileservers. 3.3a RX gets the
3761 * network MTU confused with the loopback MTU. Calculate the
3762 * maximum MTU here for use in the slow start code below.
3764 maxMTU = peer->maxMTU;
3765 /* Did peer restart with older RX version? */
3766 if (peer->maxDgramPackets > 1) {
3767 peer->maxDgramPackets = 1;
3769 } else if (np->length >=
3770 rx_AckDataSize(ap->nAcks) + 4 * sizeof(afs_int32)) {
3773 rx_AckDataSize(ap->nAcks) + 2 * sizeof(afs_int32),
3774 sizeof(afs_int32), &tSize);
3775 tSize = (afs_uint32) ntohl(tSize);
3777 * As of AFS 3.5 we set the send window to match the receive window.
3779 if (tSize < call->twind) {
3780 call->twind = tSize;
3781 call->ssthresh = MIN(call->twind, call->ssthresh);
3782 } else if (tSize > call->twind) {
3783 call->twind = tSize;
3787 * As of AFS 3.5, a jumbogram is more than one fixed size
3788 * packet transmitted in a single UDP datagram. If the remote
3789 * MTU is smaller than our local MTU then never send a datagram
3790 * larger than the natural MTU.
3793 rx_AckDataSize(ap->nAcks) + 3 * sizeof(afs_int32),
3794 sizeof(afs_int32), &tSize);
3795 maxDgramPackets = (afs_uint32) ntohl(tSize);
3796 maxDgramPackets = MIN(maxDgramPackets, rxi_nDgramPackets);
3797 maxDgramPackets = MIN(maxDgramPackets, peer->ifDgramPackets);
3798 if (peer->natMTU < peer->ifMTU)
3799 maxDgramPackets = MIN(maxDgramPackets, rxi_AdjustDgramPackets(1, peer->natMTU));
3800 if (maxDgramPackets > 1) {
3801 peer->maxDgramPackets = maxDgramPackets;
3802 call->MTU = RX_JUMBOBUFFERSIZE + RX_HEADER_SIZE;
3804 peer->maxDgramPackets = 1;
3805 call->MTU = peer->natMTU;
3807 } else if (peer->maxDgramPackets > 1) {
3808 /* Restarted with lower version of RX */
3809 peer->maxDgramPackets = 1;
3811 } else if (peer->maxDgramPackets > 1
3812 || peer->maxMTU != OLD_MAX_PACKET_SIZE) {
3813 /* Restarted with lower version of RX */
3814 peer->maxMTU = OLD_MAX_PACKET_SIZE;
3815 peer->natMTU = OLD_MAX_PACKET_SIZE;
3816 peer->MTU = OLD_MAX_PACKET_SIZE;
3817 peer->maxDgramPackets = 1;
3818 peer->nDgramPackets = 1;
3820 call->MTU = OLD_MAX_PACKET_SIZE;
3825 * Calculate how many datagrams were successfully received after
3826 * the first missing packet and adjust the negative ack counter
3831 nNacked = (nNacked + call->nDgramPackets - 1) / call->nDgramPackets;
3832 if (call->nNacks < nNacked) {
3833 call->nNacks = nNacked;
3842 if (call->flags & RX_CALL_FAST_RECOVER) {
3844 call->cwind = MIN((int)(call->cwind + 1), rx_maxSendWindow);
3846 call->flags &= ~RX_CALL_FAST_RECOVER;
3847 call->cwind = call->nextCwind;
3848 call->nextCwind = 0;
3851 call->nCwindAcks = 0;
3852 } else if (nNacked && call->nNacks >= (u_short) rx_nackThreshold) {
3853 /* Three negative acks in a row trigger congestion recovery */
3854 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
3855 MUTEX_EXIT(&peer->peer_lock);
3856 if (call->flags & RX_CALL_FAST_RECOVER_WAIT) {
3857 /* someone else is waiting to start recovery */
3860 call->flags |= RX_CALL_FAST_RECOVER_WAIT;
3861 rxi_WaitforTQBusy(call);
3862 MUTEX_ENTER(&peer->peer_lock);
3863 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
3864 call->flags &= ~RX_CALL_FAST_RECOVER_WAIT;
3865 call->flags |= RX_CALL_FAST_RECOVER;
3866 call->ssthresh = MAX(4, MIN((int)call->cwind, (int)call->twind)) >> 1;
3868 MIN((int)(call->ssthresh + rx_nackThreshold), rx_maxSendWindow);
3869 call->nDgramPackets = MAX(2, (int)call->nDgramPackets) >> 1;
3870 call->nextCwind = call->ssthresh;
3873 peer->MTU = call->MTU;
3874 peer->cwind = call->nextCwind;
3875 peer->nDgramPackets = call->nDgramPackets;
3877 call->congestSeq = peer->congestSeq;
3878 /* Reset the resend times on the packets that were nacked
3879 * so we will retransmit as soon as the window permits*/
3880 for (acked = 0, queue_ScanBackwards(&call->tq, tp, nxp, rx_packet)) {
3882 if (!(tp->flags & RX_PKTFLAG_ACKED)) {
3883 clock_Zero(&tp->retryTime);
3885 } else if (tp->flags & RX_PKTFLAG_ACKED) {
3890 /* If cwind is smaller than ssthresh, then increase
3891 * the window one packet for each ack we receive (exponential
3893 * If cwind is greater than or equal to ssthresh then increase
3894 * the congestion window by one packet for each cwind acks we
3895 * receive (linear growth). */
3896 if (call->cwind < call->ssthresh) {
3898 MIN((int)call->ssthresh, (int)(call->cwind + newAckCount));
3899 call->nCwindAcks = 0;
3901 call->nCwindAcks += newAckCount;
3902 if (call->nCwindAcks >= call->cwind) {
3903 call->nCwindAcks = 0;
3904 call->cwind = MIN((int)(call->cwind + 1), rx_maxSendWindow);
3908 * If we have received several acknowledgements in a row then
3909 * it is time to increase the size of our datagrams
3911 if ((int)call->nAcks > rx_nDgramThreshold) {
3912 if (peer->maxDgramPackets > 1) {
3913 if (call->nDgramPackets < peer->maxDgramPackets) {
3914 call->nDgramPackets++;
3916 call->MTU = RX_HEADER_SIZE + RX_JUMBOBUFFERSIZE;
3917 } else if (call->MTU < peer->maxMTU) {
3918 call->MTU += peer->natMTU;
3919 call->MTU = MIN(call->MTU, peer->maxMTU);
3925 MUTEX_EXIT(&peer->peer_lock); /* rxi_Start will lock peer. */
3927 /* Servers need to hold the call until all response packets have
3928 * been acknowledged. Soft acks are good enough since clients
3929 * are not allowed to clear their receive queues. */
3930 if (call->state == RX_STATE_HOLD
3931 && call->tfirst + call->nSoftAcked >= call->tnext) {
3932 call->state = RX_STATE_DALLY;
3933 rxi_ClearTransmitQueue(call, 0);
3934 } else if (!queue_IsEmpty(&call->tq)) {
3935 rxi_Start(0, call, 0, istack);
3940 /* Received a response to a challenge packet */
3942 rxi_ReceiveResponsePacket(register struct rx_connection *conn,
3943 register struct rx_packet *np, int istack)
3947 /* Ignore the packet if we're the client */
3948 if (conn->type == RX_CLIENT_CONNECTION)
3951 /* If already authenticated, ignore the packet (it's probably a retry) */
3952 if (RXS_CheckAuthentication(conn->securityObject, conn) == 0)
3955 /* Otherwise, have the security object evaluate the response packet */
3956 error = RXS_CheckResponse(conn->securityObject, conn, np);
3958 /* If the response is invalid, reset the connection, sending
3959 * an abort to the peer */
3963 rxi_ConnectionError(conn, error);
3964 MUTEX_ENTER(&conn->conn_data_lock);
3965 np = rxi_SendConnectionAbort(conn, np, istack, 0);
3966 MUTEX_EXIT(&conn->conn_data_lock);
3969 /* If the response is valid, any calls waiting to attach
3970 * servers can now do so */
3973 for (i = 0; i < RX_MAXCALLS; i++) {
3974 struct rx_call *call = conn->call[i];
3976 MUTEX_ENTER(&call->lock);
3977 if (call->state == RX_STATE_PRECALL)
3978 rxi_AttachServerProc(call, (osi_socket) - 1, NULL, NULL);
3979 /* tnop can be null if newcallp is null */
3980 MUTEX_EXIT(&call->lock);
3984 /* Update the peer reachability information, just in case
3985 * some calls went into attach-wait while we were waiting
3986 * for authentication..
3988 rxi_UpdatePeerReach(conn, NULL);
3993 /* A client has received an authentication challenge: the security
3994 * object is asked to cough up a respectable response packet to send
3995 * back to the server. The server is responsible for retrying the
3996 * challenge if it fails to get a response. */
3999 rxi_ReceiveChallengePacket(register struct rx_connection *conn,
4000 register struct rx_packet *np, int istack)
4004 /* Ignore the challenge if we're the server */
4005 if (conn->type == RX_SERVER_CONNECTION)
4008 /* Ignore the challenge if the connection is otherwise idle; someone's
4009 * trying to use us as an oracle. */
4010 if (!rxi_HasActiveCalls(conn))
4013 /* Send the security object the challenge packet. It is expected to fill
4014 * in the response. */
4015 error = RXS_GetResponse(conn->securityObject, conn, np);
4017 /* If the security object is unable to return a valid response, reset the
4018 * connection and send an abort to the peer. Otherwise send the response
4019 * packet to the peer connection. */
4021 rxi_ConnectionError(conn, error);
4022 MUTEX_ENTER(&conn->conn_data_lock);
4023 np = rxi_SendConnectionAbort(conn, np, istack, 0);
4024 MUTEX_EXIT(&conn->conn_data_lock);
4026 np = rxi_SendSpecial((struct rx_call *)0, conn, np,
4027 RX_PACKET_TYPE_RESPONSE, NULL, -1, istack);
4033 /* Find an available server process to service the current request in
4034 * the given call structure. If one isn't available, queue up this
4035 * call so it eventually gets one */
4037 rxi_AttachServerProc(register struct rx_call *call,
4038 register osi_socket socket, register int *tnop,
4039 register struct rx_call **newcallp)
4041 register struct rx_serverQueueEntry *sq;
4042 register struct rx_service *service = call->conn->service;
4043 register int haveQuota = 0;
4045 /* May already be attached */
4046 if (call->state == RX_STATE_ACTIVE)
4049 MUTEX_ENTER(&rx_serverPool_lock);
4051 haveQuota = QuotaOK(service);
4052 if ((!haveQuota) || queue_IsEmpty(&rx_idleServerQueue)) {
4053 /* If there are no processes available to service this call,
4054 * put the call on the incoming call queue (unless it's
4055 * already on the queue).
4057 #ifdef RX_ENABLE_LOCKS
4059 ReturnToServerPool(service);
4060 #endif /* RX_ENABLE_LOCKS */
4062 if (!(call->flags & RX_CALL_WAIT_PROC)) {
4063 call->flags |= RX_CALL_WAIT_PROC;
4064 MUTEX_ENTER(&rx_stats_mutex);
4067 MUTEX_EXIT(&rx_stats_mutex);
4068 rxi_calltrace(RX_CALL_ARRIVAL, call);
4069 SET_CALL_QUEUE_LOCK(call, &rx_serverPool_lock);
4070 queue_Append(&rx_incomingCallQueue, call);
4073 sq = queue_First(&rx_idleServerQueue, rx_serverQueueEntry);
4075 /* If hot threads are enabled, and both newcallp and sq->socketp
4076 * are non-null, then this thread will process the call, and the
4077 * idle server thread will start listening on this threads socket.
4080 if (rx_enable_hot_thread && newcallp && sq->socketp) {
4083 *sq->socketp = socket;
4084 clock_GetTime(&call->startTime);
4085 CALL_HOLD(call, RX_CALL_REFCOUNT_BEGIN);
4089 if (call->flags & RX_CALL_WAIT_PROC) {
4090 /* Conservative: I don't think this should happen */
4091 call->flags &= ~RX_CALL_WAIT_PROC;
4092 if (queue_IsOnQueue(call)) {
4094 MUTEX_ENTER(&rx_stats_mutex);
4096 MUTEX_EXIT(&rx_stats_mutex);
4099 call->state = RX_STATE_ACTIVE;
4100 call->mode = RX_MODE_RECEIVING;
4101 #ifdef RX_KERNEL_TRACE
4103 int glockOwner = ISAFS_GLOCK();
4106 afs_Trace3(afs_iclSetp, CM_TRACE_WASHERE, ICL_TYPE_STRING,
4107 __FILE__, ICL_TYPE_INT32, __LINE__, ICL_TYPE_POINTER,
4113 if (call->flags & RX_CALL_CLEARED) {
4114 /* send an ack now to start the packet flow up again */
4115 call->flags &= ~RX_CALL_CLEARED;
4116 rxi_SendAck(call, 0, 0, RX_ACK_DELAY, 0);
4118 #ifdef RX_ENABLE_LOCKS
4121 service->nRequestsRunning++;
4122 if (service->nRequestsRunning <= service->minProcs)
4128 MUTEX_EXIT(&rx_serverPool_lock);
4131 /* Delay the sending of an acknowledge event for a short while, while
4132 * a new call is being prepared (in the case of a client) or a reply
4133 * is being prepared (in the case of a server). Rather than sending
4134 * an ack packet, an ACKALL packet is sent. */
4136 rxi_AckAll(struct rxevent *event, register struct rx_call *call, char *dummy)
4138 #ifdef RX_ENABLE_LOCKS
4140 MUTEX_ENTER(&call->lock);
4141 call->delayedAckEvent = NULL;
4142 CALL_RELE(call, RX_CALL_REFCOUNT_ACKALL);
4144 rxi_SendSpecial(call, call->conn, (struct rx_packet *)0,
4145 RX_PACKET_TYPE_ACKALL, NULL, 0, 0);
4147 MUTEX_EXIT(&call->lock);
4148 #else /* RX_ENABLE_LOCKS */
4150 call->delayedAckEvent = NULL;
4151 rxi_SendSpecial(call, call->conn, (struct rx_packet *)0,
4152 RX_PACKET_TYPE_ACKALL, NULL, 0, 0);
4153 #endif /* RX_ENABLE_LOCKS */
4157 rxi_SendDelayedAck(struct rxevent *event, register struct rx_call *call,
4160 #ifdef RX_ENABLE_LOCKS
4162 MUTEX_ENTER(&call->lock);
4163 if (event == call->delayedAckEvent)
4164 call->delayedAckEvent = NULL;
4165 CALL_RELE(call, RX_CALL_REFCOUNT_DELAY);
4167 (void)rxi_SendAck(call, 0, 0, RX_ACK_DELAY, 0);
4169 MUTEX_EXIT(&call->lock);
4170 #else /* RX_ENABLE_LOCKS */
4172 call->delayedAckEvent = NULL;
4173 (void)rxi_SendAck(call, 0, 0, RX_ACK_DELAY, 0);
4174 #endif /* RX_ENABLE_LOCKS */
4178 #ifdef RX_ENABLE_LOCKS
4179 /* Set ack in all packets in transmit queue. rxi_Start will deal with
4180 * clearing them out.
4183 rxi_SetAcksInTransmitQueue(register struct rx_call *call)
4185 register struct rx_packet *p, *tp;
4188 for (queue_Scan(&call->tq, p, tp, rx_packet)) {
4189 p->flags |= RX_PKTFLAG_ACKED;
4193 call->flags |= RX_CALL_TQ_CLEARME;
4194 call->flags |= RX_CALL_TQ_SOME_ACKED;
4197 rxevent_Cancel(call->resendEvent, call, RX_CALL_REFCOUNT_RESEND);
4198 rxevent_Cancel(call->keepAliveEvent, call, RX_CALL_REFCOUNT_ALIVE);
4199 call->tfirst = call->tnext;
4200 call->nSoftAcked = 0;
4202 if (call->flags & RX_CALL_FAST_RECOVER) {
4203 call->flags &= ~RX_CALL_FAST_RECOVER;
4204 call->cwind = call->nextCwind;
4205 call->nextCwind = 0;
4208 CV_SIGNAL(&call->cv_twind);
4210 #endif /* RX_ENABLE_LOCKS */
4212 /* Clear out the transmit queue for the current call (all packets have
4213 * been received by peer) */
4215 rxi_ClearTransmitQueue(register struct rx_call *call, register int force)
4217 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
4218 register struct rx_packet *p, *tp;
4220 if (!force && (call->flags & RX_CALL_TQ_BUSY)) {
4222 for (queue_Scan(&call->tq, p, tp, rx_packet)) {
4223 p->flags |= RX_PKTFLAG_ACKED;
4227 call->flags |= RX_CALL_TQ_CLEARME;
4228 call->flags |= RX_CALL_TQ_SOME_ACKED;
4231 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
4232 rxi_FreePackets(0, &call->tq);
4233 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
4234 call->flags &= ~RX_CALL_TQ_CLEARME;
4236 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
4238 rxevent_Cancel(call->resendEvent, call, RX_CALL_REFCOUNT_RESEND);
4239 rxevent_Cancel(call->keepAliveEvent, call, RX_CALL_REFCOUNT_ALIVE);
4240 call->tfirst = call->tnext; /* implicitly acknowledge all data already sent */
4241 call->nSoftAcked = 0;
4243 if (call->flags & RX_CALL_FAST_RECOVER) {
4244 call->flags &= ~RX_CALL_FAST_RECOVER;
4245 call->cwind = call->nextCwind;
4247 #ifdef RX_ENABLE_LOCKS
4248 CV_SIGNAL(&call->cv_twind);
4250 osi_rxWakeup(&call->twind);
4255 rxi_ClearReceiveQueue(register struct rx_call *call)
4257 if (queue_IsNotEmpty(&call->rq)) {
4258 rx_packetReclaims += rxi_FreePackets(0, &call->rq);
4259 call->flags &= ~(RX_CALL_RECEIVE_DONE | RX_CALL_HAVE_LAST);
4261 if (call->state == RX_STATE_PRECALL) {
4262 call->flags |= RX_CALL_CLEARED;
4266 /* Send an abort packet for the specified call */
4268 rxi_SendCallAbort(register struct rx_call *call, struct rx_packet *packet,
4269 int istack, int force)
4272 struct clock when, now;
4277 /* Clients should never delay abort messages */
4278 if (rx_IsClientConn(call->conn))
4281 if (call->abortCode != call->error) {
4282 call->abortCode = call->error;
4283 call->abortCount = 0;
4286 if (force || rxi_callAbortThreshhold == 0
4287 || call->abortCount < rxi_callAbortThreshhold) {
4288 if (call->delayedAbortEvent) {
4289 rxevent_Cancel(call->delayedAbortEvent, call,
4290 RX_CALL_REFCOUNT_ABORT);
4292 error = htonl(call->error);
4295 rxi_SendSpecial(call, call->conn, packet, RX_PACKET_TYPE_ABORT,
4296 (char *)&error, sizeof(error), istack);
4297 } else if (!call->delayedAbortEvent) {
4298 clock_GetTime(&now);
4300 clock_Addmsec(&when, rxi_callAbortDelay);
4301 CALL_HOLD(call, RX_CALL_REFCOUNT_ABORT);
4302 call->delayedAbortEvent =
4303 rxevent_PostNow(&when, &now, rxi_SendDelayedCallAbort, call, 0);
4308 /* Send an abort packet for the specified connection. Packet is an
4309 * optional pointer to a packet that can be used to send the abort.
4310 * Once the number of abort messages reaches the threshhold, an
4311 * event is scheduled to send the abort. Setting the force flag
4312 * overrides sending delayed abort messages.
4314 * NOTE: Called with conn_data_lock held. conn_data_lock is dropped
4315 * to send the abort packet.
4318 rxi_SendConnectionAbort(register struct rx_connection *conn,
4319 struct rx_packet *packet, int istack, int force)
4322 struct clock when, now;
4327 /* Clients should never delay abort messages */
4328 if (rx_IsClientConn(conn))
4331 if (force || rxi_connAbortThreshhold == 0
4332 || conn->abortCount < rxi_connAbortThreshhold) {
4333 if (conn->delayedAbortEvent) {
4334 rxevent_Cancel(conn->delayedAbortEvent, (struct rx_call *)0, 0);
4336 error = htonl(conn->error);
4338 MUTEX_EXIT(&conn->conn_data_lock);
4340 rxi_SendSpecial((struct rx_call *)0, conn, packet,
4341 RX_PACKET_TYPE_ABORT, (char *)&error,
4342 sizeof(error), istack);
4343 MUTEX_ENTER(&conn->conn_data_lock);
4344 } else if (!conn->delayedAbortEvent) {
4345 clock_GetTime(&now);
4347 clock_Addmsec(&when, rxi_connAbortDelay);
4348 conn->delayedAbortEvent =
4349 rxevent_PostNow(&when, &now, rxi_SendDelayedConnAbort, conn, 0);
4354 /* Associate an error all of the calls owned by a connection. Called
4355 * with error non-zero. This is only for really fatal things, like
4356 * bad authentication responses. The connection itself is set in
4357 * error at this point, so that future packets received will be
4360 rxi_ConnectionError(register struct rx_connection *conn,
4361 register afs_int32 error)
4366 dpf(("rxi_ConnectionError conn %x error %d", conn, error));
4368 MUTEX_ENTER(&conn->conn_data_lock);
4369 if (conn->challengeEvent)
4370 rxevent_Cancel(conn->challengeEvent, (struct rx_call *)0, 0);
4371 if (conn->checkReachEvent) {
4372 rxevent_Cancel(conn->checkReachEvent, (struct rx_call *)0, 0);
4373 conn->checkReachEvent = 0;
4374 conn->flags &= ~RX_CONN_ATTACHWAIT;
4377 MUTEX_EXIT(&conn->conn_data_lock);
4378 for (i = 0; i < RX_MAXCALLS; i++) {
4379 struct rx_call *call = conn->call[i];
4381 MUTEX_ENTER(&call->lock);
4382 rxi_CallError(call, error);
4383 MUTEX_EXIT(&call->lock);
4386 conn->error = error;
4387 rx_MutexIncrement(rx_stats.fatalErrors, rx_stats_mutex);
4392 rxi_CallError(register struct rx_call *call, afs_int32 error)
4394 dpf(("rxi_CallError call %x error %d call->error %d", call, error, call->error));
4396 error = call->error;
4398 #ifdef RX_GLOBAL_RXLOCK_KERNEL
4399 if (!((call->flags & RX_CALL_TQ_BUSY) || (call->tqWaiters > 0))) {
4400 rxi_ResetCall(call, 0);
4403 rxi_ResetCall(call, 0);
4405 call->error = error;
4406 call->mode = RX_MODE_ERROR;
4409 /* Reset various fields in a call structure, and wakeup waiting
4410 * processes. Some fields aren't changed: state & mode are not
4411 * touched (these must be set by the caller), and bufptr, nLeft, and
4412 * nFree are not reset, since these fields are manipulated by
4413 * unprotected macros, and may only be reset by non-interrupting code.
4416 /* this code requires that call->conn be set properly as a pre-condition. */
4417 #endif /* ADAPT_WINDOW */
4420 rxi_ResetCall(register struct rx_call *call, register int newcall)
4423 register struct rx_peer *peer;
4424 struct rx_packet *packet;
4426 dpf(("rxi_ResetCall(call %x, newcall %d)\n", call, newcall));
4428 /* Notify anyone who is waiting for asynchronous packet arrival */
4429 if (call->arrivalProc) {
4430 (*call->arrivalProc) (call, call->arrivalProcHandle,
4431 call->arrivalProcArg);
4432 call->arrivalProc = (void (*)())0;
4435 if (call->delayedAbortEvent) {
4436 rxevent_Cancel(call->delayedAbortEvent, call, RX_CALL_REFCOUNT_ABORT);
4437 packet = rxi_AllocPacket(RX_PACKET_CLASS_SPECIAL);
4439 rxi_SendCallAbort(call, packet, 0, 1);
4440 rxi_FreePacket(packet);
4445 * Update the peer with the congestion information in this call
4446 * so other calls on this connection can pick up where this call
4447 * left off. If the congestion sequence numbers don't match then
4448 * another call experienced a retransmission.
4450 peer = call->conn->peer;
4451 MUTEX_ENTER(&peer->peer_lock);
4453 if (call->congestSeq == peer->congestSeq) {
4454 peer->cwind = MAX(peer->cwind, call->cwind);
4455 peer->MTU = MAX(peer->MTU, call->MTU);
4456 peer->nDgramPackets =
4457 MAX(peer->nDgramPackets, call->nDgramPackets);
4460 call->abortCode = 0;
4461 call->abortCount = 0;
4463 if (peer->maxDgramPackets > 1) {
4464 call->MTU = RX_HEADER_SIZE + RX_JUMBOBUFFERSIZE;
4466 call->MTU = peer->MTU;
4468 call->cwind = MIN((int)peer->cwind, (int)peer->nDgramPackets);
4469 call->ssthresh = rx_maxSendWindow;
4470 call->nDgramPackets = peer->nDgramPackets;
4471 call->congestSeq = peer->congestSeq;
4472 MUTEX_EXIT(&peer->peer_lock);
4474 flags = call->flags;
4475 rxi_ClearReceiveQueue(call);
4476 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
4477 if (flags & RX_CALL_TQ_BUSY) {
4478 call->flags = RX_CALL_TQ_CLEARME | RX_CALL_TQ_BUSY;
4479 call->flags |= (flags & RX_CALL_TQ_WAIT);
4481 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
4483 rxi_ClearTransmitQueue(call, 0);
4484 queue_Init(&call->tq);
4485 if (call->tqWaiters || (flags & RX_CALL_TQ_WAIT)) {
4486 dpf(("rcall %x has %d waiters and flags %d\n", call, call->tqWaiters, call->flags));
4489 while (call->tqWaiters) {
4490 #ifdef RX_ENABLE_LOCKS
4491 CV_BROADCAST(&call->cv_tq);
4492 #else /* RX_ENABLE_LOCKS */
4493 osi_rxWakeup(&call->tq);
4494 #endif /* RX_ENABLE_LOCKS */
4498 queue_Init(&call->rq);
4500 call->rwind = rx_initReceiveWindow;
4501 call->twind = rx_initSendWindow;
4502 call->nSoftAcked = 0;
4503 call->nextCwind = 0;
4506 call->nCwindAcks = 0;
4507 call->nSoftAcks = 0;
4508 call->nHardAcks = 0;
4510 call->tfirst = call->rnext = call->tnext = 1;
4512 call->lastAcked = 0;
4513 call->localStatus = call->remoteStatus = 0;
4515 if (flags & RX_CALL_READER_WAIT) {
4516 #ifdef RX_ENABLE_LOCKS
4517 CV_BROADCAST(&call->cv_rq);
4519 osi_rxWakeup(&call->rq);
4522 if (flags & RX_CALL_WAIT_PACKETS) {
4523 MUTEX_ENTER(&rx_freePktQ_lock);
4524 rxi_PacketsUnWait(); /* XXX */
4525 MUTEX_EXIT(&rx_freePktQ_lock);
4527 #ifdef RX_ENABLE_LOCKS
4528 CV_SIGNAL(&call->cv_twind);
4530 if (flags & RX_CALL_WAIT_WINDOW_ALLOC)
4531 osi_rxWakeup(&call->twind);
4534 #ifdef RX_ENABLE_LOCKS
4535 /* The following ensures that we don't mess with any queue while some
4536 * other thread might also be doing so. The call_queue_lock field is
4537 * is only modified under the call lock. If the call is in the process
4538 * of being removed from a queue, the call is not locked until the
4539 * the queue lock is dropped and only then is the call_queue_lock field
4540 * zero'd out. So it's safe to lock the queue if call_queue_lock is set.
4541 * Note that any other routine which removes a call from a queue has to
4542 * obtain the queue lock before examing the queue and removing the call.
4544 if (call->call_queue_lock) {
4545 MUTEX_ENTER(call->call_queue_lock);
4546 if (queue_IsOnQueue(call)) {
4548 if (flags & RX_CALL_WAIT_PROC) {
4549 MUTEX_ENTER(&rx_stats_mutex);
4551 MUTEX_EXIT(&rx_stats_mutex);
4554 MUTEX_EXIT(call->call_queue_lock);
4555 CLEAR_CALL_QUEUE_LOCK(call);
4557 #else /* RX_ENABLE_LOCKS */
4558 if (queue_IsOnQueue(call)) {
4560 if (flags & RX_CALL_WAIT_PROC)
4563 #endif /* RX_ENABLE_LOCKS */
4565 rxi_KeepAliveOff(call);
4566 rxevent_Cancel(call->delayedAckEvent, call, RX_CALL_REFCOUNT_DELAY);
4569 /* Send an acknowledge for the indicated packet (seq,serial) of the
4570 * indicated call, for the indicated reason (reason). This
4571 * acknowledge will specifically acknowledge receiving the packet, and
4572 * will also specify which other packets for this call have been
4573 * received. This routine returns the packet that was used to the
4574 * caller. The caller is responsible for freeing it or re-using it.
4575 * This acknowledgement also returns the highest sequence number
4576 * actually read out by the higher level to the sender; the sender
4577 * promises to keep around packets that have not been read by the
4578 * higher level yet (unless, of course, the sender decides to abort
4579 * the call altogether). Any of p, seq, serial, pflags, or reason may
4580 * be set to zero without ill effect. That is, if they are zero, they
4581 * will not convey any information.
4582 * NOW there is a trailer field, after the ack where it will safely be
4583 * ignored by mundanes, which indicates the maximum size packet this
4584 * host can swallow. */
4586 register struct rx_packet *optionalPacket; use to send ack (or null)
4587 int seq; Sequence number of the packet we are acking
4588 int serial; Serial number of the packet
4589 int pflags; Flags field from packet header
4590 int reason; Reason an acknowledge was prompted
4594 rxi_SendAck(register struct rx_call *call,
4595 register struct rx_packet *optionalPacket, int serial, int reason,
4598 struct rx_ackPacket *ap;
4599 register struct rx_packet *rqp;
4600 register struct rx_packet *nxp; /* For queue_Scan */
4601 register struct rx_packet *p;
4604 #ifdef RX_ENABLE_TSFPQ
4605 struct rx_ts_info_t * rx_ts_info;
4609 * Open the receive window once a thread starts reading packets
4611 if (call->rnext > 1) {
4612 call->rwind = rx_maxReceiveWindow;
4615 call->nHardAcks = 0;
4616 call->nSoftAcks = 0;
4617 if (call->rnext > call->lastAcked)
4618 call->lastAcked = call->rnext;
4622 rx_computelen(p, p->length); /* reset length, you never know */
4623 } /* where that's been... */
4624 #ifdef RX_ENABLE_TSFPQ
4626 RX_TS_INFO_GET(rx_ts_info);
4627 if ((p = rx_ts_info->local_special_packet)) {
4628 rx_computelen(p, p->length);
4629 } else if ((p = rxi_AllocPacket(RX_PACKET_CLASS_SPECIAL))) {
4630 rx_ts_info->local_special_packet = p;
4631 } else { /* We won't send the ack, but don't panic. */
4632 return optionalPacket;
4636 else if (!(p = rxi_AllocPacket(RX_PACKET_CLASS_SPECIAL))) {
4637 /* We won't send the ack, but don't panic. */
4638 return optionalPacket;
4643 rx_AckDataSize(call->rwind) + 4 * sizeof(afs_int32) -
4646 if (rxi_AllocDataBuf(p, templ, RX_PACKET_CLASS_SPECIAL) > 0) {
4647 #ifndef RX_ENABLE_TSFPQ
4648 if (!optionalPacket)
4651 return optionalPacket;
4653 templ = rx_AckDataSize(call->rwind) + 2 * sizeof(afs_int32);
4654 if (rx_Contiguous(p) < templ) {
4655 #ifndef RX_ENABLE_TSFPQ
4656 if (!optionalPacket)
4659 return optionalPacket;
4664 /* MTUXXX failing to send an ack is very serious. We should */
4665 /* try as hard as possible to send even a partial ack; it's */
4666 /* better than nothing. */
4667 ap = (struct rx_ackPacket *)rx_DataOf(p);
4668 ap->bufferSpace = htonl(0); /* Something should go here, sometime */
4669 ap->reason = reason;
4671 /* The skew computation used to be bogus, I think it's better now. */
4672 /* We should start paying attention to skew. XXX */
4673 ap->serial = htonl(serial);
4674 ap->maxSkew = 0; /* used to be peer->inPacketSkew */
4676 ap->firstPacket = htonl(call->rnext); /* First packet not yet forwarded to reader */
4677 ap->previousPacket = htonl(call->rprev); /* Previous packet received */
4679 /* No fear of running out of ack packet here because there can only be at most
4680 * one window full of unacknowledged packets. The window size must be constrained
4681 * to be less than the maximum ack size, of course. Also, an ack should always
4682 * fit into a single packet -- it should not ever be fragmented. */
4683 for (offset = 0, queue_Scan(&call->rq, rqp, nxp, rx_packet)) {
4684 if (!rqp || !call->rq.next
4685 || (rqp->header.seq > (call->rnext + call->rwind))) {
4686 #ifndef RX_ENABLE_TSFPQ
4687 if (!optionalPacket)
4690 rxi_CallError(call, RX_CALL_DEAD);
4691 return optionalPacket;
4694 while (rqp->header.seq > call->rnext + offset)
4695 ap->acks[offset++] = RX_ACK_TYPE_NACK;
4696 ap->acks[offset++] = RX_ACK_TYPE_ACK;
4698 if ((offset > (u_char) rx_maxReceiveWindow) || (offset > call->rwind)) {
4699 #ifndef RX_ENABLE_TSFPQ
4700 if (!optionalPacket)
4703 rxi_CallError(call, RX_CALL_DEAD);
4704 return optionalPacket;
4709 p->length = rx_AckDataSize(offset) + 4 * sizeof(afs_int32);
4711 /* these are new for AFS 3.3 */
4712 templ = rxi_AdjustMaxMTU(call->conn->peer->ifMTU, rx_maxReceiveSize);
4713 templ = htonl(templ);
4714 rx_packetwrite(p, rx_AckDataSize(offset), sizeof(afs_int32), &templ);
4715 templ = htonl(call->conn->peer->ifMTU);
4716 rx_packetwrite(p, rx_AckDataSize(offset) + sizeof(afs_int32),
4717 sizeof(afs_int32), &templ);
4719 /* new for AFS 3.4 */
4720 templ = htonl(call->rwind);
4721 rx_packetwrite(p, rx_AckDataSize(offset) + 2 * sizeof(afs_int32),
4722 sizeof(afs_int32), &templ);
4724 /* new for AFS 3.5 */
4725 templ = htonl(call->conn->peer->ifDgramPackets);
4726 rx_packetwrite(p, rx_AckDataSize(offset) + 3 * sizeof(afs_int32),
4727 sizeof(afs_int32), &templ);
4729 p->header.serviceId = call->conn->serviceId;
4730 p->header.cid = (call->conn->cid | call->channel);
4731 p->header.callNumber = *call->callNumber;
4733 p->header.securityIndex = call->conn->securityIndex;
4734 p->header.epoch = call->conn->epoch;
4735 p->header.type = RX_PACKET_TYPE_ACK;
4736 p->header.flags = RX_SLOW_START_OK;
4737 if (reason == RX_ACK_PING) {
4738 p->header.flags |= RX_REQUEST_ACK;
4740 clock_GetTime(&call->pingRequestTime);
4743 if (call->conn->type == RX_CLIENT_CONNECTION)
4744 p->header.flags |= RX_CLIENT_INITIATED;
4748 if (rxdebug_active) {
4752 len = _snprintf(msg, sizeof(msg),
4753 "tid[%d] SACK: reason %s serial %u previous %u seq %u first %u acks %u space %u ",
4754 GetCurrentThreadId(), rx_ack_reason(ap->reason),
4755 ntohl(ap->serial), ntohl(ap->previousPacket),
4756 (unsigned int)p->header.seq, ntohl(ap->firstPacket),
4757 ap->nAcks, ntohs(ap->bufferSpace) );
4761 for (offset = 0; offset < ap->nAcks && len < sizeof(msg); offset++)
4762 msg[len++] = (ap->acks[offset] == RX_ACK_TYPE_NACK ? '-' : '*');
4766 OutputDebugString(msg);
4768 #else /* AFS_NT40_ENV */
4770 fprintf(rx_Log, "SACK: reason %x previous %u seq %u first %u ",
4771 ap->reason, ntohl(ap->previousPacket),
4772 (unsigned int)p->header.seq, ntohl(ap->firstPacket));
4774 for (offset = 0; offset < ap->nAcks; offset++)
4775 putc(ap->acks[offset] == RX_ACK_TYPE_NACK ? '-' : '*',
4780 #endif /* AFS_NT40_ENV */
4783 register int i, nbytes = p->length;
4785 for (i = 1; i < p->niovecs; i++) { /* vec 0 is ALWAYS header */
4786 if (nbytes <= p->wirevec[i].iov_len) {
4787 register int savelen, saven;
4789 savelen = p->wirevec[i].iov_len;
4791 p->wirevec[i].iov_len = nbytes;
4793 rxi_Send(call, p, istack);
4794 p->wirevec[i].iov_len = savelen;
4798 nbytes -= p->wirevec[i].iov_len;
4801 rx_MutexIncrement(rx_stats.ackPacketsSent, rx_stats_mutex);
4802 #ifndef RX_ENABLE_TSFPQ
4803 if (!optionalPacket)
4806 return optionalPacket; /* Return packet for re-use by caller */
4809 /* Send all of the packets in the list in single datagram */
4811 rxi_SendList(struct rx_call *call, struct rx_packet **list, int len,
4812 int istack, int moreFlag, struct clock *now,
4813 struct clock *retryTime, int resending)
4818 struct rx_connection *conn = call->conn;
4819 struct rx_peer *peer = conn->peer;
4821 MUTEX_ENTER(&peer->peer_lock);
4824 peer->reSends += len;
4825 rx_MutexIncrement(rx_stats.dataPacketsSent, rx_stats_mutex);
4826 MUTEX_EXIT(&peer->peer_lock);
4828 if (list[len - 1]->header.flags & RX_LAST_PACKET) {
4832 /* Set the packet flags and schedule the resend events */
4833 /* Only request an ack for the last packet in the list */
4834 for (i = 0; i < len; i++) {
4835 list[i]->retryTime = *retryTime;
4836 if (list[i]->header.serial) {
4837 /* Exponentially backoff retry times */
4838 if (list[i]->backoff < MAXBACKOFF) {
4839 /* so it can't stay == 0 */
4840 list[i]->backoff = (list[i]->backoff << 1) + 1;
4843 clock_Addmsec(&(list[i]->retryTime),
4844 ((afs_uint32) list[i]->backoff) << 8);
4847 /* Wait a little extra for the ack on the last packet */
4848 if (lastPacket && !(list[i]->header.flags & RX_CLIENT_INITIATED)) {
4849 clock_Addmsec(&(list[i]->retryTime), 400);
4852 /* Record the time sent */
4853 list[i]->timeSent = *now;
4855 /* Ask for an ack on retransmitted packets, on every other packet
4856 * if the peer doesn't support slow start. Ask for an ack on every
4857 * packet until the congestion window reaches the ack rate. */
4858 if (list[i]->header.serial) {
4860 rx_MutexIncrement(rx_stats.dataPacketsReSent, rx_stats_mutex);
4862 /* improved RTO calculation- not Karn */
4863 list[i]->firstSent = *now;
4864 if (!lastPacket && (call->cwind <= (u_short) (conn->ackRate + 1)
4865 || (!(call->flags & RX_CALL_SLOW_START_OK)
4866 && (list[i]->header.seq & 1)))) {
4871 MUTEX_ENTER(&peer->peer_lock);
4875 rx_MutexIncrement(rx_stats.dataPacketsSent, rx_stats_mutex);
4876 MUTEX_EXIT(&peer->peer_lock);
4878 /* Tag this packet as not being the last in this group,
4879 * for the receiver's benefit */
4880 if (i < len - 1 || moreFlag) {
4881 list[i]->header.flags |= RX_MORE_PACKETS;
4884 /* Install the new retransmit time for the packet, and
4885 * record the time sent */
4886 list[i]->timeSent = *now;
4890 list[len - 1]->header.flags |= RX_REQUEST_ACK;
4893 /* Since we're about to send a data packet to the peer, it's
4894 * safe to nuke any scheduled end-of-packets ack */
4895 rxevent_Cancel(call->delayedAckEvent, call, RX_CALL_REFCOUNT_DELAY);
4897 CALL_HOLD(call, RX_CALL_REFCOUNT_SEND);
4898 MUTEX_EXIT(&call->lock);
4900 rxi_SendPacketList(call, conn, list, len, istack);
4902 rxi_SendPacket(call, conn, list[0], istack);
4904 MUTEX_ENTER(&call->lock);
4905 CALL_RELE(call, RX_CALL_REFCOUNT_SEND);
4907 /* Update last send time for this call (for keep-alive
4908 * processing), and for the connection (so that we can discover
4909 * idle connections) */
4910 conn->lastSendTime = call->lastSendTime = clock_Sec();
4913 /* When sending packets we need to follow these rules:
4914 * 1. Never send more than maxDgramPackets in a jumbogram.
4915 * 2. Never send a packet with more than two iovecs in a jumbogram.
4916 * 3. Never send a retransmitted packet in a jumbogram.
4917 * 4. Never send more than cwind/4 packets in a jumbogram
4918 * We always keep the last list we should have sent so we
4919 * can set the RX_MORE_PACKETS flags correctly.
4922 rxi_SendXmitList(struct rx_call *call, struct rx_packet **list, int len,
4923 int istack, struct clock *now, struct clock *retryTime,
4926 int i, cnt, lastCnt = 0;
4927 struct rx_packet **listP, **lastP = 0;
4928 struct rx_peer *peer = call->conn->peer;
4929 int morePackets = 0;
4931 for (cnt = 0, listP = &list[0], i = 0; i < len; i++) {
4932 /* Does the current packet force us to flush the current list? */
4934 && (list[i]->header.serial || (list[i]->flags & RX_PKTFLAG_ACKED)
4935 || list[i]->length > RX_JUMBOBUFFERSIZE)) {
4937 rxi_SendList(call, lastP, lastCnt, istack, 1, now, retryTime,
4939 /* If the call enters an error state stop sending, or if
4940 * we entered congestion recovery mode, stop sending */
4941 if (call->error || (call->flags & RX_CALL_FAST_RECOVER_WAIT))
4949 /* Add the current packet to the list if it hasn't been acked.
4950 * Otherwise adjust the list pointer to skip the current packet. */
4951 if (!(list[i]->flags & RX_PKTFLAG_ACKED)) {
4953 /* Do we need to flush the list? */
4954 if (cnt >= (int)peer->maxDgramPackets
4955 || cnt >= (int)call->nDgramPackets || cnt >= (int)call->cwind
4956 || list[i]->header.serial
4957 || list[i]->length != RX_JUMBOBUFFERSIZE) {
4959 rxi_SendList(call, lastP, lastCnt, istack, 1, now,
4960 retryTime, resending);
4961 /* If the call enters an error state stop sending, or if
4962 * we entered congestion recovery mode, stop sending */
4964 || (call->flags & RX_CALL_FAST_RECOVER_WAIT))
4969 listP = &list[i + 1];
4974 osi_Panic("rxi_SendList error");
4976 listP = &list[i + 1];
4980 /* Send the whole list when the call is in receive mode, when
4981 * the call is in eof mode, when we are in fast recovery mode,
4982 * and when we have the last packet */
4983 if ((list[len - 1]->header.flags & RX_LAST_PACKET)
4984 || call->mode == RX_MODE_RECEIVING || call->mode == RX_MODE_EOF
4985 || (call->flags & RX_CALL_FAST_RECOVER)) {
4986 /* Check for the case where the current list contains
4987 * an acked packet. Since we always send retransmissions
4988 * in a separate packet, we only need to check the first
4989 * packet in the list */
4990 if (cnt > 0 && !(listP[0]->flags & RX_PKTFLAG_ACKED)) {
4994 rxi_SendList(call, lastP, lastCnt, istack, morePackets, now,
4995 retryTime, resending);
4996 /* If the call enters an error state stop sending, or if
4997 * we entered congestion recovery mode, stop sending */
4998 if (call->error || (call->flags & RX_CALL_FAST_RECOVER_WAIT))
5002 rxi_SendList(call, listP, cnt, istack, 0, now, retryTime,
5005 } else if (lastCnt > 0) {
5006 rxi_SendList(call, lastP, lastCnt, istack, 0, now, retryTime,
5011 #ifdef RX_ENABLE_LOCKS
5012 /* Call rxi_Start, below, but with the call lock held. */
5014 rxi_StartUnlocked(struct rxevent *event, register struct rx_call *call,
5015 void *arg1, int istack)
5017 MUTEX_ENTER(&call->lock);
5018 rxi_Start(event, call, arg1, istack);
5019 MUTEX_EXIT(&call->lock);
5021 #endif /* RX_ENABLE_LOCKS */
5023 /* This routine is called when new packets are readied for
5024 * transmission and when retransmission may be necessary, or when the
5025 * transmission window or burst count are favourable. This should be
5026 * better optimized for new packets, the usual case, now that we've
5027 * got rid of queues of send packets. XXXXXXXXXXX */
5029 rxi_Start(struct rxevent *event, register struct rx_call *call,
5030 void *arg1, int istack)
5032 struct rx_packet *p;
5033 register struct rx_packet *nxp; /* Next pointer for queue_Scan */
5034 struct rx_peer *peer = call->conn->peer;
5035 struct clock now, usenow, retryTime;
5039 struct rx_packet **xmitList;
5042 /* If rxi_Start is being called as a result of a resend event,
5043 * then make sure that the event pointer is removed from the call
5044 * structure, since there is no longer a per-call retransmission
5046 if (event && event == call->resendEvent) {
5047 CALL_RELE(call, RX_CALL_REFCOUNT_RESEND);
5048 call->resendEvent = NULL;
5050 if (queue_IsEmpty(&call->tq)) {
5054 /* Timeouts trigger congestion recovery */
5055 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
5056 if (call->flags & RX_CALL_FAST_RECOVER_WAIT) {
5057 /* someone else is waiting to start recovery */
5060 call->flags |= RX_CALL_FAST_RECOVER_WAIT;
5061 rxi_WaitforTQBusy(call);
5062 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
5063 call->flags &= ~RX_CALL_FAST_RECOVER_WAIT;
5064 call->flags |= RX_CALL_FAST_RECOVER;
5065 if (peer->maxDgramPackets > 1) {
5066 call->MTU = RX_JUMBOBUFFERSIZE + RX_HEADER_SIZE;
5068 call->MTU = MIN(peer->natMTU, peer->maxMTU);
5070 call->ssthresh = MAX(4, MIN((int)call->cwind, (int)call->twind)) >> 1;
5071 call->nDgramPackets = 1;
5073 call->nextCwind = 1;
5076 MUTEX_ENTER(&peer->peer_lock);
5077 peer->MTU = call->MTU;
5078 peer->cwind = call->cwind;
5079 peer->nDgramPackets = 1;
5081 call->congestSeq = peer->congestSeq;
5082 MUTEX_EXIT(&peer->peer_lock);
5083 /* Clear retry times on packets. Otherwise, it's possible for
5084 * some packets in the queue to force resends at rates faster
5085 * than recovery rates.
5087 for (queue_Scan(&call->tq, p, nxp, rx_packet)) {
5088 if (!(p->flags & RX_PKTFLAG_ACKED)) {
5089 clock_Zero(&p->retryTime);
5094 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
5095 rx_MutexIncrement(rx_tq_debug.rxi_start_in_error, rx_stats_mutex);
5100 if (queue_IsNotEmpty(&call->tq)) { /* If we have anything to send */
5101 /* Get clock to compute the re-transmit time for any packets
5102 * in this burst. Note, if we back off, it's reasonable to
5103 * back off all of the packets in the same manner, even if
5104 * some of them have been retransmitted more times than more
5106 * Do a dance to avoid blocking after setting now. */
5107 clock_Zero(&retryTime);
5108 MUTEX_ENTER(&peer->peer_lock);
5109 clock_Add(&retryTime, &peer->timeout);
5110 MUTEX_EXIT(&peer->peer_lock);
5111 clock_GetTime(&now);
5112 clock_Add(&retryTime, &now);
5114 /* Send (or resend) any packets that need it, subject to
5115 * window restrictions and congestion burst control
5116 * restrictions. Ask for an ack on the last packet sent in
5117 * this burst. For now, we're relying upon the window being
5118 * considerably bigger than the largest number of packets that
5119 * are typically sent at once by one initial call to
5120 * rxi_Start. This is probably bogus (perhaps we should ask
5121 * for an ack when we're half way through the current
5122 * window?). Also, for non file transfer applications, this
5123 * may end up asking for an ack for every packet. Bogus. XXXX
5126 * But check whether we're here recursively, and let the other guy
5129 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
5130 if (!(call->flags & RX_CALL_TQ_BUSY)) {
5131 call->flags |= RX_CALL_TQ_BUSY;
5133 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
5135 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
5136 call->flags &= ~RX_CALL_NEED_START;
5137 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
5139 maxXmitPackets = MIN(call->twind, call->cwind);
5140 xmitList = (struct rx_packet **)
5141 osi_Alloc(maxXmitPackets * sizeof(struct rx_packet *));
5142 if (xmitList == NULL)
5143 osi_Panic("rxi_Start, failed to allocate xmit list");
5144 for (queue_Scan(&call->tq, p, nxp, rx_packet)) {
5145 if (call->flags & RX_CALL_FAST_RECOVER_WAIT) {
5146 /* We shouldn't be sending packets if a thread is waiting
5147 * to initiate congestion recovery */
5151 && (call->flags & RX_CALL_FAST_RECOVER)) {
5152 /* Only send one packet during fast recovery */
5155 if ((p->flags & RX_PKTFLAG_FREE)
5156 || (!queue_IsEnd(&call->tq, nxp)
5157 && (nxp->flags & RX_PKTFLAG_FREE))
5158 || (p == (struct rx_packet *)&rx_freePacketQueue)
5159 || (nxp == (struct rx_packet *)&rx_freePacketQueue)) {
5160 osi_Panic("rxi_Start: xmit queue clobbered");
5162 if (p->flags & RX_PKTFLAG_ACKED) {
5163 /* Since we may block, don't trust this */
5164 usenow.sec = usenow.usec = 0;
5165 rx_MutexIncrement(rx_stats.ignoreAckedPacket, rx_stats_mutex);
5166 continue; /* Ignore this packet if it has been acknowledged */
5169 /* Turn off all flags except these ones, which are the same
5170 * on each transmission */
5171 p->header.flags &= RX_PRESET_FLAGS;
5173 if (p->header.seq >=
5174 call->tfirst + MIN((int)call->twind,
5175 (int)(call->nSoftAcked +
5177 call->flags |= RX_CALL_WAIT_WINDOW_SEND; /* Wait for transmit window */
5178 /* Note: if we're waiting for more window space, we can
5179 * still send retransmits; hence we don't return here, but
5180 * break out to schedule a retransmit event */
5181 dpf(("call %d waiting for window",
5182 *(call->callNumber)));
5186 /* Transmit the packet if it needs to be sent. */
5187 if (!clock_Lt(&now, &p->retryTime)) {
5188 if (nXmitPackets == maxXmitPackets) {
5189 rxi_SendXmitList(call, xmitList, nXmitPackets,
5190 istack, &now, &retryTime,
5192 osi_Free(xmitList, maxXmitPackets *
5193 sizeof(struct rx_packet *));
5196 xmitList[nXmitPackets++] = p;
5200 /* xmitList now hold pointers to all of the packets that are
5201 * ready to send. Now we loop to send the packets */
5202 if (nXmitPackets > 0) {
5203 rxi_SendXmitList(call, xmitList, nXmitPackets, istack,
5204 &now, &retryTime, resending);
5207 maxXmitPackets * sizeof(struct rx_packet *));
5209 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
5211 * TQ references no longer protected by this flag; they must remain
5212 * protected by the global lock.
5214 if (call->flags & RX_CALL_FAST_RECOVER_WAIT) {
5215 call->flags &= ~RX_CALL_TQ_BUSY;
5216 if (call->tqWaiters || (call->flags & RX_CALL_TQ_WAIT)) {
5217 dpf(("call %x has %d waiters and flags %d\n", call, call->tqWaiters, call->flags));
5218 #ifdef RX_ENABLE_LOCKS
5219 osirx_AssertMine(&call->lock, "rxi_Start start");
5220 CV_BROADCAST(&call->cv_tq);
5221 #else /* RX_ENABLE_LOCKS */
5222 osi_rxWakeup(&call->tq);
5223 #endif /* RX_ENABLE_LOCKS */
5228 /* We went into the error state while sending packets. Now is
5229 * the time to reset the call. This will also inform the using
5230 * process that the call is in an error state.
5232 rx_MutexIncrement(rx_tq_debug.rxi_start_aborted, rx_stats_mutex);
5233 call->flags &= ~RX_CALL_TQ_BUSY;
5234 if (call->tqWaiters || (call->flags & RX_CALL_TQ_WAIT)) {
5235 dpf(("call %x has %d waiters and flags %d\n", call, call->tqWaiters, call->flags));
5236 #ifdef RX_ENABLE_LOCKS
5237 osirx_AssertMine(&call->lock, "rxi_Start middle");
5238 CV_BROADCAST(&call->cv_tq);
5239 #else /* RX_ENABLE_LOCKS */
5240 osi_rxWakeup(&call->tq);
5241 #endif /* RX_ENABLE_LOCKS */
5243 rxi_CallError(call, call->error);
5246 #ifdef RX_ENABLE_LOCKS
5247 if (call->flags & RX_CALL_TQ_SOME_ACKED) {
5248 register int missing;
5249 call->flags &= ~RX_CALL_TQ_SOME_ACKED;
5250 /* Some packets have received acks. If they all have, we can clear
5251 * the transmit queue.
5254 0, queue_Scan(&call->tq, p, nxp, rx_packet)) {
5255 if (p->header.seq < call->tfirst
5256 && (p->flags & RX_PKTFLAG_ACKED)) {
5263 call->flags |= RX_CALL_TQ_CLEARME;
5265 #endif /* RX_ENABLE_LOCKS */
5266 /* Don't bother doing retransmits if the TQ is cleared. */
5267 if (call->flags & RX_CALL_TQ_CLEARME) {
5268 rxi_ClearTransmitQueue(call, 1);
5270 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
5273 /* Always post a resend event, if there is anything in the
5274 * queue, and resend is possible. There should be at least
5275 * one unacknowledged packet in the queue ... otherwise none
5276 * of these packets should be on the queue in the first place.
5278 if (call->resendEvent) {
5279 /* Cancel the existing event and post a new one */
5280 rxevent_Cancel(call->resendEvent, call,
5281 RX_CALL_REFCOUNT_RESEND);
5284 /* The retry time is the retry time on the first unacknowledged
5285 * packet inside the current window */
5287 0, queue_Scan(&call->tq, p, nxp, rx_packet)) {
5288 /* Don't set timers for packets outside the window */
5289 if (p->header.seq >= call->tfirst + call->twind) {
5293 if (!(p->flags & RX_PKTFLAG_ACKED)
5294 && !clock_IsZero(&p->retryTime)) {
5296 retryTime = p->retryTime;
5301 /* Post a new event to re-run rxi_Start when retries may be needed */
5302 if (haveEvent && !(call->flags & RX_CALL_NEED_START)) {
5303 #ifdef RX_ENABLE_LOCKS
5304 CALL_HOLD(call, RX_CALL_REFCOUNT_RESEND);
5306 rxevent_PostNow2(&retryTime, &usenow,
5308 (void *)call, 0, istack);
5309 #else /* RX_ENABLE_LOCKS */
5311 rxevent_PostNow2(&retryTime, &usenow, rxi_Start,
5312 (void *)call, 0, istack);
5313 #endif /* RX_ENABLE_LOCKS */
5316 #ifdef AFS_GLOBAL_RXLOCK_KERNEL
5317 } while (call->flags & RX_CALL_NEED_START);
5319 * TQ references no longer protected by this flag; they must remain
5320 * protected by the global lock.
5322 call->flags &= ~RX_CALL_TQ_BUSY;
5323 if (call->tqWaiters || (call->flags & RX_CALL_TQ_WAIT)) {
5324 dpf(("call %x has %d waiters and flags %d\n", call, call->tqWaiters, call->flags));
5325 #ifdef RX_ENABLE_LOCKS
5326 osirx_AssertMine(&call->lock, "rxi_Start end");
5327 CV_BROADCAST(&call->cv_tq);
5328 #else /* RX_ENABLE_LOCKS */
5329 osi_rxWakeup(&call->tq);
5330 #endif /* RX_ENABLE_LOCKS */
5333 call->flags |= RX_CALL_NEED_START;
5335 #endif /* AFS_GLOBAL_RXLOCK_KERNEL */
5337 if (call->resendEvent) {
5338 rxevent_Cancel(call->resendEvent, call, RX_CALL_REFCOUNT_RESEND);
5343 /* Also adjusts the keep alive parameters for the call, to reflect
5344 * that we have just sent a packet (so keep alives aren't sent
5347 rxi_Send(register struct rx_call *call, register struct rx_packet *p,
5350 register struct rx_connection *conn = call->conn;
5352 /* Stamp each packet with the user supplied status */
5353 p->header.userStatus = call->localStatus;
5355 /* Allow the security object controlling this call's security to
5356 * make any last-minute changes to the packet */
5357 RXS_SendPacket(conn->securityObject, call, p);
5359 /* Since we're about to send SOME sort of packet to the peer, it's
5360 * safe to nuke any scheduled end-of-packets ack */
5361 rxevent_Cancel(call->delayedAckEvent, call, RX_CALL_REFCOUNT_DELAY);
5363 /* Actually send the packet, filling in more connection-specific fields */
5364 CALL_HOLD(call, RX_CALL_REFCOUNT_SEND);
5365 MUTEX_EXIT(&call->lock);
5366 rxi_SendPacket(call, conn, p, istack);
5367 MUTEX_ENTER(&call->lock);
5368 CALL_RELE(call, RX_CALL_REFCOUNT_SEND);
5370 /* Update last send time for this call (for keep-alive
5371 * processing), and for the connection (so that we can discover
5372 * idle connections) */
5373 conn->lastSendTime = call->lastSendTime = clock_Sec();
5377 /* Check if a call needs to be destroyed. Called by keep-alive code to ensure
5378 * that things are fine. Also called periodically to guarantee that nothing
5379 * falls through the cracks (e.g. (error + dally) connections have keepalive
5380 * turned off. Returns 0 if conn is well, -1 otherwise. If otherwise, call
5382 * haveCTLock Set if calling from rxi_ReapConnections
5384 #ifdef RX_ENABLE_LOCKS
5386 rxi_CheckCall(register struct rx_call *call, int haveCTLock)
5387 #else /* RX_ENABLE_LOCKS */
5389 rxi_CheckCall(register struct rx_call *call)
5390 #endif /* RX_ENABLE_LOCKS */
5392 register struct rx_connection *conn = call->conn;
5394 afs_uint32 deadTime;
5396 #ifdef RX_GLOBAL_RXLOCK_KERNEL
5397 if (call->flags & RX_CALL_TQ_BUSY) {
5398 /* Call is active and will be reset by rxi_Start if it's
5399 * in an error state.
5404 /* dead time + RTT + 8*MDEV, rounded up to next second. */
5406 (((afs_uint32) conn->secondsUntilDead << 10) +
5407 ((afs_uint32) conn->peer->rtt >> 3) +
5408 ((afs_uint32) conn->peer->rtt_dev << 1) + 1023) >> 10;
5410 /* These are computed to the second (+- 1 second). But that's
5411 * good enough for these values, which should be a significant
5412 * number of seconds. */
5413 if (now > (call->lastReceiveTime + deadTime)) {
5414 if (call->state == RX_STATE_ACTIVE) {
5415 rxi_CallError(call, RX_CALL_DEAD);
5418 #ifdef RX_ENABLE_LOCKS
5419 /* Cancel pending events */
5420 rxevent_Cancel(call->delayedAckEvent, call,
5421 RX_CALL_REFCOUNT_DELAY);
5422 rxevent_Cancel(call->resendEvent, call, RX_CALL_REFCOUNT_RESEND);
5423 rxevent_Cancel(call->keepAliveEvent, call,
5424 RX_CALL_REFCOUNT_ALIVE);
5425 if (call->refCount == 0) {
5426 rxi_FreeCall(call, haveCTLock);
5430 #else /* RX_ENABLE_LOCKS */
5433 #endif /* RX_ENABLE_LOCKS */
5435 /* Non-active calls are destroyed if they are not responding
5436 * to pings; active calls are simply flagged in error, so the
5437 * attached process can die reasonably gracefully. */
5439 /* see if we have a non-activity timeout */
5440 if (call->startWait && conn->idleDeadTime
5441 && ((call->startWait + conn->idleDeadTime) < now)) {
5442 if (call->state == RX_STATE_ACTIVE) {
5443 rxi_CallError(call, RX_CALL_TIMEOUT);
5447 /* see if we have a hard timeout */
5448 if (conn->hardDeadTime
5449 && (now > (conn->hardDeadTime + call->startTime.sec))) {
5450 if (call->state == RX_STATE_ACTIVE)
5451 rxi_CallError(call, RX_CALL_TIMEOUT);
5458 /* When a call is in progress, this routine is called occasionally to
5459 * make sure that some traffic has arrived (or been sent to) the peer.
5460 * If nothing has arrived in a reasonable amount of time, the call is
5461 * declared dead; if nothing has been sent for a while, we send a
5462 * keep-alive packet (if we're actually trying to keep the call alive)
5465 rxi_KeepAliveEvent(struct rxevent *event, register struct rx_call *call,
5468 struct rx_connection *conn;
5471 MUTEX_ENTER(&call->lock);
5472 CALL_RELE(call, RX_CALL_REFCOUNT_ALIVE);
5473 if (event == call->keepAliveEvent)
5474 call->keepAliveEvent = NULL;
5477 #ifdef RX_ENABLE_LOCKS
5478 if (rxi_CheckCall(call, 0)) {
5479 MUTEX_EXIT(&call->lock);
5482 #else /* RX_ENABLE_LOCKS */
5483 if (rxi_CheckCall(call))
5485 #endif /* RX_ENABLE_LOCKS */
5487 /* Don't try to keep alive dallying calls */
5488 if (call->state == RX_STATE_DALLY) {
5489 MUTEX_EXIT(&call->lock);
5494 if ((now - call->lastSendTime) > conn->secondsUntilPing) {
5495 /* Don't try to send keepalives if there is unacknowledged data */
5496 /* the rexmit code should be good enough, this little hack
5497 * doesn't quite work XXX */
5498 (void)rxi_SendAck(call, NULL, 0, RX_ACK_PING, 0);
5500 rxi_ScheduleKeepAliveEvent(call);
5501 MUTEX_EXIT(&call->lock);
5506 rxi_ScheduleKeepAliveEvent(register struct rx_call *call)
5508 if (!call->keepAliveEvent) {
5509 struct clock when, now;
5510 clock_GetTime(&now);
5512 when.sec += call->conn->secondsUntilPing;
5513 CALL_HOLD(call, RX_CALL_REFCOUNT_ALIVE);
5514 call->keepAliveEvent =
5515 rxevent_PostNow(&when, &now, rxi_KeepAliveEvent, call, 0);
5519 /* N.B. rxi_KeepAliveOff: is defined earlier as a macro */
5521 rxi_KeepAliveOn(register struct rx_call *call)
5523 /* Pretend last packet received was received now--i.e. if another
5524 * packet isn't received within the keep alive time, then the call
5525 * will die; Initialize last send time to the current time--even
5526 * if a packet hasn't been sent yet. This will guarantee that a
5527 * keep-alive is sent within the ping time */
5528 call->lastReceiveTime = call->lastSendTime = clock_Sec();
5529 rxi_ScheduleKeepAliveEvent(call);
5532 /* This routine is called to send connection abort messages
5533 * that have been delayed to throttle looping clients. */
5535 rxi_SendDelayedConnAbort(struct rxevent *event,
5536 register struct rx_connection *conn, char *dummy)
5539 struct rx_packet *packet;
5541 MUTEX_ENTER(&conn->conn_data_lock);
5542 conn->delayedAbortEvent = NULL;
5543 error = htonl(conn->error);
5545 MUTEX_EXIT(&conn->conn_data_lock);
5546 packet = rxi_AllocPacket(RX_PACKET_CLASS_SPECIAL);
5549 rxi_SendSpecial((struct rx_call *)0, conn, packet,
5550 RX_PACKET_TYPE_ABORT, (char *)&error,
5552 rxi_FreePacket(packet);
5556 /* This routine is called to send call abort messages
5557 * that have been delayed to throttle looping clients. */
5559 rxi_SendDelayedCallAbort(struct rxevent *event, register struct rx_call *call,
5563 struct rx_packet *packet;
5565 MUTEX_ENTER(&call->lock);
5566 call->delayedAbortEvent = NULL;
5567 error = htonl(call->error);
5569 packet = rxi_AllocPacket(RX_PACKET_CLASS_SPECIAL);
5572 rxi_SendSpecial(call, call->conn, packet, RX_PACKET_TYPE_ABORT,
5573 (char *)&error, sizeof(error), 0);
5574 rxi_FreePacket(packet);
5576 CALL_RELE(call, RX_CALL_REFCOUNT_ABORT);
5577 MUTEX_EXIT(&call->lock);
5580 /* This routine is called periodically (every RX_AUTH_REQUEST_TIMEOUT
5581 * seconds) to ask the client to authenticate itself. The routine
5582 * issues a challenge to the client, which is obtained from the
5583 * security object associated with the connection */
5585 rxi_ChallengeEvent(struct rxevent *event, register struct rx_connection *conn,
5586 void *arg1, int tries)
5588 conn->challengeEvent = NULL;
5589 if (RXS_CheckAuthentication(conn->securityObject, conn) != 0) {
5590 register struct rx_packet *packet;
5591 struct clock when, now;
5594 /* We've failed to authenticate for too long.
5595 * Reset any calls waiting for authentication;
5596 * they are all in RX_STATE_PRECALL.
5600 MUTEX_ENTER(&conn->conn_call_lock);
5601 for (i = 0; i < RX_MAXCALLS; i++) {
5602 struct rx_call *call = conn->call[i];
5604 MUTEX_ENTER(&call->lock);
5605 if (call->state == RX_STATE_PRECALL) {
5606 rxi_CallError(call, RX_CALL_DEAD);
5607 rxi_SendCallAbort(call, NULL, 0, 0);
5609 MUTEX_EXIT(&call->lock);
5612 MUTEX_EXIT(&conn->conn_call_lock);
5616 packet = rxi_AllocPacket(RX_PACKET_CLASS_SPECIAL);
5618 /* If there's no packet available, do this later. */
5619 RXS_GetChallenge(conn->securityObject, conn, packet);
5620 rxi_SendSpecial((struct rx_call *)0, conn, packet,
5621 RX_PACKET_TYPE_CHALLENGE, NULL, -1, 0);
5622 rxi_FreePacket(packet);
5624 clock_GetTime(&now);
5626 when.sec += RX_CHALLENGE_TIMEOUT;
5627 conn->challengeEvent =
5628 rxevent_PostNow2(&when, &now, rxi_ChallengeEvent, conn, 0,
5633 /* Call this routine to start requesting the client to authenticate
5634 * itself. This will continue until authentication is established,
5635 * the call times out, or an invalid response is returned. The
5636 * security object associated with the connection is asked to create
5637 * the challenge at this time. N.B. rxi_ChallengeOff is a macro,
5638 * defined earlier. */
5640 rxi_ChallengeOn(register struct rx_connection *conn)
5642 if (!conn->challengeEvent) {
5643 RXS_CreateChallenge(conn->securityObject, conn);
5644 rxi_ChallengeEvent(NULL, conn, 0, RX_CHALLENGE_MAXTRIES);
5649 /* Compute round trip time of the packet provided, in *rttp.
5652 /* rxi_ComputeRoundTripTime is called with peer locked. */
5653 /* sentp and/or peer may be null */
5655 rxi_ComputeRoundTripTime(register struct rx_packet *p,
5656 register struct clock *sentp,
5657 register struct rx_peer *peer)
5659 struct clock thisRtt, *rttp = &thisRtt;
5661 register int rtt_timeout;
5663 clock_GetTime(rttp);
5665 if (clock_Lt(rttp, sentp)) {
5667 return; /* somebody set the clock back, don't count this time. */
5669 clock_Sub(rttp, sentp);
5670 MUTEX_ENTER(&rx_stats_mutex);
5671 if (clock_Lt(rttp, &rx_stats.minRtt))
5672 rx_stats.minRtt = *rttp;
5673 if (clock_Gt(rttp, &rx_stats.maxRtt)) {
5674 if (rttp->sec > 60) {
5675 MUTEX_EXIT(&rx_stats_mutex);
5676 return; /* somebody set the clock ahead */
5678 rx_stats.maxRtt = *rttp;
5680 clock_Add(&rx_stats.totalRtt, rttp);
5681 rx_stats.nRttSamples++;
5682 MUTEX_EXIT(&rx_stats_mutex);
5684 /* better rtt calculation courtesy of UMich crew (dave,larry,peter,?) */
5686 /* Apply VanJacobson round-trip estimations */
5691 * srtt (peer->rtt) is in units of one-eighth-milliseconds.
5692 * srtt is stored as fixed point with 3 bits after the binary
5693 * point (i.e., scaled by 8). The following magic is
5694 * equivalent to the smoothing algorithm in rfc793 with an
5695 * alpha of .875 (srtt = rtt/8 + srtt*7/8 in fixed point).
5696 * srtt*8 = srtt*8 + rtt - srtt
5697 * srtt = srtt + rtt/8 - srtt/8
5700 delta = MSEC(rttp) - (peer->rtt >> 3);
5704 * We accumulate a smoothed rtt variance (actually, a smoothed
5705 * mean difference), then set the retransmit timer to smoothed
5706 * rtt + 4 times the smoothed variance (was 2x in van's original
5707 * paper, but 4x works better for me, and apparently for him as
5709 * rttvar is stored as
5710 * fixed point with 2 bits after the binary point (scaled by
5711 * 4). The following is equivalent to rfc793 smoothing with
5712 * an alpha of .75 (rttvar = rttvar*3/4 + |delta| / 4). This
5713 * replaces rfc793's wired-in beta.
5714 * dev*4 = dev*4 + (|actual - expected| - dev)
5720 delta -= (peer->rtt_dev >> 2);
5721 peer->rtt_dev += delta;
5723 /* I don't have a stored RTT so I start with this value. Since I'm
5724 * probably just starting a call, and will be pushing more data down
5725 * this, I expect congestion to increase rapidly. So I fudge a
5726 * little, and I set deviance to half the rtt. In practice,
5727 * deviance tends to approach something a little less than
5728 * half the smoothed rtt. */
5729 peer->rtt = (MSEC(rttp) << 3) + 8;
5730 peer->rtt_dev = peer->rtt >> 2; /* rtt/2: they're scaled differently */
5732 /* the timeout is RTT + 4*MDEV + 0.35 sec This is because one end or
5733 * the other of these connections is usually in a user process, and can
5734 * be switched and/or swapped out. So on fast, reliable networks, the
5735 * timeout would otherwise be too short.
5737 rtt_timeout = (peer->rtt >> 3) + peer->rtt_dev + 350;
5738 clock_Zero(&(peer->timeout));
5739 clock_Addmsec(&(peer->timeout), rtt_timeout);
5741 dpf(("rxi_ComputeRoundTripTime(rtt=%d ms, srtt=%d ms, rtt_dev=%d ms, timeout=%d.%0.3d sec)\n", MSEC(rttp), peer->rtt >> 3, peer->rtt_dev >> 2, (peer->timeout.sec), (peer->timeout.usec)));
5745 /* Find all server connections that have not been active for a long time, and
5748 rxi_ReapConnections(void)
5750 struct clock now, when;
5751 clock_GetTime(&now);
5753 /* Find server connection structures that haven't been used for
5754 * greater than rx_idleConnectionTime */
5756 struct rx_connection **conn_ptr, **conn_end;
5757 int i, havecalls = 0;
5758 MUTEX_ENTER(&rx_connHashTable_lock);
5759 for (conn_ptr = &rx_connHashTable[0], conn_end =
5760 &rx_connHashTable[rx_hashTableSize]; conn_ptr < conn_end;
5762 struct rx_connection *conn, *next;
5763 struct rx_call *call;
5767 for (conn = *conn_ptr; conn; conn = next) {
5768 /* XXX -- Shouldn't the connection be locked? */
5771 for (i = 0; i < RX_MAXCALLS; i++) {
5772 call = conn->call[i];
5775 MUTEX_ENTER(&call->lock);
5776 #ifdef RX_ENABLE_LOCKS
5777 result = rxi_CheckCall(call, 1);
5778 #else /* RX_ENABLE_LOCKS */
5779 result = rxi_CheckCall(call);
5780 #endif /* RX_ENABLE_LOCKS */
5781 MUTEX_EXIT(&call->lock);
5783 /* If CheckCall freed the call, it might
5784 * have destroyed the connection as well,
5785 * which screws up the linked lists.
5791 if (conn->type == RX_SERVER_CONNECTION) {
5792 /* This only actually destroys the connection if
5793 * there are no outstanding calls */
5794 MUTEX_ENTER(&conn->conn_data_lock);
5795 if (!havecalls && !conn->refCount
5796 && ((conn->lastSendTime + rx_idleConnectionTime) <
5798 conn->refCount++; /* it will be decr in rx_DestroyConn */
5799 MUTEX_EXIT(&conn->conn_data_lock);
5800 #ifdef RX_ENABLE_LOCKS
5801 rxi_DestroyConnectionNoLock(conn);
5802 #else /* RX_ENABLE_LOCKS */
5803 rxi_DestroyConnection(conn);
5804 #endif /* RX_ENABLE_LOCKS */
5806 #ifdef RX_ENABLE_LOCKS
5808 MUTEX_EXIT(&conn->conn_data_lock);
5810 #endif /* RX_ENABLE_LOCKS */
5814 #ifdef RX_ENABLE_LOCKS
5815 while (rx_connCleanup_list) {
5816 struct rx_connection *conn;
5817 conn = rx_connCleanup_list;
5818 rx_connCleanup_list = rx_connCleanup_list->next;
5819 MUTEX_EXIT(&rx_connHashTable_lock);
5820 rxi_CleanupConnection(conn);
5821 MUTEX_ENTER(&rx_connHashTable_lock);
5823 MUTEX_EXIT(&rx_connHashTable_lock);
5824 #endif /* RX_ENABLE_LOCKS */
5827 /* Find any peer structures that haven't been used (haven't had an
5828 * associated connection) for greater than rx_idlePeerTime */
5830 struct rx_peer **peer_ptr, **peer_end;
5832 MUTEX_ENTER(&rx_rpc_stats);
5833 MUTEX_ENTER(&rx_peerHashTable_lock);
5834 for (peer_ptr = &rx_peerHashTable[0], peer_end =
5835 &rx_peerHashTable[rx_hashTableSize]; peer_ptr < peer_end;
5837 struct rx_peer *peer, *next, *prev;
5838 for (prev = peer = *peer_ptr; peer; peer = next) {
5840 code = MUTEX_TRYENTER(&peer->peer_lock);
5841 if ((code) && (peer->refCount == 0)
5842 && ((peer->idleWhen + rx_idlePeerTime) < now.sec)) {
5843 rx_interface_stat_p rpc_stat, nrpc_stat;
5845 MUTEX_EXIT(&peer->peer_lock);
5846 MUTEX_DESTROY(&peer->peer_lock);
5848 (&peer->rpcStats, rpc_stat, nrpc_stat,
5849 rx_interface_stat)) {
5850 unsigned int num_funcs;
5853 queue_Remove(&rpc_stat->queue_header);
5854 queue_Remove(&rpc_stat->all_peers);
5855 num_funcs = rpc_stat->stats[0].func_total;
5857 sizeof(rx_interface_stat_t) +
5858 rpc_stat->stats[0].func_total *
5859 sizeof(rx_function_entry_v1_t);
5861 rxi_Free(rpc_stat, space);
5862 rxi_rpc_peer_stat_cnt -= num_funcs;
5865 rx_MutexDecrement(rx_stats.nPeerStructs, rx_stats_mutex);
5866 if (peer == *peer_ptr) {
5873 MUTEX_EXIT(&peer->peer_lock);
5879 MUTEX_EXIT(&rx_peerHashTable_lock);
5880 MUTEX_EXIT(&rx_rpc_stats);
5883 /* THIS HACK IS A TEMPORARY HACK. The idea is that the race condition in
5884 * rxi_AllocSendPacket, if it hits, will be handled at the next conn
5885 * GC, just below. Really, we shouldn't have to keep moving packets from
5886 * one place to another, but instead ought to always know if we can
5887 * afford to hold onto a packet in its particular use. */
5888 MUTEX_ENTER(&rx_freePktQ_lock);
5889 if (rx_waitingForPackets) {
5890 rx_waitingForPackets = 0;
5891 #ifdef RX_ENABLE_LOCKS
5892 CV_BROADCAST(&rx_waitingForPackets_cv);
5894 osi_rxWakeup(&rx_waitingForPackets);
5897 MUTEX_EXIT(&rx_freePktQ_lock);
5900 when.sec += RX_REAP_TIME; /* Check every RX_REAP_TIME seconds */
5901 rxevent_Post(&when, rxi_ReapConnections, 0, 0);
5905 /* rxs_Release - This isn't strictly necessary but, since the macro name from
5906 * rx.h is sort of strange this is better. This is called with a security
5907 * object before it is discarded. Each connection using a security object has
5908 * its own refcount to the object so it won't actually be freed until the last
5909 * connection is destroyed.
5911 * This is the only rxs module call. A hold could also be written but no one
5915 rxs_Release(struct rx_securityClass *aobj)
5917 return RXS_Close(aobj);
5921 #define RXRATE_PKT_OH (RX_HEADER_SIZE + RX_IPUDP_SIZE)
5922 #define RXRATE_SMALL_PKT (RXRATE_PKT_OH + sizeof(struct rx_ackPacket))
5923 #define RXRATE_AVG_SMALL_PKT (RXRATE_PKT_OH + (sizeof(struct rx_ackPacket)/2))
5924 #define RXRATE_LARGE_PKT (RXRATE_SMALL_PKT + 256)
5926 /* Adjust our estimate of the transmission rate to this peer, given
5927 * that the packet p was just acked. We can adjust peer->timeout and
5928 * call->twind. Pragmatically, this is called
5929 * only with packets of maximal length.
5930 * Called with peer and call locked.
5934 rxi_ComputeRate(register struct rx_peer *peer, register struct rx_call *call,
5935 struct rx_packet *p, struct rx_packet *ackp, u_char ackReason)
5937 afs_int32 xferSize, xferMs;
5938 register afs_int32 minTime;
5941 /* Count down packets */
5942 if (peer->rateFlag > 0)
5944 /* Do nothing until we're enabled */
5945 if (peer->rateFlag != 0)
5950 /* Count only when the ack seems legitimate */
5951 switch (ackReason) {
5952 case RX_ACK_REQUESTED:
5954 p->length + RX_HEADER_SIZE + call->conn->securityMaxTrailerSize;
5958 case RX_ACK_PING_RESPONSE:
5959 if (p) /* want the response to ping-request, not data send */
5961 clock_GetTime(&newTO);
5962 if (clock_Gt(&newTO, &call->pingRequestTime)) {
5963 clock_Sub(&newTO, &call->pingRequestTime);
5964 xferMs = (newTO.sec * 1000) + (newTO.usec / 1000);
5968 xferSize = rx_AckDataSize(rx_Window) + RX_HEADER_SIZE;
5975 dpf(("CONG peer %lx/%u: sample (%s) size %ld, %ld ms (to %lu.%06lu, rtt %u, ps %u)", ntohl(peer->host), ntohs(peer->port), (ackReason == RX_ACK_REQUESTED ? "dataack" : "pingack"), xferSize, xferMs, peer->timeout.sec, peer->timeout.usec, peer->smRtt, peer->ifMTU));
5977 /* Track only packets that are big enough. */
5978 if ((p->length + RX_HEADER_SIZE + call->conn->securityMaxTrailerSize) <
5982 /* absorb RTT data (in milliseconds) for these big packets */
5983 if (peer->smRtt == 0) {
5984 peer->smRtt = xferMs;
5986 peer->smRtt = ((peer->smRtt * 15) + xferMs + 4) >> 4;
5991 if (peer->countDown) {
5995 peer->countDown = 10; /* recalculate only every so often */
5997 /* In practice, we can measure only the RTT for full packets,
5998 * because of the way Rx acks the data that it receives. (If it's
5999 * smaller than a full packet, it often gets implicitly acked
6000 * either by the call response (from a server) or by the next call
6001 * (from a client), and either case confuses transmission times
6002 * with processing times.) Therefore, replace the above
6003 * more-sophisticated processing with a simpler version, where the
6004 * smoothed RTT is kept for full-size packets, and the time to
6005 * transmit a windowful of full-size packets is simply RTT *
6006 * windowSize. Again, we take two steps:
6007 - ensure the timeout is large enough for a single packet's RTT;
6008 - ensure that the window is small enough to fit in the desired timeout.*/
6010 /* First, the timeout check. */
6011 minTime = peer->smRtt;
6012 /* Get a reasonable estimate for a timeout period */
6014 newTO.sec = minTime / 1000;
6015 newTO.usec = (minTime - (newTO.sec * 1000)) * 1000;
6017 /* Increase the timeout period so that we can always do at least
6018 * one packet exchange */
6019 if (clock_Gt(&newTO, &peer->timeout)) {
6021 dpf(("CONG peer %lx/%u: timeout %lu.%06lu ==> %lu.%06lu (rtt %u, ps %u)", ntohl(peer->host), ntohs(peer->port), peer->timeout.sec, peer->timeout.usec, newTO.sec, newTO.usec, peer->smRtt, peer->packetSize));
6023 peer->timeout = newTO;
6026 /* Now, get an estimate for the transmit window size. */
6027 minTime = peer->timeout.sec * 1000 + (peer->timeout.usec / 1000);
6028 /* Now, convert to the number of full packets that could fit in a
6029 * reasonable fraction of that interval */
6030 minTime /= (peer->smRtt << 1);
6031 xferSize = minTime; /* (make a copy) */
6033 /* Now clamp the size to reasonable bounds. */
6036 else if (minTime > rx_Window)
6037 minTime = rx_Window;
6038 /* if (minTime != peer->maxWindow) {
6039 dpf(("CONG peer %lx/%u: windowsize %lu ==> %lu (to %lu.%06lu, rtt %u, ps %u)",
6040 ntohl(peer->host), ntohs(peer->port), peer->maxWindow, minTime,
6041 peer->timeout.sec, peer->timeout.usec, peer->smRtt,
6043 peer->maxWindow = minTime;
6044 elide... call->twind = minTime;
6048 /* Cut back on the peer timeout if it had earlier grown unreasonably.
6049 * Discern this by calculating the timeout necessary for rx_Window
6051 if ((xferSize > rx_Window) && (peer->timeout.sec >= 3)) {
6052 /* calculate estimate for transmission interval in milliseconds */
6053 minTime = rx_Window * peer->smRtt;
6054 if (minTime < 1000) {
6055 dpf(("CONG peer %lx/%u: cut TO %lu.%06lu by 0.5 (rtt %u, ps %u)",
6056 ntohl(peer->host), ntohs(peer->port), peer->timeout.sec,
6057 peer->timeout.usec, peer->smRtt, peer->packetSize));
6059 newTO.sec = 0; /* cut back on timeout by half a second */
6060 newTO.usec = 500000;
6061 clock_Sub(&peer->timeout, &newTO);
6066 } /* end of rxi_ComputeRate */
6067 #endif /* ADAPT_WINDOW */
6075 #define TRACE_OPTION_DEBUGLOG 4
6083 code = RegOpenKeyEx(HKEY_LOCAL_MACHINE, AFSREG_CLT_SVC_PARAM_SUBKEY,
6084 0, KEY_QUERY_VALUE, &parmKey);
6085 if (code != ERROR_SUCCESS)
6088 dummyLen = sizeof(TraceOption);
6089 code = RegQueryValueEx(parmKey, "TraceOption", NULL, NULL,
6090 (BYTE *) &TraceOption, &dummyLen);
6091 if (code == ERROR_SUCCESS) {
6092 rxdebug_active = (TraceOption & TRACE_OPTION_DEBUGLOG) ? 1 : 0;
6094 RegCloseKey (parmKey);
6095 #endif /* AFS_NT40_ENV */
6100 rx_DebugOnOff(int on)
6102 rxdebug_active = on;
6104 #endif /* AFS_NT40_ENV */
6107 /* Don't call this debugging routine directly; use dpf */
6109 rxi_DebugPrint(char *format, int a1, int a2, int a3, int a4, int a5, int a6,
6110 int a7, int a8, int a9, int a10, int a11, int a12, int a13,
6118 len = _snprintf(tformat, sizeof(tformat), "tid[%d] %s", GetCurrentThreadId(), format);
6121 len = _snprintf(msg, sizeof(msg)-2,
6122 tformat, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10,
6123 a11, a12, a13, a14, a15);
6125 if (msg[len-1] != '\n') {
6129 OutputDebugString(msg);
6134 clock_GetTime(&now);
6135 fprintf(rx_Log, " %u.%.3u:", (unsigned int)now.sec,
6136 (unsigned int)now.usec / 1000);
6137 fprintf(rx_Log, format, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12,
6144 * This function is used to process the rx_stats structure that is local
6145 * to a process as well as an rx_stats structure received from a remote
6146 * process (via rxdebug). Therefore, it needs to do minimal version
6150 rx_PrintTheseStats(FILE * file, struct rx_stats *s, int size,
6151 afs_int32 freePackets, char version)
6155 if (size != sizeof(struct rx_stats)) {
6157 "Unexpected size of stats structure: was %d, expected %d\n",
6158 size, sizeof(struct rx_stats));
6161 fprintf(file, "rx stats: free packets %d, allocs %d, ", (int)freePackets,
6164 if (version >= RX_DEBUGI_VERSION_W_NEWPACKETTYPES) {
6165 fprintf(file, "alloc-failures(rcv %d/%d,send %d/%d,ack %d)\n",
6166 s->receivePktAllocFailures, s->receiveCbufPktAllocFailures,
6167 s->sendPktAllocFailures, s->sendCbufPktAllocFailures,
6168 s->specialPktAllocFailures);
6170 fprintf(file, "alloc-failures(rcv %d,send %d,ack %d)\n",
6171 s->receivePktAllocFailures, s->sendPktAllocFailures,
6172 s->specialPktAllocFailures);
6176 " greedy %d, " "bogusReads %d (last from host %x), "
6177 "noPackets %d, " "noBuffers %d, " "selects %d, "
6178 "sendSelects %d\n", s->socketGreedy, s->bogusPacketOnRead,
6179 s->bogusHost, s->noPacketOnRead, s->noPacketBuffersOnRead,
6180 s->selects, s->sendSelects);
6182 fprintf(file, " packets read: ");
6183 for (i = 0; i < RX_N_PACKET_TYPES; i++) {
6184 fprintf(file, "%s %d ", rx_packetTypes[i], s->packetsRead[i]);
6186 fprintf(file, "\n");
6189 " other read counters: data %d, " "ack %d, " "dup %d "
6190 "spurious %d " "dally %d\n", s->dataPacketsRead,
6191 s->ackPacketsRead, s->dupPacketsRead, s->spuriousPacketsRead,
6192 s->ignorePacketDally);
6194 fprintf(file, " packets sent: ");
6195 for (i = 0; i < RX_N_PACKET_TYPES; i++) {
6196 fprintf(file, "%s %d ", rx_packetTypes[i], s->packetsSent[i]);
6198 fprintf(file, "\n");
6201 " other send counters: ack %d, " "data %d (not resends), "
6202 "resends %d, " "pushed %d, " "acked&ignored %d\n",
6203 s->ackPacketsSent, s->dataPacketsSent, s->dataPacketsReSent,
6204 s->dataPacketsPushed, s->ignoreAckedPacket);
6207 " \t(these should be small) sendFailed %d, " "fatalErrors %d\n",
6208 s->netSendFailures, (int)s->fatalErrors);
6210 if (s->nRttSamples) {
6211 fprintf(file, " Average rtt is %0.3f, with %d samples\n",
6212 clock_Float(&s->totalRtt) / s->nRttSamples, s->nRttSamples);
6214 fprintf(file, " Minimum rtt is %0.3f, maximum is %0.3f\n",
6215 clock_Float(&s->minRtt), clock_Float(&s->maxRtt));
6219 " %d server connections, " "%d client connections, "
6220 "%d peer structs, " "%d call structs, " "%d free call structs\n",
6221 s->nServerConns, s->nClientConns, s->nPeerStructs,
6222 s->nCallStructs, s->nFreeCallStructs);
6224 #if !defined(AFS_PTHREAD_ENV) && !defined(AFS_USE_GETTIMEOFDAY)
6225 fprintf(file, " %d clock updates\n", clock_nUpdates);
6230 /* for backward compatibility */
6232 rx_PrintStats(FILE * file)
6234 MUTEX_ENTER(&rx_stats_mutex);
6235 rx_PrintTheseStats(file, &rx_stats, sizeof(rx_stats), rx_nFreePackets,
6237 MUTEX_EXIT(&rx_stats_mutex);
6241 rx_PrintPeerStats(FILE * file, struct rx_peer *peer)
6243 fprintf(file, "Peer %x.%d. " "Burst size %d, " "burst wait %u.%d.\n",
6244 ntohl(peer->host), (int)peer->port, (int)peer->burstSize,
6245 (int)peer->burstWait.sec, (int)peer->burstWait.usec);
6248 " Rtt %d, " "retry time %u.%06d, " "total sent %d, "
6249 "resent %d\n", peer->rtt, (int)peer->timeout.sec,
6250 (int)peer->timeout.usec, peer->nSent, peer->reSends);
6253 " Packet size %d, " "max in packet skew %d, "
6254 "max out packet skew %d\n", peer->ifMTU, (int)peer->inPacketSkew,
6255 (int)peer->outPacketSkew);
6258 #ifdef AFS_PTHREAD_ENV
6260 * This mutex protects the following static variables:
6264 #define LOCK_RX_DEBUG assert(pthread_mutex_lock(&rx_debug_mutex)==0)
6265 #define UNLOCK_RX_DEBUG assert(pthread_mutex_unlock(&rx_debug_mutex)==0)
6267 #define LOCK_RX_DEBUG
6268 #define UNLOCK_RX_DEBUG
6269 #endif /* AFS_PTHREAD_ENV */
6272 MakeDebugCall(osi_socket socket, afs_uint32 remoteAddr, afs_uint16 remotePort,
6273 u_char type, void *inputData, size_t inputLength,
6274 void *outputData, size_t outputLength)
6276 static afs_int32 counter = 100;
6277 time_t waitTime, waitCount, startTime;
6278 struct rx_header theader;
6280 register afs_int32 code;
6281 struct timeval tv_now, tv_wake, tv_delta;
6282 struct sockaddr_in taddr, faddr;
6287 startTime = time(0);
6293 tp = &tbuffer[sizeof(struct rx_header)];
6294 taddr.sin_family = AF_INET;
6295 taddr.sin_port = remotePort;
6296 taddr.sin_addr.s_addr = remoteAddr;
6297 #ifdef STRUCT_SOCKADDR_HAS_SA_LEN
6298 taddr.sin_len = sizeof(struct sockaddr_in);
6301 memset(&theader, 0, sizeof(theader));
6302 theader.epoch = htonl(999);
6304 theader.callNumber = htonl(counter);
6307 theader.type = type;
6308 theader.flags = RX_CLIENT_INITIATED | RX_LAST_PACKET;
6309 theader.serviceId = 0;
6311 memcpy(tbuffer, &theader, sizeof(theader));
6312 memcpy(tp, inputData, inputLength);
6314 sendto(socket, tbuffer, inputLength + sizeof(struct rx_header), 0,
6315 (struct sockaddr *)&taddr, sizeof(struct sockaddr_in));
6317 /* see if there's a packet available */
6318 gettimeofday(&tv_wake,0);
6319 tv_wake.tv_sec += waitTime;
6322 FD_SET(socket, &imask);
6323 tv_delta.tv_sec = tv_wake.tv_sec;
6324 tv_delta.tv_usec = tv_wake.tv_usec;
6325 gettimeofday(&tv_now, 0);
6327 if (tv_delta.tv_usec < tv_now.tv_usec) {
6329 tv_delta.tv_usec += 1000000;
6332 tv_delta.tv_usec -= tv_now.tv_usec;
6334 if (tv_delta.tv_sec < tv_now.tv_sec) {
6338 tv_delta.tv_sec -= tv_now.tv_sec;
6340 code = select(socket + 1, &imask, 0, 0, &tv_delta);
6341 if (code == 1 && FD_ISSET(socket, &imask)) {
6342 /* now receive a packet */
6343 faddrLen = sizeof(struct sockaddr_in);
6345 recvfrom(socket, tbuffer, sizeof(tbuffer), 0,
6346 (struct sockaddr *)&faddr, &faddrLen);
6349 memcpy(&theader, tbuffer, sizeof(struct rx_header));
6350 if (counter == ntohl(theader.callNumber))
6358 /* see if we've timed out */
6366 code -= sizeof(struct rx_header);
6367 if (code > outputLength)
6368 code = outputLength;
6369 memcpy(outputData, tp, code);
6374 rx_GetServerDebug(osi_socket socket, afs_uint32 remoteAddr,
6375 afs_uint16 remotePort, struct rx_debugStats * stat,
6376 afs_uint32 * supportedValues)
6378 struct rx_debugIn in;
6381 *supportedValues = 0;
6382 in.type = htonl(RX_DEBUGI_GETSTATS);
6385 rc = MakeDebugCall(socket, remoteAddr, remotePort, RX_PACKET_TYPE_DEBUG,
6386 &in, sizeof(in), stat, sizeof(*stat));
6389 * If the call was successful, fixup the version and indicate
6390 * what contents of the stat structure are valid.
6391 * Also do net to host conversion of fields here.
6395 if (stat->version >= RX_DEBUGI_VERSION_W_SECSTATS) {
6396 *supportedValues |= RX_SERVER_DEBUG_SEC_STATS;
6398 if (stat->version >= RX_DEBUGI_VERSION_W_GETALLCONN) {
6399 *supportedValues |= RX_SERVER_DEBUG_ALL_CONN;
6401 if (stat->version >= RX_DEBUGI_VERSION_W_RXSTATS) {
6402 *supportedValues |= RX_SERVER_DEBUG_RX_STATS;
6404 if (stat->version >= RX_DEBUGI_VERSION_W_WAITERS) {
6405 *supportedValues |= RX_SERVER_DEBUG_WAITER_CNT;
6407 if (stat->version >= RX_DEBUGI_VERSION_W_IDLETHREADS) {
6408 *supportedValues |= RX_SERVER_DEBUG_IDLE_THREADS;
6410 if (stat->version >= RX_DEBUGI_VERSION_W_NEWPACKETTYPES) {
6411 *supportedValues |= RX_SERVER_DEBUG_NEW_PACKETS;
6413 if (stat->version >= RX_DEBUGI_VERSION_W_GETPEER) {
6414 *supportedValues |= RX_SERVER_DEBUG_ALL_PEER;
6416 if (stat->version >= RX_DEBUGI_VERSION_W_WAITED) {
6417 *supportedValues |= RX_SERVER_DEBUG_WAITED_CNT;
6420 stat->nFreePackets = ntohl(stat->nFreePackets);
6421 stat->packetReclaims = ntohl(stat->packetReclaims);
6422 stat->callsExecuted = ntohl(stat->callsExecuted);
6423 stat->nWaiting = ntohl(stat->nWaiting);
6424 stat->idleThreads = ntohl(stat->idleThreads);
6431 rx_GetServerStats(osi_socket socket, afs_uint32 remoteAddr,
6432 afs_uint16 remotePort, struct rx_stats * stat,
6433 afs_uint32 * supportedValues)
6435 struct rx_debugIn in;
6436 afs_int32 *lp = (afs_int32 *) stat;
6441 * supportedValues is currently unused, but added to allow future
6442 * versioning of this function.
6445 *supportedValues = 0;
6446 in.type = htonl(RX_DEBUGI_RXSTATS);
6448 memset(stat, 0, sizeof(*stat));
6450 rc = MakeDebugCall(socket, remoteAddr, remotePort, RX_PACKET_TYPE_DEBUG,
6451 &in, sizeof(in), stat, sizeof(*stat));
6456 * Do net to host conversion here
6459 for (i = 0; i < sizeof(*stat) / sizeof(afs_int32); i++, lp++) {
6468 rx_GetServerVersion(osi_socket socket, afs_uint32 remoteAddr,
6469 afs_uint16 remotePort, size_t version_length,
6473 return MakeDebugCall(socket, remoteAddr, remotePort,
6474 RX_PACKET_TYPE_VERSION, a, 1, version,
6479 rx_GetServerConnections(osi_socket socket, afs_uint32 remoteAddr,
6480 afs_uint16 remotePort, afs_int32 * nextConnection,
6481 int allConnections, afs_uint32 debugSupportedValues,
6482 struct rx_debugConn * conn,
6483 afs_uint32 * supportedValues)
6485 struct rx_debugIn in;
6490 * supportedValues is currently unused, but added to allow future
6491 * versioning of this function.
6494 *supportedValues = 0;
6495 if (allConnections) {
6496 in.type = htonl(RX_DEBUGI_GETALLCONN);
6498 in.type = htonl(RX_DEBUGI_GETCONN);
6500 in.index = htonl(*nextConnection);
6501 memset(conn, 0, sizeof(*conn));
6503 rc = MakeDebugCall(socket, remoteAddr, remotePort, RX_PACKET_TYPE_DEBUG,
6504 &in, sizeof(in), conn, sizeof(*conn));
6507 *nextConnection += 1;
6510 * Convert old connection format to new structure.
6513 if (debugSupportedValues & RX_SERVER_DEBUG_OLD_CONN) {
6514 struct rx_debugConn_vL *vL = (struct rx_debugConn_vL *)conn;
6515 #define MOVEvL(a) (conn->a = vL->a)
6517 /* any old or unrecognized version... */
6518 for (i = 0; i < RX_MAXCALLS; i++) {
6519 MOVEvL(callState[i]);
6520 MOVEvL(callMode[i]);
6521 MOVEvL(callFlags[i]);
6522 MOVEvL(callOther[i]);
6524 if (debugSupportedValues & RX_SERVER_DEBUG_SEC_STATS) {
6525 MOVEvL(secStats.type);
6526 MOVEvL(secStats.level);
6527 MOVEvL(secStats.flags);
6528 MOVEvL(secStats.expires);
6529 MOVEvL(secStats.packetsReceived);
6530 MOVEvL(secStats.packetsSent);
6531 MOVEvL(secStats.bytesReceived);
6532 MOVEvL(secStats.bytesSent);
6537 * Do net to host conversion here
6539 * I don't convert host or port since we are most likely
6540 * going to want these in NBO.
6542 conn->cid = ntohl(conn->cid);
6543 conn->serial = ntohl(conn->serial);
6544 for (i = 0; i < RX_MAXCALLS; i++) {
6545 conn->callNumber[i] = ntohl(conn->callNumber[i]);
6547 conn->error = ntohl(conn->error);
6548 conn->secStats.flags = ntohl(conn->secStats.flags);
6549 conn->secStats.expires = ntohl(conn->secStats.expires);
6550 conn->secStats.packetsReceived =
6551 ntohl(conn->secStats.packetsReceived);
6552 conn->secStats.packetsSent = ntohl(conn->secStats.packetsSent);
6553 conn->secStats.bytesReceived = ntohl(conn->secStats.bytesReceived);
6554 conn->secStats.bytesSent = ntohl(conn->secStats.bytesSent);
6555 conn->epoch = ntohl(conn->epoch);
6556 conn->natMTU = ntohl(conn->natMTU);
6563 rx_GetServerPeers(osi_socket socket, afs_uint32 remoteAddr,
6564 afs_uint16 remotePort, afs_int32 * nextPeer,
6565 afs_uint32 debugSupportedValues, struct rx_debugPeer * peer,
6566 afs_uint32 * supportedValues)
6568 struct rx_debugIn in;
6572 * supportedValues is currently unused, but added to allow future
6573 * versioning of this function.
6576 *supportedValues = 0;
6577 in.type = htonl(RX_DEBUGI_GETPEER);
6578 in.index = htonl(*nextPeer);
6579 memset(peer, 0, sizeof(*peer));
6581 rc = MakeDebugCall(socket, remoteAddr, remotePort, RX_PACKET_TYPE_DEBUG,
6582 &in, sizeof(in), peer, sizeof(*peer));
6588 * Do net to host conversion here
6590 * I don't convert host or port since we are most likely
6591 * going to want these in NBO.
6593 peer->ifMTU = ntohs(peer->ifMTU);
6594 peer->idleWhen = ntohl(peer->idleWhen);
6595 peer->refCount = ntohs(peer->refCount);
6596 peer->burstWait.sec = ntohl(peer->burstWait.sec);
6597 peer->burstWait.usec = ntohl(peer->burstWait.usec);
6598 peer->rtt = ntohl(peer->rtt);
6599 peer->rtt_dev = ntohl(peer->rtt_dev);
6600 peer->timeout.sec = ntohl(peer->timeout.sec);
6601 peer->timeout.usec = ntohl(peer->timeout.usec);
6602 peer->nSent = ntohl(peer->nSent);
6603 peer->reSends = ntohl(peer->reSends);
6604 peer->inPacketSkew = ntohl(peer->inPacketSkew);
6605 peer->outPacketSkew = ntohl(peer->outPacketSkew);
6606 peer->rateFlag = ntohl(peer->rateFlag);
6607 peer->natMTU = ntohs(peer->natMTU);
6608 peer->maxMTU = ntohs(peer->maxMTU);
6609 peer->maxDgramPackets = ntohs(peer->maxDgramPackets);
6610 peer->ifDgramPackets = ntohs(peer->ifDgramPackets);
6611 peer->MTU = ntohs(peer->MTU);
6612 peer->cwind = ntohs(peer->cwind);
6613 peer->nDgramPackets = ntohs(peer->nDgramPackets);
6614 peer->congestSeq = ntohs(peer->congestSeq);
6615 peer->bytesSent.high = ntohl(peer->bytesSent.high);
6616 peer->bytesSent.low = ntohl(peer->bytesSent.low);
6617 peer->bytesReceived.high = ntohl(peer->bytesReceived.high);
6618 peer->bytesReceived.low = ntohl(peer->bytesReceived.low);
6623 #endif /* RXDEBUG */
6628 struct rx_serverQueueEntry *np;
6631 register struct rx_call *call;
6632 register struct rx_serverQueueEntry *sq;
6636 if (rxinit_status == 1) {
6638 return; /* Already shutdown. */
6642 #ifndef AFS_PTHREAD_ENV
6643 FD_ZERO(&rx_selectMask);
6644 #endif /* AFS_PTHREAD_ENV */
6645 rxi_dataQuota = RX_MAX_QUOTA;
6646 #ifndef AFS_PTHREAD_ENV
6648 #endif /* AFS_PTHREAD_ENV */
6651 #ifndef AFS_PTHREAD_ENV
6652 #ifndef AFS_USE_GETTIMEOFDAY
6654 #endif /* AFS_USE_GETTIMEOFDAY */
6655 #endif /* AFS_PTHREAD_ENV */
6657 while (!queue_IsEmpty(&rx_freeCallQueue)) {
6658 call = queue_First(&rx_freeCallQueue, rx_call);
6660 rxi_Free(call, sizeof(struct rx_call));
6663 while (!queue_IsEmpty(&rx_idleServerQueue)) {
6664 sq = queue_First(&rx_idleServerQueue, rx_serverQueueEntry);
6670 struct rx_peer **peer_ptr, **peer_end;
6671 for (peer_ptr = &rx_peerHashTable[0], peer_end =
6672 &rx_peerHashTable[rx_hashTableSize]; peer_ptr < peer_end;
6674 struct rx_peer *peer, *next;
6675 for (peer = *peer_ptr; peer; peer = next) {
6676 rx_interface_stat_p rpc_stat, nrpc_stat;
6679 (&peer->rpcStats, rpc_stat, nrpc_stat,
6680 rx_interface_stat)) {
6681 unsigned int num_funcs;
6684 queue_Remove(&rpc_stat->queue_header);
6685 queue_Remove(&rpc_stat->all_peers);
6686 num_funcs = rpc_stat->stats[0].func_total;
6688 sizeof(rx_interface_stat_t) +
6689 rpc_stat->stats[0].func_total *
6690 sizeof(rx_function_entry_v1_t);
6692 rxi_Free(rpc_stat, space);
6693 MUTEX_ENTER(&rx_rpc_stats);
6694 rxi_rpc_peer_stat_cnt -= num_funcs;
6695 MUTEX_EXIT(&rx_rpc_stats);
6699 rx_MutexDecrement(rx_stats.nPeerStructs, rx_stats_mutex);
6703 for (i = 0; i < RX_MAX_SERVICES; i++) {
6705 rxi_Free(rx_services[i], sizeof(*rx_services[i]));
6707 for (i = 0; i < rx_hashTableSize; i++) {
6708 register struct rx_connection *tc, *ntc;
6709 MUTEX_ENTER(&rx_connHashTable_lock);
6710 for (tc = rx_connHashTable[i]; tc; tc = ntc) {
6712 for (j = 0; j < RX_MAXCALLS; j++) {
6714 rxi_Free(tc->call[j], sizeof(*tc->call[j]));
6717 rxi_Free(tc, sizeof(*tc));
6719 MUTEX_EXIT(&rx_connHashTable_lock);
6722 MUTEX_ENTER(&freeSQEList_lock);
6724 while ((np = rx_FreeSQEList)) {
6725 rx_FreeSQEList = *(struct rx_serverQueueEntry **)np;
6726 MUTEX_DESTROY(&np->lock);
6727 rxi_Free(np, sizeof(*np));
6730 MUTEX_EXIT(&freeSQEList_lock);
6731 MUTEX_DESTROY(&freeSQEList_lock);
6732 MUTEX_DESTROY(&rx_freeCallQueue_lock);
6733 MUTEX_DESTROY(&rx_connHashTable_lock);
6734 MUTEX_DESTROY(&rx_peerHashTable_lock);
6735 MUTEX_DESTROY(&rx_serverPool_lock);
6737 osi_Free(rx_connHashTable,
6738 rx_hashTableSize * sizeof(struct rx_connection *));
6739 osi_Free(rx_peerHashTable, rx_hashTableSize * sizeof(struct rx_peer *));
6741 UNPIN(rx_connHashTable,
6742 rx_hashTableSize * sizeof(struct rx_connection *));
6743 UNPIN(rx_peerHashTable, rx_hashTableSize * sizeof(struct rx_peer *));
6745 rxi_FreeAllPackets();
6747 MUTEX_ENTER(&rx_stats_mutex);
6748 rxi_dataQuota = RX_MAX_QUOTA;
6749 rxi_availProcs = rxi_totalMin = rxi_minDeficit = 0;
6750 MUTEX_EXIT(&rx_stats_mutex);
6756 #ifdef RX_ENABLE_LOCKS
6758 osirx_AssertMine(afs_kmutex_t * lockaddr, char *msg)
6760 if (!MUTEX_ISMINE(lockaddr))
6761 osi_Panic("Lock not held: %s", msg);
6763 #endif /* RX_ENABLE_LOCKS */
6768 * Routines to implement connection specific data.
6772 rx_KeyCreate(rx_destructor_t rtn)
6775 MUTEX_ENTER(&rxi_keyCreate_lock);
6776 key = rxi_keyCreate_counter++;
6777 rxi_keyCreate_destructor = (rx_destructor_t *)
6778 realloc((void *)rxi_keyCreate_destructor,
6779 (key + 1) * sizeof(rx_destructor_t));
6780 rxi_keyCreate_destructor[key] = rtn;
6781 MUTEX_EXIT(&rxi_keyCreate_lock);
6786 rx_SetSpecific(struct rx_connection *conn, int key, void *ptr)
6789 MUTEX_ENTER(&conn->conn_data_lock);
6790 if (!conn->specific) {
6791 conn->specific = (void **)malloc((key + 1) * sizeof(void *));
6792 for (i = 0; i < key; i++)
6793 conn->specific[i] = NULL;
6794 conn->nSpecific = key + 1;
6795 conn->specific[key] = ptr;
6796 } else if (key >= conn->nSpecific) {
6797 conn->specific = (void **)
6798 realloc(conn->specific, (key + 1) * sizeof(void *));
6799 for (i = conn->nSpecific; i < key; i++)
6800 conn->specific[i] = NULL;
6801 conn->nSpecific = key + 1;
6802 conn->specific[key] = ptr;
6804 if (conn->specific[key] && rxi_keyCreate_destructor[key])
6805 (*rxi_keyCreate_destructor[key]) (conn->specific[key]);
6806 conn->specific[key] = ptr;
6808 MUTEX_EXIT(&conn->conn_data_lock);
6812 rx_GetSpecific(struct rx_connection *conn, int key)
6815 MUTEX_ENTER(&conn->conn_data_lock);
6816 if (key >= conn->nSpecific)
6819 ptr = conn->specific[key];
6820 MUTEX_EXIT(&conn->conn_data_lock);
6824 #endif /* !KERNEL */
6827 * processStats is a queue used to store the statistics for the local
6828 * process. Its contents are similar to the contents of the rpcStats
6829 * queue on a rx_peer structure, but the actual data stored within
6830 * this queue contains totals across the lifetime of the process (assuming
6831 * the stats have not been reset) - unlike the per peer structures
6832 * which can come and go based upon the peer lifetime.
6835 static struct rx_queue processStats = { &processStats, &processStats };
6838 * peerStats is a queue used to store the statistics for all peer structs.
6839 * Its contents are the union of all the peer rpcStats queues.
6842 static struct rx_queue peerStats = { &peerStats, &peerStats };
6845 * rxi_monitor_processStats is used to turn process wide stat collection
6849 static int rxi_monitor_processStats = 0;
6852 * rxi_monitor_peerStats is used to turn per peer stat collection on and off
6855 static int rxi_monitor_peerStats = 0;
6858 * rxi_AddRpcStat - given all of the information for a particular rpc
6859 * call, create (if needed) and update the stat totals for the rpc.
6863 * IN stats - the queue of stats that will be updated with the new value
6865 * IN rxInterface - a unique number that identifies the rpc interface
6867 * IN currentFunc - the index of the function being invoked
6869 * IN totalFunc - the total number of functions in this interface
6871 * IN queueTime - the amount of time this function waited for a thread
6873 * IN execTime - the amount of time this function invocation took to execute
6875 * IN bytesSent - the number bytes sent by this invocation
6877 * IN bytesRcvd - the number bytes received by this invocation
6879 * IN isServer - if true, this invocation was made to a server
6881 * IN remoteHost - the ip address of the remote host
6883 * IN remotePort - the port of the remote host
6885 * IN addToPeerList - if != 0, add newly created stat to the global peer list
6887 * INOUT counter - if a new stats structure is allocated, the counter will
6888 * be updated with the new number of allocated stat structures
6896 rxi_AddRpcStat(struct rx_queue *stats, afs_uint32 rxInterface,
6897 afs_uint32 currentFunc, afs_uint32 totalFunc,
6898 struct clock *queueTime, struct clock *execTime,
6899 afs_hyper_t * bytesSent, afs_hyper_t * bytesRcvd, int isServer,
6900 afs_uint32 remoteHost, afs_uint32 remotePort,
6901 int addToPeerList, unsigned int *counter)
6904 rx_interface_stat_p rpc_stat, nrpc_stat;
6907 * See if there's already a structure for this interface
6910 for (queue_Scan(stats, rpc_stat, nrpc_stat, rx_interface_stat)) {
6911 if ((rpc_stat->stats[0].interfaceId == rxInterface)
6912 && (rpc_stat->stats[0].remote_is_server == isServer))
6917 * Didn't find a match so allocate a new structure and add it to the
6921 if (queue_IsEnd(stats, rpc_stat) || (rpc_stat == NULL)
6922 || (rpc_stat->stats[0].interfaceId != rxInterface)
6923 || (rpc_stat->stats[0].remote_is_server != isServer)) {
6928 sizeof(rx_interface_stat_t) +
6929 totalFunc * sizeof(rx_function_entry_v1_t);
6931 rpc_stat = (rx_interface_stat_p) rxi_Alloc(space);
6932 if (rpc_stat == NULL) {
6936 *counter += totalFunc;
6937 for (i = 0; i < totalFunc; i++) {
6938 rpc_stat->stats[i].remote_peer = remoteHost;
6939 rpc_stat->stats[i].remote_port = remotePort;
6940 rpc_stat->stats[i].remote_is_server = isServer;
6941 rpc_stat->stats[i].interfaceId = rxInterface;
6942 rpc_stat->stats[i].func_total = totalFunc;
6943 rpc_stat->stats[i].func_index = i;
6944 hzero(rpc_stat->stats[i].invocations);
6945 hzero(rpc_stat->stats[i].bytes_sent);
6946 hzero(rpc_stat->stats[i].bytes_rcvd);
6947 rpc_stat->stats[i].queue_time_sum.sec = 0;
6948 rpc_stat->stats[i].queue_time_sum.usec = 0;
6949 rpc_stat->stats[i].queue_time_sum_sqr.sec = 0;
6950 rpc_stat->stats[i].queue_time_sum_sqr.usec = 0;
6951 rpc_stat->stats[i].queue_time_min.sec = 9999999;
6952 rpc_stat->stats[i].queue_time_min.usec = 9999999;
6953 rpc_stat->stats[i].queue_time_max.sec = 0;
6954 rpc_stat->stats[i].queue_time_max.usec = 0;
6955 rpc_stat->stats[i].execution_time_sum.sec = 0;
6956 rpc_stat->stats[i].execution_time_sum.usec = 0;
6957 rpc_stat->stats[i].execution_time_sum_sqr.sec = 0;
6958 rpc_stat->stats[i].execution_time_sum_sqr.usec = 0;
6959 rpc_stat->stats[i].execution_time_min.sec = 9999999;
6960 rpc_stat->stats[i].execution_time_min.usec = 9999999;
6961 rpc_stat->stats[i].execution_time_max.sec = 0;
6962 rpc_stat->stats[i].execution_time_max.usec = 0;
6964 queue_Prepend(stats, rpc_stat);
6965 if (addToPeerList) {
6966 queue_Prepend(&peerStats, &rpc_stat->all_peers);
6971 * Increment the stats for this function
6974 hadd32(rpc_stat->stats[currentFunc].invocations, 1);
6975 hadd(rpc_stat->stats[currentFunc].bytes_sent, *bytesSent);
6976 hadd(rpc_stat->stats[currentFunc].bytes_rcvd, *bytesRcvd);
6977 clock_Add(&rpc_stat->stats[currentFunc].queue_time_sum, queueTime);
6978 clock_AddSq(&rpc_stat->stats[currentFunc].queue_time_sum_sqr, queueTime);
6979 if (clock_Lt(queueTime, &rpc_stat->stats[currentFunc].queue_time_min)) {
6980 rpc_stat->stats[currentFunc].queue_time_min = *queueTime;
6982 if (clock_Gt(queueTime, &rpc_stat->stats[currentFunc].queue_time_max)) {
6983 rpc_stat->stats[currentFunc].queue_time_max = *queueTime;
6985 clock_Add(&rpc_stat->stats[currentFunc].execution_time_sum, execTime);
6986 clock_AddSq(&rpc_stat->stats[currentFunc].execution_time_sum_sqr,
6988 if (clock_Lt(execTime, &rpc_stat->stats[currentFunc].execution_time_min)) {
6989 rpc_stat->stats[currentFunc].execution_time_min = *execTime;
6991 if (clock_Gt(execTime, &rpc_stat->stats[currentFunc].execution_time_max)) {
6992 rpc_stat->stats[currentFunc].execution_time_max = *execTime;
7000 * rx_IncrementTimeAndCount - increment the times and count for a particular
7005 * IN peer - the peer who invoked the rpc
7007 * IN rxInterface - a unique number that identifies the rpc interface
7009 * IN currentFunc - the index of the function being invoked
7011 * IN totalFunc - the total number of functions in this interface
7013 * IN queueTime - the amount of time this function waited for a thread
7015 * IN execTime - the amount of time this function invocation took to execute
7017 * IN bytesSent - the number bytes sent by this invocation
7019 * IN bytesRcvd - the number bytes received by this invocation
7021 * IN isServer - if true, this invocation was made to a server
7029 rx_IncrementTimeAndCount(struct rx_peer *peer, afs_uint32 rxInterface,
7030 afs_uint32 currentFunc, afs_uint32 totalFunc,
7031 struct clock *queueTime, struct clock *execTime,
7032 afs_hyper_t * bytesSent, afs_hyper_t * bytesRcvd,
7036 if (!(rxi_monitor_peerStats || rxi_monitor_processStats))
7039 MUTEX_ENTER(&rx_rpc_stats);
7040 MUTEX_ENTER(&peer->peer_lock);
7042 if (rxi_monitor_peerStats) {
7043 rxi_AddRpcStat(&peer->rpcStats, rxInterface, currentFunc, totalFunc,
7044 queueTime, execTime, bytesSent, bytesRcvd, isServer,
7045 peer->host, peer->port, 1, &rxi_rpc_peer_stat_cnt);
7048 if (rxi_monitor_processStats) {
7049 rxi_AddRpcStat(&processStats, rxInterface, currentFunc, totalFunc,
7050 queueTime, execTime, bytesSent, bytesRcvd, isServer,
7051 0xffffffff, 0xffffffff, 0, &rxi_rpc_process_stat_cnt);
7054 MUTEX_EXIT(&peer->peer_lock);
7055 MUTEX_EXIT(&rx_rpc_stats);
7060 * rx_MarshallProcessRPCStats - marshall an array of rpc statistics
7064 * IN callerVersion - the rpc stat version of the caller.
7066 * IN count - the number of entries to marshall.
7068 * IN stats - pointer to stats to be marshalled.
7070 * OUT ptr - Where to store the marshalled data.
7077 rx_MarshallProcessRPCStats(afs_uint32 callerVersion, int count,
7078 rx_function_entry_v1_t * stats, afs_uint32 ** ptrP)
7084 * We only support the first version
7086 for (ptr = *ptrP, i = 0; i < count; i++, stats++) {
7087 *(ptr++) = stats->remote_peer;
7088 *(ptr++) = stats->remote_port;
7089 *(ptr++) = stats->remote_is_server;
7090 *(ptr++) = stats->interfaceId;
7091 *(ptr++) = stats->func_total;
7092 *(ptr++) = stats->func_index;
7093 *(ptr++) = hgethi(stats->invocations);
7094 *(ptr++) = hgetlo(stats->invocations);
7095 *(ptr++) = hgethi(stats->bytes_sent);
7096 *(ptr++) = hgetlo(stats->bytes_sent);
7097 *(ptr++) = hgethi(stats->bytes_rcvd);
7098 *(ptr++) = hgetlo(stats->bytes_rcvd);
7099 *(ptr++) = stats->queue_time_sum.sec;
7100 *(ptr++) = stats->queue_time_sum.usec;
7101 *(ptr++) = stats->queue_time_sum_sqr.sec;
7102 *(ptr++) = stats->queue_time_sum_sqr.usec;
7103 *(ptr++) = stats->queue_time_min.sec;
7104 *(ptr++) = stats->queue_time_min.usec;
7105 *(ptr++) = stats->queue_time_max.sec;
7106 *(ptr++) = stats->queue_time_max.usec;
7107 *(ptr++) = stats->execution_time_sum.sec;
7108 *(ptr++) = stats->execution_time_sum.usec;
7109 *(ptr++) = stats->execution_time_sum_sqr.sec;
7110 *(ptr++) = stats->execution_time_sum_sqr.usec;
7111 *(ptr++) = stats->execution_time_min.sec;
7112 *(ptr++) = stats->execution_time_min.usec;
7113 *(ptr++) = stats->execution_time_max.sec;
7114 *(ptr++) = stats->execution_time_max.usec;
7120 * rx_RetrieveProcessRPCStats - retrieve all of the rpc statistics for
7125 * IN callerVersion - the rpc stat version of the caller
7127 * OUT myVersion - the rpc stat version of this function
7129 * OUT clock_sec - local time seconds
7131 * OUT clock_usec - local time microseconds
7133 * OUT allocSize - the number of bytes allocated to contain stats
7135 * OUT statCount - the number stats retrieved from this process.
7137 * OUT stats - the actual stats retrieved from this process.
7141 * Returns void. If successful, stats will != NULL.
7145 rx_RetrieveProcessRPCStats(afs_uint32 callerVersion, afs_uint32 * myVersion,
7146 afs_uint32 * clock_sec, afs_uint32 * clock_usec,
7147 size_t * allocSize, afs_uint32 * statCount,
7148 afs_uint32 ** stats)
7158 *myVersion = RX_STATS_RETRIEVAL_VERSION;
7161 * Check to see if stats are enabled
7164 MUTEX_ENTER(&rx_rpc_stats);
7165 if (!rxi_monitor_processStats) {
7166 MUTEX_EXIT(&rx_rpc_stats);
7170 clock_GetTime(&now);
7171 *clock_sec = now.sec;
7172 *clock_usec = now.usec;
7175 * Allocate the space based upon the caller version
7177 * If the client is at an older version than we are,
7178 * we return the statistic data in the older data format, but
7179 * we still return our version number so the client knows we
7180 * are maintaining more data than it can retrieve.
7183 if (callerVersion >= RX_STATS_RETRIEVAL_FIRST_EDITION) {
7184 space = rxi_rpc_process_stat_cnt * sizeof(rx_function_entry_v1_t);
7185 *statCount = rxi_rpc_process_stat_cnt;
7188 * This can't happen yet, but in the future version changes
7189 * can be handled by adding additional code here
7193 if (space > (size_t) 0) {
7195 ptr = *stats = (afs_uint32 *) rxi_Alloc(space);
7198 rx_interface_stat_p rpc_stat, nrpc_stat;
7202 (&processStats, rpc_stat, nrpc_stat, rx_interface_stat)) {
7204 * Copy the data based upon the caller version
7206 rx_MarshallProcessRPCStats(callerVersion,
7207 rpc_stat->stats[0].func_total,
7208 rpc_stat->stats, &ptr);
7214 MUTEX_EXIT(&rx_rpc_stats);
7219 * rx_RetrievePeerRPCStats - retrieve all of the rpc statistics for the peers
7223 * IN callerVersion - the rpc stat version of the caller
7225 * OUT myVersion - the rpc stat version of this function
7227 * OUT clock_sec - local time seconds
7229 * OUT clock_usec - local time microseconds
7231 * OUT allocSize - the number of bytes allocated to contain stats
7233 * OUT statCount - the number of stats retrieved from the individual
7236 * OUT stats - the actual stats retrieved from the individual peer structures.
7240 * Returns void. If successful, stats will != NULL.
7244 rx_RetrievePeerRPCStats(afs_uint32 callerVersion, afs_uint32 * myVersion,
7245 afs_uint32 * clock_sec, afs_uint32 * clock_usec,
7246 size_t * allocSize, afs_uint32 * statCount,
7247 afs_uint32 ** stats)
7257 *myVersion = RX_STATS_RETRIEVAL_VERSION;
7260 * Check to see if stats are enabled
7263 MUTEX_ENTER(&rx_rpc_stats);
7264 if (!rxi_monitor_peerStats) {
7265 MUTEX_EXIT(&rx_rpc_stats);
7269 clock_GetTime(&now);
7270 *clock_sec = now.sec;
7271 *clock_usec = now.usec;
7274 * Allocate the space based upon the caller version
7276 * If the client is at an older version than we are,
7277 * we return the statistic data in the older data format, but
7278 * we still return our version number so the client knows we
7279 * are maintaining more data than it can retrieve.
7282 if (callerVersion >= RX_STATS_RETRIEVAL_FIRST_EDITION) {
7283 space = rxi_rpc_peer_stat_cnt * sizeof(rx_function_entry_v1_t);
7284 *statCount = rxi_rpc_peer_stat_cnt;
7287 * This can't happen yet, but in the future version changes
7288 * can be handled by adding additional code here
7292 if (space > (size_t) 0) {
7294 ptr = *stats = (afs_uint32 *) rxi_Alloc(space);
7297 rx_interface_stat_p rpc_stat, nrpc_stat;
7301 (&peerStats, rpc_stat, nrpc_stat, rx_interface_stat)) {
7303 * We have to fix the offset of rpc_stat since we are
7304 * keeping this structure on two rx_queues. The rx_queue
7305 * package assumes that the rx_queue member is the first
7306 * member of the structure. That is, rx_queue assumes that
7307 * any one item is only on one queue at a time. We are
7308 * breaking that assumption and so we have to do a little
7309 * math to fix our pointers.
7312 fix_offset = (char *)rpc_stat;
7313 fix_offset -= offsetof(rx_interface_stat_t, all_peers);
7314 rpc_stat = (rx_interface_stat_p) fix_offset;
7317 * Copy the data based upon the caller version
7319 rx_MarshallProcessRPCStats(callerVersion,
7320 rpc_stat->stats[0].func_total,
7321 rpc_stat->stats, &ptr);
7327 MUTEX_EXIT(&rx_rpc_stats);
7332 * rx_FreeRPCStats - free memory allocated by
7333 * rx_RetrieveProcessRPCStats and rx_RetrievePeerRPCStats
7337 * IN stats - stats previously returned by rx_RetrieveProcessRPCStats or
7338 * rx_RetrievePeerRPCStats
7340 * IN allocSize - the number of bytes in stats.
7348 rx_FreeRPCStats(afs_uint32 * stats, size_t allocSize)
7350 rxi_Free(stats, allocSize);
7354 * rx_queryProcessRPCStats - see if process rpc stat collection is
7355 * currently enabled.
7361 * Returns 0 if stats are not enabled != 0 otherwise
7365 rx_queryProcessRPCStats(void)
7368 MUTEX_ENTER(&rx_rpc_stats);
7369 rc = rxi_monitor_processStats;
7370 MUTEX_EXIT(&rx_rpc_stats);
7375 * rx_queryPeerRPCStats - see if peer stat collection is currently enabled.
7381 * Returns 0 if stats are not enabled != 0 otherwise
7385 rx_queryPeerRPCStats(void)
7388 MUTEX_ENTER(&rx_rpc_stats);
7389 rc = rxi_monitor_peerStats;
7390 MUTEX_EXIT(&rx_rpc_stats);
7395 * rx_enableProcessRPCStats - begin rpc stat collection for entire process
7405 rx_enableProcessRPCStats(void)
7407 MUTEX_ENTER(&rx_rpc_stats);
7408 rx_enable_stats = 1;
7409 rxi_monitor_processStats = 1;
7410 MUTEX_EXIT(&rx_rpc_stats);
7414 * rx_enablePeerRPCStats - begin rpc stat collection per peer structure
7424 rx_enablePeerRPCStats(void)
7426 MUTEX_ENTER(&rx_rpc_stats);
7427 rx_enable_stats = 1;
7428 rxi_monitor_peerStats = 1;
7429 MUTEX_EXIT(&rx_rpc_stats);
7433 * rx_disableProcessRPCStats - stop rpc stat collection for entire process
7443 rx_disableProcessRPCStats(void)
7445 rx_interface_stat_p rpc_stat, nrpc_stat;
7448 MUTEX_ENTER(&rx_rpc_stats);
7451 * Turn off process statistics and if peer stats is also off, turn
7455 rxi_monitor_processStats = 0;
7456 if (rxi_monitor_peerStats == 0) {
7457 rx_enable_stats = 0;
7460 for (queue_Scan(&processStats, rpc_stat, nrpc_stat, rx_interface_stat)) {
7461 unsigned int num_funcs = 0;
7464 queue_Remove(rpc_stat);
7465 num_funcs = rpc_stat->stats[0].func_total;
7467 sizeof(rx_interface_stat_t) +
7468 rpc_stat->stats[0].func_total * sizeof(rx_function_entry_v1_t);
7470 rxi_Free(rpc_stat, space);
7471 rxi_rpc_process_stat_cnt -= num_funcs;
7473 MUTEX_EXIT(&rx_rpc_stats);
7477 * rx_disablePeerRPCStats - stop rpc stat collection for peers
7487 rx_disablePeerRPCStats(void)
7489 struct rx_peer **peer_ptr, **peer_end;
7492 MUTEX_ENTER(&rx_rpc_stats);
7495 * Turn off peer statistics and if process stats is also off, turn
7499 rxi_monitor_peerStats = 0;
7500 if (rxi_monitor_processStats == 0) {
7501 rx_enable_stats = 0;
7504 MUTEX_ENTER(&rx_peerHashTable_lock);
7505 for (peer_ptr = &rx_peerHashTable[0], peer_end =
7506 &rx_peerHashTable[rx_hashTableSize]; peer_ptr < peer_end;
7508 struct rx_peer *peer, *next, *prev;
7509 for (prev = peer = *peer_ptr; peer; peer = next) {
7511 code = MUTEX_TRYENTER(&peer->peer_lock);
7513 rx_interface_stat_p rpc_stat, nrpc_stat;
7516 (&peer->rpcStats, rpc_stat, nrpc_stat,
7517 rx_interface_stat)) {
7518 unsigned int num_funcs = 0;
7521 queue_Remove(&rpc_stat->queue_header);
7522 queue_Remove(&rpc_stat->all_peers);
7523 num_funcs = rpc_stat->stats[0].func_total;
7525 sizeof(rx_interface_stat_t) +
7526 rpc_stat->stats[0].func_total *
7527 sizeof(rx_function_entry_v1_t);
7529 rxi_Free(rpc_stat, space);
7530 rxi_rpc_peer_stat_cnt -= num_funcs;
7532 MUTEX_EXIT(&peer->peer_lock);
7533 if (prev == *peer_ptr) {
7543 MUTEX_EXIT(&rx_peerHashTable_lock);
7544 MUTEX_EXIT(&rx_rpc_stats);
7548 * rx_clearProcessRPCStats - clear the contents of the rpc stats according
7553 * IN clearFlag - flag indicating which stats to clear
7561 rx_clearProcessRPCStats(afs_uint32 clearFlag)
7563 rx_interface_stat_p rpc_stat, nrpc_stat;
7565 MUTEX_ENTER(&rx_rpc_stats);
7567 for (queue_Scan(&processStats, rpc_stat, nrpc_stat, rx_interface_stat)) {
7568 unsigned int num_funcs = 0, i;
7569 num_funcs = rpc_stat->stats[0].func_total;
7570 for (i = 0; i < num_funcs; i++) {
7571 if (clearFlag & AFS_RX_STATS_CLEAR_INVOCATIONS) {
7572 hzero(rpc_stat->stats[i].invocations);
7574 if (clearFlag & AFS_RX_STATS_CLEAR_BYTES_SENT) {
7575 hzero(rpc_stat->stats[i].bytes_sent);
7577 if (clearFlag & AFS_RX_STATS_CLEAR_BYTES_RCVD) {
7578 hzero(rpc_stat->stats[i].bytes_rcvd);
7580 if (clearFlag & AFS_RX_STATS_CLEAR_QUEUE_TIME_SUM) {
7581 rpc_stat->stats[i].queue_time_sum.sec = 0;
7582 rpc_stat->stats[i].queue_time_sum.usec = 0;
7584 if (clearFlag & AFS_RX_STATS_CLEAR_QUEUE_TIME_SQUARE) {
7585 rpc_stat->stats[i].queue_time_sum_sqr.sec = 0;
7586 rpc_stat->stats[i].queue_time_sum_sqr.usec = 0;
7588 if (clearFlag & AFS_RX_STATS_CLEAR_QUEUE_TIME_MIN) {
7589 rpc_stat->stats[i].queue_time_min.sec = 9999999;
7590 rpc_stat->stats[i].queue_time_min.usec = 9999999;
7592 if (clearFlag & AFS_RX_STATS_CLEAR_QUEUE_TIME_MAX) {
7593 rpc_stat->stats[i].queue_time_max.sec = 0;
7594 rpc_stat->stats[i].queue_time_max.usec = 0;
7596 if (clearFlag & AFS_RX_STATS_CLEAR_EXEC_TIME_SUM) {
7597 rpc_stat->stats[i].execution_time_sum.sec = 0;
7598 rpc_stat->stats[i].execution_time_sum.usec = 0;
7600 if (clearFlag & AFS_RX_STATS_CLEAR_EXEC_TIME_SQUARE) {
7601 rpc_stat->stats[i].execution_time_sum_sqr.sec = 0;
7602 rpc_stat->stats[i].execution_time_sum_sqr.usec = 0;
7604 if (clearFlag & AFS_RX_STATS_CLEAR_EXEC_TIME_MIN) {
7605 rpc_stat->stats[i].execution_time_min.sec = 9999999;
7606 rpc_stat->stats[i].execution_time_min.usec = 9999999;
7608 if (clearFlag & AFS_RX_STATS_CLEAR_EXEC_TIME_MAX) {
7609 rpc_stat->stats[i].execution_time_max.sec = 0;
7610 rpc_stat->stats[i].execution_time_max.usec = 0;
7615 MUTEX_EXIT(&rx_rpc_stats);
7619 * rx_clearPeerRPCStats - clear the contents of the rpc stats according
7624 * IN clearFlag - flag indicating which stats to clear
7632 rx_clearPeerRPCStats(afs_uint32 clearFlag)
7634 rx_interface_stat_p rpc_stat, nrpc_stat;
7636 MUTEX_ENTER(&rx_rpc_stats);
7638 for (queue_Scan(&peerStats, rpc_stat, nrpc_stat, rx_interface_stat)) {
7639 unsigned int num_funcs = 0, i;
7642 * We have to fix the offset of rpc_stat since we are
7643 * keeping this structure on two rx_queues. The rx_queue
7644 * package assumes that the rx_queue member is the first
7645 * member of the structure. That is, rx_queue assumes that
7646 * any one item is only on one queue at a time. We are
7647 * breaking that assumption and so we have to do a little
7648 * math to fix our pointers.
7651 fix_offset = (char *)rpc_stat;
7652 fix_offset -= offsetof(rx_interface_stat_t, all_peers);
7653 rpc_stat = (rx_interface_stat_p) fix_offset;
7655 num_funcs = rpc_stat->stats[0].func_total;
7656 for (i = 0; i < num_funcs; i++) {
7657 if (clearFlag & AFS_RX_STATS_CLEAR_INVOCATIONS) {
7658 hzero(rpc_stat->stats[i].invocations);
7660 if (clearFlag & AFS_RX_STATS_CLEAR_BYTES_SENT) {
7661 hzero(rpc_stat->stats[i].bytes_sent);
7663 if (clearFlag & AFS_RX_STATS_CLEAR_BYTES_RCVD) {
7664 hzero(rpc_stat->stats[i].bytes_rcvd);
7666 if (clearFlag & AFS_RX_STATS_CLEAR_QUEUE_TIME_SUM) {
7667 rpc_stat->stats[i].queue_time_sum.sec = 0;
7668 rpc_stat->stats[i].queue_time_sum.usec = 0;
7670 if (clearFlag & AFS_RX_STATS_CLEAR_QUEUE_TIME_SQUARE) {
7671 rpc_stat->stats[i].queue_time_sum_sqr.sec = 0;
7672 rpc_stat->stats[i].queue_time_sum_sqr.usec = 0;
7674 if (clearFlag & AFS_RX_STATS_CLEAR_QUEUE_TIME_MIN) {
7675 rpc_stat->stats[i].queue_time_min.sec = 9999999;
7676 rpc_stat->stats[i].queue_time_min.usec = 9999999;
7678 if (clearFlag & AFS_RX_STATS_CLEAR_QUEUE_TIME_MAX) {
7679 rpc_stat->stats[i].queue_time_max.sec = 0;
7680 rpc_stat->stats[i].queue_time_max.usec = 0;
7682 if (clearFlag & AFS_RX_STATS_CLEAR_EXEC_TIME_SUM) {
7683 rpc_stat->stats[i].execution_time_sum.sec = 0;
7684 rpc_stat->stats[i].execution_time_sum.usec = 0;
7686 if (clearFlag & AFS_RX_STATS_CLEAR_EXEC_TIME_SQUARE) {
7687 rpc_stat->stats[i].execution_time_sum_sqr.sec = 0;
7688 rpc_stat->stats[i].execution_time_sum_sqr.usec = 0;
7690 if (clearFlag & AFS_RX_STATS_CLEAR_EXEC_TIME_MIN) {
7691 rpc_stat->stats[i].execution_time_min.sec = 9999999;
7692 rpc_stat->stats[i].execution_time_min.usec = 9999999;
7694 if (clearFlag & AFS_RX_STATS_CLEAR_EXEC_TIME_MAX) {
7695 rpc_stat->stats[i].execution_time_max.sec = 0;
7696 rpc_stat->stats[i].execution_time_max.usec = 0;
7701 MUTEX_EXIT(&rx_rpc_stats);
7705 * rxi_rxstat_userok points to a routine that returns 1 if the caller
7706 * is authorized to enable/disable/clear RX statistics.
7708 static int (*rxi_rxstat_userok) (struct rx_call * call) = NULL;
7711 rx_SetRxStatUserOk(int (*proc) (struct rx_call * call))
7713 rxi_rxstat_userok = proc;
7717 rx_RxStatUserOk(struct rx_call *call)
7719 if (!rxi_rxstat_userok)
7721 return rxi_rxstat_userok(call);
7726 * DllMain() -- Entry-point function called by the DllMainCRTStartup()
7727 * function in the MSVC runtime DLL (msvcrt.dll).
7729 * Note: the system serializes calls to this function.
7732 DllMain(HINSTANCE dllInstHandle, /* instance handle for this DLL module */
7733 DWORD reason, /* reason function is being called */
7734 LPVOID reserved) /* reserved for future use */
7737 case DLL_PROCESS_ATTACH:
7738 /* library is being attached to a process */
7742 case DLL_PROCESS_DETACH: