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 for (i = 0; i < VCSIZE; i++)
392 for (tvc = afs_vhashT[i]; tvc; tvc = tvc->hnext) {
393 if (tvc->fid.Fid.Volume == a_fid->Volume) {
394 tvc->callback = NULL;
395 tvc->quick.stamp = 0;
397 localFid.Cell = tvc->fid.Cell;
398 tvc->h1.dchint = NULL; /* invalidate hints */
399 ObtainWriteLock(&afs_xcbhash, 449);
400 afs_DequeueCallback(tvc);
401 tvc->states &= ~(CStatd | CUnique | CBulkFetching);
403 if (tvc->fid.Fid.Vnode & 1)
407 ReleaseWriteLock(&afs_xcbhash);
408 if (tvc->fid.Fid.Vnode & 1 || (vType(tvc) == VDIR))
409 osi_dnlc_purgedp(tvc);
410 afs_Trace3(afs_iclSetp, CM_TRACE_CALLBACK,
411 ICL_TYPE_POINTER, tvc, ICL_TYPE_INT32,
412 tvc->states, ICL_TYPE_INT32,
414 } else if ((tvc->states & CMValid)
415 && (tvc->mvid->Fid.Volume == a_fid->Volume)) {
416 tvc->states &= ~CMValid;
418 localFid.Cell = tvc->mvid->Cell;
423 * XXXX Don't hold any locks here XXXX
425 tv = afs_FindVolume(&localFid, 0);
427 afs_ResetVolumeInfo(tv);
428 afs_PutVolume(tv, 0);
429 /* invalidate mtpoint? */
431 } /*Clear callbacks for whole volume */
434 * Clear callbacks just for the one file.
437 if (a_fid->Vnode & 1)
438 afs_oddCBs++; /*Could do this on volume basis, too */
440 afs_evenCBs++; /*A particular fid was specified */
441 i = VCHash(&localFid);
442 for (tvc = afs_vhashT[i]; tvc; tvc = tvc->hnext) {
443 if (tvc->fid.Fid.Vnode == a_fid->Vnode
444 && tvc->fid.Fid.Volume == a_fid->Volume
445 && tvc->fid.Fid.Unique == a_fid->Unique) {
446 tvc->callback = NULL;
447 tvc->quick.stamp = 0;
448 tvc->h1.dchint = NULL; /* invalidate hints */
449 ObtainWriteLock(&afs_xcbhash, 450);
450 afs_DequeueCallback(tvc);
451 tvc->states &= ~(CStatd | CUnique | CBulkFetching);
452 ReleaseWriteLock(&afs_xcbhash);
453 if (a_fid->Vnode & 1 || (vType(tvc) == VDIR))
454 osi_dnlc_purgedp(tvc);
455 afs_Trace3(afs_iclSetp, CM_TRACE_CALLBACK,
456 ICL_TYPE_POINTER, tvc, ICL_TYPE_INT32,
457 tvc->states, ICL_TYPE_LONG, 0);
459 lastCallBack_vnode = afid->Vnode;
460 lastCallBack_dv = tvc->mstat.DataVersion.low;
461 osi_GetuTime(&lastCallBack_time);
464 } /*Walk through hash table */
465 } /*Clear callbacks for one file */
468 /*Fid has non-zero volume ID */
470 * Always return a predictable value.
477 /*------------------------------------------------------------------------
478 * EXPORTED SRXAFSCB_CallBack
481 * Routine called by the server-side callback RPC interface to
482 * implement passing in callback information.
486 * a_call : Ptr to Rx call on which this request came in.
487 * a_fids : Ptr to array of fids involved.
488 * a_callbacks : Ptr to matching callback info for the fids.
494 * Nothing interesting.
498 *------------------------------------------------------------------------*/
501 SRXAFSCB_CallBack(struct rx_call *a_call, register struct AFSCBFids *a_fids,
502 struct AFSCBs *a_callbacks)
504 register int i; /*Loop variable */
505 struct AFSFid *tfid; /*Ptr to current fid */
506 register struct rx_connection *tconn; /*Call's connection */
512 XSTATS_START_CMTIME(AFS_STATS_CM_RPCIDX_CALLBACK);
514 AFS_STATCNT(SRXAFSCB_CallBack);
515 if (!(tconn = rx_ConnectionOf(a_call)))
517 tfid = (struct AFSFid *)a_fids->AFSCBFids_val;
520 * For now, we ignore callbacks, since the File Server only *breaks*
521 * callbacks at present.
523 for (i = 0; i < a_fids->AFSCBFids_len; i++)
524 ClearCallBack(tconn, &tfid[i]);
532 } /*SRXAFSCB_CallBack */
535 /*------------------------------------------------------------------------
536 * EXPORTED SRXAFSCB_Probe
539 * Routine called by the server-side callback RPC interface to
540 * implement ``probing'' the Cache Manager, just making sure it's
544 * a_call : Ptr to Rx call on which this request came in.
550 * Nothing interesting.
554 *------------------------------------------------------------------------*/
557 SRXAFSCB_Probe(struct rx_call *a_call)
563 AFS_STATCNT(SRXAFSCB_Probe);
565 XSTATS_START_CMTIME(AFS_STATS_CM_RPCIDX_PROBE);
572 } /*SRXAFSCB_Probe */
575 /*------------------------------------------------------------------------
576 * EXPORTED SRXAFSCB_InitCallBackState
579 * Routine called by the server-side callback RPC interface to
580 * implement clearing all callbacks from this host.
583 * a_call : Ptr to Rx call on which this request came in.
589 * Nothing interesting.
593 *------------------------------------------------------------------------*/
596 SRXAFSCB_InitCallBackState(struct rx_call *a_call)
599 register struct vcache *tvc;
600 register struct rx_connection *tconn;
601 register struct rx_peer *peer;
608 XSTATS_START_CMTIME(AFS_STATS_CM_RPCIDX_INITCALLBACKSTATE);
609 AFS_STATCNT(SRXAFSCB_InitCallBackState);
612 * Find the address of the host making this call
614 if ((tconn = rx_ConnectionOf(a_call)) && (peer = rx_PeerOf(tconn))) {
617 afs_oddCBs++; /*Including any missed via create race */
618 afs_evenCBs++; /*Including any missed via create race */
620 ts = afs_FindServer(rx_HostOf(peer), rx_PortOf(peer), (afsUUID *) 0,
623 for (i = 0; i < VCSIZE; i++)
624 for (tvc = afs_vhashT[i]; tvc; tvc = tvc->hnext) {
625 if (tvc->callback == ts) {
626 ObtainWriteLock(&afs_xcbhash, 451);
627 afs_DequeueCallback(tvc);
628 tvc->callback = NULL;
629 tvc->states &= ~(CStatd | CUnique | CBulkFetching);
630 ReleaseWriteLock(&afs_xcbhash);
637 /* find any volumes residing on this server and flush their state */
639 register struct volume *tv;
642 for (i = 0; i < NVOLS; i++)
643 for (tv = afs_volumes[i]; tv; tv = tv->next) {
644 for (j = 0; j < MAXHOSTS; j++)
645 if (tv->serverHost[j] == ts)
646 afs_ResetVolumeInfo(tv);
649 osi_dnlc_purge(); /* may be a little bit extreme */
658 } /*SRXAFSCB_InitCallBackState */
661 /*------------------------------------------------------------------------
662 * EXPORTED SRXAFSCB_XStatsVersion
665 * Routine called by the server-side callback RPC interface to
666 * implement pulling out the xstat version number for the Cache
670 * a_versionP : Ptr to the version number variable to set.
676 * Nothing interesting.
680 *------------------------------------------------------------------------*/
683 SRXAFSCB_XStatsVersion(struct rx_call *a_call, afs_int32 * a_versionP)
690 XSTATS_START_CMTIME(AFS_STATS_CM_RPCIDX_XSTATSVERSION);
692 *a_versionP = AFSCB_XSTAT_VERSION;
699 } /*SRXAFSCB_XStatsVersion */
702 /*------------------------------------------------------------------------
703 * EXPORTED SRXAFSCB_GetXStats
706 * Routine called by the server-side callback RPC interface to
707 * implement getting the given data collection from the extended
708 * Cache Manager statistics.
711 * a_call : Ptr to Rx call on which this request came in.
712 * a_clientVersionNum : Client version number.
713 * a_opCode : Desired operation.
714 * a_serverVersionNumP : Ptr to version number to set.
715 * a_timeP : Ptr to time value (seconds) to set.
716 * a_dataArray : Ptr to variable array structure to return
723 * Nothing interesting.
727 *------------------------------------------------------------------------*/
730 SRXAFSCB_GetXStats(struct rx_call *a_call, afs_int32 a_clientVersionNum,
731 afs_int32 a_collectionNumber, afs_int32 * a_srvVersionNumP,
732 afs_int32 * a_timeP, AFSCB_CollData * a_dataP)
734 register int code; /*Return value */
735 afs_int32 *dataBuffP; /*Ptr to data to be returned */
736 afs_int32 dataBytes; /*Bytes in data buffer */
741 XSTATS_START_CMTIME(AFS_STATS_CM_RPCIDX_GETXSTATS);
744 * Record the time of day and the server version number.
746 *a_srvVersionNumP = AFSCB_XSTAT_VERSION;
747 *a_timeP = osi_Time();
750 * Stuff the appropriate data in there (assume victory)
756 * We're not keeping stats, so just return successfully with
759 a_dataP->AFSCB_CollData_len = 0;
760 a_dataP->AFSCB_CollData_val = NULL;
762 switch (a_collectionNumber) {
763 case AFSCB_XSTATSCOLL_CALL_INFO:
765 * Pass back all the call-count-related data.
767 * >>> We are forced to allocate a separate area in which to
768 * >>> put this stuff in by the RPC stub generator, since it
769 * >>> will be freed at the tail end of the server stub code.
771 dataBytes = sizeof(struct afs_CMStats);
772 dataBuffP = (afs_int32 *) afs_osi_Alloc(dataBytes);
773 memcpy((char *)dataBuffP, (char *)&afs_cmstats, dataBytes);
774 a_dataP->AFSCB_CollData_len = dataBytes >> 2;
775 a_dataP->AFSCB_CollData_val = dataBuffP;
778 case AFSCB_XSTATSCOLL_PERF_INFO:
780 * Update and then pass back all the performance-related data.
781 * Note: the only performance fields that need to be computed
782 * at this time are the number of accesses for this collection
783 * and the current server record info.
785 * >>> We are forced to allocate a separate area in which to
786 * >>> put this stuff in by the RPC stub generator, since it
787 * >>> will be freed at the tail end of the server stub code.
789 afs_stats_cmperf.numPerfCalls++;
791 dataBytes = sizeof(afs_stats_cmperf);
792 dataBuffP = (afs_int32 *) afs_osi_Alloc(dataBytes);
793 memcpy((char *)dataBuffP, (char *)&afs_stats_cmperf, dataBytes);
794 a_dataP->AFSCB_CollData_len = dataBytes >> 2;
795 a_dataP->AFSCB_CollData_val = dataBuffP;
798 case AFSCB_XSTATSCOLL_FULL_PERF_INFO:
800 * Pass back the full range of performance and statistical
801 * data available. We have to bring the normal performance
802 * data collection up to date, then copy that data into
803 * the full collection.
805 * >>> We are forced to allocate a separate area in which to
806 * >>> put this stuff in by the RPC stub generator, since it
807 * >>> will be freed at the tail end of the server stub code.
809 afs_stats_cmperf.numPerfCalls++;
811 memcpy((char *)(&(afs_stats_cmfullperf.perf)),
812 (char *)(&afs_stats_cmperf), sizeof(struct afs_stats_CMPerf));
813 afs_stats_cmfullperf.numFullPerfCalls++;
815 dataBytes = sizeof(afs_stats_cmfullperf);
816 dataBuffP = (afs_int32 *) afs_osi_Alloc(dataBytes);
817 memcpy((char *)dataBuffP, (char *)(&afs_stats_cmfullperf), dataBytes);
818 a_dataP->AFSCB_CollData_len = dataBytes >> 2;
819 a_dataP->AFSCB_CollData_val = dataBuffP;
824 * Illegal collection number.
826 a_dataP->AFSCB_CollData_len = 0;
827 a_dataP->AFSCB_CollData_val = NULL;
829 } /*Switch on collection number */
830 #endif /* AFS_NOSTATS */
838 } /*SRXAFSCB_GetXStats */
841 /*------------------------------------------------------------------------
842 * EXPORTED afs_RXCallBackServer
845 * Body of the thread supporting callback services.
854 * Nothing interesting.
858 *------------------------------------------------------------------------*/
861 afs_RXCallBackServer(void)
863 AFS_STATCNT(afs_RXCallBackServer);
868 afs_osi_Sleep(&afs_server);
872 * Donate this process to Rx.
877 } /*afs_RXCallBackServer */
880 /*------------------------------------------------------------------------
881 * EXPORTED shutdown_CB
884 * Zero out important Cache Manager data structures.
893 * Nothing interesting.
897 *------------------------------------------------------------------------*/
902 AFS_STATCNT(shutdown_CB);
904 if (afs_cold_shutdown) {
905 afs_oddCBs = afs_evenCBs = afs_allCBs = afs_allZaps = afs_oddZaps =
906 afs_evenZaps = afs_connectBacks = 0;
913 /*------------------------------------------------------------------------
914 * EXPORTED SRXAFSCB_InitCallBackState2
917 * This routine was used in the AFS 3.5 beta release, but not anymore.
918 * It has since been replaced by SRXAFSCB_InitCallBackState3.
921 * a_call : Ptr to Rx call on which this request came in.
924 * RXGEN_OPCODE (always).
927 * Nothing interesting.
931 *------------------------------------------------------------------------*/
934 SRXAFSCB_InitCallBackState2(struct rx_call *a_call,
935 struct interfaceAddr *addr)
940 /*------------------------------------------------------------------------
941 * EXPORTED SRXAFSCB_WhoAreYou
944 * Routine called by the server-side callback RPC interface to
945 * obtain a unique identifier for the client. The server uses
946 * this identifier to figure out whether or not two RX connections
947 * are from the same client, and to find out which addresses go
948 * with which clients.
951 * a_call : Ptr to Rx call on which this request came in.
952 * addr: Ptr to return the list of interfaces for this client.
958 * Nothing interesting.
962 *------------------------------------------------------------------------*/
965 SRXAFSCB_WhoAreYou(struct rx_call *a_call, struct interfaceAddr *addr)
972 AFS_STATCNT(SRXAFSCB_WhoAreYou);
974 memset(addr, 0, sizeof(*addr));
976 ObtainReadLock(&afs_xinterface);
978 /* return all network interface addresses */
979 addr->numberOfInterfaces = afs_cb_interface.numberOfInterfaces;
980 addr->uuid = afs_cb_interface.uuid;
981 for (i = 0; i < afs_cb_interface.numberOfInterfaces; i++) {
982 addr->addr_in[i] = ntohl(afs_cb_interface.addr_in[i]);
983 addr->subnetmask[i] = ntohl(afs_cb_interface.subnetmask[i]);
984 addr->mtu[i] = ntohl(afs_cb_interface.mtu[i]);
987 ReleaseReadLock(&afs_xinterface);
995 /*------------------------------------------------------------------------
996 * EXPORTED SRXAFSCB_InitCallBackState3
999 * Routine called by the server-side callback RPC interface to
1000 * implement clearing all callbacks from this host.
1003 * a_call : Ptr to Rx call on which this request came in.
1009 * Nothing interesting.
1013 *------------------------------------------------------------------------*/
1016 SRXAFSCB_InitCallBackState3(struct rx_call *a_call, afsUUID * a_uuid)
1021 * TBD: Lookup the server by the UUID instead of its IP address.
1023 code = SRXAFSCB_InitCallBackState(a_call);
1029 /*------------------------------------------------------------------------
1030 * EXPORTED SRXAFSCB_ProbeUuid
1033 * Routine called by the server-side callback RPC interface to
1034 * implement ``probing'' the Cache Manager, just making sure it's
1035 * still there is still the same client it used to be.
1038 * a_call : Ptr to Rx call on which this request came in.
1039 * a_uuid : Ptr to UUID that must match the client's UUID.
1042 * 0 if a_uuid matches the UUID for this client
1043 * Non-zero otherwize
1046 * Nothing interesting.
1050 *------------------------------------------------------------------------*/
1053 SRXAFSCB_ProbeUuid(struct rx_call *a_call, afsUUID * a_uuid)
1059 AFS_STATCNT(SRXAFSCB_Probe);
1061 XSTATS_START_CMTIME(AFS_STATS_CM_RPCIDX_PROBE);
1062 if (!afs_uuid_equal(a_uuid, &afs_cb_interface.uuid))
1063 code = 1; /* failure */
1072 /*------------------------------------------------------------------------
1073 * EXPORTED SRXAFSCB_GetServerPrefs
1076 * Routine to list server preferences used by this client.
1079 * a_call : Ptr to Rx call on which this request came in.
1080 * a_index : Input server index
1081 * a_srvr_addr : Output server address in host byte order
1082 * (0xffffffff on last server)
1083 * a_srvr_rank : Output server rank
1089 * Nothing interesting.
1093 *------------------------------------------------------------------------*/
1096 SRXAFSCB_GetServerPrefs(struct rx_call *a_call, afs_int32 a_index,
1097 afs_int32 * a_srvr_addr, afs_int32 * a_srvr_rank)
1103 AFS_STATCNT(SRXAFSCB_GetServerPrefs);
1105 ObtainReadLock(&afs_xserver);
1107 /* Search the hash table for the server with this index */
1108 *a_srvr_addr = 0xffffffff;
1109 *a_srvr_rank = 0xffffffff;
1110 for (i = 0, j = 0; j < NSERVERS && i <= a_index; j++) {
1111 for (sa = afs_srvAddrs[j]; sa && i <= a_index; sa = sa->next_bkt, i++) {
1113 *a_srvr_addr = ntohl(sa->sa_ip);
1114 *a_srvr_rank = sa->sa_iprank;
1119 ReleaseReadLock(&afs_xserver);
1127 /*------------------------------------------------------------------------
1128 * EXPORTED SRXAFSCB_GetCellServDB
1131 * Routine to list cells configured for this client
1134 * a_call : Ptr to Rx call on which this request came in.
1135 * a_index : Input cell index
1136 * a_name : Output cell name ("" on last cell)
1137 * a_hosts : Output cell database servers in host byte order.
1143 * Nothing interesting.
1147 *------------------------------------------------------------------------*/
1150 SRXAFSCB_GetCellServDB(struct rx_call *a_call, afs_int32 a_index,
1151 char **a_name, serverList * a_hosts)
1155 char *t_name, *p_name = NULL;
1158 AFS_STATCNT(SRXAFSCB_GetCellServDB);
1160 tcell = afs_GetCellByIndex(a_index, READ_LOCK);
1164 a_hosts->serverList_val = 0;
1165 a_hosts->serverList_len = 0;
1167 p_name = tcell->cellName;
1168 for (j = 0; j < AFSMAXCELLHOSTS && tcell->cellHosts[j]; j++);
1170 a_hosts->serverList_val =
1171 (afs_int32 *) afs_osi_Alloc(j * sizeof(afs_int32));
1172 a_hosts->serverList_len = j;
1173 for (j = 0; j < AFSMAXCELLHOSTS && tcell->cellHosts[j]; j++)
1174 a_hosts->serverList_val[j] =
1175 ntohl(tcell->cellHosts[j]->addr->sa_ip);
1176 afs_PutCell(tcell, READ_LOCK);
1179 t_name = (char *)afs_osi_Alloc(i + 1);
1180 if (t_name == NULL) {
1181 afs_osi_Free(a_hosts->serverList_val, (j * sizeof(afs_int32)));
1188 memcpy(t_name, p_name, i);
1197 /*------------------------------------------------------------------------
1198 * EXPORTED SRXAFSCB_GetLocalCell
1201 * Routine to return name of client's local cell
1204 * a_call : Ptr to Rx call on which this request came in.
1205 * a_name : Output cell name
1211 * Nothing interesting.
1215 *------------------------------------------------------------------------*/
1218 SRXAFSCB_GetLocalCell(struct rx_call *a_call, char **a_name)
1222 char *t_name, *p_name = NULL;
1225 AFS_STATCNT(SRXAFSCB_GetLocalCell);
1227 /* Search the list for the primary cell. Cell number 1 is only
1228 * the primary cell is when no other cell is explicitly marked as
1229 * the primary cell. */
1230 tcell = afs_GetPrimaryCell(READ_LOCK);
1232 p_name = tcell->cellName;
1234 plen = strlen(p_name);
1237 t_name = (char *)afs_osi_Alloc(plen + 1);
1238 if (t_name == NULL) {
1240 afs_PutCell(tcell, READ_LOCK);
1245 t_name[plen] = '\0';
1247 memcpy(t_name, p_name, plen);
1253 afs_PutCell(tcell, READ_LOCK);
1259 * afs_MarshallCacheConfig - marshall client cache configuration
1263 * IN callerVersion - the rpc stat version of the caller.
1265 * IN config - client cache configuration.
1267 * OUT ptr - buffer where configuration is marshalled.
1274 afs_MarshallCacheConfig(afs_uint32 callerVersion, cm_initparams_v1 * config,
1277 AFS_STATCNT(afs_MarshallCacheConfig);
1279 * We currently only support version 1.
1281 *(ptr++) = config->nChunkFiles;
1282 *(ptr++) = config->nStatCaches;
1283 *(ptr++) = config->nDataCaches;
1284 *(ptr++) = config->nVolumeCaches;
1285 *(ptr++) = config->firstChunkSize;
1286 *(ptr++) = config->otherChunkSize;
1287 *(ptr++) = config->cacheSize;
1288 *(ptr++) = config->setTime;
1289 *(ptr++) = config->memCache;
1293 /*------------------------------------------------------------------------
1294 * EXPORTED SRXAFSCB_GetCacheConfig
1297 * Routine to return parameters used to initialize client cache.
1298 * Client may request any format version. Server may not return
1299 * format version greater than version requested by client.
1302 * a_call: Ptr to Rx call on which this request came in.
1303 * callerVersion: Data format version desired by the client.
1304 * serverVersion: Data format version of output data.
1305 * configCount: Number bytes allocated for output data.
1306 * config: Client cache configuration.
1312 * Nothing interesting.
1316 *------------------------------------------------------------------------*/
1319 SRXAFSCB_GetCacheConfig(struct rx_call *a_call, afs_uint32 callerVersion,
1320 afs_uint32 * serverVersion, afs_uint32 * configCount,
1321 cacheConfig * config)
1323 afs_uint32 *t_config;
1325 cm_initparams_v1 cm_config;
1328 AFS_STATCNT(SRXAFSCB_GetCacheConfig);
1331 * Currently only support version 1
1333 allocsize = sizeof(cm_initparams_v1);
1334 t_config = (afs_uint32 *) afs_osi_Alloc(allocsize);
1335 if (t_config == NULL) {
1340 cm_config.nChunkFiles = cm_initParams.cmi_nChunkFiles;
1341 cm_config.nStatCaches = cm_initParams.cmi_nStatCaches;
1342 cm_config.nDataCaches = cm_initParams.cmi_nDataCaches;
1343 cm_config.nVolumeCaches = cm_initParams.cmi_nVolumeCaches;
1344 cm_config.firstChunkSize = cm_initParams.cmi_firstChunkSize;
1345 cm_config.otherChunkSize = cm_initParams.cmi_otherChunkSize;
1346 cm_config.cacheSize = cm_initParams.cmi_cacheSize;
1347 cm_config.setTime = cm_initParams.cmi_setTime;
1348 cm_config.memCache = cm_initParams.cmi_memCache;
1350 afs_MarshallCacheConfig(callerVersion, &cm_config, t_config);
1352 *serverVersion = AFS_CLIENT_RETRIEVAL_FIRST_EDITION;
1353 *configCount = allocsize;
1354 config->cacheConfig_val = t_config;
1355 config->cacheConfig_len = allocsize / sizeof(afs_uint32);
1362 /*------------------------------------------------------------------------
1363 * EXPORTED SRXAFSCB_FetchData
1366 * Routine to do third party move from a remioserver to the original
1367 * issuer of an ArchiveData request. Presently supported only by the
1368 * "fs" command, not by the AFS client.
1371 * rxcall: Ptr to Rx call on which this request came in.
1372 * Fid: pointer to AFSFid structure.
1373 * Fd: File descriptor inside fs command.
1374 * Position: Offset in the file.
1375 * Length: Data length to transfer.
1376 * TotalLength: Pointer to total file length field
1382 * Nothing interesting.
1385 *------------------------------------------------------------------------*/
1387 SRXAFSCB_FetchData(struct rx_call *rxcall, struct AFSFid *Fid, afs_int32 Fd,
1388 afs_int64 Position, afs_int64 Length,
1389 afs_int64 * TotalLength)
1394 /*------------------------------------------------------------------------
1395 * EXPORTED SRXAFSCB_StoreData
1398 * Routine to do third party move from a remioserver to the original
1399 * issuer of a RetrieveData request. Presently supported only by the
1400 * "fs" command, not by the AFS client.
1403 * rxcall: Ptr to Rx call on which this request came in.
1404 * Fid: pointer to AFSFid structure.
1405 * Fd: File descriptor inside fs command.
1406 * Position: Offset in the file.
1407 * Length: Data length to transfer.
1408 * TotalLength: Pointer to total file length field
1414 * Nothing interesting.
1418 *------------------------------------------------------------------------*/
1420 SRXAFSCB_StoreData(struct rx_call *rxcall, struct AFSFid *Fid, afs_int32 Fd,
1421 afs_int64 Position, afs_int64 Length,
1422 afs_int64 * TotalLength)
1427 /*------------------------------------------------------------------------
1428 * EXPORTED SRXAFSCB_GetCellByNum
1431 * Routine to get information about a cell specified by its
1432 * cell number (returned by GetCE/GetCE64).
1435 * a_call : Ptr to Rx call on which this request came in.
1436 * a_cellnum : Input cell number
1437 * a_name : Output cell name (one zero byte when no such cell).
1438 * a_hosts : Output cell database servers in host byte order.
1444 * Nothing interesting.
1448 *------------------------------------------------------------------------*/
1451 SRXAFSCB_GetCellByNum(struct rx_call *a_call, afs_int32 a_cellnum,
1452 char **a_name, serverList * a_hosts)
1458 AFS_STATCNT(SRXAFSCB_GetCellByNum);
1460 a_hosts->serverList_val = 0;
1461 a_hosts->serverList_len = 0;
1463 tcell = afs_GetCellStale(a_cellnum, READ_LOCK);
1465 *a_name = afs_strdup("");
1470 ObtainReadLock(&tcell->lock);
1471 *a_name = afs_strdup(tcell->cellName);
1473 for (sn = 0; sn < AFSMAXCELLHOSTS && tcell->cellHosts[sn]; sn++);
1474 a_hosts->serverList_len = sn;
1475 a_hosts->serverList_val =
1476 (afs_int32 *) afs_osi_Alloc(sn * sizeof(afs_int32));
1478 for (i = 0; i < sn; i++)
1479 a_hosts->serverList_val[i] = ntohl(tcell->cellHosts[i]->addr->sa_ip);
1480 ReleaseReadLock(&tcell->lock);
1481 afs_PutCell(tcell, READ_LOCK);
1488 SRXAFSCB_TellMeAboutYourself(struct rx_call *a_call,
1489 struct interfaceAddr *addr,
1490 Capabilities * capabilities)
1494 afs_int32 *dataBuffP;
1495 afs_int32 dataBytes;
1499 AFS_STATCNT(SRXAFSCB_WhoAreYou);
1501 ObtainReadLock(&afs_xinterface);
1503 /* return all network interface addresses */
1504 addr->numberOfInterfaces = afs_cb_interface.numberOfInterfaces;
1505 addr->uuid = afs_cb_interface.uuid;
1506 for (i = 0; i < afs_cb_interface.numberOfInterfaces; i++) {
1507 addr->addr_in[i] = ntohl(afs_cb_interface.addr_in[i]);
1508 addr->subnetmask[i] = ntohl(afs_cb_interface.subnetmask[i]);
1509 addr->mtu[i] = ntohl(afs_cb_interface.mtu[i]);
1512 ReleaseReadLock(&afs_xinterface);
1516 dataBytes = 1 * sizeof(afs_int32);
1517 dataBuffP = (afs_int32 *) afs_osi_Alloc(dataBytes);
1518 dataBuffP[0] = CAPABILITY_ERRORTRANS;
1519 capabilities->Capabilities_len = dataBytes / sizeof(afs_int32);
1520 capabilities->Capabilities_val = dataBuffP;