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
12 * Exported routines (and their private support) to implement
13 * the callback RPC interface.
16 #include <afsconfig.h>
17 #include "afs/param.h"
22 #include "afs/sysincludes.h" /*Standard vendor system headers */
23 #include "afsincludes.h" /*AFS-based standard headers */
24 #include "afs/afs_stats.h" /*Cache Manager stats */
25 #include "afs/afs_args.h"
27 afs_int32 afs_allCBs = 0; /*Break callbacks on all objects */
28 afs_int32 afs_oddCBs = 0; /*Break callbacks on dirs */
29 afs_int32 afs_evenCBs = 0; /*Break callbacks received on files */
30 afs_int32 afs_allZaps = 0; /*Objects entries deleted */
31 afs_int32 afs_oddZaps = 0; /*Dir cache entries deleted */
32 afs_int32 afs_evenZaps = 0; /*File cache entries deleted */
33 afs_int32 afs_connectBacks = 0;
36 * Some debugging aids.
38 static struct ltable {
43 "afs_xvcache", (char *)&afs_xvcache}, {
44 "afs_xdcache", (char *)&afs_xdcache}, {
45 "afs_xserver", (char *)&afs_xserver}, {
46 "afs_xvcb", (char *)&afs_xvcb}, {
47 "afs_xbrs", (char *)&afs_xbrs}, {
48 "afs_xcell", (char *)&afs_xcell}, {
49 "afs_xconn", (char *)&afs_xconn}, {
50 "afs_xuser", (char *)&afs_xuser}, {
51 "afs_xvolume", (char *)&afs_xvolume}, {
52 "puttofile", (char *)&afs_puttofileLock}, {
53 "afs_ftf", (char *)&afs_ftf}, {
54 "afs_xcbhash", (char *)&afs_xcbhash}, {
55 "afs_xaxs", (char *)&afs_xaxs}, {
56 "afs_xinterface", (char *)&afs_xinterface},
59 "afs_xosi", (char *)&afs_xosi},
62 "afs_xsrvAddr", (char *)&afs_xsrvAddr}
64 unsigned long lastCallBack_vnode;
65 unsigned int lastCallBack_dv;
66 osi_timeval_t lastCallBack_time;
68 /* these are for storing alternate interface addresses */
69 struct interfaceAddr afs_cb_interface;
71 /*------------------------------------------------------------------------
72 * EXPORTED SRXAFSCB_GetCE
75 * Routine called by the server-side callback RPC interface to
76 * implement pulling out the contents of the i'th cache entry.
79 * a_call : Ptr to Rx call on which this request came in.
80 * a_index : Index of desired cache entry.
81 * a_result : Ptr to a buffer for the given cache entry.
84 * 0 if everything went fine,
85 * 1 if we were given a bad index.
88 * Nothing interesting.
92 *------------------------------------------------------------------------*/
95 SRXAFSCB_GetCE(struct rx_call *a_call, afs_int32 a_index,
96 struct AFSDBCacheEntry *a_result)
99 register int i; /*Loop variable */
100 register struct vcache *tvc; /*Ptr to current cache entry */
101 int code; /*Return code */
106 XSTATS_START_CMTIME(AFS_STATS_CM_RPCIDX_GETCE);
108 AFS_STATCNT(SRXAFSCB_GetCE);
109 for (i = 0; i < VCSIZE; i++) {
110 for (tvc = afs_vhashT[i]; tvc; tvc = tvc->hnext) {
114 } /*Zip through current hash chain */
115 } /*Zip through hash chains */
125 * Copy out the located entry.
127 a_result->addr = afs_data_pointer_to_int32(tvc);
128 a_result->cell = tvc->fid.Cell;
129 a_result->netFid.Volume = tvc->fid.Fid.Volume;
130 a_result->netFid.Vnode = tvc->fid.Fid.Vnode;
131 a_result->netFid.Unique = tvc->fid.Fid.Unique;
132 a_result->lock.waitStates = tvc->lock.wait_states;
133 a_result->lock.exclLocked = tvc->lock.excl_locked;
134 a_result->lock.readersReading = tvc->lock.readers_reading;
135 a_result->lock.numWaiting = tvc->lock.num_waiting;
136 #if defined(INSTRUMENT_LOCKS)
137 a_result->lock.pid_last_reader = tvc->lock.pid_last_reader;
138 a_result->lock.pid_writer = tvc->lock.pid_writer;
139 a_result->lock.src_indicator = tvc->lock.src_indicator;
141 /* On osf20 , the vcache does not maintain these three fields */
142 a_result->lock.pid_last_reader = 0;
143 a_result->lock.pid_writer = 0;
144 a_result->lock.src_indicator = 0;
145 #endif /* AFS_OSF20_ENV */
146 #ifdef AFS_64BIT_CLIENT
147 a_result->Length = (afs_int32) tvc->m.Length & 0xffffffff;
148 #else /* AFS_64BIT_CLIENT */
149 a_result->Length = tvc->m.Length;
150 #endif /* AFS_64BIT_CLIENT */
151 a_result->DataVersion = hgetlo(tvc->m.DataVersion);
152 a_result->callback = afs_data_pointer_to_int32(tvc->callback); /* XXXX Now a pointer; change it XXXX */
153 a_result->cbExpires = tvc->cbExpires;
154 a_result->refCount = VREFCOUNT(tvc);
155 a_result->opens = tvc->opens;
156 a_result->writers = tvc->execsOrWriters;
157 a_result->mvstat = tvc->mvstat;
158 a_result->states = tvc->states;
162 * Return our results.
171 } /*SRXAFSCB_GetCE */
174 SRXAFSCB_GetCE64(struct rx_call *a_call, afs_int32 a_index,
175 struct AFSDBCacheEntry64 *a_result)
177 register int i; /*Loop variable */
178 register struct vcache *tvc; /*Ptr to current cache entry */
179 int code; /*Return code */
184 XSTATS_START_CMTIME(AFS_STATS_CM_RPCIDX_GETCE);
186 AFS_STATCNT(SRXAFSCB_GetCE64);
187 for (i = 0; i < VCSIZE; i++) {
188 for (tvc = afs_vhashT[i]; tvc; tvc = tvc->hnext) {
192 } /*Zip through current hash chain */
193 } /*Zip through hash chains */
203 * Copy out the located entry.
205 a_result->addr = afs_data_pointer_to_int32(tvc);
206 a_result->cell = tvc->fid.Cell;
207 a_result->netFid.Volume = tvc->fid.Fid.Volume;
208 a_result->netFid.Vnode = tvc->fid.Fid.Vnode;
209 a_result->netFid.Unique = tvc->fid.Fid.Unique;
210 a_result->lock.waitStates = tvc->lock.wait_states;
211 a_result->lock.exclLocked = tvc->lock.excl_locked;
212 a_result->lock.readersReading = tvc->lock.readers_reading;
213 a_result->lock.numWaiting = tvc->lock.num_waiting;
214 #if defined(INSTRUMENT_LOCKS)
215 a_result->lock.pid_last_reader = tvc->lock.pid_last_reader;
216 a_result->lock.pid_writer = tvc->lock.pid_writer;
217 a_result->lock.src_indicator = tvc->lock.src_indicator;
219 /* On osf20 , the vcache does not maintain these three fields */
220 a_result->lock.pid_last_reader = 0;
221 a_result->lock.pid_writer = 0;
222 a_result->lock.src_indicator = 0;
223 #endif /* AFS_OSF20_ENV */
224 #if !defined(AFS_64BIT_ENV)
225 a_result->Length.high = 0;
226 a_result->Length.low = tvc->m.Length;
228 a_result->Length = tvc->m.Length;
230 a_result->DataVersion = hgetlo(tvc->m.DataVersion);
231 a_result->callback = afs_data_pointer_to_int32(tvc->callback); /* XXXX Now a pointer; change it XXXX */
232 a_result->cbExpires = tvc->cbExpires;
233 a_result->refCount = VREFCOUNT(tvc);
234 a_result->opens = tvc->opens;
235 a_result->writers = tvc->execsOrWriters;
236 a_result->mvstat = tvc->mvstat;
237 a_result->states = tvc->states;
241 * Return our results.
250 } /*SRXAFSCB_GetCE64 */
253 /*------------------------------------------------------------------------
254 * EXPORTED SRXAFSCB_GetLock
257 * Routine called by the server-side callback RPC interface to
258 * implement pulling out the contents of a lock in the lock
262 * a_call : Ptr to Rx call on which this request came in.
263 * a_index : Index of desired lock.
264 * a_result : Ptr to a buffer for the given lock.
267 * 0 if everything went fine,
268 * 1 if we were given a bad index.
271 * Nothing interesting.
275 *------------------------------------------------------------------------*/
278 SRXAFSCB_GetLock(struct rx_call *a_call, afs_int32 a_index,
279 struct AFSDBLock *a_result)
281 struct ltable *tl; /*Ptr to lock table entry */
282 int nentries; /*Num entries in table */
283 int code; /*Return code */
288 XSTATS_START_CMTIME(AFS_STATS_CM_RPCIDX_GETLOCK);
290 AFS_STATCNT(SRXAFSCB_GetLock);
291 nentries = sizeof(ltable) / sizeof(struct ltable);
292 if (a_index < 0 || a_index >= nentries) {
299 * Found it - copy out its contents.
301 tl = <able[a_index];
302 strcpy(a_result->name, tl->name);
303 a_result->lock.waitStates =
304 ((struct afs_lock *)(tl->addr))->wait_states;
305 a_result->lock.exclLocked =
306 ((struct afs_lock *)(tl->addr))->excl_locked;
307 a_result->lock.readersReading =
308 ((struct afs_lock *)(tl->addr))->readers_reading;
309 a_result->lock.numWaiting =
310 ((struct afs_lock *)(tl->addr))->num_waiting;
311 #ifdef INSTRUMENT_LOCKS
312 a_result->lock.pid_last_reader =
313 ((struct afs_lock *)(tl->addr))->pid_last_reader;
314 a_result->lock.pid_writer =
315 ((struct afs_lock *)(tl->addr))->pid_writer;
316 a_result->lock.src_indicator =
317 ((struct afs_lock *)(tl->addr))->src_indicator;
319 a_result->lock.pid_last_reader = 0;
320 a_result->lock.pid_writer = 0;
321 a_result->lock.src_indicator = 0;
332 } /*SRXAFSCB_GetLock */
335 /*------------------------------------------------------------------------
336 * static ClearCallBack
339 * Clear out callback information for the specified file, or
340 * even a whole volume. Used to worry about callback was from
341 * within the particular cell or not. Now we don't bother with
342 * that anymore; it's not worth the time.
345 * a_conn : Ptr to Rx connection involved.
346 * a_fid : Ptr to AFS fid being cleared.
352 * Nothing interesting.
357 Appears to need to be called with GLOCK held, as the icl_Event4 stuff asserts otherwise
359 *------------------------------------------------------------------------*/
362 ClearCallBack(register struct rx_connection *a_conn,
363 register struct AFSFid *a_fid)
365 register struct vcache *tvc;
367 struct VenusFid localFid;
370 AFS_STATCNT(ClearCallBack);
375 * XXXX Don't hold any server locks here because of callback protocol XXX
378 localFid.Fid.Volume = a_fid->Volume;
379 localFid.Fid.Vnode = a_fid->Vnode;
380 localFid.Fid.Unique = a_fid->Unique;
383 * Volume ID of zero means don't do anything.
385 if (a_fid->Volume != 0) {
386 if (a_fid->Vnode == 0) {
388 * Clear callback for the whole volume. Zip through the
389 * hash chain, nullifying entries whose volume ID matches.
391 i = VCHashV(&localFid);
392 for (tvc = afs_vhashTV[i]; tvc; tvc = tvc->vhnext) {
393 if (tvc->fid.Fid.Volume == a_fid->Volume) {
394 tvc->callback = NULL;
396 localFid.Cell = tvc->fid.Cell;
397 tvc->dchint = NULL; /* invalidate hints */
398 ObtainWriteLock(&afs_xcbhash, 449);
399 afs_DequeueCallback(tvc);
400 tvc->states &= ~(CStatd | CUnique | CBulkFetching);
402 if (tvc->fid.Fid.Vnode & 1)
406 ReleaseWriteLock(&afs_xcbhash);
407 if (tvc->fid.Fid.Vnode & 1 || (vType(tvc) == VDIR))
408 osi_dnlc_purgedp(tvc);
409 afs_Trace3(afs_iclSetp, CM_TRACE_CALLBACK,
410 ICL_TYPE_POINTER, tvc, ICL_TYPE_INT32,
411 tvc->states, ICL_TYPE_INT32,
413 } else if ((tvc->states & CMValid)
414 && (tvc->mvid->Fid.Volume == a_fid->Volume)) {
415 tvc->states &= ~CMValid;
417 localFid.Cell = tvc->mvid->Cell;
422 * XXXX Don't hold any locks here XXXX
424 tv = afs_FindVolume(&localFid, 0);
426 afs_ResetVolumeInfo(tv);
427 afs_PutVolume(tv, 0);
428 /* invalidate mtpoint? */
430 } /*Clear callbacks for whole volume */
433 * Clear callbacks just for the one file.
436 if (a_fid->Vnode & 1)
437 afs_oddCBs++; /*Could do this on volume basis, too */
439 afs_evenCBs++; /*A particular fid was specified */
440 i = VCHash(&localFid);
441 for (tvc = afs_vhashT[i]; tvc; tvc = tvc->hnext) {
442 if (tvc->fid.Fid.Vnode == a_fid->Vnode
443 && tvc->fid.Fid.Volume == a_fid->Volume
444 && tvc->fid.Fid.Unique == a_fid->Unique) {
445 tvc->callback = NULL;
446 tvc->dchint = NULL; /* invalidate hints */
447 ObtainWriteLock(&afs_xcbhash, 450);
448 afs_DequeueCallback(tvc);
449 tvc->states &= ~(CStatd | CUnique | CBulkFetching);
450 ReleaseWriteLock(&afs_xcbhash);
451 if (a_fid->Vnode & 1 || (vType(tvc) == VDIR))
452 osi_dnlc_purgedp(tvc);
453 afs_Trace3(afs_iclSetp, CM_TRACE_CALLBACK,
454 ICL_TYPE_POINTER, tvc, ICL_TYPE_INT32,
455 tvc->states, ICL_TYPE_LONG, 0);
457 lastCallBack_vnode = afid->Vnode;
458 lastCallBack_dv = tvc->mstat.DataVersion.low;
459 osi_GetuTime(&lastCallBack_time);
462 } /*Walk through hash table */
463 } /*Clear callbacks for one file */
466 /*Fid has non-zero volume ID */
468 * Always return a predictable value.
475 /*------------------------------------------------------------------------
476 * EXPORTED SRXAFSCB_CallBack
479 * Routine called by the server-side callback RPC interface to
480 * implement passing in callback information.
484 * a_call : Ptr to Rx call on which this request came in.
485 * a_fids : Ptr to array of fids involved.
486 * a_callbacks : Ptr to matching callback info for the fids.
492 * Nothing interesting.
496 *------------------------------------------------------------------------*/
499 SRXAFSCB_CallBack(struct rx_call *a_call, register struct AFSCBFids *a_fids,
500 struct AFSCBs *a_callbacks)
502 register int i; /*Loop variable */
503 struct AFSFid *tfid; /*Ptr to current fid */
504 register struct rx_connection *tconn; /*Call's connection */
510 XSTATS_START_CMTIME(AFS_STATS_CM_RPCIDX_CALLBACK);
512 AFS_STATCNT(SRXAFSCB_CallBack);
513 if (!(tconn = rx_ConnectionOf(a_call)))
515 tfid = (struct AFSFid *)a_fids->AFSCBFids_val;
518 * For now, we ignore callbacks, since the File Server only *breaks*
519 * callbacks at present.
521 for (i = 0; i < a_fids->AFSCBFids_len; i++)
522 ClearCallBack(tconn, &tfid[i]);
530 } /*SRXAFSCB_CallBack */
533 /*------------------------------------------------------------------------
534 * EXPORTED SRXAFSCB_Probe
537 * Routine called by the server-side callback RPC interface to
538 * implement ``probing'' the Cache Manager, just making sure it's
542 * a_call : Ptr to Rx call on which this request came in.
548 * Nothing interesting.
552 *------------------------------------------------------------------------*/
555 SRXAFSCB_Probe(struct rx_call *a_call)
561 AFS_STATCNT(SRXAFSCB_Probe);
563 XSTATS_START_CMTIME(AFS_STATS_CM_RPCIDX_PROBE);
570 } /*SRXAFSCB_Probe */
573 /*------------------------------------------------------------------------
574 * EXPORTED SRXAFSCB_InitCallBackState
577 * Routine called by the server-side callback RPC interface to
578 * implement clearing all callbacks from this host.
581 * a_call : Ptr to Rx call on which this request came in.
587 * Nothing interesting.
591 *------------------------------------------------------------------------*/
594 SRXAFSCB_InitCallBackState(struct rx_call *a_call)
597 register struct vcache *tvc;
598 register struct rx_connection *tconn;
599 register struct rx_peer *peer;
606 XSTATS_START_CMTIME(AFS_STATS_CM_RPCIDX_INITCALLBACKSTATE);
607 AFS_STATCNT(SRXAFSCB_InitCallBackState);
610 * Find the address of the host making this call
612 if ((tconn = rx_ConnectionOf(a_call)) && (peer = rx_PeerOf(tconn))) {
615 afs_oddCBs++; /*Including any missed via create race */
616 afs_evenCBs++; /*Including any missed via create race */
618 ts = afs_FindServer(rx_HostOf(peer), rx_PortOf(peer), (afsUUID *) 0,
621 for (i = 0; i < VCSIZE; i++)
622 for (tvc = afs_vhashT[i]; tvc; tvc = tvc->hnext) {
623 if (tvc->callback == ts) {
624 ObtainWriteLock(&afs_xcbhash, 451);
625 afs_DequeueCallback(tvc);
626 tvc->callback = NULL;
627 tvc->states &= ~(CStatd | CUnique | CBulkFetching);
628 ReleaseWriteLock(&afs_xcbhash);
635 /* find any volumes residing on this server and flush their state */
637 register struct volume *tv;
640 for (i = 0; i < NVOLS; i++)
641 for (tv = afs_volumes[i]; tv; tv = tv->next) {
642 for (j = 0; j < MAXHOSTS; j++)
643 if (tv->serverHost[j] == ts)
644 afs_ResetVolumeInfo(tv);
647 osi_dnlc_purge(); /* may be a little bit extreme */
656 } /*SRXAFSCB_InitCallBackState */
659 /*------------------------------------------------------------------------
660 * EXPORTED SRXAFSCB_XStatsVersion
663 * Routine called by the server-side callback RPC interface to
664 * implement pulling out the xstat version number for the Cache
668 * a_versionP : Ptr to the version number variable to set.
674 * Nothing interesting.
678 *------------------------------------------------------------------------*/
681 SRXAFSCB_XStatsVersion(struct rx_call *a_call, afs_int32 * a_versionP)
688 XSTATS_START_CMTIME(AFS_STATS_CM_RPCIDX_XSTATSVERSION);
690 *a_versionP = AFSCB_XSTAT_VERSION;
697 } /*SRXAFSCB_XStatsVersion */
700 /*------------------------------------------------------------------------
701 * EXPORTED SRXAFSCB_GetXStats
704 * Routine called by the server-side callback RPC interface to
705 * implement getting the given data collection from the extended
706 * Cache Manager statistics.
709 * a_call : Ptr to Rx call on which this request came in.
710 * a_clientVersionNum : Client version number.
711 * a_opCode : Desired operation.
712 * a_serverVersionNumP : Ptr to version number to set.
713 * a_timeP : Ptr to time value (seconds) to set.
714 * a_dataArray : Ptr to variable array structure to return
721 * Nothing interesting.
725 *------------------------------------------------------------------------*/
728 SRXAFSCB_GetXStats(struct rx_call *a_call, afs_int32 a_clientVersionNum,
729 afs_int32 a_collectionNumber, afs_int32 * a_srvVersionNumP,
730 afs_int32 * a_timeP, AFSCB_CollData * a_dataP)
732 register int code; /*Return value */
733 afs_int32 *dataBuffP; /*Ptr to data to be returned */
734 afs_int32 dataBytes; /*Bytes in data buffer */
739 XSTATS_START_CMTIME(AFS_STATS_CM_RPCIDX_GETXSTATS);
742 * Record the time of day and the server version number.
744 *a_srvVersionNumP = AFSCB_XSTAT_VERSION;
745 *a_timeP = osi_Time();
748 * Stuff the appropriate data in there (assume victory)
754 * We're not keeping stats, so just return successfully with
757 a_dataP->AFSCB_CollData_len = 0;
758 a_dataP->AFSCB_CollData_val = NULL;
760 switch (a_collectionNumber) {
761 case AFSCB_XSTATSCOLL_CALL_INFO:
763 * Pass back all the call-count-related data.
765 * >>> We are forced to allocate a separate area in which to
766 * >>> put this stuff in by the RPC stub generator, since it
767 * >>> will be freed at the tail end of the server stub code.
769 dataBytes = sizeof(struct afs_CMStats);
770 dataBuffP = (afs_int32 *) afs_osi_Alloc(dataBytes);
771 memcpy((char *)dataBuffP, (char *)&afs_cmstats, dataBytes);
772 a_dataP->AFSCB_CollData_len = dataBytes >> 2;
773 a_dataP->AFSCB_CollData_val = dataBuffP;
776 case AFSCB_XSTATSCOLL_PERF_INFO:
778 * Update and then pass back all the performance-related data.
779 * Note: the only performance fields that need to be computed
780 * at this time are the number of accesses for this collection
781 * and the current server record info.
783 * >>> We are forced to allocate a separate area in which to
784 * >>> put this stuff in by the RPC stub generator, since it
785 * >>> will be freed at the tail end of the server stub code.
787 afs_stats_cmperf.numPerfCalls++;
789 dataBytes = sizeof(afs_stats_cmperf);
790 dataBuffP = (afs_int32 *) afs_osi_Alloc(dataBytes);
791 memcpy((char *)dataBuffP, (char *)&afs_stats_cmperf, dataBytes);
792 a_dataP->AFSCB_CollData_len = dataBytes >> 2;
793 a_dataP->AFSCB_CollData_val = dataBuffP;
796 case AFSCB_XSTATSCOLL_FULL_PERF_INFO:
798 * Pass back the full range of performance and statistical
799 * data available. We have to bring the normal performance
800 * data collection up to date, then copy that data into
801 * the full collection.
803 * >>> We are forced to allocate a separate area in which to
804 * >>> put this stuff in by the RPC stub generator, since it
805 * >>> will be freed at the tail end of the server stub code.
807 afs_stats_cmperf.numPerfCalls++;
809 memcpy((char *)(&(afs_stats_cmfullperf.perf)),
810 (char *)(&afs_stats_cmperf), sizeof(struct afs_stats_CMPerf));
811 afs_stats_cmfullperf.numFullPerfCalls++;
813 dataBytes = sizeof(afs_stats_cmfullperf);
814 dataBuffP = (afs_int32 *) afs_osi_Alloc(dataBytes);
815 memcpy((char *)dataBuffP, (char *)(&afs_stats_cmfullperf), dataBytes);
816 a_dataP->AFSCB_CollData_len = dataBytes >> 2;
817 a_dataP->AFSCB_CollData_val = dataBuffP;
822 * Illegal collection number.
824 a_dataP->AFSCB_CollData_len = 0;
825 a_dataP->AFSCB_CollData_val = NULL;
827 } /*Switch on collection number */
828 #endif /* AFS_NOSTATS */
836 } /*SRXAFSCB_GetXStats */
839 /*------------------------------------------------------------------------
840 * EXPORTED afs_RXCallBackServer
843 * Body of the thread supporting callback services.
852 * Nothing interesting.
856 *------------------------------------------------------------------------*/
859 afs_RXCallBackServer(void)
861 AFS_STATCNT(afs_RXCallBackServer);
866 afs_osi_Sleep(&afs_server);
870 * Donate this process to Rx.
875 } /*afs_RXCallBackServer */
878 /*------------------------------------------------------------------------
879 * EXPORTED shutdown_CB
882 * Zero out important Cache Manager data structures.
891 * Nothing interesting.
895 *------------------------------------------------------------------------*/
900 AFS_STATCNT(shutdown_CB);
902 if (afs_cold_shutdown) {
903 afs_oddCBs = afs_evenCBs = afs_allCBs = afs_allZaps = afs_oddZaps =
904 afs_evenZaps = afs_connectBacks = 0;
911 /*------------------------------------------------------------------------
912 * EXPORTED SRXAFSCB_InitCallBackState2
915 * This routine was used in the AFS 3.5 beta release, but not anymore.
916 * It has since been replaced by SRXAFSCB_InitCallBackState3.
919 * a_call : Ptr to Rx call on which this request came in.
922 * RXGEN_OPCODE (always).
925 * Nothing interesting.
929 *------------------------------------------------------------------------*/
932 SRXAFSCB_InitCallBackState2(struct rx_call *a_call,
933 struct interfaceAddr *addr)
938 /*------------------------------------------------------------------------
939 * EXPORTED SRXAFSCB_WhoAreYou
942 * Routine called by the server-side callback RPC interface to
943 * obtain a unique identifier for the client. The server uses
944 * this identifier to figure out whether or not two RX connections
945 * are from the same client, and to find out which addresses go
946 * with which clients.
949 * a_call : Ptr to Rx call on which this request came in.
950 * addr: Ptr to return the list of interfaces for this client.
956 * Nothing interesting.
960 *------------------------------------------------------------------------*/
963 SRXAFSCB_WhoAreYou(struct rx_call *a_call, struct interfaceAddr *addr)
970 AFS_STATCNT(SRXAFSCB_WhoAreYou);
972 memset(addr, 0, sizeof(*addr));
974 ObtainReadLock(&afs_xinterface);
976 /* return all network interface addresses */
977 addr->numberOfInterfaces = afs_cb_interface.numberOfInterfaces;
978 addr->uuid = afs_cb_interface.uuid;
979 for (i = 0; i < afs_cb_interface.numberOfInterfaces; i++) {
980 addr->addr_in[i] = ntohl(afs_cb_interface.addr_in[i]);
981 addr->subnetmask[i] = ntohl(afs_cb_interface.subnetmask[i]);
982 addr->mtu[i] = ntohl(afs_cb_interface.mtu[i]);
985 ReleaseReadLock(&afs_xinterface);
993 /*------------------------------------------------------------------------
994 * EXPORTED SRXAFSCB_InitCallBackState3
997 * Routine called by the server-side callback RPC interface to
998 * implement clearing all callbacks from this host.
1001 * a_call : Ptr to Rx call on which this request came in.
1007 * Nothing interesting.
1011 *------------------------------------------------------------------------*/
1014 SRXAFSCB_InitCallBackState3(struct rx_call *a_call, afsUUID * a_uuid)
1019 * TBD: Lookup the server by the UUID instead of its IP address.
1021 code = SRXAFSCB_InitCallBackState(a_call);
1027 /*------------------------------------------------------------------------
1028 * EXPORTED SRXAFSCB_ProbeUuid
1031 * Routine called by the server-side callback RPC interface to
1032 * implement ``probing'' the Cache Manager, just making sure it's
1033 * still there is still the same client it used to be.
1036 * a_call : Ptr to Rx call on which this request came in.
1037 * a_uuid : Ptr to UUID that must match the client's UUID.
1040 * 0 if a_uuid matches the UUID for this client
1041 * Non-zero otherwize
1044 * Nothing interesting.
1048 *------------------------------------------------------------------------*/
1051 SRXAFSCB_ProbeUuid(struct rx_call *a_call, afsUUID * a_uuid)
1057 AFS_STATCNT(SRXAFSCB_Probe);
1059 XSTATS_START_CMTIME(AFS_STATS_CM_RPCIDX_PROBE);
1060 if (!afs_uuid_equal(a_uuid, &afs_cb_interface.uuid))
1061 code = 1; /* failure */
1070 /*------------------------------------------------------------------------
1071 * EXPORTED SRXAFSCB_GetServerPrefs
1074 * Routine to list server preferences used by this client.
1077 * a_call : Ptr to Rx call on which this request came in.
1078 * a_index : Input server index
1079 * a_srvr_addr : Output server address in host byte order
1080 * (0xffffffff on last server)
1081 * a_srvr_rank : Output server rank
1087 * Nothing interesting.
1091 *------------------------------------------------------------------------*/
1094 SRXAFSCB_GetServerPrefs(struct rx_call *a_call, afs_int32 a_index,
1095 afs_int32 * a_srvr_addr, afs_int32 * a_srvr_rank)
1101 AFS_STATCNT(SRXAFSCB_GetServerPrefs);
1103 ObtainReadLock(&afs_xserver);
1105 /* Search the hash table for the server with this index */
1106 *a_srvr_addr = 0xffffffff;
1107 *a_srvr_rank = 0xffffffff;
1108 for (i = 0, j = 0; j < NSERVERS && i <= a_index; j++) {
1109 for (sa = afs_srvAddrs[j]; sa && i <= a_index; sa = sa->next_bkt, i++) {
1111 *a_srvr_addr = ntohl(sa->sa_ip);
1112 *a_srvr_rank = sa->sa_iprank;
1117 ReleaseReadLock(&afs_xserver);
1125 /*------------------------------------------------------------------------
1126 * EXPORTED SRXAFSCB_GetCellServDB
1129 * Routine to list cells configured for this client
1132 * a_call : Ptr to Rx call on which this request came in.
1133 * a_index : Input cell index
1134 * a_name : Output cell name ("" on last cell)
1135 * a_hosts : Output cell database servers in host byte order.
1141 * Nothing interesting.
1145 *------------------------------------------------------------------------*/
1148 SRXAFSCB_GetCellServDB(struct rx_call *a_call, afs_int32 a_index,
1149 char **a_name, serverList * a_hosts)
1153 char *t_name, *p_name = NULL;
1156 AFS_STATCNT(SRXAFSCB_GetCellServDB);
1158 tcell = afs_GetCellByIndex(a_index, READ_LOCK);
1162 a_hosts->serverList_val = 0;
1163 a_hosts->serverList_len = 0;
1165 p_name = tcell->cellName;
1166 for (j = 0; j < AFSMAXCELLHOSTS && tcell->cellHosts[j]; j++);
1168 a_hosts->serverList_val =
1169 (afs_int32 *) afs_osi_Alloc(j * sizeof(afs_int32));
1170 a_hosts->serverList_len = j;
1171 for (j = 0; j < AFSMAXCELLHOSTS && tcell->cellHosts[j]; j++)
1172 a_hosts->serverList_val[j] =
1173 ntohl(tcell->cellHosts[j]->addr->sa_ip);
1174 afs_PutCell(tcell, READ_LOCK);
1177 t_name = (char *)afs_osi_Alloc(i + 1);
1178 if (t_name == NULL) {
1179 afs_osi_Free(a_hosts->serverList_val, (j * sizeof(afs_int32)));
1186 memcpy(t_name, p_name, i);
1195 /*------------------------------------------------------------------------
1196 * EXPORTED SRXAFSCB_GetLocalCell
1199 * Routine to return name of client's local cell
1202 * a_call : Ptr to Rx call on which this request came in.
1203 * a_name : Output cell name
1209 * Nothing interesting.
1213 *------------------------------------------------------------------------*/
1216 SRXAFSCB_GetLocalCell(struct rx_call *a_call, char **a_name)
1220 char *t_name, *p_name = NULL;
1223 AFS_STATCNT(SRXAFSCB_GetLocalCell);
1225 /* Search the list for the primary cell. Cell number 1 is only
1226 * the primary cell is when no other cell is explicitly marked as
1227 * the primary cell. */
1228 tcell = afs_GetPrimaryCell(READ_LOCK);
1230 p_name = tcell->cellName;
1232 plen = strlen(p_name);
1235 t_name = (char *)afs_osi_Alloc(plen + 1);
1236 if (t_name == NULL) {
1238 afs_PutCell(tcell, READ_LOCK);
1243 t_name[plen] = '\0';
1245 memcpy(t_name, p_name, plen);
1251 afs_PutCell(tcell, READ_LOCK);
1257 * afs_MarshallCacheConfig - marshall client cache configuration
1261 * IN callerVersion - the rpc stat version of the caller.
1263 * IN config - client cache configuration.
1265 * OUT ptr - buffer where configuration is marshalled.
1272 afs_MarshallCacheConfig(afs_uint32 callerVersion, cm_initparams_v1 * config,
1275 AFS_STATCNT(afs_MarshallCacheConfig);
1277 * We currently only support version 1.
1279 *(ptr++) = config->nChunkFiles;
1280 *(ptr++) = config->nStatCaches;
1281 *(ptr++) = config->nDataCaches;
1282 *(ptr++) = config->nVolumeCaches;
1283 *(ptr++) = config->firstChunkSize;
1284 *(ptr++) = config->otherChunkSize;
1285 *(ptr++) = config->cacheSize;
1286 *(ptr++) = config->setTime;
1287 *(ptr++) = config->memCache;
1291 /*------------------------------------------------------------------------
1292 * EXPORTED SRXAFSCB_GetCacheConfig
1295 * Routine to return parameters used to initialize client cache.
1296 * Client may request any format version. Server may not return
1297 * format version greater than version requested by client.
1300 * a_call: Ptr to Rx call on which this request came in.
1301 * callerVersion: Data format version desired by the client.
1302 * serverVersion: Data format version of output data.
1303 * configCount: Number bytes allocated for output data.
1304 * config: Client cache configuration.
1310 * Nothing interesting.
1314 *------------------------------------------------------------------------*/
1317 SRXAFSCB_GetCacheConfig(struct rx_call *a_call, afs_uint32 callerVersion,
1318 afs_uint32 * serverVersion, afs_uint32 * configCount,
1319 cacheConfig * config)
1321 afs_uint32 *t_config;
1323 cm_initparams_v1 cm_config;
1326 AFS_STATCNT(SRXAFSCB_GetCacheConfig);
1329 * Currently only support version 1
1331 allocsize = sizeof(cm_initparams_v1);
1332 t_config = (afs_uint32 *) afs_osi_Alloc(allocsize);
1333 if (t_config == NULL) {
1338 cm_config.nChunkFiles = cm_initParams.cmi_nChunkFiles;
1339 cm_config.nStatCaches = cm_initParams.cmi_nStatCaches;
1340 cm_config.nDataCaches = cm_initParams.cmi_nDataCaches;
1341 cm_config.nVolumeCaches = cm_initParams.cmi_nVolumeCaches;
1342 cm_config.firstChunkSize = cm_initParams.cmi_firstChunkSize;
1343 cm_config.otherChunkSize = cm_initParams.cmi_otherChunkSize;
1344 cm_config.cacheSize = cm_initParams.cmi_cacheSize;
1345 cm_config.setTime = cm_initParams.cmi_setTime;
1346 cm_config.memCache = cm_initParams.cmi_memCache;
1348 afs_MarshallCacheConfig(callerVersion, &cm_config, t_config);
1350 *serverVersion = AFS_CLIENT_RETRIEVAL_FIRST_EDITION;
1351 *configCount = allocsize;
1352 config->cacheConfig_val = t_config;
1353 config->cacheConfig_len = allocsize / sizeof(afs_uint32);
1360 /*------------------------------------------------------------------------
1361 * EXPORTED SRXAFSCB_FetchData
1364 * Routine to do third party move from a remioserver to the original
1365 * issuer of an ArchiveData request. Presently supported only by the
1366 * "fs" command, not by the AFS client.
1369 * rxcall: Ptr to Rx call on which this request came in.
1370 * Fid: pointer to AFSFid structure.
1371 * Fd: File descriptor inside fs command.
1372 * Position: Offset in the file.
1373 * Length: Data length to transfer.
1374 * TotalLength: Pointer to total file length field
1380 * Nothing interesting.
1383 *------------------------------------------------------------------------*/
1385 SRXAFSCB_FetchData(struct rx_call *rxcall, struct AFSFid *Fid, afs_int32 Fd,
1386 afs_int64 Position, afs_int64 Length,
1387 afs_int64 * TotalLength)
1392 /*------------------------------------------------------------------------
1393 * EXPORTED SRXAFSCB_StoreData
1396 * Routine to do third party move from a remioserver to the original
1397 * issuer of a RetrieveData request. Presently supported only by the
1398 * "fs" command, not by the AFS client.
1401 * rxcall: Ptr to Rx call on which this request came in.
1402 * Fid: pointer to AFSFid structure.
1403 * Fd: File descriptor inside fs command.
1404 * Position: Offset in the file.
1405 * Length: Data length to transfer.
1406 * TotalLength: Pointer to total file length field
1412 * Nothing interesting.
1416 *------------------------------------------------------------------------*/
1418 SRXAFSCB_StoreData(struct rx_call *rxcall, struct AFSFid *Fid, afs_int32 Fd,
1419 afs_int64 Position, afs_int64 Length,
1420 afs_int64 * TotalLength)
1425 /*------------------------------------------------------------------------
1426 * EXPORTED SRXAFSCB_GetCellByNum
1429 * Routine to get information about a cell specified by its
1430 * cell number (returned by GetCE/GetCE64).
1433 * a_call : Ptr to Rx call on which this request came in.
1434 * a_cellnum : Input cell number
1435 * a_name : Output cell name (one zero byte when no such cell).
1436 * a_hosts : Output cell database servers in host byte order.
1442 * Nothing interesting.
1446 *------------------------------------------------------------------------*/
1449 SRXAFSCB_GetCellByNum(struct rx_call *a_call, afs_int32 a_cellnum,
1450 char **a_name, serverList * a_hosts)
1456 AFS_STATCNT(SRXAFSCB_GetCellByNum);
1458 a_hosts->serverList_val = 0;
1459 a_hosts->serverList_len = 0;
1461 tcell = afs_GetCellStale(a_cellnum, READ_LOCK);
1463 *a_name = afs_strdup("");
1468 ObtainReadLock(&tcell->lock);
1469 *a_name = afs_strdup(tcell->cellName);
1471 for (sn = 0; sn < AFSMAXCELLHOSTS && tcell->cellHosts[sn]; sn++);
1472 a_hosts->serverList_len = sn;
1473 a_hosts->serverList_val =
1474 (afs_int32 *) afs_osi_Alloc(sn * sizeof(afs_int32));
1476 for (i = 0; i < sn; i++)
1477 a_hosts->serverList_val[i] = ntohl(tcell->cellHosts[i]->addr->sa_ip);
1478 ReleaseReadLock(&tcell->lock);
1479 afs_PutCell(tcell, READ_LOCK);
1486 SRXAFSCB_TellMeAboutYourself(struct rx_call *a_call,
1487 struct interfaceAddr *addr,
1488 Capabilities * capabilities)
1492 afs_int32 *dataBuffP;
1493 afs_int32 dataBytes;
1497 AFS_STATCNT(SRXAFSCB_WhoAreYou);
1499 ObtainReadLock(&afs_xinterface);
1501 /* return all network interface addresses */
1502 addr->numberOfInterfaces = afs_cb_interface.numberOfInterfaces;
1503 addr->uuid = afs_cb_interface.uuid;
1504 for (i = 0; i < afs_cb_interface.numberOfInterfaces; i++) {
1505 addr->addr_in[i] = ntohl(afs_cb_interface.addr_in[i]);
1506 addr->subnetmask[i] = ntohl(afs_cb_interface.subnetmask[i]);
1507 addr->mtu[i] = ntohl(afs_cb_interface.mtu[i]);
1510 ReleaseReadLock(&afs_xinterface);
1514 dataBytes = 1 * sizeof(afs_int32);
1515 dataBuffP = (afs_int32 *) afs_osi_Alloc(dataBytes);
1516 dataBuffP[0] = CAPABILITY_ERRORTRANS;
1517 capabilities->Capabilities_len = dataBytes / sizeof(afs_int32);
1518 capabilities->Capabilities_val = dataBuffP;