7df8f041d8b23624b966884cd5b1de0ea3d3742d
[openafs.git] / src / afs / VNOPS / afs_vnop_lookup.c
1 /*
2  * Copyright 2000, International Business Machines Corporation and others.
3  * All Rights Reserved.
4  * 
5  * This software has been released under the terms of the IBM Public
6  * License.  For details, see the LICENSE file in the top-level source
7  * directory or online at http://www.openafs.org/dl/license10.html
8  */
9
10 /*
11  * Implements:
12  * afs_lookup
13  * EvalMountPoint
14  * afs_DoBulkStat
15  *
16  * Locals:
17  * afs_strcat
18  * AFS_EQ_ATSYS (macro)
19  * afs_index
20  */
21
22 #include "../afs/param.h"       /* Should be always first */
23 #include "../afs/sysincludes.h" /* Standard vendor system headers */
24 #include "../afs/afsincludes.h" /* Afs-based standard headers */
25 #include "../afs/afs_stats.h" /* statistics */
26 #include "../afs/afs_cbqueue.h"
27 #include "../afs/nfsclient.h"
28 #include "../afs/exporter.h"
29 #include "../afs/afs_osidnlc.h"
30
31
32 /**
33  * A few definitions. This is until we have a proper header file        
34  * which has prototypes for all functions
35  */
36
37 extern struct DirEntry * afs_dir_GetBlob();
38
39 extern afs_rwlock_t afs_xvcache;
40 extern afs_rwlock_t afs_xcbhash;
41 extern struct afs_exporter *afs_nfsexporter;
42 extern char *afs_sysname;
43 extern struct afs_q VLRU;                       /*vcache LRU*/
44 #ifdef AFS_LINUX22_ENV
45 extern struct inode_operations afs_symlink_iops, afs_dir_iops;
46 #endif
47
48
49 afs_int32 afs_bulkStatsDone;
50 static int bulkStatCounter = 0; /* counter for bulk stat seq. numbers */
51
52
53 /* this would be faster if it did comparison as int32word, but would be 
54  * dependant on byte-order and alignment, and I haven't figured out
55  * what "@sys" is in binary... */
56 #define AFS_EQ_ATSYS(name) (((name)[0]=='@')&&((name)[1]=='s')&&((name)[2]=='y')&&((name)[3]=='s')&&(!(name)[4]))
57
58 char *
59 afs_strcat(s1, s2)
60         register char *s1, *s2;
61 {
62         register char *os1;
63
64         AFS_STATCNT(strcat);
65         os1 = s1;
66         while (*s1++)
67                 ;
68         --s1;
69         while (*s1++ = *s2++)
70                 ;
71         return (os1);
72 }
73
74
75 char *afs_index(a, c)
76     register char *a, c; {
77     register char tc;
78     AFS_STATCNT(afs_index);
79     while (tc = *a) {
80         if (tc == c) return a;
81         else a++;
82     }
83     return (char *) 0;
84 }
85
86 /* call under write lock, evaluate mvid field from a mt pt.
87  * avc is the vnode of the mount point object.
88  * advc is the vnode of the containing directory
89  * avolpp is where we return a pointer to the volume named by the mount pt, if success
90  * areq is the identity of the caller.
91  *
92  * NOTE: this function returns a held volume structure in *volpp if it returns 0!
93  */
94 EvalMountPoint(avc, advc, avolpp, areq)
95     register struct vcache *avc;
96     struct volume **avolpp;
97     struct vcache *advc;            /* the containing dir */
98     register struct vrequest *areq;
99 {
100     afs_int32  code;
101     struct volume *tvp = 0;
102     struct VenusFid tfid;
103     struct cell *tcell;
104     char   *cpos, *volnamep;
105     char   type, buf[128];
106     afs_int32  prefetchRO;          /* 1=>No  2=>Yes */
107     afs_int32  mtptCell, assocCell, hac=0;
108     afs_int32  samecell, roname, len;
109
110     AFS_STATCNT(EvalMountPoint);
111 #ifdef notdef
112     if (avc->mvid && (avc->states & CMValid)) return 0; /* done while racing */
113 #endif
114     *avolpp = (struct volume *)0;
115     code = afs_HandleLink(avc, areq);
116     if (code) return code;
117
118     /* Determine which cell and volume the mointpoint goes to */
119     type = avc->linkData[0];                   /* '#'=>Regular '%'=>RW */
120     cpos = afs_index(&avc->linkData[1], ':');  /* if cell name present */
121     if (cpos) {
122        volnamep = cpos+1;
123        *cpos = 0;
124        tcell = afs_GetCellByName(&avc->linkData[1], READ_LOCK);
125        *cpos =  ':';
126     } else {
127        volnamep = &avc->linkData[1];
128        tcell = afs_GetCell(avc->fid.Cell, READ_LOCK);
129     }
130     if (!tcell) return ENOENT;
131
132     mtptCell = tcell->cell;               /* The cell for the mountpoint */
133     if (tcell->lcellp) {
134        hac = 1;                           /* has associated cell */
135        assocCell = tcell->lcellp->cell;   /* The associated cell */
136     }
137     afs_PutCell(tcell, READ_LOCK);          
138
139     /* Is volume name a "<n>.backup" or "<n>.readonly" name */
140     len = strlen(volnamep);
141     roname = ((len > 9) && (strcmp(&volnamep[len - 9],".readonly") == 0)) ||
142              ((len > 7) && (strcmp(&volnamep[len - 7],".backup")   == 0));
143
144     /* When we cross mountpoint, do we stay in the same cell */
145     samecell = (avc->fid.Cell == mtptCell) || (hac && (avc->fid.Cell == assocCell));
146
147     /* Decide whether to prefetch the RO. Also means we want the RO.
148      * If this is a regular mountpoint with a RW volume name and
149      * we cross a cell boundary -or- start from a RO volume, then we will
150      * want to prefetch the RO volume when we get the RW below.
151      */
152     if ( (type == '#') && !roname && (!samecell || (avc->states & CRO)) ) {
153        prefetchRO = 2; /* Yes, prefetch the RO */
154     } else {
155        prefetchRO = 1; /* No prefetch of the RO */
156     }
157
158     /* Get the volume struct. Unless this volume name has ".readonly" or
159      * ".backup" in it, this will get the volume struct for the RW volume.
160      * The RO volume will be prefetched if requested (but not returned).
161      */
162     tvp = afs_GetVolumeByName(volnamep, mtptCell, prefetchRO, areq, WRITE_LOCK);
163
164     /* If no volume was found in this cell, try the associated linked cell */
165     if (!tvp && hac && areq->volumeError) {
166        tvp = afs_GetVolumeByName(volnamep, assocCell, prefetchRO, areq, WRITE_LOCK);
167     }
168
169     /* Still not found. If we are looking for the RO, then perhaps the RW 
170      * doesn't exist? Try adding ".readonly" to volname and look for that.
171      * Don't know why we do this. Would have still found it in above call - jpm.
172      */
173     if (!tvp && (prefetchRO == 2)) {
174        strcpy(buf, volnamep);
175        afs_strcat(buf, ".readonly");
176
177        tvp = afs_GetVolumeByName(buf, mtptCell, 1, areq, WRITE_LOCK);
178
179        /* Try the associated linked cell if failed */
180        if (!tvp && hac && areq->volumeError) {
181           tvp = afs_GetVolumeByName(buf, assocCell, 1, areq, WRITE_LOCK);
182        }
183     }
184   
185     if (!tvp) return ENODEV;       /* Couldn't find the volume */
186
187     /* Don't cross mountpoint from a BK to a BK volume */
188     if ((avc->states & CBackup) && (tvp->states & VBackup)) {
189         afs_PutVolume(tvp, WRITE_LOCK);
190         return ELOOP;
191     }
192
193     /* If we want (prefetched) the RO and it exists, then drop the
194      * RW volume and get the RO. Othewise, go with the RW.
195      */
196     if ((prefetchRO == 2) && tvp->roVol) {
197        tfid.Fid.Volume = tvp->roVol;                 /* remember RO volume */
198        tfid.Cell       = tvp->cell;
199        afs_PutVolume(tvp, WRITE_LOCK);               /* release old volume */
200        tvp = afs_GetVolume(&tfid, areq, WRITE_LOCK); /* get the new one */
201        if (!tvp) return ENODEV;                      /* oops, can't do it */
202     }
203
204     if (avc->mvid == 0)
205         avc->mvid = (struct VenusFid *) osi_AllocSmallSpace(sizeof(struct VenusFid));
206     avc->mvid->Cell = tvp->cell;
207     avc->mvid->Fid.Volume = tvp->volume;
208     avc->mvid->Fid.Vnode = 1;
209     avc->mvid->Fid.Unique = 1;
210     avc->states |= CMValid;
211
212     /* Used to: if the mount point is stored within a backup volume,
213      * then we should only update the parent pointer information if
214      * there's none already set, so as to avoid updating a volume's ..
215      * info with something in an OldFiles directory.
216      *
217      * Next two lines used to be under this if:
218      *
219      * if (!(avc->states & CBackup) || tvp->dotdot.Fid.Volume == 0)
220      *
221      * Now: update mount point back pointer on every call, so that we handle
222      * multiple mount points better.  This way, when du tries to go back
223      * via chddir(".."), it will end up exactly where it started, yet
224      * cd'ing via a new path to a volume will reset the ".." pointer
225      * to the new path.
226      */
227     tvp->mtpoint = avc->fid;    /* setup back pointer to mtpoint */
228     tvp->dotdot  = advc->fid;
229
230     *avolpp = tvp;
231     return 0;
232 }
233     
234 afs_ENameOK(aname)
235     register char *aname; {
236     register char tc;
237     register int tlen;
238
239     AFS_STATCNT(ENameOK);
240     tlen = strlen(aname);
241     if (tlen >= 4 && strcmp(aname+tlen-4, "@sys") == 0) return 0;
242     return 1;
243 }
244
245 Check_AtSys(avc, aname, outb, areq)
246     register struct vcache *avc;
247     char *aname, **outb;
248     struct vrequest *areq;
249 {
250     register char *tname;
251     register int error = 0, offset = -1;
252
253     for (tname=aname; *tname; tname++) /*Move to the end of the string*/;
254
255     /*
256      * If the current string is 4 chars long or more, check to see if the
257      * tail end is "@sys".
258      */
259     if ((tname >= aname + 4) && (AFS_EQ_ATSYS(tname-4)))
260         offset = (tname - 4) - aname;
261     if (offset < 0) {
262         tname = aname;
263     }  else {
264         tname = (char *) osi_AllocLargeSpace(AFS_LRALLOCSIZ);
265         if (offset)
266             strncpy(tname, aname, offset);
267         if (!afs_nfsexporter) 
268             strcpy(tname+offset, (afs_sysname ? afs_sysname : SYS_NAME ));
269         else {
270             register struct unixuser *au;
271             register afs_int32 error;
272             au = afs_GetUser(areq->uid, avc->fid.Cell, 0); afs_PutUser(au, 0);  
273             if (au->exporter) {
274                 error = EXP_SYSNAME(au->exporter, (char *)0, tname+offset);
275                 if (error) 
276                     strcpy(tname+offset, "@sys");
277             } else {
278                 strcpy(tname+offset, (afs_sysname ? afs_sysname : SYS_NAME ));
279             }
280         }
281         error = 1;
282     }
283     *outb = tname;
284     return error;
285 }
286
287
288 char *afs_getsysname(areq, adp)
289     register struct vrequest *areq;
290     register struct vcache *adp; {
291     static char sysname[MAXSYSNAME];
292     register struct unixuser *au;
293     register afs_int32 error;
294
295     AFS_STATCNT(getsysname);
296     /* this whole interface is wrong, it should take a buffer ptr and copy
297      * the data out.
298      */
299     au = afs_GetUser(areq->uid, adp->fid.Cell, 0);
300     afs_PutUser(au, 0); 
301     if (au->exporter) {
302       error = EXP_SYSNAME(au->exporter, (char *)0, sysname);
303       if (error) return "@sys";
304       else return sysname;
305     } else {
306       return (afs_sysname == 0? SYS_NAME : afs_sysname);
307     }
308 }
309
310 void afs_HandleAtName(aname, aresult, areq, adp)
311     register char *aname;
312     register char *aresult;
313     register struct vrequest *areq;
314     register struct vcache *adp; {
315     register int tlen;
316     AFS_STATCNT(HandleAtName);
317     tlen = strlen(aname);
318     if (tlen >= 4 && strcmp(aname+tlen-4, "@sys")==0) {
319         strncpy(aresult, aname, tlen-4);
320         strcpy(aresult+tlen-4, afs_getsysname(areq, adp));
321     }
322     else strcpy(aresult, aname);
323     }
324
325 #if (defined(AFS_SGI62_ENV) || defined(AFS_SUN57_64BIT_ENV))
326 extern int BlobScan(ino64_t *afile, afs_int32 ablob);
327 #else
328 #if defined AFS_LINUX_64BIT_KERNEL
329 extern int BlobScan(long *afile, afs_int32 ablob);
330 #else
331 extern int BlobScan(afs_int32 *afile, afs_int32 ablob);
332 #endif
333 #endif
334
335
336 /* called with an unlocked directory and directory cookie.  Areqp
337  * describes who is making the call.
338  * Scans the next N (about 30, typically) directory entries, and does
339  * a bulk stat call to stat them all.
340  *
341  * Must be very careful when merging in RPC responses, since we dont
342  * want to overwrite newer info that was added by a file system mutating
343  * call that ran concurrently with our bulk stat call.
344  *
345  * We do that, as described below, by not merging in our info (always
346  * safe to skip the merge) if the status info is valid in the vcache entry.
347  *
348  * If adapt ever implements the bulk stat RPC, then this code will need to
349  * ensure that vcaches created for failed RPC's to older servers have the
350  * CForeign bit set.
351  */
352 struct vcache * BStvc = (struct vcache *) 0;
353 void afs_DoBulkStat(adp, dirCookie, areqp)
354   struct vcache *adp;
355   long dirCookie;
356   struct vrequest *areqp;
357 {
358     int nentries;               /* # of entries to prefetch */
359     int nskip;                  /* # of slots in the LRU queue to skip */
360     struct vcache *lruvcp;      /* vcache ptr of our goal pos in LRU queue */
361     struct dcache *dcp;         /* chunk containing the dir block */
362     char *statMemp;             /* status memory block */
363     char *cbfMemp;              /* callback and fid memory block */
364     long temp;                  /* temp for holding chunk length, &c. */
365     struct AFSFid *fidsp;       /* file IDs were collecting */
366     struct AFSCallBack *cbsp;   /* call back pointers */
367     struct AFSCallBack *tcbp;   /* temp callback ptr */
368     struct AFSFetchStatus *statsp;      /* file status info */
369     struct AFSVolSync volSync;  /* vol sync return info */
370     struct vcache *tvcp;        /* temp vcp */
371     struct afs_q *tq;           /* temp queue variable */
372     AFSCBFids fidParm;          /* file ID parm for bulk stat */
373     AFSBulkStats statParm;      /* stat info parm for bulk stat */
374     int fidIndex;               /* which file were stating */
375     struct conn *tcp;           /* conn for call */
376     AFSCBs cbParm;              /* callback parm for bulk stat */
377     struct server *hostp = 0;   /* host we got callback from */
378     long origEvenCBs;           /* original # of callbacks for even-fid files */
379     long origOddCBs;            /* original # of callbacks for odd-fid files */
380     long origEvenZaps;          /* original # of recycles for even-fid files */
381     long origOddZaps;           /* original # of recycles for odd-fid files */
382     long startTime;             /* time we started the call,
383                                  * for callback expiration base
384                                  */
385     int statSeqNo;              /* Valued of file size to detect races */
386     int code;                   /* error code */
387     long newIndex;              /* new index in the dir */
388     struct DirEntry *dirEntryp; /* dir entry we are examining */
389     int i;
390     struct VenusFid afid;       /* file ID we are using now */
391     struct VenusFid tfid;       /* another temp. file ID */
392     afs_int32 retry;                  /* handle low-level SGI MP race conditions */
393     long volStates;             /* flags from vol structure */
394     struct volume *volp=0;      /* volume ptr */
395     struct VenusFid dotdot;
396     int flagIndex;              /* First file with bulk fetch flag set */
397     XSTATS_DECLS
398
399     /* first compute some basic parameters.  We dont want to prefetch more
400      * than a fraction of the cache in any given call, and we want to preserve
401      * a portion of the LRU queue in any event, so as to avoid thrashing
402      * the entire stat cache (we will at least leave some of it alone).
403      * presently dont stat more than 1/8 the cache in any one call.      */
404     nentries = afs_cacheStats / 8;
405
406     /* dont bother prefetching more than one calls worth of info */
407     if (nentries > AFSCBMAX) nentries = AFSCBMAX;
408
409     /* heuristic to make sure that things fit in 4K.  This means that
410      * we shouldnt make it any bigger than 47 entries.  I am typically
411      * going to keep it a little lower, since we don't want to load
412      * too much of the stat cache.
413      */
414     if (nentries > 30) nentries = 30;
415
416     /* now, to reduce the stack size, well allocate two 4K blocks,
417      * one for fids and callbacks, and one for stat info.  Well set
418      * up our pointers to the memory from there, too.
419      */
420     statMemp = osi_AllocLargeSpace(nentries * sizeof(AFSFetchStatus));
421     statsp = (struct AFSFetchStatus *) statMemp;
422     cbfMemp = osi_AllocLargeSpace(nentries *
423         (sizeof(AFSCallBack) + sizeof(AFSFid)));
424     fidsp = (AFSFid *) cbfMemp;
425     cbsp = (AFSCallBack *) (cbfMemp + nentries * sizeof(AFSFid));
426
427     /* next, we must iterate over the directory, starting from the specified
428      * cookie offset (dirCookie), and counting out nentries file entries.
429      * We skip files that already have stat cache entries, since we
430      * dont want to bulk stat files that are already in the cache.
431      */
432 tagain:
433     code = afs_VerifyVCache(adp, areqp);
434     if (code) goto done;
435
436     dcp = afs_GetDCache(adp, 0, areqp, &temp, &temp, 1);
437     if (!dcp) {
438         code = ENOENT;
439         goto done;
440     }
441
442     /* lock the directory cache entry */
443     ObtainReadLock(&adp->lock);
444
445     /*
446      * Make sure that the data in the cache is current. There are two
447      * cases we need to worry about:
448      * 1. The cache data is being fetched by another process.
449      * 2. The cache data is no longer valid
450      */
451     while ((adp->states & CStatd)
452            && (dcp->flags & DFFetching)
453            && hsame(adp->m.DataVersion, dcp->f.versionNo)) {
454         dcp->flags |= DFWaiting;
455         ReleaseReadLock(&adp->lock);
456         afs_osi_Sleep(&dcp->validPos);
457         ObtainReadLock(&adp->lock);
458     }
459     if (!(adp->states & CStatd)
460         || !hsame(adp->m.DataVersion, dcp->f.versionNo)) {
461         ReleaseReadLock(&adp->lock);
462         afs_PutDCache(dcp);
463         goto tagain;
464     }
465
466     /* Generate a sequence number so we can tell whether we should
467      * store the attributes when processing the response. This number is
468      * stored in the file size when we set the CBulkFetching bit. If the
469      * CBulkFetching is still set and this value hasn't changed, then
470      * we know we were the last to set CBulkFetching bit for this file,
471      * and it is safe to set the status information for this file.
472      */
473     statSeqNo = bulkStatCounter++;
474
475     /* now we have dir data in the cache, so scan the dir page */
476     fidIndex = 0;
477     flagIndex = 0;
478     while (1) { /* Should probably have some constant bound */
479         /* look for first safe entry to examine in the directory.  BlobScan
480          * looks for a the 1st allocated dir after the dirCookie slot.
481          */
482         newIndex = BlobScan(&dcp->f.inode, (dirCookie>>5));
483         if (newIndex == 0) break;
484
485         /* remember the updated directory cookie */
486         dirCookie = newIndex << 5;
487
488         /* get a ptr to the dir entry */
489         dirEntryp =(struct DirEntry *)afs_dir_GetBlob(&dcp->f.inode, newIndex);
490         if (!dirEntryp) break;
491
492         /* dont copy more than we have room for */
493         if (fidIndex >= nentries) {
494           DRelease((char *) dirEntryp, 0);
495           break;
496         }
497
498         /* now, if the dir entry looks good, copy it out to our list.  Vnode
499          * 0 means deleted, although it should also be free were it deleted.
500          */
501         if (dirEntryp->fid.vnode != 0) {
502             /* dont copy entries we have in our cache.  This check will
503              * also make us skip "." and probably "..", unless it has
504              * disappeared from the cache since we did our namei call.
505              */
506             tfid.Cell = adp->fid.Cell;
507             tfid.Fid.Volume = adp->fid.Fid.Volume;
508             tfid.Fid.Vnode = ntohl(dirEntryp->fid.vnode);
509             tfid.Fid.Unique = ntohl(dirEntryp->fid.vunique);
510             do {
511               retry = 0;
512               ObtainWriteLock(&afs_xvcache, 130);
513               tvcp = afs_FindVCache(&tfid, 0, 0, &retry, 0 /* no stats | LRU */);
514               if (tvcp && retry) {
515                 ReleaseWriteLock(&afs_xvcache);
516                 afs_PutVCache(tvcp);
517               }
518             } while (tvcp && retry);
519             if (!tvcp) {          /* otherwise, create manually */
520               tvcp = afs_NewVCache(&tfid, hostp, 0, 0);
521               ObtainWriteLock(&tvcp->lock, 505);
522               ReleaseWriteLock(&afs_xvcache);
523               afs_RemoveVCB(&tfid);
524               ReleaseWriteLock(&tvcp->lock);
525             } else {
526               ReleaseWriteLock(&afs_xvcache);
527             }
528             if (!tvcp)
529               goto done; /* can't happen at present, more's the pity */
530
531             /* WARNING: afs_DoBulkStat uses the Length field to store a
532              * sequence number for each bulk status request. Under no
533              * circumstances should afs_DoBulkStat store a sequence number
534              * if the new length will be ignored when afs_ProcessFS is
535              * called with new stats. */
536 #ifdef AFS_SGI_ENV
537             if (!(tvcp->states & (CStatd|CBulkFetching))
538                 && (tvcp->execsOrWriters <= 0)
539                 && !afs_DirtyPages(tvcp)
540                 && !AFS_VN_MAPPED((vnode_t*)tvcp))
541 #else
542             if (!(tvcp->states & (CStatd|CBulkFetching))
543                 && (tvcp->execsOrWriters <= 0) 
544                 && !afs_DirtyPages(tvcp))
545 #endif
546
547             {
548                 /* this entry doesnt exist in the cache, and is not
549                  * already being fetched by someone else, so add it to the
550                  * list of file IDs to obtain.
551                  *
552                  * We detect a callback breaking race condition by checking the
553                  * CBulkFetching state bit and the value in the file size.
554                  * It is safe to set the status only if the CBulkFetching
555                  * flag is still set and the value in the file size does
556                  * not change.
557                  *
558                  * Don't fetch status for dirty files. We need to
559                  * preserve the value of the file size. We could
560                  * flush the pages, but it wouldn't be worthwhile.
561                  */
562                 bcopy((char *) &tfid.Fid, (char *)(fidsp+fidIndex),
563                       sizeof(*fidsp));
564                 tvcp->states |= CBulkFetching;
565                 tvcp->m.Length = statSeqNo;
566                 fidIndex++;
567             }
568             afs_PutVCache(tvcp);
569         }       /* if dir vnode has non-zero entry */
570
571         /* move to the next dir entry by adding in the # of entries
572          * used by this dir entry.
573          */
574         temp = afs_dir_NameBlobs(dirEntryp->name) << 5;
575         DRelease((char *) dirEntryp, 0);
576         if (temp <= 0) break;
577         dirCookie += temp;
578     }   /* while loop over all dir entries */
579
580     /* now release the dir lock and prepare to make the bulk RPC */
581     ReleaseReadLock(&adp->lock);
582
583     /* release the chunk */
584     afs_PutDCache(dcp);
585
586     /* dont make a null call */
587     if (fidIndex == 0) goto done;
588
589     do {
590         /* setup the RPC parm structures */
591         fidParm.AFSCBFids_len = fidIndex;
592         fidParm.AFSCBFids_val = fidsp;
593         statParm.AFSBulkStats_len = fidIndex;
594         statParm.AFSBulkStats_val = statsp;
595         cbParm.AFSCBs_len = fidIndex;
596         cbParm.AFSCBs_val = cbsp;
597
598         /* start the timer; callback expirations are relative to this */
599         startTime = osi_Time();
600
601         tcp = afs_Conn(&adp->fid, areqp, SHARED_LOCK);
602         if (tcp) {
603             hostp = tcp->srvr->server;
604             XSTATS_START_TIME(AFS_STATS_FS_RPCIDX_BULKSTATUS);
605 #ifdef RX_ENABLE_LOCKS
606             AFS_GUNLOCK();
607 #endif /* RX_ENABLE_LOCKS */
608             code = RXAFS_BulkStatus(tcp->id, &fidParm, &statParm, &cbParm,
609                                     &volSync);
610 #ifdef RX_ENABLE_LOCKS
611             AFS_GLOCK();
612 #endif /* RX_ENABLE_LOCKS */
613             XSTATS_END_TIME;
614         }
615         else code = -1;
616     } while (afs_Analyze(tcp, code, &adp->fid, areqp, 
617                          AFS_STATS_FS_RPCIDX_BULKSTATUS, SHARED_LOCK, (struct cell *)0));
618
619     /* now, if we didnt get the info, bail out. */
620     if (code) goto done;
621
622     /* we need vol flags to create the entries properly */
623     dotdot.Fid.Volume = 0;
624     volp = afs_GetVolume(&adp->fid, areqp, READ_LOCK);
625     if (volp) {
626         volStates = volp->states;
627         if (volp->dotdot.Fid.Volume != 0)
628             dotdot = volp->dotdot;
629     }
630     else volStates = 0;
631
632     /* find the place to merge the info into  We do this by skipping
633      * nskip entries in the LRU queue.  The more we skip, the more
634      * we preserve, since the head of the VLRU queue is the most recently
635      * referenced file.
636      */
637   reskip:
638     nskip = afs_cacheStats / 2;         /* preserved fraction of the cache */
639     ObtainReadLock(&afs_xvcache);
640     if (QEmpty(&VLRU)) {
641       /* actually a serious error, probably should panic. Probably will 
642        * panic soon, oh well. */
643       ReleaseReadLock(&afs_xvcache);
644       afs_warnuser("afs_DoBulkStat: VLRU empty!");
645       goto done;
646     }
647     if ((VLRU.next->prev != &VLRU) || (VLRU.prev->next != &VLRU)) {
648        refpanic ("Bulkstat VLRU inconsistent");
649     }
650     for(tq = VLRU.next; tq != &VLRU; tq = QNext(tq)) {
651         if (--nskip <= 0) break;
652         else if (QNext(QPrev(tq)) != tq) {
653            BStvc = QTOV(tq);
654            refpanic ("BulkStat VLRU inconsistent");
655         }
656     }
657     if (tq != &VLRU) lruvcp = QTOV(tq);
658     else lruvcp = QTOV(VLRU.next);
659
660     /* now we have to hold this entry, so that it does not get moved
661      * into the free list while we're running.  It could still get
662      * moved within the lru queue, but hopefully that will be rare; it
663      * doesn't hurt nearly as much.
664      */
665     retry = 0;
666     osi_vnhold(lruvcp, &retry);
667     ReleaseReadLock(&afs_xvcache);           /* could be read lock */
668     if (retry)
669       goto reskip;
670
671     /* otherwise, merge in the info.  We have to be quite careful here,
672      * since we need to ensure that we don't merge old info over newer
673      * stuff in a stat cache entry.  We're very conservative here: we don't
674      * do the merge at all unless we ourselves create the stat cache
675      * entry.  That's pretty safe, and should work pretty well, since we
676      * typically expect to do the stat cache creation ourselves.
677      *
678      * We also have to take into account racing token revocations.
679      */
680     for(i=0; i<fidIndex; i++) {
681         afid.Cell = adp->fid.Cell;
682         afid.Fid.Volume = adp->fid.Fid.Volume;
683         afid.Fid.Vnode = fidsp[i].Vnode;
684         afid.Fid.Unique = fidsp[i].Unique;
685         do {
686            retry = 0;
687            ObtainReadLock(&afs_xvcache);
688            tvcp = afs_FindVCache(&afid, 1, 0, &retry, 0/* !stats&!lru*/);
689            ReleaseReadLock(&afs_xvcache);
690         } while (tvcp && retry);
691
692         /* The entry may no longer exist */
693         if (tvcp == NULL) {
694             continue;
695         }
696
697         /* now we have the entry held, but we need to fill it in */
698         ObtainWriteLock(&tvcp->lock,131);
699
700         /* if CBulkFetching is not set, or if the file size no longer
701          * matches the value we placed there when we set the CBulkFetching
702          * flag, then someone else has done something with this node,
703          * and we may not have the latest status information for this
704          * file.  Leave the entry alone.
705          */
706         if (!(tvcp->states & CBulkFetching) || (tvcp->m.Length != statSeqNo)) {
707             flagIndex++;
708             ReleaseWriteLock(&tvcp->lock);
709             afs_PutVCache(tvcp);
710             continue;
711         }
712
713         /* now copy ".." entry back out of volume structure, if necessary */
714         if (tvcp->mvstat == 2  && (dotdot.Fid.Volume != 0)) {
715             if (!tvcp->mvid)
716                 tvcp->mvid = (struct VenusFid *) osi_AllocSmallSpace(sizeof(struct VenusFid));
717             *tvcp->mvid = dotdot;
718         }
719
720         ObtainWriteLock(&afs_xvcache,132);
721         if ((VLRU.next->prev != &VLRU) || (VLRU.prev->next != &VLRU)) {
722            refpanic ("Bulkstat VLRU inconsistent2");
723         }
724         if ((QNext(QPrev(&tvcp->vlruq)) != &tvcp->vlruq) 
725             || (QPrev(QNext(&tvcp->vlruq)) != &tvcp->vlruq))
726            refpanic ("Bulkstat VLRU inconsistent4");
727         if ((QNext(QPrev(&lruvcp->vlruq)) != &lruvcp->vlruq) 
728             || (QPrev(QNext(&lruvcp->vlruq)) != &lruvcp->vlruq)) 
729            refpanic ("Bulkstat VLRU inconsistent5");
730
731         if (tvcp != lruvcp) {  /* if they are == don't move it, don't corrupt vlru */
732            QRemove(&tvcp->vlruq);
733            QAdd(&lruvcp->vlruq, &tvcp->vlruq);
734         }
735
736         if ((VLRU.next->prev != &VLRU) || (VLRU.prev->next != &VLRU)) {
737            refpanic ("Bulkstat VLRU inconsistent3");
738         }
739         if ((QNext(QPrev(&tvcp->vlruq)) != &tvcp->vlruq) 
740             || (QPrev(QNext(&tvcp->vlruq)) != &tvcp->vlruq))
741            refpanic ("Bulkstat VLRU inconsistent5");
742         if ((QNext(QPrev(&lruvcp->vlruq)) != &lruvcp->vlruq) 
743             || (QPrev(QNext(&lruvcp->vlruq)) != &lruvcp->vlruq))
744            refpanic ("Bulkstat VLRU inconsistent6");
745         ReleaseWriteLock(&afs_xvcache);
746
747         ObtainWriteLock(&afs_xcbhash, 494);
748
749         /* We need to check the flags again. We may have missed
750          * something while we were waiting for a lock.
751          */
752         if (!(tvcp->states & CBulkFetching) || (tvcp->m.Length != statSeqNo)) {
753             flagIndex++;
754             ReleaseWriteLock(&tvcp->lock);
755             ReleaseWriteLock(&afs_xcbhash);
756             afs_PutVCache(tvcp);
757             continue;
758         }
759
760         /* now merge in the resulting status back into the vnode.
761          * We only do this if the entry looks clear.
762          */
763         afs_ProcessFS(tvcp, &statsp[i], areqp);
764 #ifdef AFS_LINUX22_ENV
765         /* overwrite the ops if it's a directory or symlink. */
766         if (vType(tvcp) == VDIR)
767             tvcp->v.v_op = &afs_dir_iops;
768         else if (vType(tvcp) == VLNK)
769             tvcp->v.v_op = &afs_symlink_iops;
770 #endif
771
772         /* do some accounting for bulk stats: mark this entry as
773          * loaded, so we can tell if we use it before it gets
774          * recycled.
775          */
776         tvcp->states |= CBulkStat;
777         tvcp->states &= ~CBulkFetching;
778         flagIndex++;
779         afs_bulkStatsDone++;
780
781         /* merge in vol info */
782         if (volStates & VRO) tvcp->states |= CRO;
783         if (volStates & VBackup) tvcp->states |= CBackup;
784         if (volStates & VForeign) tvcp->states |= CForeign;
785
786         /* merge in the callback info */
787         tvcp->states |= CTruth;
788
789         /* get ptr to the callback we are interested in */
790         tcbp = cbsp + i;
791
792         if (tcbp->ExpirationTime != 0) {
793             tvcp->cbExpires = tcbp->ExpirationTime+startTime;
794             tvcp->callback = hostp;
795             tvcp->states |= CStatd;
796             afs_QueueCallback(tvcp, CBHash(tcbp->ExpirationTime), volp);
797         }
798         else if (tvcp->states & CRO) {
799             /* ordinary callback on a read-only volume -- AFS 3.2 style */
800             tvcp->cbExpires = 3600+startTime;
801             tvcp->callback = hostp;
802             tvcp->states |= CStatd;
803             afs_QueueCallback(tvcp, CBHash(3600), volp);
804         }
805         else {
806             tvcp->callback = 0;
807             tvcp->states &= ~(CStatd|CUnique);  
808             afs_DequeueCallback(tvcp);
809             if ((tvcp->states & CForeign) || (vType(tvcp) == VDIR)) 
810               osi_dnlc_purgedp (tvcp);  /* if it (could be) a directory */
811         }
812         ReleaseWriteLock(&afs_xcbhash);
813
814         ReleaseWriteLock(&tvcp->lock);
815         /* finally, we're done with the entry */
816         afs_PutVCache(tvcp);
817     }   /* for all files we got back */
818
819     /* finally return the pointer into the LRU queue */
820     afs_PutVCache(lruvcp);
821
822   done:
823     /* Be sure to turn off the CBulkFetching flags */
824     for(i=flagIndex; i<fidIndex; i++) {
825         afid.Cell = adp->fid.Cell;
826         afid.Fid.Volume = adp->fid.Fid.Volume;
827         afid.Fid.Vnode = fidsp[i].Vnode;
828         afid.Fid.Unique = fidsp[i].Unique;
829         do {
830            retry = 0;
831            ObtainReadLock(&afs_xvcache);
832            tvcp = afs_FindVCache(&afid, 1, 0, &retry, 0/* !stats&!lru*/);
833            ReleaseReadLock(&afs_xvcache);
834         } while (tvcp && retry);
835         if (tvcp != NULL
836             && (tvcp->states & CBulkFetching)
837             && (tvcp->m.Length == statSeqNo)) {
838           tvcp->states &= ~CBulkFetching;
839         }
840         if (tvcp != NULL) {
841           afs_PutVCache(tvcp);
842         }
843     }
844     if ( volp )
845         afs_PutVolume(volp, READ_LOCK);
846     
847     osi_FreeLargeSpace(statMemp);
848     osi_FreeLargeSpace(cbfMemp);
849 }
850
851 /* was: (AFS_DEC_ENV) || defined(AFS_OSF30_ENV) || defined(AFS_NCR_ENV) */
852 int AFSDOBULK = 1;
853
854 #ifdef  AFS_OSF_ENV
855 afs_lookup(adp, ndp)
856     struct vcache *adp;
857     struct nameidata *ndp; {
858     char aname[MAXNAMLEN+1];    /* XXX */
859     struct vcache **avcp = (struct vcache **)&(ndp->ni_vp);
860     struct ucred *acred = ndp->ni_cred;
861     int wantparent = ndp->ni_nameiop & WANTPARENT;
862     int opflag = ndp->ni_nameiop & OPFLAG;
863 #else   /* AFS_OSF_ENV */
864 #if     defined(AFS_SUN5_ENV) || defined(AFS_SGI_ENV)
865 afs_lookup(OSI_VC_ARG(adp), aname, avcp, pnp, flags, rdir, acred)
866     struct pathname *pnp;
867     int flags;
868     struct vnode *rdir;
869 #else
870 afs_lookup(adp, aname, avcp, acred)
871 #endif
872     OSI_VC_DECL(adp);
873     struct vcache **avcp;
874     char *aname;
875     struct AFS_UCRED *acred; {
876 #endif
877     struct vrequest treq;
878     char *tname = (char *)0;
879     register struct vcache *tvc=0;
880     register afs_int32 code;
881     int pass = 0, hit = 0;
882     long dirCookie;
883     extern afs_int32 afs_mariner;                       /*Writing activity to log?*/
884     OSI_VC_CONVERT(adp)
885     afs_hyper_t versionNo;
886
887     AFS_STATCNT(afs_lookup);
888 #ifdef  AFS_OSF_ENV
889     ndp->ni_dvp = (struct vnode *)adp;
890     bcopy(ndp->ni_ptr, aname, ndp->ni_namelen);
891     aname[ndp->ni_namelen] = '\0';
892 #endif  /* AFS_OSF_ENV */
893
894     *avcp = (struct vcache *) 0;   /* Since some callers don't initialize it */
895
896     if (code = afs_InitReq(&treq, acred)) { 
897       goto done;
898     }
899
900     /* lookup the name aname in the appropriate dir, and return a cache entry
901       on the resulting fid */
902
903     /*
904      * check for, and handle "@sys" if it's there.  We should be able
905      * to avoid the alloc and the strcpy with a little work, but it's
906      * not pressing.  If there aren't any remote users (ie, via the 
907      * NFS translator), we have a slightly easier job.
908      * the faster way to do this is to check for *aname == '@' and if 
909      * it's there, check for @sys, otherwise, assume there's no @sys 
910      * then, if the lookup fails, check for .*@sys...
911      */
912     if (!AFS_EQ_ATSYS(aname)) {
913       tname = aname;
914     }
915     else {
916         tname = (char *) osi_AllocLargeSpace(AFS_SMALLOCSIZ);
917         if (!afs_nfsexporter) 
918           strcpy(tname, (afs_sysname ? afs_sysname : SYS_NAME ));
919         else {
920           register struct unixuser *au;
921           register afs_int32 error;
922           au = afs_GetUser(treq.uid, adp->fid.Cell, 0); afs_PutUser(au, 0);     
923           if (au->exporter) {
924             error = EXP_SYSNAME(au->exporter, (char *)0, tname);
925             if (error) 
926               strcpy(tname, "@sys");
927           } else {
928               strcpy(tname, (afs_sysname ? afs_sysname : SYS_NAME ));
929           }
930         }
931       }
932
933     /* come back to here if we encounter a non-existent object in a read-only
934        volume's directory */
935
936   redo:
937     *avcp = (struct vcache *) 0;   /* Since some callers don't initialize it */
938
939     if (!(adp->states & CStatd)) {
940         if (code = afs_VerifyVCache2(adp, &treq))
941           goto done;
942     }
943     else code = 0;
944
945     /* watch for ".." in a volume root */
946     if (adp->mvstat == 2 && tname[0] == '.' && tname[1] == '.' && !tname[2]) {
947         /* looking up ".." in root via special hacks */
948         if (adp->mvid == (struct VenusFid *) 0 || adp->mvid->Fid.Volume == 0) {
949 #ifdef  AFS_OSF_ENV
950             extern struct vcache *afs_globalVp;
951             if (adp == afs_globalVp) {
952                 struct vnode *rvp = (struct vnode *)adp;
953 /*
954                 ndp->ni_vp = rvp->v_vfsp->vfs_vnodecovered;
955                 ndp->ni_dvp = ndp->ni_vp;
956                 VN_HOLD(*avcp);
957 */
958                 code = ENODEV;
959                 goto done;
960             }
961 #endif
962             code = ENODEV;
963             goto done;
964         }
965         /* otherwise we have the fid here, so we use it */
966         tvc = afs_GetVCache(adp->mvid, &treq, (afs_int32 *)0,
967                             (struct vcache*)0, 0);
968         afs_Trace3(afs_iclSetp, CM_TRACE_GETVCDOTDOT,
969                    ICL_TYPE_FID, adp->mvid, ICL_TYPE_POINTER, tvc, 
970                    ICL_TYPE_INT32,  code);
971         *avcp = tvc;
972         code = (tvc ? 0 : ENOENT);
973         hit = 1;
974         if (tvc && !tvc->vrefCount) {
975             osi_Panic("TT1");
976         }
977         if (code) {
978             /*printf("LOOKUP GETVCDOTDOT -> %d\n", code);*/
979         }
980         goto done;
981     }
982
983     /* now check the access */
984     if (treq.uid != adp->last_looker) {  
985        if (!afs_AccessOK(adp, PRSFS_LOOKUP, &treq, CHECK_MODE_BITS)) {
986          *avcp = (struct vcache *)0;
987          code = EACCES;
988          goto done;
989        }
990        else adp->last_looker = treq.uid;
991     } 
992
993
994     /* special case lookup of ".".  Can we check for it sooner in this code,
995      * for instance, way up before "redo:" ??
996      * I'm not fiddling with the LRUQ here, either, perhaps I should, or else 
997      * invent a lightweight version of GetVCache.
998      */
999     if (tname[0] == '.' && !tname[1]) { /* special case */
1000         ObtainReadLock(&afs_xvcache);   
1001         osi_vnhold(adp, 0);
1002         ReleaseReadLock(&afs_xvcache);  
1003       code = 0;
1004       *avcp = tvc = adp;
1005       hit = 1;
1006         if (adp && !adp->vrefCount) {
1007             osi_Panic("TT2");
1008         }
1009       goto done;
1010     }
1011
1012     tvc = osi_dnlc_lookup (adp, tname, WRITE_LOCK);
1013     *avcp = tvc;  /* maybe wasn't initialized, but it is now */
1014 #ifdef AFS_LINUX22_ENV
1015     if (tvc) {
1016       if (tvc->mvstat == 2) { /* we don't trust the dnlc for root vcaches */
1017         AFS_RELE(tvc);
1018         *avcp = 0;
1019       }
1020       else {  
1021         code = 0;
1022         hit = 1;
1023         goto done;
1024       }
1025     }
1026 #else /* non - LINUX */
1027     if (tvc) {
1028       code = 0;
1029       hit = 1;
1030       goto done;
1031     }
1032 #endif /* linux22 */
1033
1034     {
1035     register struct dcache *tdc;
1036     afs_int32 dirOffset, dirLen;
1037     ino_t theDir;
1038     struct VenusFid tfid;
1039
1040     /* now we have to lookup the next fid */
1041     tdc = afs_GetDCache(adp, 0, &treq, &dirOffset, &dirLen, 1);
1042     if (!tdc) {
1043       *avcp = (struct vcache *)0;  /* redundant, but harmless */
1044       code = EIO;
1045       goto done;
1046     }
1047
1048     /* now we will just call dir package with appropriate inode.
1049       Dirs are always fetched in their entirety for now */
1050     /* If the first lookup doesn't succeed, maybe it's got @sys in the name */
1051     ObtainReadLock(&adp->lock);
1052
1053     /*
1054      * Make sure that the data in the cache is current. There are two
1055      * cases we need to worry about:
1056      * 1. The cache data is being fetched by another process.
1057      * 2. The cache data is no longer valid
1058      */
1059     while ((adp->states & CStatd)
1060            && (tdc->flags & DFFetching)
1061            && hsame(adp->m.DataVersion, tdc->f.versionNo)) {
1062         tdc->flags |= DFWaiting;
1063         ReleaseReadLock(&adp->lock);
1064         afs_osi_Sleep(&tdc->validPos);
1065         ObtainReadLock(&adp->lock);
1066     }
1067     if (!(adp->states & CStatd)
1068         || !hsame(adp->m.DataVersion, tdc->f.versionNo)) {
1069         ReleaseReadLock(&adp->lock);
1070         afs_PutDCache(tdc);
1071         goto redo;
1072     }
1073
1074     /* Save the version number for when we call osi_dnlc_enter */
1075     hset(versionNo, tdc->f.versionNo);
1076
1077     theDir = tdc->f.inode;
1078     code = afs_dir_LookupOffset(&theDir, tname, &tfid.Fid, &dirCookie);
1079     if (code == ENOENT && tname == aname) {
1080       int len;
1081       len = strlen(aname);
1082       if (len >= 4 && AFS_EQ_ATSYS(aname+len-4)) {
1083         tname = (char *) osi_AllocLargeSpace(AFS_LRALLOCSIZ);
1084         afs_HandleAtName(aname, tname, &treq, adp);
1085         code = afs_dir_LookupOffset(&theDir, tname, &tfid.Fid, &dirCookie);
1086       }
1087     }
1088     ReleaseReadLock(&adp->lock);
1089     afs_PutDCache(tdc);
1090
1091     /* new fid has same cell and volume */
1092     tfid.Cell = adp->fid.Cell;
1093     tfid.Fid.Volume = adp->fid.Fid.Volume;
1094     afs_Trace4(afs_iclSetp, CM_TRACE_LOOKUP, ICL_TYPE_POINTER, adp, 
1095                ICL_TYPE_STRING, tname,
1096                ICL_TYPE_FID, &tfid, ICL_TYPE_INT32, code);
1097
1098     if (code) {
1099         if (code != ENOENT) {
1100             printf("LOOKUP dirLookupOff -> %d\n", code);
1101         }
1102         goto done;
1103     }  
1104
1105     /* prefetch some entries, if the dir is currently open.  The variable
1106      * dirCookie tells us where to start prefetching from.
1107      */
1108     if (AFSDOBULK && adp->opens > 0 && !(adp->states & CForeign)) {
1109         afs_int32 retry;
1110         /* if the entry is not in the cache, or is in the cache,
1111          * but hasn't been statd, then do a bulk stat operation.
1112          */
1113         do {
1114            retry = 0;
1115            ObtainReadLock(&afs_xvcache);        
1116            tvc = afs_FindVCache(&tfid, 1, 0, &retry, 0/* !stats,!lru */);
1117            ReleaseReadLock(&afs_xvcache);       
1118         } while (tvc && retry);
1119
1120         if (!tvc || !(tvc->states & CStatd)) {
1121             afs_DoBulkStat(adp, dirCookie, &treq);
1122         }
1123
1124         /* if the vcache isn't usable, release it */
1125         if (tvc && !(tvc->states & CStatd)) {
1126             afs_PutVCache(tvc);
1127             tvc = (struct vcache *) 0;
1128         }
1129     }
1130     else tvc = (struct vcache *) 0;
1131     
1132     /* now get the status info, if we don't already have it */
1133     /* This is kind of weird, but we might wind up accidentally calling
1134      * RXAFS_Lookup because we happened upon a file which legitimately
1135      * has a 0 uniquifier. That is the result of allowing unique to wrap
1136      * to 0. This was fixed in AFS 3.4. For CForeigh, Unique == 0 means that
1137      * the file has not yet been looked up.
1138      */
1139     if (!tvc) {
1140        afs_int32 cached = 0;
1141        if (!tfid.Fid.Unique && (adp->states & CForeign)) {
1142             tvc = afs_LookupVCache(&tfid, &treq, &cached, WRITE_LOCK, 
1143                                    adp, tname);
1144        } 
1145        if (!tvc) {  /* lookup failed or wasn't called */
1146             tvc = afs_GetVCache(&tfid, &treq, &cached, (struct vcache*)0,
1147                                 WRITE_LOCK);
1148        }
1149     } /* if !tvc */
1150     } /* sub-block just to reduce stack usage */
1151
1152     if (tvc) {
1153        if (adp->states & CForeign)
1154            tvc->states |= CForeign;
1155         tvc->parentVnode = adp->fid.Fid.Vnode;
1156         tvc->parentUnique = adp->fid.Fid.Unique;
1157         tvc->states &= ~CBulkStat;
1158         if (tvc->mvstat == 1) {
1159           /* a mt point, possibly unevaluated */
1160           struct volume *tvolp;
1161
1162             ObtainWriteLock(&tvc->lock,133);
1163             code = EvalMountPoint(tvc, adp, &tvolp, &treq);
1164             ReleaseWriteLock(&tvc->lock);
1165
1166             if (code) {
1167                 if (tvolp) afs_PutVolume(tvolp, WRITE_LOCK);
1168                 goto done;
1169             }
1170
1171             /* next, we want to continue using the target of the mt point */
1172             if (tvc->mvid && (tvc->states & CMValid)) {
1173               struct vcache *uvc;
1174                 /* now lookup target, to set .. pointer */
1175                 afs_Trace2(afs_iclSetp, CM_TRACE_LOOKUP1,
1176                            ICL_TYPE_POINTER, tvc, ICL_TYPE_FID, &tvc->fid);
1177                 uvc = tvc;      /* remember for later */
1178
1179                 if (tvolp && (tvolp->states & VForeign)) {
1180                     /* XXXX tvolp has ref cnt on but not locked! XXX */
1181                     tvc = afs_GetRootVCache(tvc->mvid, &treq, (afs_int32 *)0, tvolp, WRITE_LOCK);
1182                 } else {
1183                     tvc = afs_GetVCache(tvc->mvid, &treq, (afs_int32 *)0,
1184                                         (struct vcache*)0, WRITE_LOCK);
1185                 }
1186                 afs_PutVCache(uvc, WRITE_LOCK); /* we're done with it */
1187
1188                 if (!tvc) {
1189                     code = ENOENT;
1190                     if (tvolp) {
1191                         afs_PutVolume(tvolp, WRITE_LOCK);
1192                     }
1193                     goto done;
1194                 }
1195
1196                 /* now, if we came via a new mt pt (say because of a new
1197                  * release of a R/O volume), we must reevaluate the ..
1198                  * ptr to point back to the appropriate place */
1199                 if (tvolp) {
1200                     ObtainWriteLock(&tvc->lock,134);
1201                     if (tvc->mvid == (struct VenusFid *) 0) {
1202                         tvc->mvid = (struct VenusFid *) osi_AllocSmallSpace(sizeof(struct VenusFid));
1203                     }
1204                     /* setup backpointer */
1205                     *tvc->mvid = tvolp->dotdot;
1206                     ReleaseWriteLock(&tvc->lock);
1207                     afs_PutVolume(tvolp, WRITE_LOCK);
1208                 }
1209             }
1210             else {
1211                 afs_PutVCache(tvc, WRITE_LOCK);
1212                 code = ENOENT;
1213                 if (tvolp) afs_PutVolume(tvolp, WRITE_LOCK);
1214                 goto done;
1215             }
1216         }
1217         *avcp = tvc;
1218         if (tvc && !tvc->vrefCount) {
1219             osi_Panic("TT3");
1220         }
1221         code = 0;
1222     }
1223     else {
1224         /* if we get here, we found something in a directory that couldn't
1225            be located (a Multics "connection failure").  If the volume is
1226            read-only, we try flushing this entry from the cache and trying
1227            again. */
1228         if (pass == 0) {
1229             struct volume *tv;
1230             tv = afs_GetVolume(&adp->fid, &treq, READ_LOCK);
1231             if (tv) {
1232                 if (tv->states & VRO) {
1233                     pass = 1;                   /* try this *once* */
1234                     ObtainWriteLock(&afs_xcbhash, 495);
1235                     afs_DequeueCallback(adp);
1236                     /* re-stat to get later version */
1237                     adp->states &= ~CStatd;
1238                     ReleaseWriteLock(&afs_xcbhash);
1239                     osi_dnlc_purgedp(adp);
1240                     afs_PutVolume(tv, READ_LOCK);
1241                     goto redo;
1242                 }
1243                 afs_PutVolume(tv, READ_LOCK);
1244             }
1245         }
1246         code = ENOENT;
1247     }
1248
1249 done:
1250     /* put the network buffer back, if need be */
1251     if (tname != aname && tname) osi_FreeLargeSpace(tname);
1252     if (code == 0) {
1253 #ifdef  AFS_OSF_ENV
1254         /* Handle RENAME; only need to check rename "."  */
1255         if (opflag == RENAME && wantparent && *ndp->ni_next == 0) {
1256             if (!FidCmp(&(tvc->fid), &(adp->fid))) { 
1257                 afs_PutVCache(*avcp, WRITE_LOCK);
1258                 *avcp = NULL;
1259                 return afs_CheckCode(EISDIR, &treq, 18);
1260             }
1261         }
1262 #endif  /* AFS_OSF_ENV */
1263
1264         if (afs_mariner)
1265           afs_AddMarinerName(aname, tvc); 
1266         if (!hit) {
1267           osi_dnlc_enter (adp, aname, tvc, &versionNo);
1268         }
1269         else {
1270 #ifdef AFS_LINUX20_ENV
1271             /* So Linux inode cache is up to date. */
1272             code = afs_VerifyVCache(tvc, &treq);
1273 #else
1274             return 0;  /* can't have been any errors if hit and !code */
1275 #endif
1276         }
1277     }
1278     code = afs_CheckCode(code, &treq, 19);
1279     if (code) {
1280        /* If there is an error, make sure *avcp is null.
1281         * Alphas panic otherwise - defect 10719.
1282         */
1283        *avcp = (struct vcache *)0;
1284     }
1285
1286     return code;
1287 }