libafs: Set tvcp->callback before BulkStatus
[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
17 #include <afsconfig.h>
18 #include "afs/param.h"
19
20 #include "afs/sysincludes.h"    /* Standard vendor system headers */
21 #include "afsincludes.h"        /* Afs-based standard headers */
22 #include "afs/afs_stats.h"      /* statistics */
23 #include "afs/afs_cbqueue.h"
24 #include "afs/nfsclient.h"
25 #include "afs/exporter.h"
26 #include "afs/afs_osidnlc.h"
27 #include "afs/afs_dynroot.h"
28
29 extern struct vcache *afs_globalVp;
30
31 afs_int32 afs_bkvolpref = 0;
32 afs_int32 afs_bulkStatsDone;
33 static int bulkStatCounter = 0; /* counter for bulk stat seq. numbers */
34 int afs_fakestat_enable = 0;    /* 1: fakestat-all, 2: fakestat-crosscell */
35
36
37 /* this would be faster if it did comparison as int32word, but would be 
38  * dependant on byte-order and alignment, and I haven't figured out
39  * what "@sys" is in binary... */
40 #define AFS_EQ_ATSYS(name) (((name)[0]=='@')&&((name)[1]=='s')&&((name)[2]=='y')&&((name)[3]=='s')&&(!(name)[4]))
41
42 /* call under write lock, evaluate mvid field from a mt pt.
43  * avc is the vnode of the mount point object; must be write-locked.
44  * advc is the vnode of the containing directory (optional; if NULL and
45  *   EvalMountPoint succeeds, caller must initialize *avolpp->dotdot)
46  * avolpp is where we return a pointer to the volume named by the mount pt, if success
47  * areq is the identity of the caller.
48  *
49  * NOTE: this function returns a held volume structure in *volpp if it returns 0!
50  */
51 static int
52 EvalMountData(char type, char *data, afs_uint32 states, afs_uint32 cellnum,
53               struct volume **avolpp, struct vrequest *areq,
54               afs_uint32 *acellidxp, afs_uint32 *avolnump,
55               afs_uint32 *avnoidp, afs_uint32 *auniqp)
56 {
57     struct volume *tvp = 0;
58     struct VenusFid tfid;
59     struct cell *tcell;
60     char *cpos, *volnamep;
61     char *buf, *endptr;
62     afs_int32 prefetch;         /* 1=>None  2=>RO  3=>BK */
63     afs_int32 mtptCell, assocCell = 0, hac = 0;
64     afs_int32 samecell, roname, len;
65     afs_uint32 volid = 0, cellidx, vnoid = 0, uniq = 0;
66
67     /* Start by figuring out and finding the cell */
68     cpos = afs_strchr(data, ':');       /* if cell name present */
69     if (cpos) {
70         volnamep = cpos + 1;
71         *cpos = 0;
72         if ((afs_strtoi_r(data, &endptr, &cellnum) == 0) &&
73             (endptr == cpos))
74             tcell = afs_GetCell(cellnum, READ_LOCK);
75         else {
76             tcell = afs_GetCellByName(data, READ_LOCK);
77             cellnum = 0;
78         }
79         *cpos = ':';
80     } else if (cellnum) {
81         volnamep = data;
82         tcell = afs_GetCell(cellnum, READ_LOCK);
83     } else {
84         /* No cellname or cellnum; return ENODEV */
85         return ENODEV;
86     }
87     if (!tcell) {
88         /* no cell found; return ENODEV */
89         return ENODEV;
90     }
91
92     cellidx = tcell->cellIndex;
93     mtptCell = tcell->cellNum;  /* The cell for the mountpoint */
94     if (tcell->lcellp) {
95         hac = 1;                /* has associated cell */
96         assocCell = tcell->lcellp->cellNum;     /* The associated cell */
97     }
98     afs_PutCell(tcell, READ_LOCK);
99
100     /* If there's nothing to look up, we can't proceed */
101     if (!*volnamep)
102         return ENODEV;
103
104     /* cell found. figure out volume */
105     cpos = afs_strchr(volnamep, ':');
106     if (cpos)
107         *cpos = 0;
108
109     /* Look for an all-numeric volume ID */
110     if ((afs_strtoi_r(volnamep, &endptr, &volid) == 0) &&
111         ((endptr == cpos) || (!*endptr)))
112     {
113         /* Ok. Is there a vnode and uniq? */
114         if (cpos) {
115             char *vnodep = (char *)(cpos + 1);
116             char *uniqp = NULL;
117             if ((!*vnodep) /* no vnode after colon */
118                 || !(uniqp = afs_strchr(vnodep, ':')) /* no colon for uniq */
119                 || (!*(++uniqp)) /* no uniq after colon */
120                 || (afs_strtoi_r(vnodep, &endptr, &vnoid) != 0) /* bad vno */
121                 || (*endptr != ':') /* bad vnode field */
122                 || (afs_strtoi_r(uniqp, &endptr, &uniq) != 0) /* bad uniq */
123                 || (*endptr)) /* anything after uniq */
124             {
125                 *cpos = ':';
126                 /* sorry. vnode and uniq, or nothing */
127                 return ENODEV;
128             }
129         }
130     } else
131             volid = 0;
132
133     /*
134      * If the volume ID was all-numeric, and they didn't ask for a
135      * pointer to the volume structure, then just return the number
136      * as-is.  This is currently only used for handling name lookups
137      * in the dynamic mount directory.
138      */
139     if (volid && !avolpp) {
140         if (*cpos)
141             *cpos = ':';
142         goto done;
143     }
144
145     /*
146      * If the volume ID was all-numeric, and the type was '%', then
147      * assume whoever made the mount point knew what they were doing,
148      * and don't second-guess them by forcing use of a RW volume when
149      * they gave the ID of something else.
150      */
151     if (volid && type == '%') {
152         tfid.Fid.Volume = volid;        /* remember BK volume */
153         tfid.Cell = mtptCell;
154         tvp = afs_GetVolume(&tfid, areq, WRITE_LOCK);   /* get the new one */
155         if (cpos) /* one way or another we're done */
156             *cpos = ':';
157         if (!tvp)
158             return ENODEV; /* afs_GetVolume failed; return ENODEV */
159         goto done;
160     }
161
162     /* Is volume name a "<n>.backup" or "<n>.readonly" name */
163     len = strlen(volnamep);
164     roname = ((len > 9) && (strcmp(&volnamep[len - 9], ".readonly") == 0))
165         || ((len > 7) && (strcmp(&volnamep[len - 7], ".backup") == 0));
166
167     /* When we cross mountpoint, do we stay in the same cell */
168     samecell = (cellnum == mtptCell) || (hac && (cellnum == assocCell));
169
170     /* Decide whether to prefetch the BK, or RO.  Also means we want the BK or
171      * RO.
172      * If this is a regular mountpoint with a RW volume name
173      * - If BK preference is enabled AND we remain within the same cell AND
174      *   start from a BK volume, then we will want to prefetch the BK volume.
175      * - If we cross a cell boundary OR start from a RO volume, then we will
176      *   want to prefetch the RO volume.
177      */
178     if ((type == '#') && !roname) {
179         if (afs_bkvolpref && samecell && (states & CBackup))
180             prefetch = 3;       /* Prefetch the BK */
181         else if (!samecell || (states & CRO))
182             prefetch = 2;       /* Prefetch the RO */
183         else
184             prefetch = 1;       /* Do not prefetch */
185     } else {
186         prefetch = 1;           /* Do not prefetch */
187     }
188
189     /* Get the volume struct. Unless this volume name has ".readonly" or
190      * ".backup" in it, this will get the volume struct for the RW volume.
191      * The RO volume will be prefetched if requested (but not returned).
192      * Set up to use volname first.
193      */
194     tvp = afs_GetVolumeByName(volnamep, mtptCell, prefetch, areq, WRITE_LOCK);
195
196     /* If no volume was found in this cell, try the associated linked cell */
197     if (!tvp && hac && areq->volumeError) {
198         tvp =
199             afs_GetVolumeByName(volnamep, assocCell, prefetch, areq,
200                                 WRITE_LOCK);
201     }
202
203     /* Still not found. If we are looking for the RO, then perhaps the RW 
204      * doesn't exist? Try adding ".readonly" to volname and look for that.
205      * Don't know why we do this. Would have still found it in above call - jpm.
206      */
207     if (!tvp && (prefetch == 2) && len < AFS_SMALLOCSIZ - 10) {
208         buf = (char *)osi_AllocSmallSpace(len + 10);
209
210         strcpy(buf, volnamep);
211         afs_strcat(buf, ".readonly");
212
213         tvp = afs_GetVolumeByName(buf, mtptCell, 1, areq, WRITE_LOCK);
214
215         /* Try the associated linked cell if failed */
216         if (!tvp && hac && areq->volumeError) {
217             tvp = afs_GetVolumeByName(buf, assocCell, 1, areq, WRITE_LOCK);
218         }
219         osi_FreeSmallSpace(buf);
220     }
221     /* done with volname */
222     if (cpos)
223         *cpos = ':';
224     if (!tvp)
225         return ENODEV;          /* Couldn't find the volume */
226     else
227         volid = tvp->volume;
228
229     /* Don't cross mountpoint from a BK to a BK volume */
230     if ((states & CBackup) && (tvp->states & VBackup)) {
231         afs_PutVolume(tvp, WRITE_LOCK);
232         return ENODEV;
233     }
234
235     /* If we want (prefetched) the BK and it exists, then drop the RW volume
236      * and get the BK.
237      * Otherwise, if we want (prefetched0 the RO and it exists, then drop the
238      * RW volume and get the RO.
239      * Otherwise, go with the RW.
240      */
241     if ((prefetch == 3) && tvp->backVol) {
242         tfid.Fid.Volume = tvp->backVol; /* remember BK volume */
243         tfid.Cell = tvp->cell;
244         afs_PutVolume(tvp, WRITE_LOCK); /* release old volume */
245         tvp = afs_GetVolume(&tfid, areq, WRITE_LOCK);   /* get the new one */
246         if (!tvp)
247             return ENODEV;      /* oops, can't do it */
248     } else if ((prefetch >= 2) && tvp->roVol) {
249         tfid.Fid.Volume = tvp->roVol;   /* remember RO volume */
250         tfid.Cell = tvp->cell;
251         afs_PutVolume(tvp, WRITE_LOCK); /* release old volume */
252         tvp = afs_GetVolume(&tfid, areq, WRITE_LOCK);   /* get the new one */
253         if (!tvp)
254             return ENODEV;      /* oops, can't do it */
255     }
256
257 done:
258     if (acellidxp)
259         *acellidxp = cellidx;
260     if (avolnump)
261         *avolnump = volid;
262     if (avnoidp)
263         *avnoidp = vnoid;
264     if (auniqp)
265         *auniqp = uniq;
266     if (avolpp)
267         *avolpp = tvp;
268     else if (tvp)
269         afs_PutVolume(tvp, WRITE_LOCK);
270     return 0;
271 }
272
273 int
274 EvalMountPoint(struct vcache *avc, struct vcache *advc,
275                struct volume **avolpp, struct vrequest *areq)
276 {
277     afs_int32 code;
278     afs_uint32 avnoid, auniq;
279
280     AFS_STATCNT(EvalMountPoint);
281 #ifdef notdef
282     if (avc->mvid && (avc->f.states & CMValid))
283         return 0;               /* done while racing */
284 #endif
285     *avolpp = NULL;
286     code = afs_HandleLink(avc, areq);
287     if (code)
288         return code;
289
290     /* Determine which cell and volume the mointpoint goes to */
291     code = EvalMountData(avc->linkData[0], avc->linkData + 1,
292                          avc->f.states, avc->f.fid.Cell, avolpp, areq, 0, 0,
293                          &avnoid, &auniq);
294     if (code) return code;
295
296     if (!avnoid)
297         avnoid = 1;
298
299     if (!auniq)
300         auniq = 1;
301
302     if (avc->mvid == 0)
303         avc->mvid =
304             (struct VenusFid *)osi_AllocSmallSpace(sizeof(struct VenusFid));
305     avc->mvid->Cell = (*avolpp)->cell;
306     avc->mvid->Fid.Volume = (*avolpp)->volume;
307     avc->mvid->Fid.Vnode = avnoid;
308     avc->mvid->Fid.Unique = auniq;
309     avc->f.states |= CMValid;
310
311     /* Used to: if the mount point is stored within a backup volume,
312      * then we should only update the parent pointer information if
313      * there's none already set, so as to avoid updating a volume's ..
314      * info with something in an OldFiles directory.
315      *
316      * Next two lines used to be under this if:
317      *
318      * if (!(avc->f.states & CBackup) || tvp->dotdot.Fid.Volume == 0)
319      *
320      * Now: update mount point back pointer on every call, so that we handle
321      * multiple mount points better.  This way, when du tries to go back
322      * via chddir(".."), it will end up exactly where it started, yet
323      * cd'ing via a new path to a volume will reset the ".." pointer
324      * to the new path.
325      */
326     (*avolpp)->mtpoint = avc->f.fid;    /* setup back pointer to mtpoint */
327     
328     if (advc)
329         (*avolpp)->dotdot = advc->f.fid;
330
331     return 0;
332 }
333
334 /*
335  * afs_InitFakeStat
336  *
337  * Must be called on an afs_fakestat_state object before calling
338  * afs_EvalFakeStat or afs_PutFakeStat.  Calling afs_PutFakeStat
339  * without calling afs_EvalFakeStat is legal, as long as this
340  * function is called.
341  */
342 void
343 afs_InitFakeStat(struct afs_fakestat_state *state)
344 {
345     if (!afs_fakestat_enable)
346         return;
347
348     state->valid = 1;
349     state->did_eval = 0;
350     state->need_release = 0;
351 }
352
353 /*
354  * afs_EvalFakeStat_int
355  *
356  * The actual implementation of afs_EvalFakeStat and afs_TryEvalFakeStat,
357  * which is called by those wrapper functions.
358  *
359  * Only issues RPCs if canblock is non-zero.
360  */
361 static int
362 afs_EvalFakeStat_int(struct vcache **avcp, struct afs_fakestat_state *state,
363                      struct vrequest *areq, int canblock)
364 {
365     struct vcache *tvc, *root_vp;
366     struct volume *tvolp = NULL;
367     int code = 0;
368
369     if (!afs_fakestat_enable)
370         return 0;
371
372     osi_Assert(state->valid == 1);
373     osi_Assert(state->did_eval == 0);
374     state->did_eval = 1;
375
376     tvc = *avcp;
377     if (tvc->mvstat != 1)
378         return 0;
379
380     if (canblock) {
381         /* Is the call to VerifyVCache really necessary? */
382         code = afs_VerifyVCache(tvc, areq);
383         if (code)
384             goto done;
385
386         ObtainWriteLock(&tvc->lock, 599);
387         code = EvalMountPoint(tvc, NULL, &tvolp, areq);
388         ReleaseWriteLock(&tvc->lock);
389         if (code)
390             goto done;
391         if (tvolp) {
392             tvolp->dotdot = tvc->f.fid;
393             tvolp->dotdot.Fid.Vnode = tvc->f.parent.vnode;
394             tvolp->dotdot.Fid.Unique = tvc->f.parent.unique;
395         }
396     }
397     if (tvc->mvid && (tvc->f.states & CMValid)) {
398         if (!canblock) {
399             afs_int32 retry;
400
401             do {
402                 retry = 0;
403                 ObtainWriteLock(&afs_xvcache, 597);
404                 root_vp = afs_FindVCache(tvc->mvid, &retry, IS_WLOCK);
405                 if (root_vp && retry) {
406                     ReleaseWriteLock(&afs_xvcache);
407                     afs_PutVCache(root_vp);
408                 }
409             } while (root_vp && retry);
410             ReleaseWriteLock(&afs_xvcache);
411         } else {
412             root_vp = afs_GetVCache(tvc->mvid, areq, NULL, NULL);
413         }
414         if (!root_vp) {
415             code = canblock ? ENOENT : 0;
416             goto done;
417         }
418 #ifdef AFS_DARWIN80_ENV
419         root_vp->f.m.Type = VDIR;
420         AFS_GUNLOCK();
421         code = afs_darwin_finalizevnode(root_vp, NULL, NULL, 0, 0);
422         AFS_GLOCK();
423         if (code) goto done;
424         vnode_ref(AFSTOV(root_vp));
425 #endif
426         if (tvolp && !afs_InReadDir(root_vp)) {
427             /* Is this always kosher?  Perhaps we should instead use
428              * NBObtainWriteLock to avoid potential deadlock.
429              */
430             ObtainWriteLock(&root_vp->lock, 598);
431             if (!root_vp->mvid)
432                 root_vp->mvid = osi_AllocSmallSpace(sizeof(struct VenusFid));
433             *root_vp->mvid = tvolp->dotdot;
434             ReleaseWriteLock(&root_vp->lock);
435         }
436         state->need_release = 1;
437         state->root_vp = root_vp;
438         *avcp = root_vp;
439         code = 0;
440     } else {
441         code = canblock ? ENOENT : 0;
442     }
443
444   done:
445     if (tvolp)
446         afs_PutVolume(tvolp, WRITE_LOCK);
447     return code;
448 }
449
450 /*
451  * afs_EvalFakeStat
452  *
453  * Automatically does the equivalent of EvalMountPoint for vcache entries
454  * which are mount points.  Remembers enough state to properly release
455  * the volume root vcache when afs_PutFakeStat() is called.
456  *
457  * State variable must be initialized by afs_InitFakeState() beforehand.
458  *
459  * Returns 0 when everything succeeds and *avcp points to the vcache entry
460  * that should be used for the real vnode operation.  Returns non-zero if
461  * something goes wrong and the error code should be returned to the user.
462  */
463 int
464 afs_EvalFakeStat(struct vcache **avcp, struct afs_fakestat_state *state,
465                  struct vrequest *areq)
466 {
467     return afs_EvalFakeStat_int(avcp, state, areq, 1);
468 }
469
470 /*
471  * afs_TryEvalFakeStat
472  *
473  * Same as afs_EvalFakeStat, but tries not to talk to remote servers
474  * and only evaluate the mount point if all the data is already in
475  * local caches.
476  *
477  * Returns 0 if everything succeeds and *avcp points to a valid
478  * vcache entry (possibly evaluated).
479  */
480 int
481 afs_TryEvalFakeStat(struct vcache **avcp, struct afs_fakestat_state *state,
482                     struct vrequest *areq)
483 {
484     return afs_EvalFakeStat_int(avcp, state, areq, 0);
485 }
486
487 /*
488  * afs_PutFakeStat
489  *
490  * Perform any necessary cleanup at the end of a vnode op, given that
491  * afs_InitFakeStat was previously called with this state.
492  */
493 void
494 afs_PutFakeStat(struct afs_fakestat_state *state)
495 {
496     if (!afs_fakestat_enable)
497         return;
498
499     osi_Assert(state->valid == 1);
500     if (state->need_release)
501         afs_PutVCache(state->root_vp);
502     state->valid = 0;
503 }
504
505 int
506 afs_ENameOK(char *aname)
507 {
508     int tlen;
509
510     AFS_STATCNT(ENameOK);
511     tlen = strlen(aname);
512     if (tlen >= 4 && strcmp(aname + tlen - 4, "@sys") == 0)
513         return 0;
514     return 1;
515 }
516
517 static int
518 afs_getsysname(struct vrequest *areq, struct vcache *adp,
519                char *bufp, int *num, char **sysnamelist[])
520 {
521     struct unixuser *au;
522     afs_int32 error;
523
524     AFS_STATCNT(getsysname);
525
526     *sysnamelist = afs_sysnamelist;
527
528     if (!afs_nfsexporter)
529         strcpy(bufp, (*sysnamelist)[0]);
530     else {
531         au = afs_GetUser(areq->uid, adp->f.fid.Cell, 0);
532         if (au->exporter) {
533             error = EXP_SYSNAME(au->exporter, (char *)0, sysnamelist, num, 0);
534             if (error) {
535                 strcpy(bufp, "@sys");
536                 afs_PutUser(au, 0);
537                 return -1;
538             } else {
539                 strcpy(bufp, (*sysnamelist)[0]);
540             }
541         } else
542             strcpy(bufp, afs_sysname);
543         afs_PutUser(au, 0);
544     }
545     return 0;
546 }
547
548 void
549 Check_AtSys(struct vcache *avc, const char *aname,
550             struct sysname_info *state, struct vrequest *areq)
551 {
552     int num = 0;
553     char **sysnamelist[MAXNUMSYSNAMES];
554
555     if (AFS_EQ_ATSYS(aname)) {
556         state->offset = 0;
557         state->name = (char *)osi_AllocLargeSpace(MAXSYSNAME);
558         state->allocked = 1;
559         state->index =
560             afs_getsysname(areq, avc, state->name, &num, sysnamelist);
561     } else {
562         state->offset = -1;
563         state->allocked = 0;
564         state->index = 0;
565         state->name = (char *)aname;
566     }
567 }
568
569 int
570 Next_AtSys(struct vcache *avc, struct vrequest *areq,
571            struct sysname_info *state)
572 {
573     int num = afs_sysnamecount;
574     char **sysnamelist[MAXNUMSYSNAMES];
575
576     if (state->index == -1)
577         return 0;               /* No list */
578
579     /* Check for the initial state of aname != "@sys" in Check_AtSys */
580     if (state->offset == -1 && state->allocked == 0) {
581         char *tname;
582
583         /* Check for .*@sys */
584         for (tname = state->name; *tname; tname++)
585             /*Move to the end of the string */ ;
586
587         if ((tname > state->name + 4) && (AFS_EQ_ATSYS(tname - 4))) {
588             state->offset = (tname - 4) - state->name;
589             tname = (char *)osi_AllocLargeSpace(AFS_LRALLOCSIZ);
590             strncpy(tname, state->name, state->offset);
591             state->name = tname;
592             state->allocked = 1;
593             num = 0;
594             state->index =
595                 afs_getsysname(areq, avc, state->name + state->offset, &num,
596                                sysnamelist);
597             return 1;
598         } else
599             return 0;           /* .*@sys doesn't match either */
600     } else {
601         struct unixuser *au;
602         afs_int32 error;
603
604         *sysnamelist = afs_sysnamelist;
605
606         if (afs_nfsexporter) {
607             au = afs_GetUser(areq->uid, avc->f.fid.Cell, 0);
608             if (au->exporter) {
609                 error =
610                     EXP_SYSNAME(au->exporter, (char *)0, sysnamelist, &num, 0);
611                 if (error) {
612                     afs_PutUser(au, 0);
613                     return 0;
614                 }
615             }
616             afs_PutUser(au, 0);
617         }
618         if (++(state->index) >= num || !(*sysnamelist)[(unsigned int)state->index])
619             return 0;           /* end of list */
620     }
621     strcpy(state->name + state->offset, (*sysnamelist)[(unsigned int)state->index]);
622     return 1;
623 }
624
625 extern int BlobScan(struct dcache * afile, afs_int32 ablob);
626
627 /* called with an unlocked directory and directory cookie.  Areqp
628  * describes who is making the call.
629  * Scans the next N (about 30, typically) directory entries, and does
630  * a bulk stat call to stat them all.
631  *
632  * Must be very careful when merging in RPC responses, since we dont
633  * want to overwrite newer info that was added by a file system mutating
634  * call that ran concurrently with our bulk stat call.
635  *
636  * We do that, as described below, by not merging in our info (always
637  * safe to skip the merge) if the status info is valid in the vcache entry.
638  *
639  * If adapt ever implements the bulk stat RPC, then this code will need to
640  * ensure that vcaches created for failed RPC's to older servers have the
641  * CForeign bit set.
642  */
643 static struct vcache *BStvc = NULL;
644
645 int
646 afs_DoBulkStat(struct vcache *adp, long dirCookie, struct vrequest *areqp)
647 {
648     int nentries;               /* # of entries to prefetch */
649     int nskip;                  /* # of slots in the LRU queue to skip */
650 #ifdef AFS_DARWIN80_ENV
651     int npasses = 0;
652     struct vnode *lruvp;
653 #endif
654     struct vcache *lruvcp;      /* vcache ptr of our goal pos in LRU queue */
655     struct dcache *dcp;         /* chunk containing the dir block */
656     afs_size_t temp;            /* temp for holding chunk length, &c. */
657     struct AFSFid *fidsp;       /* file IDs were collecting */
658     struct AFSCallBack *cbsp;   /* call back pointers */
659     struct AFSCallBack *tcbp;   /* temp callback ptr */
660     struct AFSFetchStatus *statsp;      /* file status info */
661     struct AFSVolSync volSync;  /* vol sync return info */
662     struct vcache *tvcp;        /* temp vcp */
663     struct afs_q *tq;           /* temp queue variable */
664     AFSCBFids fidParm;          /* file ID parm for bulk stat */
665     AFSBulkStats statParm;      /* stat info parm for bulk stat */
666     int fidIndex = 0;           /* which file were stating */
667     struct afs_conn *tcp = 0;   /* conn for call */
668     AFSCBs cbParm;              /* callback parm for bulk stat */
669     struct server *hostp = 0;   /* host we got callback from */
670     long startTime;             /* time we started the call,
671                                  * for callback expiration base
672                                  */
673     afs_size_t statSeqNo = 0;   /* Valued of file size to detect races */
674     int code;                   /* error code */
675     long newIndex;              /* new index in the dir */
676     struct DirEntry *dirEntryp; /* dir entry we are examining */
677     int i;
678     struct VenusFid afid;       /* file ID we are using now */
679     struct VenusFid tfid;       /* another temp. file ID */
680     afs_int32 retry;            /* handle low-level SGI MP race conditions */
681     long volStates;             /* flags from vol structure */
682     struct volume *volp = 0;    /* volume ptr */
683     struct VenusFid dotdot = {0, {0, 0, 0}};
684     int flagIndex = 0;          /* First file with bulk fetch flag set */
685     int inlinebulk = 0;         /* Did we use InlineBulk RPC or not? */
686     XSTATS_DECLS;
687     dotdot.Cell = 0;
688     dotdot.Fid.Unique = 0;
689     dotdot.Fid.Vnode = 0;
690
691     /* first compute some basic parameters.  We dont want to prefetch more
692      * than a fraction of the cache in any given call, and we want to preserve
693      * a portion of the LRU queue in any event, so as to avoid thrashing
694      * the entire stat cache (we will at least leave some of it alone).
695      * presently dont stat more than 1/8 the cache in any one call.      */
696     nentries = afs_cacheStats / 8;
697
698     /* dont bother prefetching more than one calls worth of info */
699     if (nentries > AFSCBMAX)
700         nentries = AFSCBMAX;
701
702     /* heuristic to make sure that things fit in 4K.  This means that
703      * we shouldnt make it any bigger than 47 entries.  I am typically
704      * going to keep it a little lower, since we don't want to load
705      * too much of the stat cache.
706      */
707     if (nentries > 30)
708         nentries = 30;
709
710     /* now, to reduce the stack size, well allocate two 4K blocks,
711      * one for fids and callbacks, and one for stat info.  Well set
712      * up our pointers to the memory from there, too.
713      */
714     statsp = (AFSFetchStatus *) 
715             osi_Alloc(AFSCBMAX * sizeof(AFSFetchStatus));
716     fidsp = (AFSFid *) osi_AllocLargeSpace(nentries * sizeof(AFSFid));
717     cbsp = (AFSCallBack *) 
718             osi_Alloc(AFSCBMAX * sizeof(AFSCallBack));
719
720     /* next, we must iterate over the directory, starting from the specified
721      * cookie offset (dirCookie), and counting out nentries file entries.
722      * We skip files that already have stat cache entries, since we
723      * dont want to bulk stat files that are already in the cache.
724      */
725   tagain:
726     code = afs_VerifyVCache(adp, areqp);
727     if (code)
728         goto done2;
729
730     dcp = afs_GetDCache(adp, (afs_size_t) 0, areqp, &temp, &temp, 1);
731     if (!dcp) {
732         code = ENOENT;
733         goto done2;
734     }
735
736     /* lock the directory cache entry */
737     ObtainReadLock(&adp->lock);
738     ObtainReadLock(&dcp->lock);
739
740     /*
741      * Make sure that the data in the cache is current. There are two
742      * cases we need to worry about:
743      * 1. The cache data is being fetched by another process.
744      * 2. The cache data is no longer valid
745      */
746     while ((adp->f.states & CStatd)
747            && (dcp->dflags & DFFetching)
748            && hsame(adp->f.m.DataVersion, dcp->f.versionNo)) {
749         afs_Trace4(afs_iclSetp, CM_TRACE_DCACHEWAIT, ICL_TYPE_STRING,
750                    __FILE__, ICL_TYPE_INT32, __LINE__, ICL_TYPE_POINTER, dcp,
751                    ICL_TYPE_INT32, dcp->dflags);
752         ReleaseReadLock(&dcp->lock);
753         ReleaseReadLock(&adp->lock);
754         afs_osi_Sleep(&dcp->validPos);
755         ObtainReadLock(&adp->lock);
756         ObtainReadLock(&dcp->lock);
757     }
758     if (!(adp->f.states & CStatd)
759         || !hsame(adp->f.m.DataVersion, dcp->f.versionNo)) {
760         ReleaseReadLock(&dcp->lock);
761         ReleaseReadLock(&adp->lock);
762         afs_PutDCache(dcp);
763         goto tagain;
764     }
765
766     /* Generate a sequence number so we can tell whether we should
767      * store the attributes when processing the response. This number is
768      * stored in the file size when we set the CBulkFetching bit. If the
769      * CBulkFetching is still set and this value hasn't changed, then
770      * we know we were the last to set CBulkFetching bit for this file,
771      * and it is safe to set the status information for this file.
772      */
773     statSeqNo = bulkStatCounter++;
774     /* ensure against wrapping */
775     if (statSeqNo == 0)
776         statSeqNo = bulkStatCounter++;
777
778     /* now we have dir data in the cache, so scan the dir page */
779     fidIndex = 0;
780     flagIndex = 0;
781     while (1) {                 /* Should probably have some constant bound */
782         /* look for first safe entry to examine in the directory.  BlobScan
783          * looks for a the 1st allocated dir after the dirCookie slot.
784          */
785         newIndex = BlobScan(dcp, (dirCookie >> 5));
786         if (newIndex == 0)
787             break;
788
789         /* remember the updated directory cookie */
790         dirCookie = newIndex << 5;
791
792         /* get a ptr to the dir entry */
793         dirEntryp =
794             (struct DirEntry *)afs_dir_GetBlob(dcp, newIndex);
795         if (!dirEntryp)
796             break;
797
798         /* dont copy more than we have room for */
799         if (fidIndex >= nentries) {
800             DRelease(dirEntryp, 0);
801             break;
802         }
803
804         /* now, if the dir entry looks good, copy it out to our list.  Vnode
805          * 0 means deleted, although it should also be free were it deleted.
806          */
807         if (dirEntryp->fid.vnode != 0) {
808             /* dont copy entries we have in our cache.  This check will
809              * also make us skip "." and probably "..", unless it has
810              * disappeared from the cache since we did our namei call.
811              */
812             tfid.Cell = adp->f.fid.Cell;
813             tfid.Fid.Volume = adp->f.fid.Fid.Volume;
814             tfid.Fid.Vnode = ntohl(dirEntryp->fid.vnode);
815             tfid.Fid.Unique = ntohl(dirEntryp->fid.vunique);
816             do {
817                 retry = 0;
818                 ObtainWriteLock(&afs_xvcache, 130);
819                 tvcp = afs_FindVCache(&tfid, &retry, IS_WLOCK /* no stats | LRU */ );
820                 if (tvcp && retry) {
821                     ReleaseWriteLock(&afs_xvcache);
822                     afs_PutVCache(tvcp);
823                 }
824             } while (tvcp && retry);
825             if (!tvcp) {        /* otherwise, create manually */
826                 tvcp = afs_NewBulkVCache(&tfid, hostp, statSeqNo);
827                 if (tvcp)
828                 {
829                         ObtainWriteLock(&tvcp->lock, 505);
830                         ReleaseWriteLock(&afs_xvcache);
831                         afs_RemoveVCB(&tfid);
832                         ReleaseWriteLock(&tvcp->lock);
833                 } else {
834                         ReleaseWriteLock(&afs_xvcache);
835                 }
836             } else {
837                 ReleaseWriteLock(&afs_xvcache);
838             }
839             if (!tvcp)
840             {
841                 DRelease(dirEntryp, 0);
842                 ReleaseReadLock(&dcp->lock);
843                 ReleaseReadLock(&adp->lock);
844                 afs_PutDCache(dcp);
845                 goto done;      /* can happen if afs_NewVCache fails */
846             }
847
848             /* WARNING: afs_DoBulkStat uses the Length field to store a
849              * sequence number for each bulk status request. Under no
850              * circumstances should afs_DoBulkStat store a sequence number
851              * if the new length will be ignored when afs_ProcessFS is
852              * called with new stats. */
853 #ifdef AFS_SGI_ENV
854             if (!(tvcp->f.states & CStatd)
855                 && (!((tvcp->f.states & CBulkFetching) &&
856                       (tvcp->f.m.Length != statSeqNo)))
857                 && (tvcp->execsOrWriters <= 0)
858                 && !afs_DirtyPages(tvcp)
859                 && !AFS_VN_MAPPED((vnode_t *) tvcp))
860 #else
861             if (!(tvcp->f.states & CStatd)
862                 && (!((tvcp->f.states & CBulkFetching) &&
863                       (tvcp->f.m.Length != statSeqNo)))
864                 && (tvcp->execsOrWriters <= 0)
865                 && !afs_DirtyPages(tvcp))
866 #endif
867
868             {
869                 /* this entry doesnt exist in the cache, and is not
870                  * already being fetched by someone else, so add it to the
871                  * list of file IDs to obtain.
872                  *
873                  * We detect a callback breaking race condition by checking the
874                  * CBulkFetching state bit and the value in the file size.
875                  * It is safe to set the status only if the CBulkFetching
876                  * flag is still set and the value in the file size does
877                  * not change. NewBulkVCache sets us up for the new ones.
878                  * Set up the rest here.
879                  *
880                  * Don't fetch status for dirty files. We need to
881                  * preserve the value of the file size. We could
882                  * flush the pages, but it wouldn't be worthwhile.
883                  */
884                 if (!(tvcp->f.states & CBulkFetching)) {
885                     tvcp->f.states |= CBulkFetching;
886                     tvcp->f.m.Length = statSeqNo;
887                 }
888                 memcpy((char *)(fidsp + fidIndex), (char *)&tfid.Fid,
889                        sizeof(*fidsp));
890                 fidIndex++;
891             }
892             afs_PutVCache(tvcp);
893         }
894
895         /* if dir vnode has non-zero entry */
896         /* move to the next dir entry by adding in the # of entries
897          * used by this dir entry.
898          */
899         temp = afs_dir_NameBlobs(dirEntryp->name) << 5;
900         DRelease(dirEntryp, 0);
901         if (temp <= 0)
902             break;
903         dirCookie += temp;
904     }                           /* while loop over all dir entries */
905
906     /* now release the dir lock and prepare to make the bulk RPC */
907     ReleaseReadLock(&dcp->lock);
908     ReleaseReadLock(&adp->lock);
909
910     /* release the chunk */
911     afs_PutDCache(dcp);
912
913     /* dont make a null call */
914     if (fidIndex == 0)
915         goto done;
916
917     do {
918         /* setup the RPC parm structures */
919         fidParm.AFSCBFids_len = fidIndex;
920         fidParm.AFSCBFids_val = fidsp;
921         statParm.AFSBulkStats_len = fidIndex;
922         statParm.AFSBulkStats_val = statsp;
923         cbParm.AFSCBs_len = fidIndex;
924         cbParm.AFSCBs_val = cbsp;
925
926         /* start the timer; callback expirations are relative to this */
927         startTime = osi_Time();
928
929         tcp = afs_Conn(&adp->f.fid, areqp, SHARED_LOCK);
930         if (tcp) {
931             hostp = tcp->parent->srvr->server;
932
933             for (i = 0; i < fidIndex; i++) {
934                 /* we must set tvcp->callback before the BulkStatus call, so
935                  * we can detect concurrent InitCallBackState's */
936
937                 afid.Cell = adp->f.fid.Cell;
938                 afid.Fid.Volume = adp->f.fid.Fid.Volume;
939                 afid.Fid.Vnode = fidsp[i].Vnode;
940                 afid.Fid.Unique = fidsp[i].Unique;
941
942                 do {
943                     retry = 0;
944                     ObtainReadLock(&afs_xvcache);
945                     tvcp = afs_FindVCache(&afid, &retry, 0 /* !stats&!lru */);
946                     ReleaseReadLock(&afs_xvcache);
947                 } while (tvcp && retry);
948
949                 if (!tvcp) {
950                     continue;
951                 }
952
953                 if ((tvcp->f.states & CBulkFetching) &&
954                      (tvcp->f.m.Length == statSeqNo)) {
955                     tvcp->callback = hostp;
956                 }
957
958                 afs_PutVCache(tvcp);
959                 tvcp = NULL;
960             }
961
962             XSTATS_START_TIME(AFS_STATS_FS_RPCIDX_BULKSTATUS);
963
964             if (!(tcp->parent->srvr->server->flags & SNO_INLINEBULK)) {
965             retryonce:
966                 RX_AFS_GUNLOCK();
967                 code =
968                     RXAFS_InlineBulkStatus(tcp->id, &fidParm, &statParm,
969                                            &cbParm, &volSync);
970                 RX_AFS_GLOCK();
971                 if (code == RXGEN_OPCODE) {
972                     tcp->parent->srvr->server->flags |= SNO_INLINEBULK;
973                     inlinebulk = 0;
974                     RX_AFS_GUNLOCK();
975                     code =
976                         RXAFS_BulkStatus(tcp->id, &fidParm, &statParm,
977                                          &cbParm, &volSync);
978                     RX_AFS_GLOCK();
979                 } else {
980                     inlinebulk = 1;
981                     if (!code && ((&statsp[0])->errorCode)) {
982                         /*
983                          * If this is an error needing retry, do so.
984                          * Retryable errors are all whole-volume or
985                          * whole-server.
986                          */
987                         if (afs_Analyze(tcp, (&statsp[0])->errorCode,
988                                         &adp->f.fid, areqp,
989                                         AFS_STATS_FS_RPCIDX_BULKSTATUS,
990                                         SHARED_LOCK, NULL) != 0)
991                             goto retryonce;
992                     }
993                 }
994             } else {
995                 inlinebulk = 0;
996                 RX_AFS_GUNLOCK();
997                 code =
998                     RXAFS_BulkStatus(tcp->id, &fidParm, &statParm, &cbParm,
999                                      &volSync);
1000                 RX_AFS_GLOCK();
1001             }
1002             XSTATS_END_TIME;
1003         } else
1004             code = -1;
1005     } while (afs_Analyze
1006              (tcp, code, &adp->f.fid, areqp, AFS_STATS_FS_RPCIDX_BULKSTATUS,
1007               SHARED_LOCK, NULL));
1008
1009     /* now, if we didnt get the info, bail out. */
1010     if (code)
1011         goto done;
1012
1013     /* we need vol flags to create the entries properly */
1014     dotdot.Fid.Volume = 0;
1015     volp = afs_GetVolume(&adp->f.fid, areqp, READ_LOCK);
1016     if (volp) {
1017         volStates = volp->states;
1018         if (volp->dotdot.Fid.Volume != 0)
1019             dotdot = volp->dotdot;
1020     } else
1021         volStates = 0;
1022
1023     /* find the place to merge the info into  We do this by skipping
1024      * nskip entries in the LRU queue.  The more we skip, the more
1025      * we preserve, since the head of the VLRU queue is the most recently
1026      * referenced file.
1027      */
1028   reskip:
1029     nskip = afs_cacheStats / 2; /* preserved fraction of the cache */
1030     ObtainReadLock(&afs_xvcache);
1031 #ifdef AFS_DARWIN80_ENV
1032  reskip2:
1033 #endif
1034     if (QEmpty(&VLRU)) {
1035         /* actually a serious error, probably should panic. Probably will 
1036          * panic soon, oh well. */
1037         ReleaseReadLock(&afs_xvcache);
1038         afs_warnuser("afs_DoBulkStat: VLRU empty!");
1039         goto done;
1040     }
1041     if ((VLRU.next->prev != &VLRU) || (VLRU.prev->next != &VLRU)) {
1042         refpanic("Bulkstat VLRU inconsistent");
1043     }
1044     for (tq = VLRU.next; tq != &VLRU; tq = QNext(tq)) {
1045         if (--nskip <= 0) {
1046 #ifdef AFS_DARWIN80_ENV
1047             if ((!(QTOV(tq)->f.states & CDeadVnode)&&!(QTOV(tq)->f.states & CVInit)))
1048 #endif
1049                 break;
1050         }
1051         if (QNext(QPrev(tq)) != tq) {
1052             BStvc = QTOV(tq);
1053             refpanic("BulkStat VLRU inconsistent");
1054         }
1055     }
1056     if (tq != &VLRU)
1057         lruvcp = QTOV(tq);
1058     else
1059         lruvcp = QTOV(VLRU.next);
1060
1061     /* now we have to hold this entry, so that it does not get moved
1062      * into the free list while we're running.  It could still get
1063      * moved within the lru queue, but hopefully that will be rare; it
1064      * doesn't hurt nearly as much.
1065      */
1066     retry = 0;
1067 #ifdef AFS_DARWIN80_ENV
1068     if (((lruvcp->f.states & CDeadVnode)||(lruvcp->f.states & CVInit))) {
1069         if (npasses == 0) {
1070             nskip = 1;
1071             npasses++;
1072             goto reskip2;
1073         } else
1074             panic("Can't find non-dead vnode in VLRU\n");
1075     }
1076     lruvp = AFSTOV(lruvcp);
1077     if (vnode_get(lruvp))       /* this bumps ref count */
1078         retry = 1;
1079     else if (vnode_ref(lruvp)) {
1080         AFS_GUNLOCK();
1081         /* AFSTOV(lruvcp) may be NULL */
1082         vnode_put(lruvp);
1083         AFS_GLOCK();
1084         retry = 1;
1085     }
1086 #else
1087     osi_vnhold(lruvcp, &retry);
1088 #endif
1089     ReleaseReadLock(&afs_xvcache);      /* could be read lock */
1090     if (retry)
1091         goto reskip;
1092
1093     /* otherwise, merge in the info.  We have to be quite careful here,
1094      * since we need to ensure that we don't merge old info over newer
1095      * stuff in a stat cache entry.  We're very conservative here: we don't
1096      * do the merge at all unless we ourselves create the stat cache
1097      * entry.  That's pretty safe, and should work pretty well, since we
1098      * typically expect to do the stat cache creation ourselves.
1099      *
1100      * We also have to take into account racing token revocations.
1101      */
1102     for (i = 0; i < fidIndex; i++) {
1103         if ((&statsp[i])->errorCode)
1104             continue;
1105         afid.Cell = adp->f.fid.Cell;
1106         afid.Fid.Volume = adp->f.fid.Fid.Volume;
1107         afid.Fid.Vnode = fidsp[i].Vnode;
1108         afid.Fid.Unique = fidsp[i].Unique;
1109         do {
1110             retry = 0;
1111             ObtainReadLock(&afs_xvcache);
1112             tvcp = afs_FindVCache(&afid, &retry, FIND_CDEAD /* !stats&!lru */);
1113             ReleaseReadLock(&afs_xvcache);
1114         } while (tvcp && retry);
1115
1116         /* The entry may no longer exist */
1117         if (tvcp == NULL) {
1118             continue;
1119         }
1120
1121         /* now we have the entry held, but we need to fill it in */
1122         ObtainWriteLock(&tvcp->lock, 131);
1123
1124         /* if CBulkFetching is not set, or if the file size no longer
1125          * matches the value we placed there when we set the CBulkFetching
1126          * flag, then someone else has done something with this node,
1127          * and we may not have the latest status information for this
1128          * file.  Leave the entry alone.
1129          */
1130         if (!(tvcp->f.states & CBulkFetching) || (tvcp->f.m.Length != statSeqNo)) {
1131             flagIndex++;
1132             ReleaseWriteLock(&tvcp->lock);
1133             afs_PutVCache(tvcp);
1134             continue;
1135         }
1136
1137         /* now copy ".." entry back out of volume structure, if necessary */
1138         if (tvcp->mvstat == 2 && (dotdot.Fid.Volume != 0)) {
1139             if (!tvcp->mvid)
1140                 tvcp->mvid = (struct VenusFid *)
1141                     osi_AllocSmallSpace(sizeof(struct VenusFid));
1142             *tvcp->mvid = dotdot;
1143         }
1144
1145 #ifdef AFS_DARWIN80_ENV
1146         if (((lruvcp->f.states & CDeadVnode)||(lruvcp->f.states & CVInit)))
1147             panic("vlru control point went dead\n");
1148 #endif
1149
1150         ObtainWriteLock(&afs_xvcache, 132);
1151         if ((VLRU.next->prev != &VLRU) || (VLRU.prev->next != &VLRU)) {
1152             refpanic("Bulkstat VLRU inconsistent2");
1153         }
1154         if ((QNext(QPrev(&tvcp->vlruq)) != &tvcp->vlruq)
1155             || (QPrev(QNext(&tvcp->vlruq)) != &tvcp->vlruq)) {
1156             refpanic("Bulkstat VLRU inconsistent4");
1157         }
1158         if ((QNext(QPrev(&lruvcp->vlruq)) != &lruvcp->vlruq)
1159             || (QPrev(QNext(&lruvcp->vlruq)) != &lruvcp->vlruq)) {
1160             refpanic("Bulkstat VLRU inconsistent5");
1161         }
1162
1163         if (tvcp != lruvcp) {   /* if they are == don't move it, don't corrupt vlru */
1164             QRemove(&tvcp->vlruq);
1165             QAdd(&lruvcp->vlruq, &tvcp->vlruq);
1166         }
1167
1168         if ((VLRU.next->prev != &VLRU) || (VLRU.prev->next != &VLRU)) {
1169             refpanic("Bulkstat VLRU inconsistent3");
1170         }
1171         if ((QNext(QPrev(&tvcp->vlruq)) != &tvcp->vlruq)
1172             || (QPrev(QNext(&tvcp->vlruq)) != &tvcp->vlruq)) {
1173             refpanic("Bulkstat VLRU inconsistent5");
1174         }
1175         if ((QNext(QPrev(&lruvcp->vlruq)) != &lruvcp->vlruq)
1176             || (QPrev(QNext(&lruvcp->vlruq)) != &lruvcp->vlruq)) {
1177             refpanic("Bulkstat VLRU inconsistent6");
1178         }
1179         ReleaseWriteLock(&afs_xvcache);
1180
1181         ObtainWriteLock(&afs_xcbhash, 494);
1182
1183         /* We need to check the flags again. We may have missed
1184          * something while we were waiting for a lock.
1185          */
1186         if (!(tvcp->f.states & CBulkFetching) || (tvcp->f.m.Length != statSeqNo)) {
1187             flagIndex++;
1188             ReleaseWriteLock(&tvcp->lock);
1189             ReleaseWriteLock(&afs_xcbhash);
1190             afs_PutVCache(tvcp);
1191             continue;
1192         }
1193
1194         /* now merge in the resulting status back into the vnode.
1195          * We only do this if the entry looks clear.
1196          */
1197         afs_ProcessFS(tvcp, &statsp[i], areqp);
1198 #if defined(AFS_LINUX22_ENV)
1199         afs_fill_inode(AFSTOV(tvcp), NULL);     /* reset inode operations */
1200 #endif
1201
1202         /* do some accounting for bulk stats: mark this entry as
1203          * loaded, so we can tell if we use it before it gets
1204          * recycled.
1205          */
1206         tvcp->f.states |= CBulkStat;
1207         tvcp->f.states &= ~CBulkFetching;
1208         flagIndex++;
1209         afs_bulkStatsDone++;
1210
1211         /* merge in vol info */
1212         if (volStates & VRO)
1213             tvcp->f.states |= CRO;
1214         if (volStates & VBackup)
1215             tvcp->f.states |= CBackup;
1216         if (volStates & VForeign)
1217             tvcp->f.states |= CForeign;
1218
1219         /* merge in the callback info */
1220         tvcp->f.states |= CTruth;
1221
1222         /* get ptr to the callback we are interested in */
1223         tcbp = cbsp + i;
1224
1225         if (tcbp->ExpirationTime != 0) {
1226             tvcp->cbExpires = tcbp->ExpirationTime + startTime;
1227             tvcp->callback = hostp;
1228             tvcp->f.states |= CStatd;
1229             afs_QueueCallback(tvcp, CBHash(tcbp->ExpirationTime), volp);
1230         } else if (tvcp->f.states & CRO) {
1231             /* ordinary callback on a read-only volume -- AFS 3.2 style */
1232             tvcp->cbExpires = 3600 + startTime;
1233             tvcp->callback = hostp;
1234             tvcp->f.states |= CStatd;
1235             afs_QueueCallback(tvcp, CBHash(3600), volp);
1236         } else {
1237             tvcp->callback = 0;
1238             tvcp->f.states &= ~(CStatd | CUnique);
1239             afs_DequeueCallback(tvcp);
1240             if ((tvcp->f.states & CForeign) || (vType(tvcp) == VDIR))
1241                 osi_dnlc_purgedp(tvcp); /* if it (could be) a directory */
1242         }
1243 #ifdef AFS_DARWIN80_ENV
1244         /* reclaim->FlushVCache will need xcbhash */
1245         if (((tvcp->f.states & CDeadVnode)||(tvcp->f.states & CVInit))) {
1246             ReleaseWriteLock(&afs_xcbhash);
1247             /* passing in a parent hangs getting the vnode lock */
1248             code = afs_darwin_finalizevnode(tvcp, NULL, NULL, 0, 1);
1249             if (code) {
1250                 /* It's gonna get recycled - shouldn't happen */
1251                 tvcp->callback = 0;
1252                 tvcp->f.states &= ~(CStatd | CUnique);
1253                 afs_DequeueCallback(tvcp);
1254                 if ((tvcp->f.states & CForeign) || (vType(tvcp) == VDIR))
1255                     osi_dnlc_purgedp(tvcp); /* if it (could be) a directory */
1256             } else {
1257                 /* re-acquire the usecount that finalizevnode disposed of */
1258                 vnode_ref(AFSTOV(tvcp));
1259             }
1260         } else
1261 #endif
1262         ReleaseWriteLock(&afs_xcbhash);
1263
1264         ReleaseWriteLock(&tvcp->lock);
1265         /* finally, we're done with the entry */
1266         afs_PutVCache(tvcp);
1267     }                           /* for all files we got back */
1268
1269     /* finally return the pointer into the LRU queue */
1270 #ifdef AFS_DARWIN80_ENV
1271     if (((lruvcp->f.states & CDeadVnode)||(lruvcp->f.states & CVInit)))
1272         panic("vlru control point went dead before put\n");
1273     AFS_GUNLOCK();
1274     vnode_put(lruvp);
1275     vnode_rele(lruvp);
1276     AFS_GLOCK();
1277 #else
1278     afs_PutVCache(lruvcp);
1279 #endif
1280
1281   done:
1282     /* Be sure to turn off the CBulkFetching flags */
1283     for (i = flagIndex; i < fidIndex; i++) {
1284         afid.Cell = adp->f.fid.Cell;
1285         afid.Fid.Volume = adp->f.fid.Fid.Volume;
1286         afid.Fid.Vnode = fidsp[i].Vnode;
1287         afid.Fid.Unique = fidsp[i].Unique;
1288         do {
1289             retry = 0;
1290             ObtainReadLock(&afs_xvcache);
1291             tvcp = afs_FindVCache(&afid, &retry, FIND_CDEAD /* !stats&!lru */);
1292             ReleaseReadLock(&afs_xvcache);
1293         } while (tvcp && retry);
1294         if (tvcp != NULL) {
1295             if ((tvcp->f.states & CBulkFetching)
1296                 && (tvcp->f.m.Length == statSeqNo)) {
1297                 tvcp->f.states &= ~CBulkFetching;
1298             }
1299             afs_PutVCache(tvcp);
1300         }
1301     }
1302     if (volp)
1303         afs_PutVolume(volp, READ_LOCK);
1304
1305     /* If we did the InlineBulk RPC pull out the return code */
1306     if (inlinebulk && code == 0) {
1307         if ((&statsp[0])->errorCode) {
1308             afs_Analyze(tcp, (&statsp[0])->errorCode, &adp->f.fid, areqp,
1309                         AFS_STATS_FS_RPCIDX_BULKSTATUS, SHARED_LOCK, NULL);
1310             code = (&statsp[0])->errorCode;
1311         }
1312     } else {
1313         code = 0;
1314     }
1315   done2:
1316     osi_FreeLargeSpace((char *)fidsp);
1317     osi_Free((char *)statsp, AFSCBMAX * sizeof(AFSFetchStatus));
1318     osi_Free((char *)cbsp, AFSCBMAX * sizeof(AFSCallBack));
1319     return code;
1320 }
1321
1322 /* was: (AFS_DEC_ENV) || defined(AFS_OSF30_ENV) || defined(AFS_NCR_ENV) */
1323 static int AFSDOBULK = 1;
1324
1325 static_inline int
1326 osi_lookup_isdot(const char *aname)
1327 {
1328 #ifdef AFS_SUN5_ENV
1329     if (!aname[0]) {
1330         /* in Solaris, we can get passed "" as a path component if we are the
1331          * root directory, e.g. after a call to chroot. It is equivalent to
1332          * looking up "." */
1333         return 1;
1334     }
1335 #endif /* AFS_SUN5_ENV */
1336     if (aname[0] == '.' && !aname[1]) {
1337         return 1;
1338     }
1339     return 0;
1340 }
1341
1342 int
1343 #if defined(AFS_SUN5_ENV) || defined(AFS_SGI_ENV)
1344 afs_lookup(OSI_VC_DECL(adp), char *aname, struct vcache **avcp, struct pathname *pnp, int flags, struct vnode *rdir, afs_ucred_t *acred)
1345 #elif defined(UKERNEL)
1346 afs_lookup(OSI_VC_DECL(adp), char *aname, struct vcache **avcp, afs_ucred_t *acred, int flags)
1347 #else
1348 afs_lookup(OSI_VC_DECL(adp), char *aname, struct vcache **avcp, afs_ucred_t *acred)
1349 #endif
1350 {
1351     struct vrequest treq;
1352     char *tname = NULL;
1353     struct vcache *tvc = 0;
1354     afs_int32 code;
1355     afs_int32 bulkcode = 0;
1356     int pass = 0, hit = 0;
1357     int force_eval = afs_fakestat_enable ? 0 : 1;
1358     long dirCookie;
1359     extern afs_int32 afs_mariner;       /*Writing activity to log? */
1360     afs_hyper_t versionNo;
1361     int no_read_access = 0;
1362     struct sysname_info sysState;       /* used only for @sys checking */
1363     int dynrootRetry = 1;
1364     struct afs_fakestat_state fakestate;
1365     int tryEvalOnly = 0;
1366     OSI_VC_CONVERT(adp);
1367
1368     AFS_STATCNT(afs_lookup);
1369     afs_InitFakeStat(&fakestate);
1370
1371     AFS_DISCON_LOCK();
1372     
1373     if ((code = afs_InitReq(&treq, acred)))
1374         goto done;
1375
1376     if (afs_fakestat_enable && adp->mvstat == 1) {
1377        if (strcmp(aname, ".directory") == 0)
1378            tryEvalOnly = 1;
1379     }
1380
1381 #if defined(AFS_DARWIN_ENV)
1382     /* Workaround for MacOSX Finder, which tries to look for
1383      * .DS_Store and Contents under every directory.
1384      */
1385     if (afs_fakestat_enable && adp->mvstat == 1) {
1386         if (strcmp(aname, ".DS_Store") == 0)
1387             tryEvalOnly = 1;
1388         if (strcmp(aname, "Contents") == 0)
1389             tryEvalOnly = 1;
1390     }
1391     if (afs_fakestat_enable && adp->mvstat == 2) {
1392         if (strncmp(aname, "._", 2) == 0)
1393             tryEvalOnly = 1;
1394     }
1395 #endif
1396
1397     if (tryEvalOnly)
1398         code = afs_TryEvalFakeStat(&adp, &fakestate, &treq);
1399     else
1400         code = afs_EvalFakeStat(&adp, &fakestate, &treq);
1401
1402     /*printf("Code is %d\n", code);*/
1403     
1404     if (tryEvalOnly && adp->mvstat == 1)
1405         code = ENOENT;
1406     if (code)
1407         goto done;
1408
1409     *avcp = NULL;               /* Since some callers don't initialize it */
1410
1411     /* come back to here if we encounter a non-existent object in a read-only
1412      * volume's directory */
1413
1414   redo:
1415     *avcp = NULL;               /* Since some callers don't initialize it */
1416     bulkcode = 0;
1417
1418     if (!(adp->f.states & CStatd) && !afs_InReadDir(adp)) {
1419         if ((code = afs_VerifyVCache2(adp, &treq))) {
1420             goto done;
1421         }
1422     } else
1423         code = 0;
1424
1425     /* watch for ".." in a volume root */
1426     if (adp->mvstat == 2 && aname[0] == '.' && aname[1] == '.' && !aname[2]) {
1427         /* looking up ".." in root via special hacks */
1428         if (adp->mvid == (struct VenusFid *)0 || adp->mvid->Fid.Volume == 0) {
1429             code = ENODEV;
1430             goto done;
1431         }
1432         /* otherwise we have the fid here, so we use it */
1433         /*printf("Getting vcache\n");*/
1434         tvc = afs_GetVCache(adp->mvid, &treq, NULL, NULL);
1435         afs_Trace3(afs_iclSetp, CM_TRACE_GETVCDOTDOT, ICL_TYPE_FID, adp->mvid,
1436                    ICL_TYPE_POINTER, tvc, ICL_TYPE_INT32, code);
1437         *avcp = tvc;
1438         code = (tvc ? 0 : ENOENT);
1439         hit = 1;
1440         if (tvc && !VREFCOUNT_GT(tvc, 0)) {
1441             osi_Panic("TT1");
1442         }
1443         if (code) {
1444             /*printf("LOOKUP GETVCDOTDOT -> %d\n", code); */
1445         }
1446         goto done;
1447     }
1448
1449     /* now check the access */
1450     if (treq.uid != adp->last_looker) {
1451         if (!afs_AccessOK(adp, PRSFS_LOOKUP, &treq, CHECK_MODE_BITS)) {
1452             *avcp = NULL;
1453             code = EACCES;
1454             goto done;
1455         } else
1456             adp->last_looker = treq.uid;
1457     }
1458
1459     /* Check for read access as well.  We need read access in order to
1460      * stat files, but not to stat subdirectories. */
1461     if (!afs_AccessOK(adp, PRSFS_READ, &treq, CHECK_MODE_BITS))
1462         no_read_access = 1;
1463
1464     /* special case lookup of ".".  Can we check for it sooner in this code,
1465      * for instance, way up before "redo:" ??
1466      * I'm not fiddling with the LRUQ here, either, perhaps I should, or else 
1467      * invent a lightweight version of GetVCache.
1468      */
1469     if (osi_lookup_isdot(aname)) {      /* special case */
1470         ObtainReadLock(&afs_xvcache);
1471         osi_vnhold(adp, 0);
1472         ReleaseReadLock(&afs_xvcache);
1473 #ifdef AFS_DARWIN80_ENV
1474         vnode_get(AFSTOV(adp));
1475 #endif
1476         code = 0;
1477         *avcp = tvc = adp;
1478         hit = 1;
1479         if (adp && !VREFCOUNT_GT(adp, 0)) {
1480             osi_Panic("TT2");
1481         }
1482         goto done;
1483     }
1484
1485     /*
1486      * Special case lookup of ".." in the dynamic mount directory.
1487      * The parent of this directory is _always_ the AFS root volume.
1488      */
1489     if (afs_IsDynrootMount(adp) &&
1490         aname[0] == '.' && aname[1] == '.' && !aname[2]) {
1491
1492         ObtainReadLock(&afs_xvcache);
1493         osi_vnhold(afs_globalVp, 0);
1494         ReleaseReadLock(&afs_xvcache);
1495 #ifdef AFS_DARWIN80_ENV
1496         vnode_get(AFSTOV(afs_globalVp));
1497 #endif
1498         code = 0;
1499         *avcp = tvc = afs_globalVp;
1500         hit = 1;
1501         goto done;
1502     }
1503
1504     /*
1505      * Special case lookups in the dynamic mount directory.
1506      * The names here take the form cell:volume, similar to a mount point.
1507      * EvalMountData parses that and returns a cell and volume ID, which
1508      * we use to construct the appropriate dynroot Fid.
1509      */
1510     if (afs_IsDynrootMount(adp)) {
1511         struct VenusFid tfid;
1512         afs_uint32 cellidx, volid, vnoid, uniq;
1513
1514         code = EvalMountData('%', aname, 0, 0, NULL, &treq, &cellidx, &volid, &vnoid, &uniq);
1515         if (code)
1516             goto done;
1517         /* If a vnode was returned, it's not a real mount point */
1518         if (vnoid > 1) {
1519             struct cell *tcell = afs_GetCellByIndex(cellidx, READ_LOCK);
1520             tfid.Cell = tcell->cellNum;
1521             afs_PutCell(tcell, READ_LOCK);
1522             tfid.Fid.Vnode = vnoid;
1523             tfid.Fid.Volume = volid;
1524             tfid.Fid.Unique = uniq;
1525         } else {
1526             afs_GetDynrootMountFid(&tfid);
1527             tfid.Fid.Vnode = VNUM_FROM_TYPEID(VN_TYPE_MOUNT, cellidx << 2);
1528             tfid.Fid.Unique = volid;
1529         }
1530         *avcp = tvc = afs_GetVCache(&tfid, &treq, NULL, NULL);
1531         code = (tvc ? 0 : ENOENT);
1532         hit = 1;
1533         goto done;
1534     }
1535
1536 #ifdef AFS_LINUX26_ENV
1537     /*
1538      * Special case of the dynamic mount volume in a static root.
1539      * This is really unfortunate, but we need this for the translator.
1540      */
1541     if (adp == afs_globalVp && !afs_GetDynrootEnable() &&
1542         !strcmp(aname, AFS_DYNROOT_MOUNTNAME)) {
1543         struct VenusFid tfid;
1544
1545         afs_GetDynrootMountFid(&tfid);
1546         *avcp = tvc = afs_GetVCache(&tfid, &treq, NULL, NULL);
1547         code = 0;
1548         hit = 1;
1549         goto done;
1550     }
1551 #endif
1552
1553     Check_AtSys(adp, aname, &sysState, &treq);
1554     tname = sysState.name;
1555
1556     /* 1st Check_AtSys and lookup by tname is required here, for now,
1557      * because the dnlc is *not* told to remove entries for the parent
1558      * dir of file/dir op that afs_LocalHero likes, but dnlc is informed
1559      * if the cached entry for the parent dir is invalidated for a
1560      * non-local change.
1561      * Otherwise, we'd be able to do a dnlc lookup on an entry ending
1562      * w/@sys and know the dnlc was consistent with reality. */
1563     tvc = osi_dnlc_lookup(adp, tname, WRITE_LOCK);
1564     *avcp = tvc;                /* maybe wasn't initialized, but it is now */
1565     if (tvc) {
1566         if (no_read_access && vType(tvc) != VDIR && vType(tvc) != VLNK) {
1567             /* need read access on dir to stat non-directory / non-link */
1568             afs_PutVCache(tvc);
1569             *avcp = NULL;
1570             code = EACCES;
1571             goto done;
1572         }
1573 #ifdef AFS_LINUX22_ENV
1574         if (tvc->mvstat == 2) { /* we don't trust the dnlc for root vcaches */
1575             AFS_RELE(AFSTOV(tvc));
1576             *avcp = 0;
1577         } else {
1578             code = 0;
1579             hit = 1;
1580             goto done;
1581         }
1582 #else /* non - LINUX */
1583         code = 0;
1584         hit = 1;
1585         goto done;
1586 #endif /* linux22 */
1587     }
1588
1589     {                           /* sub-block just to reduce stack usage */
1590         struct dcache *tdc;
1591         afs_size_t dirOffset, dirLen;
1592         struct VenusFid tfid;
1593
1594         /* now we have to lookup the next fid */
1595         if (afs_InReadDir(adp))
1596             tdc = adp->dcreaddir;
1597         else
1598             tdc = afs_GetDCache(adp, (afs_size_t) 0, &treq,
1599                                 &dirOffset, &dirLen, 1);
1600         if (!tdc) {
1601             *avcp = NULL;       /* redundant, but harmless */
1602             code = EIO;
1603             goto done;
1604         }
1605
1606         /* now we will just call dir package with appropriate inode.
1607          * Dirs are always fetched in their entirety for now */
1608         ObtainReadLock(&adp->lock);
1609         ObtainReadLock(&tdc->lock);
1610
1611         /*
1612          * Make sure that the data in the cache is current. There are two
1613          * cases we need to worry about:
1614          * 1. The cache data is being fetched by another process.
1615          * 2. The cache data is no longer valid
1616          *
1617          * If a readdir is in progress _in this thread_, it has a shared
1618          * lock on the vcache and has obtained current data, so we just
1619          * use that.  This eliminates several possible deadlocks.  
1620          */
1621         if (!afs_InReadDir(adp)) {
1622             while ((adp->f.states & CStatd)
1623                    && (tdc->dflags & DFFetching)
1624                    && hsame(adp->f.m.DataVersion, tdc->f.versionNo)) {
1625                 ReleaseReadLock(&tdc->lock);
1626                 ReleaseReadLock(&adp->lock);
1627                 afs_osi_Sleep(&tdc->validPos);
1628                 ObtainReadLock(&adp->lock);
1629                 ObtainReadLock(&tdc->lock);
1630             }
1631             if (!(adp->f.states & CStatd)
1632                 || !hsame(adp->f.m.DataVersion, tdc->f.versionNo)) {
1633                 ReleaseReadLock(&tdc->lock);
1634                 ReleaseReadLock(&adp->lock);
1635                 afs_PutDCache(tdc);
1636                 if (tname && tname != aname)
1637                     osi_FreeLargeSpace(tname);
1638                 goto redo;
1639             }
1640         }
1641
1642         /* Save the version number for when we call osi_dnlc_enter */
1643         hset(versionNo, tdc->f.versionNo);
1644
1645         /*
1646          * check for, and handle "@sys" if it's there.  We should be able
1647          * to avoid the alloc and the strcpy with a little work, but it's
1648          * not pressing.  If there aren't any remote users (ie, via the 
1649          * NFS translator), we have a slightly easier job.
1650          * the faster way to do this is to check for *aname == '@' and if 
1651          * it's there, check for @sys, otherwise, assume there's no @sys 
1652          * then, if the lookup fails, check for .*@sys...
1653          */
1654         /* above now implemented by Check_AtSys and Next_AtSys */
1655
1656         /* lookup the name in the appropriate dir, and return a cache entry
1657          * on the resulting fid */
1658         code =
1659             afs_dir_LookupOffset(tdc, sysState.name, &tfid.Fid,
1660                                  &dirCookie);
1661
1662         /* If the first lookup doesn't succeed, maybe it's got @sys in the name */
1663         while (code == ENOENT && Next_AtSys(adp, &treq, &sysState))
1664             code =
1665                 afs_dir_LookupOffset(tdc, sysState.name, &tfid.Fid,
1666                                      &dirCookie);
1667         tname = sysState.name;
1668
1669         ReleaseReadLock(&tdc->lock);
1670         if (!afs_InReadDir(adp))
1671             afs_PutDCache(tdc);
1672         if (code == ENOENT && afs_IsDynroot(adp) && dynrootRetry && !tryEvalOnly) {
1673             struct cell *tc;
1674             char *cn = (tname[0] == '.') ? tname + 1 : tname;
1675             ReleaseReadLock(&adp->lock);
1676             /* confirm it's not just hushed */
1677             tc = afs_GetCellByName(cn, WRITE_LOCK);
1678             if (tc) {
1679                 if (tc->states & CHush) {
1680                     tc->states &= ~CHush;
1681                     ReleaseWriteLock(&tc->lock);
1682                     afs_DynrootInvalidate();
1683                     goto redo;
1684                 }
1685                 ReleaseWriteLock(&tc->lock);
1686             }
1687             /* Allow a second dynroot retry if the cell was hushed before */
1688             dynrootRetry = 0;
1689             if (tname[0] == '.')
1690                 afs_LookupAFSDB(tname + 1);
1691             else
1692                 afs_LookupAFSDB(tname);
1693             if (tname && tname != aname)
1694                 osi_FreeLargeSpace(tname);
1695             goto redo;
1696         } else {
1697             ReleaseReadLock(&adp->lock);
1698         }
1699
1700         /* new fid has same cell and volume */
1701         tfid.Cell = adp->f.fid.Cell;
1702         tfid.Fid.Volume = adp->f.fid.Fid.Volume;
1703         afs_Trace4(afs_iclSetp, CM_TRACE_LOOKUP, ICL_TYPE_POINTER, adp,
1704                    ICL_TYPE_STRING, tname, ICL_TYPE_FID, &tfid,
1705                    ICL_TYPE_INT32, code);
1706
1707         if (code) {
1708             if (code != ENOENT) {
1709                 /*printf("LOOKUP dirLookupOff -> %d\n", code);*/
1710             }
1711             goto done;
1712         }
1713
1714         /* prefetch some entries, if the dir is currently open.  The variable
1715          * dirCookie tells us where to start prefetching from.
1716          */
1717         if (!AFS_IS_DISCONNECTED && 
1718             AFSDOBULK && adp->opens > 0 && !(adp->f.states & CForeign)
1719             && !afs_IsDynroot(adp) && !afs_InReadDir(adp)) {
1720             afs_int32 retry;
1721             /* if the entry is not in the cache, or is in the cache,
1722              * but hasn't been statd, then do a bulk stat operation.
1723              */
1724             do {
1725                 retry = 0;
1726                 ObtainReadLock(&afs_xvcache);
1727                 tvc = afs_FindVCache(&tfid, &retry, 0 /* !stats,!lru */ );
1728                 ReleaseReadLock(&afs_xvcache);
1729             } while (tvc && retry);
1730
1731             if (!tvc || !(tvc->f.states & CStatd))
1732                 bulkcode = afs_DoBulkStat(adp, dirCookie, &treq);
1733             else
1734                 bulkcode = 0;
1735
1736             /* if the vcache isn't usable, release it */
1737             if (tvc && !(tvc->f.states & CStatd)) {
1738                 afs_PutVCache(tvc);
1739                 tvc = NULL;
1740             }
1741         } else {
1742             tvc = NULL;
1743             bulkcode = 0;
1744         }
1745
1746         /* now get the status info, if we don't already have it */
1747         /* This is kind of weird, but we might wind up accidentally calling
1748          * RXAFS_Lookup because we happened upon a file which legitimately
1749          * has a 0 uniquifier. That is the result of allowing unique to wrap
1750          * to 0. This was fixed in AFS 3.4. For CForeign, Unique == 0 means that
1751          * the file has not yet been looked up.
1752          */
1753         if (!tvc) {
1754             afs_int32 cached = 0;
1755             if (!tfid.Fid.Unique && (adp->f.states & CForeign)) {
1756                 tvc = afs_LookupVCache(&tfid, &treq, &cached, adp, tname);
1757             }
1758             if (!tvc && !bulkcode) {    /* lookup failed or wasn't called */
1759                 tvc = afs_GetVCache(&tfid, &treq, &cached, NULL);
1760             }
1761         }                       /* if !tvc */
1762     }                           /* sub-block just to reduce stack usage */
1763
1764     if (tvc) {
1765         if (adp->f.states & CForeign)
1766             tvc->f.states |= CForeign;
1767         tvc->f.parent.vnode = adp->f.fid.Fid.Vnode;
1768         tvc->f.parent.unique = adp->f.fid.Fid.Unique;
1769         tvc->f.states &= ~CBulkStat;
1770
1771         if (afs_fakestat_enable == 2 && tvc->mvstat == 1) {
1772             ObtainSharedLock(&tvc->lock, 680);
1773             if (!tvc->linkData) {
1774                 UpgradeSToWLock(&tvc->lock, 681);
1775                 code = afs_HandleLink(tvc, &treq);
1776                 ConvertWToRLock(&tvc->lock);
1777             } else {
1778                 ConvertSToRLock(&tvc->lock);
1779                 code = 0;
1780             }
1781             if (!code && !afs_strchr(tvc->linkData, ':'))
1782                 force_eval = 1;
1783             ReleaseReadLock(&tvc->lock);
1784         }
1785         if (tvc->mvstat == 1 && (tvc->f.states & CMValid) && tvc->mvid != NULL)
1786           force_eval = 1; /* This is now almost for free, get it correct */
1787
1788 #if defined(UKERNEL) && defined(AFS_WEB_ENHANCEMENTS)
1789         if (!(flags & AFS_LOOKUP_NOEVAL))
1790             /* don't eval mount points */
1791 #endif /* UKERNEL && AFS_WEB_ENHANCEMENTS */
1792             if (tvc->mvstat == 1 && force_eval) {
1793                 /* a mt point, possibly unevaluated */
1794                 struct volume *tvolp;
1795
1796                 ObtainWriteLock(&tvc->lock, 133);
1797                 code = EvalMountPoint(tvc, adp, &tvolp, &treq);
1798                 ReleaseWriteLock(&tvc->lock);
1799
1800                 if (code) {
1801                     afs_PutVCache(tvc);
1802                     if (tvolp)
1803                         afs_PutVolume(tvolp, WRITE_LOCK);
1804                     goto done;
1805                 }
1806
1807                 /* next, we want to continue using the target of the mt point */
1808                 if (tvc->mvid && (tvc->f.states & CMValid)) {
1809                     struct vcache *uvc;
1810                     /* now lookup target, to set .. pointer */
1811                     afs_Trace2(afs_iclSetp, CM_TRACE_LOOKUP1,
1812                                ICL_TYPE_POINTER, tvc, ICL_TYPE_FID,
1813                                &tvc->f.fid);
1814                     uvc = tvc;  /* remember for later */
1815
1816                     if (tvolp && (tvolp->states & VForeign)) {
1817                         /* XXXX tvolp has ref cnt on but not locked! XXX */
1818                         tvc =
1819                             afs_GetRootVCache(tvc->mvid, &treq, NULL, tvolp);
1820                     } else {
1821                         tvc = afs_GetVCache(tvc->mvid, &treq, NULL, NULL);
1822                     }
1823                     afs_PutVCache(uvc); /* we're done with it */
1824
1825                     if (!tvc) {
1826                         code = ENOENT;
1827                         if (tvolp) {
1828                             afs_PutVolume(tvolp, WRITE_LOCK);
1829                         }
1830                         goto done;
1831                     }
1832
1833                     /* now, if we came via a new mt pt (say because of a new
1834                      * release of a R/O volume), we must reevaluate the ..
1835                      * ptr to point back to the appropriate place */
1836                     if (tvolp) {
1837                         ObtainWriteLock(&tvc->lock, 134);
1838                         if (tvc->mvid == NULL) {
1839                             tvc->mvid = (struct VenusFid *)
1840                                 osi_AllocSmallSpace(sizeof(struct VenusFid));
1841                         }
1842                         /* setup backpointer */
1843                         *tvc->mvid = tvolp->dotdot;
1844                         ReleaseWriteLock(&tvc->lock);
1845                         afs_PutVolume(tvolp, WRITE_LOCK);
1846                     }
1847                 } else {
1848                     afs_PutVCache(tvc);
1849                     code = ENOENT;
1850                     if (tvolp)
1851                         afs_PutVolume(tvolp, WRITE_LOCK);
1852                     goto done;
1853                 }
1854             }
1855         *avcp = tvc;
1856         if (tvc && !VREFCOUNT_GT(tvc, 0)) {
1857             osi_Panic("TT3");
1858         }
1859         code = 0;
1860     } else {
1861         /* if we get here, we found something in a directory that couldn't
1862          * be located (a Multics "connection failure").  If the volume is
1863          * read-only, we try flushing this entry from the cache and trying
1864          * again. */
1865         if (!AFS_IS_DISCONNECTED) {
1866             if (pass == 0) {
1867                 struct volume *tv;
1868                 tv = afs_GetVolume(&adp->f.fid, &treq, READ_LOCK);
1869                 if (tv) {
1870                     if (tv->states & VRO) {
1871                         pass = 1;       /* try this *once* */
1872                         ObtainWriteLock(&afs_xcbhash, 495);
1873                         afs_DequeueCallback(adp);
1874                         /* re-stat to get later version */
1875                         adp->f.states &= ~CStatd;
1876                         ReleaseWriteLock(&afs_xcbhash);
1877                         osi_dnlc_purgedp(adp);
1878                         afs_PutVolume(tv, READ_LOCK);
1879                         goto redo;
1880                     }
1881                     afs_PutVolume(tv, READ_LOCK);
1882                 }
1883             }
1884             code = ENOENT;
1885         } else {
1886             code = ENETDOWN;
1887         }
1888     }
1889
1890   done:
1891     /* put the network buffer back, if need be */
1892     if (tname != aname && tname)
1893         osi_FreeLargeSpace(tname);
1894     if (code == 0) {
1895
1896         if (afs_mariner)
1897             afs_AddMarinerName(aname, tvc);
1898
1899 #if defined(UKERNEL) && defined(AFS_WEB_ENHANCEMENTS)
1900         if (!(flags & AFS_LOOKUP_NOEVAL)) {
1901             /* Here we don't enter the name into the DNLC because we want the
1902              * evaluated mount dir to be there (the vcache for the mounted
1903              * volume) rather than the vc of the mount point itself.  We can
1904              * still find the mount point's vc in the vcache by its fid. */
1905 #endif /* UKERNEL && AFS_WEB_ENHANCEMENTS */
1906             if (!hit && force_eval) {
1907                 osi_dnlc_enter(adp, aname, tvc, &versionNo);
1908             } else {
1909 #ifdef AFS_LINUX20_ENV
1910                 /* So Linux inode cache is up to date. */
1911                 code = afs_VerifyVCache(tvc, &treq);
1912 #else
1913                 afs_PutFakeStat(&fakestate);
1914                 AFS_DISCON_UNLOCK();
1915                 return 0;       /* can't have been any errors if hit and !code */
1916 #endif
1917             }
1918 #if defined(UKERNEL) && defined(AFS_WEB_ENHANCEMENTS)
1919         }
1920 #endif
1921     }
1922     if (bulkcode)
1923         code = bulkcode;
1924
1925     code = afs_CheckCode(code, &treq, 19);
1926     if (code) {
1927         /* If there is an error, make sure *avcp is null.
1928          * Alphas panic otherwise - defect 10719.
1929          */
1930         *avcp = NULL;
1931     }
1932
1933     afs_PutFakeStat(&fakestate);
1934     AFS_DISCON_UNLOCK();
1935     return code;
1936 }