53ed8aa172dd49f04acf1f043b76be02e6fc9650
[openafs.git] / src / afs / afs_vcache.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_FlushVCache
13  * afs_AllocCBR
14  * afs_FreeCBR
15  * afs_FlushVCBs
16  * afs_QueueVCB
17  * afs_RemoveVCB
18  * afs_NewVCache
19  * afs_FlushActiveVcaches
20  * afs_VerifyVCache2
21  * afs_WriteVCache
22  * afs_SimpleVStat
23  * afs_ProcessFS
24  * TellALittleWhiteLie
25  * afs_RemoteLookup
26  * afs_GetVCache
27  * afs_LookupVCache
28  * afs_GetRootVCache
29  * afs_FetchStatus
30  * afs_StuffVcache
31  * afs_PutVCache
32  * afs_FindVCache
33  * afs_NFSFindVCache
34  * afs_vcacheInit
35  * shutdown_vcache
36  *
37  */
38 #include <afsconfig.h>
39 #include "../afs/param.h"
40
41 RCSID("$Header$");
42
43 #include "../afs/sysincludes.h" /*Standard vendor system headers*/
44 #include "../afs/afsincludes.h" /*AFS-based standard headers*/
45 #include "../afs/afs_stats.h"
46 #include "../afs/afs_cbqueue.h"
47 #include "../afs/afs_osidnlc.h"
48
49 #ifdef AFS_OSF_ENV
50 afs_int32 afs_maxvcount = 0;            /* max number of vcache entries */
51 afs_int32 afs_vcount = 0;                       /* number of vcache in use now */
52 #if     defined(AFS_OSF30_ENV)
53 extern int max_vnodes;                  /* number of total system vnodes */
54 #else
55 extern int nvnode;                      /* number of total system vnodes */
56 #endif 
57 #ifndef AFS_OSF30_ENV
58 extern int numvnodes;                   /* number vnodes in use now */ 
59 #endif
60 #endif /* AFS_OSF_ENV */
61 #ifdef AFS_SGI_ENV
62 int afsvnumbers = 0;
63 #endif
64
65 /* Imported variables */
66 extern struct server *afs_servers[NSERVERS];
67 extern afs_rwlock_t afs_xserver;
68 extern afs_rwlock_t afs_xcbhash;
69 extern struct vcache *afs_globalVp;
70 #ifdef AFS_OSF_ENV
71 extern struct mount *afs_globalVFS;
72 extern struct vnodeops Afs_vnodeops;
73 #elif defined(AFS_DARWIN_ENV)
74 extern struct mount *afs_globalVFS;
75 #else
76 extern struct vfs *afs_globalVFS;
77 #endif /* AFS_OSF_ENV */
78 #if     defined(AFS_DUX40_ENV)
79 extern struct vfs_ubcops afs_ubcops;
80 #endif
81 #ifdef AFS_SGI62_ENV
82 extern struct vnodeops Afs_vnodeops;
83 #endif
84 #ifdef AFS_SGI64_ENV
85 char *makesname();
86 #endif /* AFS_SGI64_ENV */
87  
88 /* Exported variables */
89 afs_rwlock_t afs_xvcache;               /*Lock: alloc new stat cache entries*/
90 afs_lock_t afs_xvcb;                    /*Lock: fids on which there are callbacks*/
91 struct vcache *freeVCList;              /*Free list for stat cache entries*/
92 struct vcache *Initial_freeVCList;      /*Initial list for above*/
93 struct afs_q VLRU;                      /*vcache LRU*/
94 afs_int32 vcachegen = 0;
95 unsigned int afs_paniconwarn = 0;
96 struct vcache *afs_vhashT[VCSIZE];
97 afs_int32 afs_bulkStatsLost;
98 int afs_norefpanic = 0;
99
100 /* Forward declarations */
101 static afs_int32 afs_QueueVCB(struct vcache *avc);
102
103
104 /*
105  * afs_FlushVCache
106  *
107  * Description:
108  *      Flush the given vcache entry.
109  *
110  * Parameters:
111  *      avc : Pointer to vcache entry to flush.
112  *      slept : Pointer to int to set 1 if we sleep/drop locks, 0 if we don't.
113  *
114  * Environment:
115  *      afs_xvcache lock must be held for writing upon entry to
116  *      prevent people from changing the vrefCount field, and to
117  *      protect the lruq and hnext fields.
118  * LOCK: afs_FlushVCache afs_xvcache W 
119  * REFCNT: vcache ref count must be zero on entry except for osf1
120  * RACE: lock is dropped and reobtained, permitting race in caller
121  */
122
123 int afs_FlushVCache(struct vcache *avc, int *slept)
124 { /*afs_FlushVCache*/
125
126     register afs_int32 i, code;
127     register struct vcache **uvc, *wvc, *tvc;
128
129     *slept = 0;
130     AFS_STATCNT(afs_FlushVCache);
131     afs_Trace2(afs_iclSetp, CM_TRACE_FLUSHV, ICL_TYPE_POINTER, avc,
132                ICL_TYPE_INT32, avc->states);
133 #ifdef  AFS_OSF_ENV
134     AFS_GUNLOCK();
135     VN_LOCK((struct vnode *)avc);
136     AFS_GLOCK();
137 #endif
138
139     code = osi_VM_FlushVCache(avc, slept);
140     if (code)
141         goto bad;
142
143     if (avc->states & CVFlushed) {
144         code = EBUSY;
145         goto bad;
146     }
147     if (avc->nextfree || !avc->vlruq.prev || !avc->vlruq.next) { /* qv afs.h */
148       refpanic ("LRU vs. Free inconsistency");
149     }
150     avc->states |= CVFlushed;
151     /* pull the entry out of the lruq and put it on the free list */
152     QRemove(&avc->vlruq);
153     avc->vlruq.prev = avc->vlruq.next = (struct afs_q *) 0;
154
155     /* keep track of # of files that we bulk stat'd, but never used
156      * before they got recycled.
157      */
158     if (avc->states & CBulkStat)
159         afs_bulkStatsLost++;
160     vcachegen++;
161     /* remove entry from the hash chain */
162     i = VCHash(&avc->fid);
163     uvc = &afs_vhashT[i];
164     for(wvc = *uvc; wvc; uvc = &wvc->hnext, wvc = *uvc) {
165         if (avc == wvc) {
166             *uvc = avc->hnext;
167             avc->hnext = (struct vcache *) NULL;
168             break;
169         }
170     }
171     if (!wvc) osi_Panic("flushvcache"); /* not in correct hash bucket */
172     if (avc->mvid) osi_FreeSmallSpace(avc->mvid);
173     avc->mvid = (struct VenusFid*)0;
174     if (avc->linkData) {
175       afs_osi_Free(avc->linkData, strlen(avc->linkData)+1);
176       avc->linkData = NULL;
177     }
178     afs_FreeAllAxs(&(avc->Access));
179
180     /* we can't really give back callbacks on RO files, since the 
181      * server only tracks them on a per-volume basis, and we don't
182      * know whether we still have some other files from the same
183      * volume. */
184     if ((avc->states & CRO) == 0 && avc->callback) {
185         afs_QueueVCB(avc);
186     }
187     ObtainWriteLock(&afs_xcbhash, 460);
188     afs_DequeueCallback(avc);  /* remove it from queued callbacks list */
189     avc->states &= ~(CStatd | CUnique);
190     ReleaseWriteLock(&afs_xcbhash);
191     afs_symhint_inval(avc);
192     if ((avc->states & CForeign) || (avc->fid.Fid.Vnode & 1)) 
193       osi_dnlc_purgedp (avc);  /* if it (could be) a directory */
194     else 
195       osi_dnlc_purgevp (avc);
196
197     /*
198      * Next, keep track of which vnodes we've deleted for create's
199      * optimistic synchronization algorithm
200      */
201     afs_allZaps++;
202     if (avc->fid.Fid.Vnode & 1) afs_oddZaps++;
203     else afs_evenZaps++;
204
205 #if     !defined(AFS_OSF_ENV)
206     /* put the entry in the free list */
207     avc->nextfree = freeVCList;
208     freeVCList = avc;
209     if (avc->vlruq.prev || avc->vlruq.next) {
210        refpanic ("LRU vs. Free inconsistency");
211     }
212 #else 
213     /* This should put it back on the vnode free list since usecount is 1 */
214     afs_vcount--;
215     vSetType(avc, VREG);
216     if (VREFCOUNT(avc) > 0) {
217         VN_UNLOCK((struct vnode *)avc);
218         AFS_RELE((struct vnode *)avc);
219     } else {
220        if (afs_norefpanic) {
221           printf ("flush vc refcnt < 1");
222           afs_norefpanic++;
223           (void) vgone(avc, VX_NOSLEEP, (struct vnodeops *) 0);
224           AFS_GLOCK();
225           VN_UNLOCK((struct vnode *)avc);
226        }
227        else osi_Panic ("flush vc refcnt < 1");
228     }
229 #endif  /* AFS_OSF_ENV */
230     avc->states |= CVFlushed;
231     return 0;
232
233 bad:
234 #ifdef  AFS_OSF_ENV
235     VN_UNLOCK((struct vnode *)avc);
236 #endif
237     return code;
238
239 } /*afs_FlushVCache*/
240
241 #ifndef AFS_SGI_ENV
242 /*
243  * afs_InactiveVCache
244  *
245  * The core of the inactive vnode op for all but IRIX.
246  */
247 void afs_InactiveVCache(struct vcache *avc, struct AFS_UCRED *acred)
248 {
249     extern afs_rwlock_t afs_xdcache, afs_xvcache;
250     
251     AFS_STATCNT(afs_inactive);
252     if (avc->states & CDirty) {
253       /* we can't keep trying to push back dirty data forever.  Give up. */
254       afs_InvalidateAllSegments(avc, 1/*set lock*/);  /* turns off dirty bit */
255     }
256     avc->states &= ~CMAPPED;    /* mainly used by SunOS 4.0.x */
257     avc->states &= ~CDirty;     /* Turn it off */
258     if (avc->states & CUnlinked) {
259         if (CheckLock(&afs_xvcache) || CheckLock(&afs_xdcache)) { 
260             avc->states |= CUnlinkedDel;
261             return; 
262         }
263         afs_remunlink(avc, 1);  /* ignore any return code */
264     }
265
266 }
267 #endif
268
269 /*
270  * afs_AllocCBR
271  *
272  * Description: allocate a callback return structure from the
273  * free list and return it.
274  *
275  * Env: The alloc and free routines are both called with the afs_xvcb lock
276  * held, so we don't have to worry about blocking in osi_Alloc.
277  */
278 static struct afs_cbr *afs_cbrSpace = 0;
279 struct afs_cbr *afs_AllocCBR() {
280     register struct afs_cbr *tsp;
281     int i;
282
283     while (!afs_cbrSpace) {
284         if (afs_stats_cmperf.CallBackAlloced >= 2) {
285             /* don't allocate more than 2 * AFS_NCBRS for now */
286             afs_FlushVCBs(0);
287             afs_stats_cmperf.CallBackFlushes++;
288         }
289         else {
290             /* try allocating */
291             tsp = (struct afs_cbr *) afs_osi_Alloc(AFS_NCBRS * sizeof(struct afs_cbr));
292             for(i=0; i < AFS_NCBRS-1; i++) {
293                 tsp[i].next = &tsp[i+1];
294             }
295             tsp[AFS_NCBRS-1].next = 0;
296             afs_cbrSpace = tsp;
297             afs_stats_cmperf.CallBackAlloced++;
298         }
299     }
300     tsp = afs_cbrSpace;
301     afs_cbrSpace = tsp->next;
302     return tsp;
303 }
304
305 /*
306  * afs_FreeCBR
307  *
308  * Description: free a callback return structure.
309  *
310  * Parameters:
311  *      asp -- the address of the structure to free.
312  *
313  * Environment: the xvcb lock is held over these calls.
314  */
315 afs_FreeCBR(asp)
316 register struct afs_cbr *asp; {
317     asp->next = afs_cbrSpace;
318     afs_cbrSpace = asp;
319     return 0;
320 }
321
322 /*
323  * afs_FlushVCBs
324  *
325  * Description: flush all queued callbacks to all servers.
326  *
327  * Parameters: none.
328  *
329  * Environment: holds xvcb lock over RPC to guard against race conditions
330  *      when a new callback is granted for the same file later on.
331  */
332 afs_int32 afs_FlushVCBs (afs_int32 lockit) 
333 {
334     struct AFSFid tfids[AFS_MAXCBRSCALL];
335     struct AFSCallBack callBacks[1];
336     struct AFSCBFids fidArray;
337     struct AFSCBs cbArray;
338     afs_int32 code;
339     struct afs_cbr *tcbrp;
340     int tcount;
341     struct server *tsp;
342     int i;
343     struct vrequest treq;
344     struct conn *tc;
345     int safety1, safety2, safety3;
346     extern int afs_totalServers;
347     XSTATS_DECLS
348
349     if (code = afs_InitReq(&treq, &afs_osi_cred)) return code;
350     treq.flags |= O_NONBLOCK;
351
352     if (lockit) MObtainWriteLock(&afs_xvcb,273);
353     ObtainReadLock(&afs_xserver);
354     for(i=0; i<NSERVERS; i++) {
355         for(safety1 = 0, tsp = afs_servers[i];
356             tsp && safety1 < afs_totalServers+10; tsp=tsp->next, safety1++) { 
357             /* don't have any */
358             if (tsp->cbrs == (struct afs_cbr *) 0) continue;
359
360             /* otherwise, grab a block of AFS_MAXCBRSCALL from the list
361              * and make an RPC, over and over again.
362              */
363             tcount = 0; /* number found so far */
364             for (safety2 = 0; safety2 < afs_cacheStats ; safety2++) {
365                 if (tcount >= AFS_MAXCBRSCALL || !tsp->cbrs) {
366                     /* if buffer is full, or we've queued all we're going
367                      * to from this server, we should flush out the
368                      * callbacks.
369                      */
370                     fidArray.AFSCBFids_len = tcount;
371                     fidArray.AFSCBFids_val = (struct AFSFid *) tfids;
372                     cbArray.AFSCBs_len = 1;
373                     cbArray.AFSCBs_val = callBacks;
374                     callBacks[0].CallBackType = CB_EXCLUSIVE;
375                     for (safety3 = 0; safety3 < MAXHOSTS*2; safety3++) {
376                         tc = afs_ConnByHost(tsp, tsp->cell->fsport,
377                                             tsp->cell->cell, &treq, 0,
378                                             SHARED_LOCK);
379                         if (tc) {
380                           XSTATS_START_TIME(AFS_STATS_FS_RPCIDX_GIVEUPCALLBACKS);
381 #ifdef RX_ENABLE_LOCKS
382                           AFS_GUNLOCK();
383 #endif /* RX_ENABLE_LOCKS */
384                           code = RXAFS_GiveUpCallBacks(tc->id, &fidArray,
385                                                        &cbArray);
386 #ifdef RX_ENABLE_LOCKS
387                           AFS_GLOCK();
388 #endif /* RX_ENABLE_LOCKS */
389                           XSTATS_END_TIME;
390                         }
391                         else code = -1;
392                         if (!afs_Analyze(tc, code, 0, &treq,
393                                      AFS_STATS_FS_RPCIDX_GIVEUPCALLBACKS,
394                                      SHARED_LOCK, tsp->cell)) {
395                            break;
396                         }
397                     }
398                     /* ignore return code, since callbacks may have
399                      * been returned anyway, we shouldn't leave them
400                      * around to be returned again.
401                      *
402                      * Next, see if we are done with this server, and if so,
403                      * break to deal with the next one.
404                      */
405                     if (!tsp->cbrs) break;
406                     tcount = 0;
407                 }       /* if to flush full buffer */
408                 /* if we make it here, we have an entry at the head of cbrs,
409                  * which we should copy to the file ID array and then free.
410                  */
411                 tcbrp = tsp->cbrs;
412                 tfids[tcount++] = tcbrp->fid;
413                 tsp->cbrs = tcbrp->next;
414                 afs_FreeCBR(tcbrp);
415             }           /* while loop for this one server */
416             if (safety2 > afs_cacheStats) {
417               afs_warn("possible internal error afs_flushVCBs (%d)\n", safety2);
418             }
419         }               /* for loop for this hash chain */
420     }                   /* loop through all hash chains */
421     if (safety1 > afs_totalServers+2)  {
422        afs_warn("AFS internal error (afs_flushVCBs) (%d > %d), continuing...\n", safety1, afs_totalServers+2);
423        if (afs_paniconwarn)
424          osi_Panic("afs_flushVCBS safety1");
425     }
426
427     ReleaseReadLock(&afs_xserver);
428     if (lockit) MReleaseWriteLock(&afs_xvcb);
429     return 0;
430 }
431
432 /*
433  * afs_QueueVCB
434  *
435  * Description:
436  *      Queue a callback on the given fid.
437  *
438  * Parameters:
439  *      avc: vcache entry
440  *
441  * Environment:
442  *      Locks the xvcb lock.
443  *      Called when the xvcache lock is already held.
444  */
445
446 static afs_int32 afs_QueueVCB(struct vcache *avc)
447 {
448     register struct server *tsp;
449     register struct afs_cbr *tcbp;
450
451     AFS_STATCNT(afs_QueueVCB);
452     /* The callback is really just a struct server ptr. */
453     tsp = (struct server *)(avc->callback);
454
455     /* we now have a pointer to the server, so we just allocate
456      * a queue entry and queue it.
457      */
458     MObtainWriteLock(&afs_xvcb,274);
459     tcbp = afs_AllocCBR();
460     tcbp->fid = avc->fid.Fid;
461     tcbp->next = tsp->cbrs;
462     tsp->cbrs = tcbp;
463
464     /* now release locks and return */
465     MReleaseWriteLock(&afs_xvcb);
466     return 0;
467 }
468
469
470 /*
471  * afs_RemoveVCB
472  *
473  * Description:
474  *      Remove a queued callback by looking through all the servers
475  *      to see if any have this callback queued.
476  *
477  * Parameters:
478  *      afid: The fid we want cleansed of queued callbacks.
479  *
480  * Environment:
481  *      Locks xvcb and xserver locks.
482  *      Typically called with xdcache, xvcache and/or individual vcache
483  *      entries locked.
484  */
485
486 afs_RemoveVCB(afid)
487     register struct VenusFid *afid;
488
489 { /*afs_RemoveVCB*/
490
491     register int i, j;
492     register struct server *tsp;
493     register struct afs_cbr *tcbrp;
494     struct afs_cbr **lcbrpp;
495
496     AFS_STATCNT(afs_RemoveVCB);
497     MObtainWriteLock(&afs_xvcb,275);
498     ObtainReadLock(&afs_xserver);
499     for(i=0;i<NSERVERS;i++) {
500         for(tsp=afs_servers[i]; tsp; tsp=tsp->next) {
501             /* if cell is known, and is wrong, then skip this server */
502             if (tsp->cell && tsp->cell->cell != afid->Cell) continue;
503
504             /*
505              * Otherwise, iterate through file IDs we're sending to the
506              * server.
507              */
508             lcbrpp = &tsp->cbrs;        /* first queued return callback */
509             for(tcbrp = *lcbrpp; tcbrp; lcbrpp = &tcbrp->next, tcbrp = *lcbrpp) {
510                 if (afid->Fid.Volume == tcbrp->fid.Volume &&
511                     afid->Fid.Unique == tcbrp->fid.Unique &&
512                     afid->Fid.Vnode == tcbrp->fid.Vnode) {
513                     *lcbrpp = tcbrp->next;      /* unthread from list */
514                     afs_FreeCBR(tcbrp);
515                     goto done;
516                 }
517             }
518         }
519     }
520   done:
521     ReleaseReadLock(&afs_xserver);
522     MReleaseWriteLock(&afs_xvcb);
523     return 0;
524
525 } /*afs_RemoveVCB*/
526
527
528
529 /*
530  * afs_NewVCache
531  *
532  * Description:
533  *      This routine is responsible for allocating a new cache entry
534  *      from the free list.  It formats the cache entry and inserts it
535  *      into the appropriate hash tables.  It must be called with
536  *      afs_xvcache write-locked so as to prevent several processes from
537  *      trying to create a new cache entry simultaneously.
538  *
539  * Parameters:
540  *      afid  : The file id of the file whose cache entry is being
541  *              created.
542  */
543 /* LOCK: afs_NewVCache  afs_xvcache W */ 
544 struct vcache *afs_NewVCache(struct VenusFid *afid, struct server *serverp,
545                              afs_int32 lockit, afs_int32 locktype)
546 {
547     struct vcache *tvc;
548     afs_int32 i;
549     afs_int32 anumber = VCACHE_FREE;
550 #ifdef  AFS_AIX_ENV
551     struct gnode *gnodepnt;
552 #endif
553 #ifdef  AFS_MACH_ENV
554     struct vm_info * vm_info_ptr;
555 #endif /* AFS_MACH_ENV */
556 #ifdef  AFS_OSF_ENV
557     struct vcache *nvc;
558 #endif  /* AFS_OSF_ENV */
559     struct afs_q *tq, *uq;
560     int code, fv_slept;
561
562     AFS_STATCNT(afs_NewVCache);
563 #ifdef AFS_LINUX22_ENV
564     if (!freeVCList) {
565         /* Free some if possible. */
566          struct afs_q *tq, *uq;
567          int i; char *panicstr;
568          int vmax = 2 * afs_cacheStats;
569          int vn = VCACHE_FREE;
570
571          AFS_GUNLOCK();
572          shrink_dcache_sb(afs_globalVFS);
573          AFS_GLOCK();
574
575          i = 0;
576          for(tq = VLRU.prev; tq != &VLRU && vn > 0; tq = uq) {
577             tvc = QTOV(tq);
578             uq = QPrev(tq);
579             if (tvc->states & CVFlushed) 
580                  refpanic ("CVFlushed on VLRU");
581             else if (i++ > vmax)
582                  refpanic ("Exceeded pool of AFS vnodes(VLRU cycle?)");
583             else if (QNext(uq) != tq)
584                  refpanic ("VLRU inconsistent");
585
586             if (tvc == afs_globalVp)
587                 continue;
588
589             if ( VREFCOUNT(tvc) && tvc->opens == 0 ) {
590                 struct inode *ip = (struct inode*)tvc;
591                 if (list_empty(&ip->i_dentry)) {
592                     vn --;
593                 }
594                 else {
595                     struct list_head *cur;
596                     struct list_head *head = &ip->i_dentry;
597                     int all = 1;
598                 restart:
599 #if defined(AFS_LINUX24_ENV)
600                     spin_lock(&dcache_lock);
601 #endif
602                     cur = head;
603                     while ((cur = cur->next) != head) {
604                         struct dentry *dentry = list_entry(cur, struct dentry, d_alias);
605 #if defined(AFS_LINUX24_ENV)
606                         if (!atomic_read(&dentry->d_count)) {
607 #else
608                         if (!dentry->d_count) {
609 #endif
610                             AFS_GUNLOCK();
611 #if defined(AFS_LINUX24_ENV)
612                             dget_locked(dentry);
613                             spin_unlock(&dcache_lock);
614 #else
615                             dget(dentry);
616 #endif
617                             d_drop(dentry);
618                             dput(dentry);
619                             AFS_GLOCK();
620                             goto restart;
621                         }
622                         else {
623                             all = 0;
624                         }
625                     }
626 #if defined(AFS_LINUX24_ENV)
627                     spin_unlock(&dcache_lock);
628 #endif
629                     if (all) vn --;
630                 }
631             }
632             if (tq == uq) break;
633          }
634     }
635 #endif /* AFS_LINUX22_ENV */
636 #ifdef  AFS_OSF_ENV
637 #ifdef  AFS_OSF30_ENV
638     if (afs_vcount >= afs_maxvcount) 
639 #else
640     /*
641      * If we are using > 33 % of the total system vnodes for AFS vcache
642      * entries or we are using the maximum number of vcache entries,
643      * then free some.  (if our usage is > 33% we should free some, if
644      * our usage is > afs_maxvcount, set elsewhere to 0.5*nvnode, 
645      * we _must_ free some -- no choice).
646      */
647     if ( (( 3 * afs_vcount ) > nvnode) || ( afs_vcount >= afs_maxvcount ))
648 #endif
649        {
650          struct afs_q *tq, *uq;
651          int i; char *panicstr;
652
653          i = 0;
654          for(tq = VLRU.prev; tq != &VLRU && anumber > 0; tq = uq) {
655             tvc = QTOV(tq);
656             uq = QPrev(tq);
657             if (tvc->states & CVFlushed) 
658                  refpanic ("CVFlushed on VLRU");
659             else if (i++ > afs_maxvcount)
660                  refpanic ("Exceeded pool of AFS vnodes(VLRU cycle?)");
661             else if (QNext(uq) != tq)
662                  refpanic ("VLRU inconsistent");
663             else if (VREFCOUNT(tvc) < 1) 
664                  refpanic ("refcnt 0 on VLRU");
665
666             if ( VREFCOUNT(tvc) == 1   &&   tvc->opens == 0 
667                 && (tvc->states & CUnlinkedDel) == 0) {
668                 code = afs_FlushVCache(tvc, &fv_slept);
669                 if (code == 0) {
670                   anumber--;
671                 }
672                 if (fv_slept) {
673                   uq = VLRU.prev;
674                   i = 0;
675                   continue;  /* start over - may have raced. */
676                 }
677             }
678             if (tq == uq) break;
679          }
680          if (anumber == VCACHE_FREE) {
681             printf("NewVCache: warning none freed, using %d of %d\n", 
682                    afs_vcount, afs_maxvcount);
683             if (afs_vcount >= afs_maxvcount) {
684                 osi_Panic("NewVCache - none freed");
685                 /* XXX instead of panicing, should do afs_maxvcount++ 
686                    and magic up another one */
687             }
688          }
689       }
690
691     AFS_GUNLOCK();
692     if (getnewvnode(MOUNT_AFS, &Afs_vnodeops, &nvc)) {
693         /* What should we do ???? */
694         osi_Panic("afs_NewVCache: no more vnodes");
695     }
696     AFS_GLOCK();
697
698     tvc = nvc;
699     tvc->nextfree = (struct vcache *)0; 
700     afs_vcount++;
701 #else   /* AFS_OSF_ENV */
702     /* pull out a free cache entry */
703     if (!freeVCList) {
704         i = 0;
705         for(tq = VLRU.prev; (anumber > 0) && (tq != &VLRU); tq = uq) {
706            tvc = QTOV(tq);
707            uq = QPrev(tq);
708
709            if (tvc->states & CVFlushed)
710                 refpanic("CVFlushed on VLRU");
711            else if (i++ > 2*afs_cacheStats) /* even allowing for a few xallocs...*/
712                 refpanic("Increase -stat parameter of afsd(VLRU cycle?)");
713            else if (QNext(uq) != tq)
714                 refpanic("VLRU inconsistent");
715
716 #ifdef AFS_DARWIN_ENV
717            if (tvc->opens == 0 && ((tvc->states & CUnlinkedDel) == 0) &&
718                 VREFCOUNT(tvc) == 1 && UBCINFOEXISTS(&tvc->v)) {
719                osi_VM_TryReclaim(tvc, &fv_slept);
720                if (fv_slept) {
721                   uq = VLRU.prev;
722                   i = 0;
723                   continue;  /* start over - may have raced. */
724                }
725             }
726 #endif
727            if (VREFCOUNT(tvc) == 0 && tvc->opens == 0
728                && (tvc->states & CUnlinkedDel) == 0) {
729                 code = afs_FlushVCache(tvc, &fv_slept);
730                 if (code == 0) {
731                   anumber--;
732                 }
733                 if (fv_slept) {
734                   uq = VLRU.prev;
735                   i = 0;
736                   continue;  /* start over - may have raced. */
737                 }
738            } 
739            if (tq == uq ) break;
740         }
741     }
742     if (!freeVCList) {
743         /* none free, making one is better than a panic */
744         afs_stats_cmperf.vcacheXAllocs++;       /* count in case we have a leak */
745         tvc = (struct vcache *) afs_osi_Alloc(sizeof (struct vcache));
746 #ifdef  AFS_AIX32_ENV
747         pin((char *)tvc, sizeof(struct vcache));        /* XXX */
748 #endif
749 #ifdef  AFS_MACH_ENV
750         /* In case it still comes here we need to fill this */
751         tvc->v.v_vm_info = VM_INFO_NULL;
752         vm_info_init(tvc->v.v_vm_info);
753         /* perhaps we should also do close_flush on non-NeXT mach systems;
754          * who knows; we don't currently have the sources.
755          */
756 #endif /* AFS_MACH_ENV */
757 #if defined(AFS_SGI_ENV)
758         { char name[METER_NAMSZ];
759         memset(tvc, 0, sizeof(struct vcache));
760         tvc->v.v_number = ++afsvnumbers;
761         tvc->vc_rwlockid = OSI_NO_LOCKID;
762         initnsema(&tvc->vc_rwlock, 1, makesname(name, "vrw", tvc->v.v_number));
763 #ifndef AFS_SGI53_ENV
764         initnsema(&tvc->v.v_sync, 0, makesname(name, "vsy", tvc->v.v_number));
765 #endif
766 #ifndef AFS_SGI62_ENV
767         initnlock(&tvc->v.v_lock, makesname(name, "vlk", tvc->v.v_number));
768 #endif
769         }
770 #endif /* AFS_SGI_ENV */
771     }
772     else {
773         tvc = freeVCList;   /* take from free list */
774         freeVCList = tvc->nextfree;
775         tvc->nextfree = (struct vcache *)0;
776     }
777 #endif  /* AFS_OSF_ENV */
778
779 #ifdef  AFS_MACH_ENV
780     vm_info_ptr = tvc->v.v_vm_info;
781 #endif /* AFS_MACH_ENV */
782
783 #if !defined(AFS_SGI_ENV) && !defined(AFS_OSF_ENV)
784     memset((char *)tvc, 0, sizeof(struct vcache));
785 #else
786     tvc->uncred = 0;
787 #endif
788
789     RWLOCK_INIT(&tvc->lock, "vcache lock");
790 #if     defined(AFS_SUN5_ENV)
791     RWLOCK_INIT(&tvc->vlock, "vcache vlock");
792 #endif /* defined(AFS_SUN5_ENV) */
793
794 #ifdef  AFS_MACH_ENV
795     tvc->v.v_vm_info = vm_info_ptr;
796     tvc->v.v_vm_info->pager = MEMORY_OBJECT_NULL;
797 #endif /* AFS_MACH_ENV */
798     tvc->parentVnode = 0;
799     tvc->mvid = (struct VenusFid *) 0;
800     tvc->linkData = (char *) 0;
801     tvc->cbExpires = 0;
802     tvc->opens = 0;
803     tvc->execsOrWriters = 0;
804     tvc->flockCount = 0;
805     tvc->anyAccess = 0;
806     tvc->states = 0;
807     tvc->last_looker = 0;
808     tvc->fid = *afid;
809     tvc->asynchrony = -1;
810     tvc->vc_error = 0;
811     afs_symhint_inval(tvc);
812 #ifdef AFS_TEXT_ENV
813     tvc->flushDV.low = tvc->flushDV.high =  AFS_MAXDV;
814 #endif
815     hzero(tvc->mapDV);
816     tvc->truncPos = AFS_NOTRUNC;        /* don't truncate until we need to */
817     hzero(tvc->m.DataVersion);          /* in case we copy it into flushDV */
818 #ifdef  AFS_OSF_ENV
819     /* Hold it for the LRU (should make count 2) */
820     VN_HOLD((struct vnode *)tvc);
821 #else   /* AFS_OSF_ENV */
822     VREFCOUNT_SET(tvc, 1);      /* us */
823 #endif  /* AFS_OSF_ENV */
824 #ifdef  AFS_AIX32_ENV
825     LOCK_INIT(&tvc->pvmlock, "vcache pvmlock");
826     tvc->vmh = tvc->segid = NULL;
827     tvc->credp = NULL;
828 #endif
829 #if defined(AFS_SUN_ENV) || defined(AFS_ALPHA_ENV) || defined(AFS_SUN5_ENV)
830 #if     defined(AFS_SUN5_ENV)
831     rw_init(&tvc->rwlock, "vcache rwlock", RW_DEFAULT, NULL);
832
833 #if     defined(AFS_SUN55_ENV)
834         /* This is required if the kaio (kernel aynchronous io)
835         ** module is installed. Inside the kernel, the function
836         ** check_vp( common/os/aio.c) checks to see if the kernel has 
837         ** to provide asynchronous io for this vnode. This
838         ** function extracts the device number by following the
839         ** v_data field of the vnode. If we do not set this field
840         ** then the system panics. The  value of the v_data field
841         ** is not really important for AFS vnodes because the kernel
842         ** does not do asynchronous io for regular files. Hence,
843         ** for the time being, we fill up the v_data field with the
844         ** vnode pointer itself. */
845     tvc->v.v_data = (char *)tvc;
846 #endif /* AFS_SUN55_ENV */
847 #endif
848     afs_BozonInit(&tvc->pvnLock, tvc);
849 #endif
850
851     tvc->Access = NULL;
852     tvc->callback = serverp;    /* to minimize chance that clear
853                                    request is lost */
854     /* initialize vnode data, note vrefCount is v.v_count */
855 #ifdef  AFS_AIX_ENV
856     /* Don't forget to free the gnode space */
857     tvc->v.v_gnode = gnodepnt = (struct gnode *) osi_AllocSmallSpace(sizeof(struct gnode));
858     memset((char *)gnodepnt, 0, sizeof(struct gnode));
859 #endif
860 #ifdef AFS_SGI64_ENV
861     memset((void*)&(tvc->vc_bhv_desc), 0, sizeof(tvc->vc_bhv_desc));
862     bhv_desc_init(&(tvc->vc_bhv_desc), tvc, tvc, &Afs_vnodeops);
863 #ifdef AFS_SGI65_ENV
864     vn_bhv_head_init(&(tvc->v.v_bh), "afsvp");
865     vn_bhv_insert_initial(&(tvc->v.v_bh), &(tvc->vc_bhv_desc));
866 #else
867     bhv_head_init(&(tvc->v.v_bh));
868     bhv_insert_initial(&(tvc->v.v_bh), &(tvc->vc_bhv_desc));
869 #endif
870 #ifdef AFS_SGI65_ENV
871     tvc->v.v_mreg = tvc->v.v_mregb = (struct pregion*)tvc;
872 #ifdef VNODE_TRACING
873     tvc->v.v_trace = ktrace_alloc(VNODE_TRACE_SIZE, 0);
874 #endif
875     init_bitlock(&tvc->v.v_pcacheflag, VNODE_PCACHE_LOCKBIT, "afs_pcache",
876                  tvc->v.v_number);
877     init_mutex(&tvc->v.v_filocksem, MUTEX_DEFAULT, "afsvfl", (long)tvc);
878     init_mutex(&tvc->v.v_buf_lock, MUTEX_DEFAULT, "afsvnbuf", (long)tvc);
879 #endif
880     vnode_pcache_init(&tvc->v);
881 #if defined(DEBUG) && defined(VNODE_INIT_BITLOCK)
882     /* Above define is never true execpt in SGI test kernels. */
883     init_bitlock(&(tvc->v.v_flag, VLOCK, "vnode", tvc->v.v_number);
884 #endif
885 #ifdef INTR_KTHREADS
886     AFS_VN_INIT_BUF_LOCK(&(tvc->v));
887 #endif
888 #else
889     SetAfsVnode((struct vnode *)tvc);
890 #endif /* AFS_SGI64_ENV */
891 #ifdef AFS_DARWIN_ENV
892     tvc->v.v_ubcinfo = UBC_INFO_NULL;
893     lockinit(&tvc->rwlock, PINOD, "vcache rwlock", 0, 0);
894     cache_purge((struct vnode *)tvc); 
895     tvc->v.v_data=tvc;
896     tvc->v.v_tag=VT_AFS;
897     /* VLISTNONE(&tvc->v); */
898     tvc->v.v_freelist.tqe_next=0;
899     tvc->v.v_freelist.tqe_prev=(struct vnode **)0xdeadb;
900     /*tvc->vrefCount++;*/
901 #endif 
902     /*
903      * The proper value for mvstat (for root fids) is setup by the caller.
904      */
905     tvc->mvstat = 0;           
906     if (afid->Fid.Vnode == 1 && afid->Fid.Unique == 1)
907         tvc->mvstat = 2;   
908     if (afs_globalVFS == 0) osi_Panic("afs globalvfs");
909     vSetVfsp(tvc, afs_globalVFS);
910     vSetType(tvc, VREG);
911 #ifdef  AFS_AIX_ENV
912     tvc->v.v_vfsnext = afs_globalVFS->vfs_vnodes;   /* link off vfs */
913     tvc->v.v_vfsprev = NULL;
914     afs_globalVFS->vfs_vnodes = &tvc->v;
915     if (tvc->v.v_vfsnext != NULL)
916         tvc->v.v_vfsnext->v_vfsprev = &tvc->v;
917     tvc->v.v_next = gnodepnt->gn_vnode;  /*Single vnode per gnode for us!*/
918     gnodepnt->gn_vnode = &tvc->v;
919 #endif
920 #ifdef  AFS_DEC_ENV
921     tvc->v.g_dev = ((struct mount *)afs_globalVFS->vfs_data)->m_dev;
922 #endif
923 #if     defined(AFS_DUX40_ENV)
924     insmntque(tvc, afs_globalVFS, &afs_ubcops);
925 #else
926 #ifdef  AFS_OSF_ENV
927     /* Is this needed??? */
928     insmntque(tvc, afs_globalVFS);
929 #endif  /* AFS_OSF_ENV */
930 #endif  /* AFS_DUX40_ENV */
931 #if defined(AFS_SGI_ENV)
932     VN_SET_DPAGES(&(tvc->v), (struct pfdat*)NULL);
933     osi_Assert((tvc->v.v_flag & VINACT) == 0);
934     tvc->v.v_flag = 0;
935     osi_Assert(VN_GET_PGCNT(&(tvc->v)) == 0);
936     osi_Assert(tvc->mapcnt == 0 && tvc->vc_locktrips == 0);
937     osi_Assert(tvc->vc_rwlockid == OSI_NO_LOCKID);
938     osi_Assert(tvc->v.v_filocks == NULL);
939 #if !defined(AFS_SGI65_ENV)
940     osi_Assert(tvc->v.v_filocksem == NULL);
941 #endif
942     osi_Assert(tvc->cred == NULL);
943 #ifdef AFS_SGI64_ENV
944     vnode_pcache_reinit(&tvc->v);
945     tvc->v.v_rdev = NODEV;
946 #endif
947     vn_initlist((struct vnlist *)&tvc->v);
948     tvc->lastr = 0;
949 #endif /* AFS_SGI_ENV */
950 #if defined(AFS_LINUX22_ENV)
951     {
952         struct inode *ip = (struct inode*)tvc;
953         sema_init(&ip->i_sem, 1);
954 #if defined(AFS_LINUX24_ENV)
955         sema_init(&ip->i_zombie, 1);
956         init_waitqueue_head(&ip->i_wait);
957         spin_lock_init(&ip->i_data.i_shared_lock);
958 #ifdef STRUCT_ADDRESS_SPACE_HAS_PAGE_LOCK
959         spin_lock_init(&ip->i_data.page_lock);
960 #endif
961         INIT_LIST_HEAD(&ip->i_data.clean_pages);
962         INIT_LIST_HEAD(&ip->i_data.dirty_pages);
963         INIT_LIST_HEAD(&ip->i_data.locked_pages);
964         INIT_LIST_HEAD(&ip->i_dirty_buffers);
965         ip->i_data.host = (void*) ip;
966         ip->i_mapping = &ip->i_data;
967 #else
968         sema_init(&ip->i_atomic_write, 1);
969         init_waitqueue(&ip->i_wait);
970 #endif
971         INIT_LIST_HEAD(&ip->i_hash);
972         INIT_LIST_HEAD(&ip->i_dentry);
973         if (afs_globalVFS) {
974             ip->i_dev = afs_globalVFS->s_dev;
975             ip->i_sb = afs_globalVFS;
976         }
977      }
978 #endif
979     tvc->h1.dchint = 0;
980     osi_dnlc_purgedp(tvc);  /* this may be overkill */
981     memset((char *)&(tvc->quick), 0, sizeof(struct vtodc));
982     memset((char *)&(tvc->callsort), 0, sizeof(struct afs_q));
983     tvc->slocks = (struct SimpleLocks *)0;
984     i = VCHash(afid);
985
986     tvc->hnext = afs_vhashT[i];
987     afs_vhashT[i] = tvc;
988     if ((VLRU.next->prev != &VLRU) || (VLRU.prev->next != &VLRU)) {
989        refpanic ("NewVCache VLRU inconsistent");
990     }
991     QAdd(&VLRU, &tvc->vlruq);                           /* put in lruq */
992     if ((VLRU.next->prev != &VLRU) || (VLRU.prev->next != &VLRU)) {
993        refpanic ("NewVCache VLRU inconsistent2");
994     }
995     if (tvc->vlruq.next->prev != &(tvc->vlruq)) {
996        refpanic ("NewVCache VLRU inconsistent3");
997     }
998     if (tvc->vlruq.prev->next != &(tvc->vlruq)) {
999        refpanic ("NewVCache VLRU inconsistent4");
1000     }
1001     vcachegen++;
1002
1003     return tvc;
1004
1005 } /*afs_NewVCache*/
1006
1007
1008 /*
1009  * afs_FlushActiveVcaches
1010  *
1011  * Description:
1012  *      ???
1013  *
1014  * Parameters:
1015  *      doflocks : Do we handle flocks?
1016  */
1017 /* LOCK: afs_FlushActiveVcaches afs_xvcache N */
1018 void
1019 afs_FlushActiveVcaches(doflocks)
1020     register afs_int32 doflocks;
1021
1022 { /*afs_FlushActiveVcaches*/
1023
1024     register struct vcache *tvc;
1025     register int i;
1026     register struct conn *tc;
1027     register afs_int32 code;
1028     register struct AFS_UCRED *cred;
1029     struct vrequest treq, ureq;
1030     struct AFSVolSync tsync;
1031     int didCore;
1032     XSTATS_DECLS
1033
1034     AFS_STATCNT(afs_FlushActiveVcaches);
1035     ObtainReadLock(&afs_xvcache);
1036     for(i=0;i<VCSIZE;i++) {
1037         for(tvc = afs_vhashT[i]; tvc; tvc=tvc->hnext) {
1038             if (doflocks && tvc->flockCount != 0) {
1039                 /* if this entry has an flock, send a keep-alive call out */
1040                 osi_vnhold(tvc, 0);
1041                 ReleaseReadLock(&afs_xvcache);
1042                 ObtainWriteLock(&tvc->lock,51);
1043                 do {
1044                     afs_InitReq(&treq, &afs_osi_cred);
1045                     treq.flags |= O_NONBLOCK;
1046
1047                     tc = afs_Conn(&tvc->fid, &treq, SHARED_LOCK);
1048                     if (tc) {
1049                       XSTATS_START_TIME(AFS_STATS_FS_RPCIDX_EXTENDLOCK);
1050 #ifdef RX_ENABLE_LOCKS
1051                       AFS_GUNLOCK();
1052 #endif /* RX_ENABLE_LOCKS */
1053                       code =
1054                             RXAFS_ExtendLock(tc->id,
1055                                              (struct AFSFid *) &tvc->fid.Fid,
1056                                              &tsync);
1057 #ifdef RX_ENABLE_LOCKS
1058                       AFS_GLOCK();
1059 #endif /* RX_ENABLE_LOCKS */
1060                       XSTATS_END_TIME;
1061                     }
1062                     else code = -1;
1063                 } while
1064                     (afs_Analyze(tc, code, &tvc->fid, &treq,
1065                                  AFS_STATS_FS_RPCIDX_EXTENDLOCK,
1066                                  SHARED_LOCK, (struct cell *)0));
1067
1068                 ReleaseWriteLock(&tvc->lock);
1069                 ObtainReadLock(&afs_xvcache);
1070                 AFS_FAST_RELE(tvc);
1071             }
1072             didCore = 0;
1073             if ((tvc->states & CCore) || (tvc->states & CUnlinkedDel)) {
1074                 /*
1075                  * Don't let it evaporate in case someone else is in
1076                  * this code.  Also, drop the afs_xvcache lock while
1077                  * getting vcache locks.
1078                  */
1079                 osi_vnhold(tvc,0);
1080                 ReleaseReadLock(&afs_xvcache);
1081 #if defined(AFS_SUN_ENV) || defined(AFS_ALPHA_ENV) 
1082                 afs_BozonLock(&tvc->pvnLock, tvc);
1083 #endif
1084 #if defined(AFS_SGI_ENV)
1085                 /*
1086                  * That's because if we come in via the CUnlinkedDel bit state path we'll be have 0 refcnt
1087                  */
1088                 osi_Assert(VREFCOUNT(tvc) > 0);
1089                 AFS_RWLOCK((vnode_t *)tvc, VRWLOCK_WRITE);
1090 #endif
1091                 ObtainWriteLock(&tvc->lock,52);
1092                 if (tvc->states & CCore) {
1093                     tvc->states &= ~CCore;
1094                     /* XXXX Find better place-holder for cred XXXX */
1095                     cred = (struct AFS_UCRED *) tvc->linkData;
1096                     tvc->linkData = (char *) 0; /* XXX */
1097                     afs_InitReq(&ureq, cred);
1098                     afs_Trace2(afs_iclSetp, CM_TRACE_ACTCCORE,
1099                                ICL_TYPE_POINTER, tvc,
1100                                ICL_TYPE_INT32, tvc->execsOrWriters);
1101                     code = afs_StoreOnLastReference(tvc, &ureq);
1102                     ReleaseWriteLock(&tvc->lock);
1103 #if defined(AFS_SUN_ENV) || defined(AFS_ALPHA_ENV) 
1104                     afs_BozonUnlock(&tvc->pvnLock, tvc);
1105 #endif
1106                     hzero(tvc->flushDV);
1107                     osi_FlushText(tvc);
1108                     didCore = 1;
1109                     if (code && code != VNOVNODE) {
1110                         afs_StoreWarn(code, tvc->fid.Fid.Volume,
1111                                       /* /dev/console */ 1);
1112                     }
1113                 } else if (tvc->states & CUnlinkedDel) {
1114                     /*
1115                      * Ignore errors 
1116                      */
1117                     ReleaseWriteLock(&tvc->lock);
1118 #if defined(AFS_SUN_ENV) || defined(AFS_ALPHA_ENV) 
1119                     afs_BozonUnlock(&tvc->pvnLock, tvc);
1120 #endif
1121 #if defined(AFS_SGI_ENV)
1122                     AFS_RWUNLOCK((vnode_t *)tvc, VRWLOCK_WRITE);
1123 #endif
1124                     afs_remunlink(tvc, 0);
1125 #if defined(AFS_SGI_ENV)
1126                     AFS_RWLOCK((vnode_t *)tvc, VRWLOCK_WRITE);
1127 #endif
1128                 }
1129                 else {
1130                     /* lost (or won, perhaps) the race condition */
1131                     ReleaseWriteLock(&tvc->lock);
1132 #if defined(AFS_SUN_ENV) || defined(AFS_ALPHA_ENV)
1133                     afs_BozonUnlock(&tvc->pvnLock, tvc);
1134 #endif
1135                 }
1136 #if defined(AFS_SGI_ENV)
1137                 AFS_RWUNLOCK((vnode_t *)tvc, VRWLOCK_WRITE);
1138 #endif
1139                 ObtainReadLock(&afs_xvcache);
1140                 AFS_FAST_RELE(tvc);
1141                 if (didCore) {
1142 #ifdef  AFS_GFS_ENV
1143                     VREFCOUNT_DEC(tvc);
1144 #else
1145                     AFS_RELE((struct vnode *)tvc);
1146 #endif
1147                     /* Matches write code setting CCore flag */
1148                     crfree(cred);
1149                 }
1150             }          
1151 #ifdef AFS_DARWIN_ENV
1152             if (VREFCOUNT(tvc) == 1 && UBCINFOEXISTS(&tvc->v)) {
1153                 if (tvc->opens) panic("flushactive open, hasubc, but refcnt 1");
1154                 osi_VM_TryReclaim(tvc,0);
1155             }
1156 #endif
1157         }
1158     }
1159     ReleaseReadLock(&afs_xvcache);
1160
1161 } /*afs_FlushActiveVcaches*/
1162
1163
1164 /*
1165  * afs_VerifyVCache
1166  *
1167  * Description:
1168  *      Make sure a cache entry is up-to-date status-wise.
1169  * 
1170  * NOTE: everywhere that calls this can potentially be sped up
1171  *       by checking CStatd first, and avoiding doing the InitReq
1172  *       if this is up-to-date.
1173  *
1174  *  Anymore, the only places that call this KNOW already that the 
1175  *  vcache is not up-to-date, so we don't screw around.
1176  *
1177  * Parameters:
1178  *      avc  : Ptr to vcache entry to verify.
1179  *      areq : ???
1180  */
1181
1182 int afs_VerifyVCache2(struct vcache *avc, struct vrequest *areq)
1183 {
1184     register struct vcache *tvc;
1185
1186     AFS_STATCNT(afs_VerifyVCache);
1187
1188 #if defined(AFS_OSF_ENV)
1189     ObtainReadLock(&avc->lock);
1190     if (afs_IsWired(avc)) {
1191         ReleaseReadLock(&avc->lock);
1192         return 0;
1193     }
1194     ReleaseReadLock(&avc->lock);
1195 #endif /* AFS_OSF_ENV */
1196     /* otherwise we must fetch the status info */
1197
1198     ObtainWriteLock(&avc->lock,53);
1199     if (avc->states & CStatd) {
1200         ReleaseWriteLock(&avc->lock);
1201         return 0;
1202     }
1203     ObtainWriteLock(&afs_xcbhash, 461);
1204     avc->states &= ~( CStatd | CUnique );   
1205     avc->callback = (struct server *)0;
1206     afs_DequeueCallback(avc);
1207     ReleaseWriteLock(&afs_xcbhash);
1208     ReleaseWriteLock(&avc->lock);
1209
1210     /* since we've been called back, or the callback has expired, 
1211      * it's possible that the contents of this directory, or this 
1212      * file's name have changed, thus invalidating the dnlc contents.
1213      */
1214     if ((avc->states & CForeign) || (avc->fid.Fid.Vnode & 1)) 
1215       osi_dnlc_purgedp (avc);
1216     else
1217       osi_dnlc_purgevp (avc);
1218     
1219     /* fetch the status info */
1220     tvc = afs_GetVCache(&avc->fid, areq, (afs_int32*)0, avc, READ_LOCK);
1221     if (!tvc) return ENOENT;
1222     /* Put it back; caller has already incremented vrefCount */
1223     afs_PutVCache(tvc, READ_LOCK);
1224     return 0;
1225
1226 } /*afs_VerifyVCache*/
1227
1228
1229 /*
1230  * afs_SimpleVStat
1231  *
1232  * Description:
1233  *      Simple copy of stat info into cache.
1234  *
1235  * Parameters:
1236  *      avc   : Ptr to vcache entry involved.
1237  *      astat : Ptr to stat info to copy.
1238  *
1239  * Environment:
1240  *      Nothing interesting.
1241  *
1242  * Callers:  as of 1992-04-29, only called by WriteVCache
1243  */
1244 static void
1245 afs_SimpleVStat(avc, astat, areq)
1246     register struct vcache *avc;
1247     register struct AFSFetchStatus *astat;
1248     struct vrequest *areq;
1249 { /*afs_SimpleVStat*/
1250
1251     AFS_STATCNT(afs_SimpleVStat);
1252
1253 #ifdef AFS_SGI_ENV
1254     if ((avc->execsOrWriters <= 0) && !afs_DirtyPages(avc)
1255         && !AFS_VN_MAPPED((vnode_t*)avc))
1256 #else
1257     if ((avc->execsOrWriters <= 0) && !afs_DirtyPages(avc))
1258 #endif
1259
1260         {
1261 #if defined(AFS_SGI_ENV)
1262             osi_Assert((valusema(&avc->vc_rwlock) <= 0) &&
1263                    (OSI_GET_LOCKID() == avc->vc_rwlockid));
1264             if (astat->Length < avc->m.Length) {
1265                 vnode_t *vp = (vnode_t *)avc;
1266                 
1267                 osi_Assert(WriteLocked(&avc->lock));
1268                 ReleaseWriteLock(&avc->lock);
1269                 AFS_GUNLOCK();
1270                 PTOSSVP(vp, (off_t)astat->Length, (off_t)MAXLONG);
1271                 AFS_GLOCK();
1272                 ObtainWriteLock(&avc->lock,67);
1273             }
1274 #endif
1275             /* if writing the file, don't fetch over this value */
1276             afs_Trace3(afs_iclSetp, CM_TRACE_SIMPLEVSTAT,
1277                        ICL_TYPE_POINTER, avc,
1278                        ICL_TYPE_INT32, avc->m.Length,
1279                        ICL_TYPE_INT32, astat->Length);
1280             avc->m.Length = astat->Length;
1281             avc->m.Date = astat->ClientModTime;
1282         }
1283     avc->m.Owner = astat->Owner;
1284     avc->m.Group = astat->Group;
1285     avc->m.Mode = astat->UnixModeBits;
1286     if (vType(avc) == VREG) {
1287         avc->m.Mode |= S_IFREG;
1288     }
1289     else if (vType(avc) == VDIR) {
1290         avc->m.Mode |= S_IFDIR;
1291     }
1292     else if (vType(avc) == VLNK) {
1293
1294
1295
1296         avc->m.Mode |= S_IFLNK;
1297         if ((avc->m.Mode & 0111) == 0) avc->mvstat = 1;
1298     }
1299     if (avc->states & CForeign) {
1300       struct axscache *ac;
1301         avc->anyAccess = astat->AnonymousAccess;
1302 #ifdef badidea
1303         if ((astat->CallerAccess & ~astat->AnonymousAccess)) 
1304          /*   USED TO SAY : 
1305           * Caller has at least one bit not covered by anonymous, and
1306           * thus may have interesting rights.
1307           *
1308           * HOWEVER, this is a really bad idea, because any access query
1309           * for bits which aren't covered by anonymous, on behalf of a user
1310           * who doesn't have any special rights, will result in an answer of 
1311           * the form "I don't know, lets make a FetchStatus RPC and find out!"
1312           * It's an especially bad idea under Ultrix, since (due to the lack of
1313           * a proper access() call) it must perform several afs_access() calls 
1314           * in order to create magic mode bits that vary according to who makes
1315           * the call.  In other words, _every_ stat() generates a test for 
1316           * writeability...
1317           */
1318 #endif /* badidea */
1319           if (avc->Access && (ac = afs_FindAxs(avc->Access, areq->uid)))
1320             ac->axess =  astat->CallerAccess;
1321           else  /* not found, add a new one if possible */
1322             afs_AddAxs(avc->Access, areq->uid, astat->CallerAccess);
1323     }
1324
1325
1326 } /*afs_SimpleVStat*/
1327
1328
1329 /*
1330  * afs_WriteVCache
1331  *
1332  * Description:
1333  *      Store the status info *only* back to the server for a
1334  *      fid/vrequest.
1335  *
1336  * Parameters:
1337  *      avc     : Ptr to the vcache entry.
1338  *      astatus : Ptr to the status info to store.
1339  *      areq    : Ptr to the associated vrequest.
1340  *
1341  * Environment:
1342  *      Must be called with a shared lock held on the vnode.
1343  */
1344
1345 afs_WriteVCache(avc, astatus, areq)
1346     register struct vcache *avc;
1347     register struct AFSStoreStatus *astatus;
1348     struct vrequest *areq;
1349
1350 { /*afs_WriteVCache*/
1351   afs_int32 code;
1352   struct conn *tc;
1353     struct AFSFetchStatus OutStatus;
1354     struct AFSVolSync tsync;
1355     XSTATS_DECLS
1356
1357     AFS_STATCNT(afs_WriteVCache);
1358     afs_Trace2(afs_iclSetp, CM_TRACE_WVCACHE, ICL_TYPE_POINTER, avc,
1359                ICL_TYPE_INT32, avc->m.Length);
1360
1361     do {
1362         tc = afs_Conn(&avc->fid, areq, SHARED_LOCK);
1363         if (tc) {
1364           XSTATS_START_TIME(AFS_STATS_FS_RPCIDX_STORESTATUS);
1365 #ifdef RX_ENABLE_LOCKS
1366           AFS_GUNLOCK();
1367 #endif /* RX_ENABLE_LOCKS */
1368           code = RXAFS_StoreStatus(tc->id,
1369                                    (struct AFSFid *) &avc->fid.Fid,
1370                                    astatus, &OutStatus, &tsync);
1371 #ifdef RX_ENABLE_LOCKS
1372           AFS_GLOCK();
1373 #endif /* RX_ENABLE_LOCKS */
1374           XSTATS_END_TIME;
1375         }
1376         else code = -1;
1377     } while
1378         (afs_Analyze(tc, code, &avc->fid, areq,
1379                      AFS_STATS_FS_RPCIDX_STORESTATUS,
1380                      SHARED_LOCK, (struct cell *)0));
1381
1382     UpgradeSToWLock(&avc->lock,20);
1383     if (code == 0) {
1384         /* success, do the changes locally */
1385         afs_SimpleVStat(avc, &OutStatus, areq);
1386         /*
1387          * Update the date, too.  SimpleVStat didn't do this, since
1388          * it thought we were doing this after fetching new status
1389          * over a file being written.
1390          */
1391         avc->m.Date = OutStatus.ClientModTime;
1392     }
1393     else {
1394         /* failure, set up to check with server next time */
1395         ObtainWriteLock(&afs_xcbhash, 462);
1396         afs_DequeueCallback(avc);
1397         avc->states &= ~( CStatd | CUnique);  /* turn off stat valid flag */
1398         ReleaseWriteLock(&afs_xcbhash);
1399         if ((avc->states & CForeign) || (avc->fid.Fid.Vnode & 1)) 
1400           osi_dnlc_purgedp (avc);  /* if it (could be) a directory */
1401     }
1402     ConvertWToSLock(&avc->lock);
1403     return code;
1404
1405 } /*afs_WriteVCache*/
1406
1407 /*
1408  * afs_ProcessFS
1409  *
1410  * Description:
1411  *      Copy astat block into vcache info
1412  *
1413  * Parameters:
1414  *      avc   : Ptr to vcache entry.
1415  *      astat : Ptr to stat block to copy in.
1416  *      areq  : Ptr to associated request.
1417  *
1418  * Environment:
1419  *      Must be called under a write lock
1420  *
1421  * Note: this code may get dataversion and length out of sync if the file has
1422  *       been modified.  This is less than ideal.  I haven't thought about
1423  *       it sufficiently to be certain that it is adequate.
1424  */
1425 void
1426 afs_ProcessFS(avc, astat, areq)
1427     register struct vcache *avc;
1428     struct vrequest *areq;
1429     register struct AFSFetchStatus *astat;
1430
1431 { /*afs_ProcessFS*/
1432
1433     register int i;
1434     AFS_STATCNT(afs_ProcessFS);
1435
1436     /* WARNING: afs_DoBulkStat uses the Length field to store a sequence
1437      * number for each bulk status request. Under no circumstances
1438      * should afs_DoBulkStat store a sequence number if the new
1439      * length will be ignored when afs_ProcessFS is called with
1440      * new stats. If you change the following conditional then you
1441      * also need to change the conditional in afs_DoBulkStat.  */
1442 #ifdef AFS_SGI_ENV
1443     if ((avc->execsOrWriters <= 0) && !afs_DirtyPages(avc)
1444         && !AFS_VN_MAPPED((vnode_t*)avc))
1445 #else
1446     if ((avc->execsOrWriters <= 0) && !afs_DirtyPages(avc))
1447 #endif
1448         {
1449             /* if we're writing or mapping this file, don't fetch over these
1450              *  values.
1451              */
1452             afs_Trace3(afs_iclSetp, CM_TRACE_PROCESSFS, ICL_TYPE_POINTER, avc,
1453                        ICL_TYPE_INT32, avc->m.Length,
1454                        ICL_TYPE_INT32, astat->Length);
1455             avc->m.Length = astat->Length;
1456             avc->m.Date = astat->ClientModTime;
1457         }
1458     hset64(avc->m.DataVersion, astat->dataVersionHigh, astat->DataVersion);
1459     avc->m.Owner = astat->Owner;
1460     avc->m.Mode = astat->UnixModeBits;
1461     avc->m.Group = astat->Group;
1462     avc->m.LinkCount = astat->LinkCount;
1463     if (astat->FileType == File) {
1464         vSetType(avc, VREG);
1465         avc->m.Mode |= S_IFREG;
1466     }
1467     else if (astat->FileType == Directory) {
1468         vSetType(avc, VDIR);
1469         avc->m.Mode |= S_IFDIR;
1470     }
1471     else if (astat->FileType == SymbolicLink) {
1472         vSetType(avc, VLNK);
1473         avc->m.Mode |= S_IFLNK;
1474         if ((avc->m.Mode & 0111) == 0) avc->mvstat = 1;
1475     }
1476     avc->anyAccess = astat->AnonymousAccess;
1477 #ifdef badidea
1478     if ((astat->CallerAccess & ~astat->AnonymousAccess)) 
1479       /*   USED TO SAY : 
1480        * Caller has at least one bit not covered by anonymous, and
1481        * thus may have interesting rights.
1482        *
1483        * HOWEVER, this is a really bad idea, because any access query
1484        * for bits which aren't covered by anonymous, on behalf of a user
1485        * who doesn't have any special rights, will result in an answer of 
1486        * the form "I don't know, lets make a FetchStatus RPC and find out!"
1487        * It's an especially bad idea under Ultrix, since (due to the lack of
1488        * a proper access() call) it must perform several afs_access() calls 
1489        * in order to create magic mode bits that vary according to who makes
1490        * the call.  In other words, _every_ stat() generates a test for 
1491        * writeability...
1492        */
1493 #endif /* badidea */
1494       {
1495         struct axscache *ac;
1496         if (avc->Access && (ac = afs_FindAxs(avc->Access, areq->uid)))
1497           ac->axess =  astat->CallerAccess;
1498         else  /* not found, add a new one if possible */
1499           afs_AddAxs(avc->Access, areq->uid, astat->CallerAccess);
1500       }
1501
1502 #ifdef AFS_LINUX22_ENV
1503     vcache2inode(avc);    /* Set the inode attr cache */
1504 #endif
1505
1506 } /*afs_ProcessFS*/
1507
1508
1509 afs_RemoteLookup(afid, areq, name, nfid, OutStatusp, CallBackp, serverp, tsyncp)
1510     register struct VenusFid *afid;
1511     struct vrequest *areq;
1512     char *name;
1513     struct VenusFid *nfid;
1514     struct AFSFetchStatus *OutStatusp;
1515     struct AFSCallBack *CallBackp;
1516     struct server **serverp;
1517     struct AFSVolSync *tsyncp;
1518 {
1519     afs_int32 code, i;
1520     register struct vcache *tvc;
1521     struct volume *tvp;
1522     afs_uint32 start;
1523     register struct conn *tc;
1524     struct AFSFetchStatus OutDirStatus;
1525     XSTATS_DECLS
1526
1527     if (!name) name = "";       /* XXX */
1528     do {
1529         tc = afs_Conn(afid, areq, SHARED_LOCK);
1530         if (tc) {
1531             if (serverp) *serverp = tc->srvr->server;
1532             start = osi_Time();
1533             XSTATS_START_TIME(AFS_STATS_FS_RPCIDX_XLOOKUP);
1534 #ifdef RX_ENABLE_LOCKS
1535             AFS_GUNLOCK();
1536 #endif /* RX_ENABLE_LOCKS */
1537             code = RXAFS_Lookup(tc->id, (struct AFSFid *) &afid->Fid, name,
1538                                 (struct AFSFid *) &nfid->Fid, 
1539                                 OutStatusp, &OutDirStatus, CallBackp, tsyncp);
1540 #ifdef RX_ENABLE_LOCKS
1541             AFS_GLOCK();
1542 #endif /* RX_ENABLE_LOCKS */
1543             XSTATS_END_TIME;
1544         } else 
1545             code = -1;
1546     } while
1547         (afs_Analyze(tc, code, afid, areq,
1548                      AFS_STATS_FS_RPCIDX_XLOOKUP,
1549                      SHARED_LOCK, (struct cell *)0));
1550
1551     return code;
1552 }
1553
1554
1555 /*
1556  * afs_GetVCache
1557  *
1558  * Description:
1559  *      Given a file id and a vrequest structure, fetch the status
1560  *      information associated with the file.
1561  *
1562  * Parameters:
1563  *      afid : File ID.
1564  *      areq : Ptr to associated vrequest structure, specifying the
1565  *              user whose authentication tokens will be used.
1566  *      avc  : caller may already have a vcache for this file, which is 
1567  *             already held.
1568  *
1569  * Environment:
1570  *      The cache entry is returned with an increased vrefCount field.
1571  *      The entry must be discarded by calling afs_PutVCache when you
1572  *      are through using the pointer to the cache entry.
1573  *
1574  *      You should not hold any locks when calling this function, except
1575  *      locks on other vcache entries.  If you lock more than one vcache
1576  *      entry simultaneously, you should lock them in this order:
1577  *
1578  *          1. Lock all files first, then directories.
1579  *          2.  Within a particular type, lock entries in Fid.Vnode order.
1580  *  
1581  *      This locking hierarchy is convenient because it allows locking
1582  *      of a parent dir cache entry, given a file (to check its access
1583  *      control list).  It also allows renames to be handled easily by
1584  *      locking directories in a constant order.
1585  * NB.  NewVCache -> FlushVCache presently (4/10/95) drops the xvcache lock.
1586  */
1587 struct vcache *afs_GetVCache(afid, areq, cached, avc, locktype)
1588     register struct VenusFid *afid;
1589     struct vrequest *areq;
1590     afs_int32 *cached;
1591     afs_int32 locktype;
1592     struct vcache *avc; /* might have a vcache structure already, which must
1593                          * already be held by the caller */
1594 { /*afs_GetVCache*/
1595
1596     afs_int32 code, i, newvcache=0;
1597     register struct vcache *tvc;
1598     struct volume *tvp;
1599     afs_int32 retry;
1600
1601     AFS_STATCNT(afs_GetVCache);
1602
1603     if (cached) *cached = 0;            /* Init just in case */
1604
1605 loop:
1606     ObtainSharedLock(&afs_xvcache,5); 
1607
1608     tvc = afs_FindVCache(afid, 0, 0, &retry, DO_STATS | DO_VLRU );
1609     if (tvc && retry) {
1610 #if     defined(AFS_SGI_ENV) && !defined(AFS_SGI53_ENV)
1611         ReleaseSharedLock(&afs_xvcache);
1612         spunlock_psema(tvc->v.v_lock, retry, &tvc->v.v_sync, PINOD);
1613         goto loop;
1614 #endif
1615    }
1616    
1617     if (tvc) {
1618       if (cached) 
1619         *cached = 1;
1620       if (tvc->states & CStatd) {               
1621         ReleaseSharedLock(&afs_xvcache);
1622         return tvc;
1623       }
1624     }
1625     else {      
1626         UpgradeSToWLock(&afs_xvcache,21);
1627
1628         /* no cache entry, better grab one */
1629         tvc = afs_NewVCache(afid, (struct server *)0, 1, WRITE_LOCK);
1630         newvcache = 1;
1631
1632         ConvertWToSLock(&afs_xvcache);
1633         afs_stats_cmperf.vcacheMisses++;
1634     }
1635
1636     ReleaseSharedLock(&afs_xvcache);
1637
1638     ObtainWriteLock(&tvc->lock,54);
1639
1640     if (tvc->states & CStatd) {
1641 #ifdef AFS_LINUX22_ENV
1642         vcache2inode(tvc);
1643 #endif
1644         ReleaseWriteLock(&tvc->lock);
1645 #ifdef AFS_DARWIN_ENV
1646         osi_VM_Setup(tvc);
1647 #endif
1648         return tvc;
1649     }
1650
1651 #if defined(AFS_OSF_ENV)
1652       if (afs_IsWired(tvc)) {
1653           ReleaseWriteLock(&tvc->lock);
1654           return tvc;
1655       }
1656 #endif /* AFS_OSF_ENV */
1657
1658     ObtainWriteLock(&afs_xcbhash, 464);
1659     tvc->states &= ~CUnique;   
1660     tvc->callback = 0;
1661     afs_DequeueCallback(tvc);
1662     ReleaseWriteLock(&afs_xcbhash);
1663
1664     /* It is always appropriate to throw away all the access rights? */
1665     afs_FreeAllAxs(&(tvc->Access));
1666     tvp = afs_GetVolume(afid, areq, READ_LOCK);   /* copy useful per-volume info */
1667     if (tvp) {
1668         if ((tvp->states & VForeign)) {
1669             if (newvcache) tvc->states |= CForeign;
1670             if (newvcache && (tvp->rootVnode == afid->Fid.Vnode) 
1671                 && (tvp->rootUnique == afid->Fid.Unique)) {
1672                 tvc->mvstat = 2;
1673               }
1674         }
1675         if (tvp->states & VRO) tvc->states |= CRO;
1676         if (tvp->states & VBackup) tvc->states |= CBackup;
1677         /* now copy ".." entry back out of volume structure, if necessary */
1678         if (tvc->mvstat == 2  && tvp->dotdot.Fid.Volume != 0) {
1679             if (!tvc->mvid)
1680                 tvc->mvid = (struct VenusFid *)
1681                     osi_AllocSmallSpace(sizeof(struct VenusFid));
1682             *tvc->mvid = tvp->dotdot;
1683         }
1684         afs_PutVolume(tvp, READ_LOCK);
1685     }
1686
1687     /* stat the file */
1688     afs_RemoveVCB(afid);
1689     {
1690         struct AFSFetchStatus OutStatus;
1691
1692         if (afs_DynrootNewVnode(tvc, &OutStatus)) {
1693             afs_ProcessFS(tvc, &OutStatus, areq);
1694             tvc->states |= CStatd | CUnique;
1695             code = 0;
1696         } else {
1697             code = afs_FetchStatus(tvc, afid, areq, &OutStatus);
1698         }
1699     }
1700
1701     if (code) {
1702         ReleaseWriteLock(&tvc->lock);
1703
1704         ObtainReadLock(&afs_xvcache);
1705         AFS_FAST_RELE(tvc);
1706         ReleaseReadLock(&afs_xvcache);
1707         return (struct vcache *) 0;
1708     }
1709
1710     ReleaseWriteLock(&tvc->lock);
1711 #ifdef AFS_DARWIN_ENV
1712     osi_VM_Setup(avc);
1713 #endif
1714     return tvc;
1715
1716 } /*afs_GetVCache*/
1717
1718
1719
1720 struct vcache *afs_LookupVCache(struct VenusFid *afid, struct vrequest *areq,
1721                                 afs_int32 *cached, afs_int32 locktype,
1722                                 struct vcache *adp, char *aname)
1723 {
1724     afs_int32 code, now, newvcache=0, hash;
1725     struct VenusFid nfid;
1726     register struct vcache *tvc;
1727     struct volume *tvp;
1728     struct AFSFetchStatus OutStatus;
1729     struct AFSCallBack CallBack;
1730     struct AFSVolSync tsync;
1731     struct server *serverp = 0;
1732     afs_int32 origCBs;
1733     afs_int32 retry;
1734
1735     AFS_STATCNT(afs_GetVCache);
1736     if (cached) *cached = 0;            /* Init just in case */
1737
1738   loop1:
1739     ObtainReadLock(&afs_xvcache);
1740     tvc = afs_FindVCache(afid, 0, 0, &retry, DO_STATS /* no vlru */);
1741
1742     if (tvc) {
1743       ReleaseReadLock(&afs_xvcache);
1744       if (retry) {
1745 #if     defined(AFS_SGI_ENV) && !defined(AFS_SGI53_ENV)
1746         spunlock_psema(tvc->v.v_lock, retry, &tvc->v.v_sync, PINOD);
1747         goto loop1;
1748 #endif
1749       }
1750       ObtainReadLock(&tvc->lock);
1751
1752       if (tvc->states & CStatd) {
1753         if (cached) {
1754           *cached = 1;
1755         }
1756         ReleaseReadLock(&tvc->lock);
1757         return tvc;
1758       } 
1759       tvc->states &= ~CUnique;   
1760
1761         ReleaseReadLock(&tvc->lock);
1762         ObtainReadLock(&afs_xvcache);
1763         AFS_FAST_RELE(tvc);
1764     }  /* if (tvc) */
1765
1766     ReleaseReadLock(&afs_xvcache);
1767
1768     /* lookup the file */
1769     nfid = *afid;
1770     now = osi_Time();
1771     origCBs = afs_allCBs;       /* if anything changes, we don't have a cb */
1772     code = afs_RemoteLookup(&adp->fid, areq, aname, &nfid, &OutStatus, &CallBack,
1773                             &serverp, &tsync);  
1774
1775   loop2:
1776     ObtainSharedLock(&afs_xvcache,6);
1777     tvc = afs_FindVCache(&nfid, 0, 0, &retry, DO_VLRU /* no xstats now*/);
1778     if (tvc && retry) {
1779 #if     defined(AFS_SGI_ENV) && !defined(AFS_SGI53_ENV)
1780       ReleaseSharedLock(&afs_xvcache);
1781       spunlock_psema(tvc->v.v_lock, retry, &tvc->v.v_sync, PINOD);
1782       goto loop2;
1783 #endif
1784     }
1785
1786     if (!tvc) {
1787         /* no cache entry, better grab one */
1788         UpgradeSToWLock(&afs_xvcache,22);
1789         tvc = afs_NewVCache(&nfid, (struct server *)0, 1, WRITE_LOCK);
1790         newvcache = 1;
1791         ConvertWToSLock(&afs_xvcache);
1792     }
1793
1794     ReleaseSharedLock(&afs_xvcache);
1795     ObtainWriteLock(&tvc->lock,55);
1796  
1797     /* It is always appropriate to throw away all the access rights? */
1798     afs_FreeAllAxs(&(tvc->Access));
1799     tvp = afs_GetVolume(afid, areq, READ_LOCK); /* copy useful per-vol info */
1800     if (tvp) {
1801         if ((tvp->states & VForeign)) {
1802             if (newvcache) tvc->states |= CForeign;
1803             if (newvcache && (tvp->rootVnode == afid->Fid.Vnode)
1804                 && (tvp->rootUnique == afid->Fid.Unique))
1805                 tvc->mvstat = 2;
1806         }
1807         if (tvp->states & VRO) tvc->states |= CRO;
1808         if (tvp->states & VBackup) tvc->states |= CBackup;
1809         /* now copy ".." entry back out of volume structure, if necessary */
1810         if (tvc->mvstat == 2  && tvp->dotdot.Fid.Volume != 0) {
1811             if (!tvc->mvid)
1812                 tvc->mvid = (struct VenusFid *)
1813                     osi_AllocSmallSpace(sizeof(struct VenusFid));
1814             *tvc->mvid = tvp->dotdot;
1815         }
1816     }
1817
1818     if (code) {
1819         ObtainWriteLock(&afs_xcbhash, 465);
1820         afs_DequeueCallback(tvc);
1821         tvc->states &= ~( CStatd | CUnique );
1822         ReleaseWriteLock(&afs_xcbhash);
1823         if ((tvc->states & CForeign) || (tvc->fid.Fid.Vnode & 1)) 
1824           osi_dnlc_purgedp (tvc);  /* if it (could be) a directory */
1825         if ( tvp )
1826                 afs_PutVolume(tvp, READ_LOCK);
1827         ReleaseWriteLock(&tvc->lock);
1828         ObtainReadLock(&afs_xvcache);
1829         AFS_FAST_RELE(tvc);
1830         ReleaseReadLock(&afs_xvcache);
1831         return (struct vcache *) 0;
1832     }
1833
1834     ObtainWriteLock(&afs_xcbhash, 466);
1835     if (origCBs == afs_allCBs) {
1836         if (CallBack.ExpirationTime) {
1837             tvc->callback = serverp;
1838             tvc->cbExpires = CallBack.ExpirationTime+now;
1839             tvc->states |= CStatd | CUnique;
1840             tvc->states &= ~CBulkFetching;
1841             afs_QueueCallback(tvc, CBHash(CallBack.ExpirationTime), tvp);
1842         } else if (tvc->states & CRO) {
1843             /* adapt gives us an hour. */
1844             tvc->cbExpires = 3600+osi_Time(); /*XXX*/
1845             tvc->states |= CStatd | CUnique;
1846             tvc->states &= ~CBulkFetching;
1847             afs_QueueCallback(tvc, CBHash(3600), tvp); 
1848         } else {
1849             tvc->callback = (struct server *)0;
1850             afs_DequeueCallback(tvc);
1851             tvc->states &= ~(CStatd | CUnique);   
1852             if ((tvc->states & CForeign) || (tvc->fid.Fid.Vnode & 1)) 
1853               osi_dnlc_purgedp (tvc);  /* if it (could be) a directory */
1854         }
1855     } else {
1856         afs_DequeueCallback(tvc);
1857         tvc->states &= ~CStatd; 
1858         tvc->states &= ~CUnique;   
1859         tvc->callback = (struct server *)0;
1860         if ((tvc->states & CForeign) || (tvc->fid.Fid.Vnode & 1)) 
1861           osi_dnlc_purgedp (tvc);  /* if it (could be) a directory */
1862     }   
1863     ReleaseWriteLock(&afs_xcbhash);
1864     if ( tvp )
1865         afs_PutVolume(tvp, READ_LOCK);
1866     afs_ProcessFS(tvc, &OutStatus, areq);
1867
1868     ReleaseWriteLock(&tvc->lock);
1869 #ifdef AFS_DARWIN_ENV
1870     osi_VM_Setup(tvc);
1871 #endif
1872     return tvc;
1873
1874 }
1875
1876 struct vcache *afs_GetRootVCache(struct VenusFid *afid,
1877                                  struct vrequest *areq, afs_int32 *cached,
1878                                  struct volume *tvolp, afs_int32 locktype)
1879 {
1880     afs_int32 code, i, newvcache = 0, haveStatus = 0;
1881     afs_int32 getNewFid = 0;
1882     afs_uint32 start;
1883     struct VenusFid nfid;
1884     register struct vcache *tvc;
1885     struct server *serverp = 0;
1886     struct AFSFetchStatus OutStatus;
1887     struct AFSCallBack CallBack;
1888     struct AFSVolSync tsync;
1889     int origCBs;
1890
1891     start = osi_Time();
1892
1893  newmtpt:
1894     if (!tvolp->rootVnode || getNewFid) {
1895         struct VenusFid tfid;
1896
1897         tfid = *afid;
1898         tfid.Fid.Vnode = 0;     /* Means get rootfid of volume */
1899         origCBs = afs_allCBs; /* ignore InitCallBackState */
1900         code = afs_RemoteLookup(&tfid, areq, (char *)0, &nfid, 
1901                                 &OutStatus, &CallBack, &serverp, &tsync);
1902         if (code) {
1903             return (struct vcache *)0;
1904         }
1905 /*      ReleaseReadLock(&tvolp->lock);           */
1906         ObtainWriteLock(&tvolp->lock,56);
1907         tvolp->rootVnode = afid->Fid.Vnode = nfid.Fid.Vnode;
1908         tvolp->rootUnique = afid->Fid.Unique = nfid.Fid.Unique;
1909         ReleaseWriteLock(&tvolp->lock); 
1910 /*      ObtainReadLock(&tvolp->lock);*/
1911         haveStatus = 1;
1912     } else {
1913         afid->Fid.Vnode = tvolp->rootVnode;
1914         afid->Fid.Unique = tvolp->rootUnique;
1915     }   
1916     
1917     ObtainSharedLock(&afs_xvcache,7);
1918     i = VCHash(afid);
1919     for (tvc = afs_vhashT[i]; tvc; tvc = tvc->hnext) {
1920         if (!FidCmp(&(tvc->fid), afid)) {
1921 #ifdef  AFS_OSF_ENV
1922             /* Grab this vnode, possibly reactivating from the free list */
1923             /* for the present (95.05.25) everything on the hash table is 
1924              * definitively NOT in the free list -- at least until afs_reclaim
1925              * can be safely implemented */
1926             int vg;
1927             AFS_GUNLOCK();
1928             vg = vget((struct vnode *)tvc);   /* this bumps ref count */
1929             AFS_GLOCK();
1930             if (vg)
1931                 continue;
1932 #endif  /* AFS_OSF_ENV */
1933             break;
1934         }
1935     }
1936
1937     if (!haveStatus && (!tvc || !(tvc->states & CStatd))) {
1938         /* Mount point no longer stat'd or unknown. FID may have changed. */
1939 #ifdef AFS_OSF_ENV
1940         if (tvc)
1941             AFS_RELE(tvc);
1942 #endif
1943         tvc = (struct vcache*)0;
1944         getNewFid = 1;
1945         ReleaseSharedLock(&afs_xvcache);
1946         goto newmtpt;
1947     }
1948
1949     if (!tvc) {
1950         UpgradeSToWLock(&afs_xvcache,23);
1951         /* no cache entry, better grab one */
1952         tvc = afs_NewVCache(afid, (struct server *)0, 1, WRITE_LOCK);
1953         newvcache = 1;
1954         afs_stats_cmperf.vcacheMisses++;
1955     }
1956     else {
1957         if (cached) *cached = 1;
1958         afs_stats_cmperf.vcacheHits++;
1959 #ifdef  AFS_OSF_ENV
1960         /* we already bumped the ref count in the for loop above */
1961 #else   /* AFS_OSF_ENV */
1962         osi_vnhold(tvc,0);
1963 #endif
1964         UpgradeSToWLock(&afs_xvcache,24);
1965         if ((VLRU.next->prev != &VLRU) || (VLRU.prev->next != &VLRU)) {
1966            refpanic ("GRVC VLRU inconsistent0");
1967         }
1968         if (tvc->vlruq.next->prev != &(tvc->vlruq)) {
1969            refpanic ("GRVC VLRU inconsistent1");
1970         }
1971         if (tvc->vlruq.prev->next != &(tvc->vlruq)) {
1972            refpanic ("GRVC VLRU inconsistent2");
1973         }
1974         QRemove(&tvc->vlruq);           /* move to lruq head */
1975         QAdd(&VLRU, &tvc->vlruq);
1976         if ((VLRU.next->prev != &VLRU) || (VLRU.prev->next != &VLRU)) {
1977            refpanic ("GRVC VLRU inconsistent3");
1978         }
1979         if (tvc->vlruq.next->prev != &(tvc->vlruq)) {
1980            refpanic ("GRVC VLRU inconsistent4");
1981         }
1982         if (tvc->vlruq.prev->next != &(tvc->vlruq)) {
1983            refpanic ("GRVC VLRU inconsistent5");
1984         }
1985         vcachegen++;
1986     }
1987
1988     ReleaseWriteLock(&afs_xvcache);
1989
1990     if (tvc->states & CStatd) {
1991         return tvc;
1992     } else {  
1993
1994       ObtainReadLock(&tvc->lock);
1995       tvc->states &= ~CUnique;   
1996       tvc->callback = (struct server *)0;              /* redundant, perhaps */
1997       ReleaseReadLock(&tvc->lock);
1998     }
1999
2000     ObtainWriteLock(&tvc->lock,57);
2001
2002     /* It is always appropriate to throw away all the access rights? */
2003     afs_FreeAllAxs(&(tvc->Access));
2004
2005     if (newvcache) tvc->states |= CForeign;
2006     if (tvolp->states & VRO) tvc->states |= CRO;
2007     if (tvolp->states & VBackup) tvc->states |= CBackup;
2008     /* now copy ".." entry back out of volume structure, if necessary */
2009     if (newvcache && (tvolp->rootVnode == afid->Fid.Vnode) 
2010         && (tvolp->rootUnique == afid->Fid.Unique)) {
2011         tvc->mvstat = 2;
2012     }
2013     if (tvc->mvstat == 2  && tvolp->dotdot.Fid.Volume != 0) {
2014         if (!tvc->mvid)
2015             tvc->mvid = (struct VenusFid *)osi_AllocSmallSpace(sizeof(struct VenusFid));
2016         *tvc->mvid = tvolp->dotdot;
2017     }
2018
2019     /* stat the file */
2020     afs_RemoveVCB(afid);
2021
2022     if (!haveStatus) {
2023         struct VenusFid tfid;
2024
2025         tfid = *afid;
2026         tfid.Fid.Vnode = 0;     /* Means get rootfid of volume */
2027         origCBs = afs_allCBs; /* ignore InitCallBackState */
2028         code = afs_RemoteLookup(&tfid, areq, (char *)0, &nfid, &OutStatus,
2029                                 &CallBack, &serverp, &tsync);
2030     }
2031
2032     if (code) {
2033         ObtainWriteLock(&afs_xcbhash, 467);
2034         afs_DequeueCallback(tvc);
2035         tvc->callback = (struct server *)0;
2036         tvc->states &= ~(CStatd|CUnique);  
2037         ReleaseWriteLock(&afs_xcbhash);
2038         if ((tvc->states & CForeign) || (tvc->fid.Fid.Vnode & 1)) 
2039           osi_dnlc_purgedp (tvc);  /* if it (could be) a directory */
2040         ReleaseWriteLock(&tvc->lock);
2041         ObtainReadLock(&afs_xvcache);
2042         AFS_FAST_RELE(tvc);
2043         ReleaseReadLock(&afs_xvcache);
2044         return (struct vcache *) 0;
2045     }
2046         
2047     ObtainWriteLock(&afs_xcbhash, 468);
2048     if (origCBs == afs_allCBs) {
2049         tvc->states |= CTruth;
2050         tvc->callback = serverp;
2051         if (CallBack.ExpirationTime != 0) {  
2052             tvc->cbExpires = CallBack.ExpirationTime+start;
2053             tvc->states |= CStatd;
2054             tvc->states &= ~CBulkFetching;
2055             afs_QueueCallback(tvc, CBHash(CallBack.ExpirationTime), tvolp);
2056         } else if (tvc->states & CRO) {
2057             /* adapt gives us an hour. */
2058             tvc->cbExpires = 3600+osi_Time(); /*XXX*/
2059             tvc->states |= CStatd;
2060             tvc->states &= ~CBulkFetching;
2061             afs_QueueCallback(tvc, CBHash(3600), tvolp);
2062         }
2063     } else {
2064         afs_DequeueCallback(tvc);
2065         tvc->callback = (struct server *)0;
2066         tvc->states &= ~(CStatd | CUnique);
2067         if ((tvc->states & CForeign) || (tvc->fid.Fid.Vnode & 1)) 
2068           osi_dnlc_purgedp (tvc);  /* if it (could be) a directory */
2069     }
2070     ReleaseWriteLock(&afs_xcbhash);
2071     afs_ProcessFS(tvc, &OutStatus, areq);
2072     
2073     ReleaseWriteLock(&tvc->lock);
2074     return tvc;
2075 }
2076
2077
2078
2079 /*
2080  * must be called with avc write-locked 
2081  * don't absolutely have to invalidate the hint unless the dv has 
2082  * changed, but be sure to get it right else there will be consistency bugs.
2083  */
2084 afs_int32 afs_FetchStatus(struct vcache *avc, struct VenusFid *afid,
2085                       struct vrequest *areq, struct AFSFetchStatus *Outsp)
2086 {
2087   int code;
2088   afs_uint32 start;
2089   register struct conn *tc;
2090   struct AFSCallBack CallBack;
2091   struct AFSVolSync tsync;
2092   struct volume*    volp;
2093   XSTATS_DECLS
2094
2095     do {
2096         tc = afs_Conn(afid, areq, SHARED_LOCK);
2097         avc->quick.stamp = 0; avc->h1.dchint = NULL; /* invalidate hints */
2098         if (tc) {
2099             avc->callback = tc->srvr->server;
2100             start = osi_Time();
2101             XSTATS_START_TIME(AFS_STATS_FS_RPCIDX_FETCHSTATUS);
2102 #ifdef RX_ENABLE_LOCKS
2103             AFS_GUNLOCK();
2104 #endif /* RX_ENABLE_LOCKS */
2105             code = RXAFS_FetchStatus(tc->id,
2106                                      (struct AFSFid *) &afid->Fid,
2107                                      Outsp, &CallBack, &tsync);
2108 #ifdef RX_ENABLE_LOCKS
2109             AFS_GLOCK();
2110 #endif /* RX_ENABLE_LOCKS */
2111
2112             XSTATS_END_TIME;
2113
2114         }
2115         else code = -1;
2116     } while
2117         (afs_Analyze(tc, code, afid, areq,
2118                      AFS_STATS_FS_RPCIDX_FETCHSTATUS,
2119                      SHARED_LOCK, (struct cell *)0));
2120
2121 if (!code) {
2122   afs_ProcessFS(avc, Outsp, areq);
2123   volp = afs_GetVolume(afid, areq, READ_LOCK);
2124   ObtainWriteLock(&afs_xcbhash, 469);
2125   avc->states |= CTruth;
2126   if (avc->callback /* check for race */) {
2127     if (CallBack.ExpirationTime != 0) {  
2128       avc->cbExpires = CallBack.ExpirationTime+start;
2129       avc->states |= CStatd;
2130       avc->states &= ~CBulkFetching;
2131       afs_QueueCallback(avc, CBHash(CallBack.ExpirationTime), volp);
2132     }
2133     else if (avc->states & CRO) 
2134       { /* ordinary callback on a read-only volume -- AFS 3.2 style */
2135         avc->cbExpires = 3600+start;
2136         avc->states |= CStatd;
2137         avc->states &= ~CBulkFetching;
2138         afs_QueueCallback(avc, CBHash(3600), volp);
2139        }
2140     else {
2141       afs_DequeueCallback(avc);
2142       avc->callback = (struct server *)0;
2143       avc->states &= ~(CStatd|CUnique);  
2144       if ((avc->states & CForeign) || (avc->fid.Fid.Vnode & 1)) 
2145         osi_dnlc_purgedp (avc);  /* if it (could be) a directory */
2146     }
2147   }
2148   else {
2149     afs_DequeueCallback(avc);
2150     avc->callback = (struct server *)0;
2151     avc->states &= ~(CStatd|CUnique);  
2152     if ((avc->states & CForeign) || (avc->fid.Fid.Vnode & 1)) 
2153       osi_dnlc_purgedp (avc);  /* if it (could be) a directory */
2154   }
2155   ReleaseWriteLock(&afs_xcbhash);
2156   if ( volp )
2157     afs_PutVolume(volp, READ_LOCK);
2158 }
2159 else {     /* used to undo the local callback, but that's too extreme. 
2160             * There are plenty of good reasons that fetchstatus might return 
2161             * an error, such as EPERM.  If we have the vnode cached, statd, 
2162             * with callback, might as well keep track of the fact that we 
2163             * don't have access...
2164             */
2165      if (code == EPERM || code == EACCES) {
2166        struct axscache *ac;
2167        if (avc->Access && (ac = afs_FindAxs(avc->Access, areq->uid)))
2168          ac->axess = 0;
2169        else  /* not found, add a new one if possible */
2170          afs_AddAxs(avc->Access, areq->uid, 0);
2171      }
2172 }
2173 return code;
2174 }
2175
2176 #if 0
2177 /*
2178  * afs_StuffVcache
2179  *
2180  * Description:
2181  *      Stuff some information into the vcache for the given file.
2182  *
2183  * Parameters:
2184  *      afid      : File in question.
2185  *      OutStatus : Fetch status on the file.
2186  *      CallBack  : Callback info.
2187  *      tc        : RPC connection involved.
2188  *      areq      : vrequest involved.
2189  *
2190  * Environment:
2191  *      Nothing interesting.
2192  */
2193 void
2194 afs_StuffVcache(afid, OutStatus, CallBack, tc, areq)
2195     register struct VenusFid *afid;
2196     struct AFSFetchStatus *OutStatus;
2197     struct AFSCallBack *CallBack;
2198     register struct conn *tc;
2199     struct vrequest *areq;
2200
2201 { /*afs_StuffVcache*/
2202
2203     register afs_int32 code, i, newvcache=0;
2204     register struct vcache *tvc;
2205     struct AFSVolSync tsync;
2206     struct volume *tvp;
2207     struct axscache *ac;
2208     afs_int32 retry;
2209
2210     AFS_STATCNT(afs_StuffVcache);
2211 #ifdef IFS_VCACHECOUNT
2212     ifs_gvcachecall++;
2213 #endif
2214
2215   loop:
2216     ObtainSharedLock(&afs_xvcache,8);
2217
2218     tvc = afs_FindVCache(afid, 0, 0, &retry, DO_VLRU /* no stats */);
2219     if (tvc && retry) {
2220 #if     defined(AFS_SGI_ENV) && !defined(AFS_SGI53_ENV)
2221         ReleaseSharedLock(&afs_xvcache);
2222         spunlock_psema(tvc->v.v_lock, retry, &tvc->v.v_sync, PINOD);
2223         goto loop;
2224 #endif
2225    }
2226
2227     if (!tvc) {
2228         /* no cache entry, better grab one */
2229         UpgradeSToWLock(&afs_xvcache,25);
2230         tvc = afs_NewVCache(afid, (struct server *)0, 1, WRITE_LOCK);
2231         newvcache = 1;
2232         ConvertWToSLock(&afs_xvcache);
2233     }
2234
2235     ReleaseSharedLock(&afs_xvcache);
2236     ObtainWriteLock(&tvc->lock,58);
2237
2238     tvc->states &= ~CStatd;
2239     if ((tvc->states & CForeign) || (tvc->fid.Fid.Vnode & 1)) 
2240       osi_dnlc_purgedp (tvc);  /* if it (could be) a directory */
2241
2242     /* Is it always appropriate to throw away all the access rights? */
2243     afs_FreeAllAxs(&(tvc->Access));
2244
2245     /*Copy useful per-volume info*/
2246     tvp = afs_GetVolume(afid, areq, READ_LOCK);
2247     if (tvp) {
2248         if (newvcache && (tvp->states & VForeign)) tvc->states |= CForeign;
2249         if (tvp->states & VRO) tvc->states |= CRO;
2250         if (tvp->states & VBackup) tvc->states |= CBackup;
2251         /*
2252          * Now, copy ".." entry back out of volume structure, if
2253          * necessary
2254          */
2255         if (tvc->mvstat == 2  && tvp->dotdot.Fid.Volume != 0) {
2256             if (!tvc->mvid) tvc->mvid =
2257                 (struct VenusFid *) osi_AllocSmallSpace(sizeof(struct VenusFid));
2258             *tvc->mvid = tvp->dotdot;
2259         }
2260     }
2261     /* store the stat on the file */
2262     afs_RemoveVCB(afid);
2263     afs_ProcessFS(tvc, OutStatus, areq);
2264     tvc->callback = tc->srvr->server;
2265
2266     /* we use osi_Time twice below.  Ideally, we would use the time at which 
2267      * the FetchStatus call began, instead, but we don't have it here.  So we
2268      * make do with "now".  In the CRO case, it doesn't really matter. In 
2269      * the other case, we hope that the difference between "now" and when the 
2270      * call actually began execution on the server won't be larger than the
2271      * padding which the server keeps.  Subtract 1 second anyway, to be on 
2272      * the safe side.  Can't subtract more because we don't know how big
2273      * ExpirationTime is.  Possible consistency problems may arise if the call
2274      * timeout period becomes longer than the server's expiration padding.  */
2275     ObtainWriteLock(&afs_xcbhash, 470);
2276     if (CallBack->ExpirationTime != 0) {
2277         tvc->cbExpires = CallBack->ExpirationTime+osi_Time()-1; 
2278         tvc->states |= CStatd;
2279         tvc->states &= ~CBulkFetching;
2280         afs_QueueCallback(tvc, CBHash(CallBack->ExpirationTime), tvp);
2281         }
2282     else if (tvc->states & CRO) {
2283        /* old-fashioned AFS 3.2 style */
2284        tvc->cbExpires = 3600+osi_Time(); /*XXX*/
2285        tvc->states |= CStatd;
2286        tvc->states &= ~CBulkFetching;
2287        afs_QueueCallback(tvc, CBHash(3600), tvp); 
2288      }
2289     else {
2290       afs_DequeueCallback(tvc);
2291       tvc->callback = (struct server *)0;
2292       tvc->states &= ~(CStatd|CUnique);  
2293       if ((tvc->states & CForeign) || (tvc->fid.Fid.Vnode & 1)) 
2294         osi_dnlc_purgedp (tvc);  /* if it (could be) a directory */
2295     }
2296     ReleaseWriteLock(&afs_xcbhash);
2297     if ( tvp )
2298         afs_PutVolume(tvp, READ_LOCK);
2299         
2300     /* look in per-pag cache */
2301       if (tvc->Access && (ac = afs_FindAxs(tvc->Access, areq->uid)))
2302           ac->axess = OutStatus->CallerAccess;   /* substitute pags */
2303       else  /* not found, add a new one if possible */
2304           afs_AddAxs(tvc->Access, areq->uid, OutStatus->CallerAccess);
2305
2306     ReleaseWriteLock(&tvc->lock);
2307     afs_Trace4(afs_iclSetp, CM_TRACE_STUFFVCACHE, ICL_TYPE_POINTER, tvc,
2308                ICL_TYPE_POINTER, tvc->callback, ICL_TYPE_INT32, tvc->cbExpires,
2309                ICL_TYPE_INT32, tvc->cbExpires-osi_Time());
2310     /*
2311      * Release ref count... hope this guy stays around...
2312      */
2313     afs_PutVCache(tvc, WRITE_LOCK);
2314 } /*afs_StuffVcache*/
2315 #endif
2316
2317 /*
2318  * afs_PutVCache
2319  *
2320  * Description:
2321  *      Decrements the reference count on a cache entry.
2322  *
2323  * Parameters:
2324  *      avc : Pointer to the cache entry to decrement.
2325  *
2326  * Environment:
2327  *      Nothing interesting.
2328  */
2329 void
2330 afs_PutVCache(avc, locktype)
2331     register struct vcache *avc;
2332     afs_int32 locktype;
2333 { /*afs_PutVCache*/
2334
2335     AFS_STATCNT(afs_PutVCache);
2336     /*
2337      * Can we use a read lock here?
2338      */
2339     ObtainReadLock(&afs_xvcache);
2340     AFS_FAST_RELE(avc);
2341     ReleaseReadLock(&afs_xvcache);
2342 } /*afs_PutVCache*/
2343
2344 /*
2345  * afs_FindVCache
2346  *
2347  * Description:
2348  *      Find a vcache entry given a fid.
2349  *
2350  * Parameters:
2351  *      afid : Pointer to the fid whose cache entry we desire.
2352  *      retry: (SGI-specific) tell the caller to drop the lock on xvcache, 
2353  *             unlock the vnode, and try again.
2354  *      flags: bit 1 to specify whether to compute hit statistics.  Not
2355  *             set if FindVCache is called as part of internal bookkeeping.
2356  *
2357  * Environment:
2358  *      Must be called with the afs_xvcache lock at least held at
2359  *      the read level.  In order to do the VLRU adjustment, the xvcache lock
2360  *      must be shared-- we upgrade it here.
2361  */
2362
2363 struct vcache *afs_FindVCache(struct VenusFid *afid, afs_int32 lockit,
2364                               afs_int32 locktype, afs_int32 *retry, afs_int32 flag)
2365 {
2366
2367     register struct vcache *tvc;
2368     afs_int32 i;
2369
2370     AFS_STATCNT(afs_FindVCache);
2371
2372     i = VCHash(afid);
2373     for(tvc = afs_vhashT[i]; tvc; tvc = tvc->hnext) {
2374         if (FidMatches(afid, tvc)) {
2375 #ifdef  AFS_OSF_ENV
2376             /* Grab this vnode, possibly reactivating from the free list */
2377             int vg;
2378             AFS_GUNLOCK();
2379             vg = vget((struct vnode *)tvc);
2380             AFS_GLOCK();
2381             if (vg)
2382                 continue;
2383 #endif  /* AFS_OSF_ENV */
2384             break;
2385         }
2386     }
2387
2388     /* should I have a read lock on the vnode here? */
2389     if (tvc) {
2390         if (retry) *retry = 0;
2391 #if !defined(AFS_OSF_ENV)
2392         osi_vnhold(tvc, retry);  /* already held, above */
2393         if (retry && *retry) 
2394           return 0;
2395 #endif
2396         /*
2397          * only move to front of vlru if we have proper vcache locking)
2398          */
2399         if (flag & DO_VLRU) {
2400            if ((VLRU.next->prev != &VLRU) || (VLRU.prev->next != &VLRU)) {
2401               refpanic ("FindVC VLRU inconsistent1");
2402            }
2403            if (tvc->vlruq.next->prev != &(tvc->vlruq)) {
2404               refpanic ("FindVC VLRU inconsistent1");
2405            }
2406            if (tvc->vlruq.prev->next != &(tvc->vlruq)) {
2407               refpanic ("FindVC VLRU inconsistent2");
2408            }
2409             UpgradeSToWLock(&afs_xvcache,26);
2410             QRemove(&tvc->vlruq);
2411             QAdd(&VLRU, &tvc->vlruq);
2412             ConvertWToSLock(&afs_xvcache);
2413            if ((VLRU.next->prev != &VLRU) || (VLRU.prev->next != &VLRU)) {
2414               refpanic ("FindVC VLRU inconsistent1");
2415            }
2416            if (tvc->vlruq.next->prev != &(tvc->vlruq)) {
2417               refpanic ("FindVC VLRU inconsistent2");
2418            }
2419            if (tvc->vlruq.prev->next != &(tvc->vlruq)) {
2420               refpanic ("FindVC VLRU inconsistent3");
2421            }
2422         }
2423         vcachegen++;
2424     } 
2425
2426     if (flag & DO_STATS) {
2427       if (tvc)  afs_stats_cmperf.vcacheHits++;
2428       else      afs_stats_cmperf.vcacheMisses++;
2429       if (afid->Cell == LOCALCELL)
2430         afs_stats_cmperf.vlocalAccesses++;
2431       else
2432         afs_stats_cmperf.vremoteAccesses++;
2433     }
2434
2435 #ifdef AFS_LINUX22_ENV
2436     if (tvc && (tvc->states & CStatd))
2437         vcache2inode(tvc); /* mainly to reset i_nlink */
2438 #endif
2439 #ifdef AFS_DARWIN_ENV
2440     if (tvc)
2441         osi_VM_Setup(tvc);
2442 #endif
2443     return tvc;
2444 } /*afs_FindVCache*/
2445
2446 /*
2447  * afs_NFSFindVCache
2448  *
2449  * Description:
2450  *      Find a vcache entry given a fid. Does a wildcard match on what we
2451  *      have for the fid. If more than one entry, don't return anything.
2452  *
2453  * Parameters:
2454  *      avcp : Fill in pointer if we found one and only one.
2455  *      afid : Pointer to the fid whose cache entry we desire.
2456  *      retry: (SGI-specific) tell the caller to drop the lock on xvcache, 
2457  *             unlock the vnode, and try again.
2458  *      flags: bit 1 to specify whether to compute hit statistics.  Not
2459  *             set if FindVCache is called as part of internal bookkeeping.
2460  *
2461  * Environment:
2462  *      Must be called with the afs_xvcache lock at least held at
2463  *      the read level.  In order to do the VLRU adjustment, the xvcache lock
2464  *      must be shared-- we upgrade it here.
2465  *
2466  * Return value:
2467  *      number of matches found.
2468  */
2469
2470 int afs_duplicate_nfs_fids=0;
2471
2472 afs_int32 afs_NFSFindVCache(avcp, afid, lockit)
2473      struct vcache **avcp;
2474     struct VenusFid *afid;
2475     afs_int32 lockit;
2476 { /*afs_FindVCache*/
2477
2478     register struct vcache *tvc;
2479     afs_int32 i;
2480     afs_int32 retry = 0;
2481     afs_int32 count = 0;
2482     struct vcache *found_tvc = NULL;
2483
2484     AFS_STATCNT(afs_FindVCache);
2485
2486  loop:
2487
2488     ObtainSharedLock(&afs_xvcache,331); 
2489
2490     i = VCHash(afid);
2491     for(tvc = afs_vhashT[i]; tvc; tvc = tvc->hnext) {
2492         /* Match only on what we have.... */
2493         if (((tvc->fid.Fid.Vnode & 0xffff) == afid->Fid.Vnode)
2494             && (tvc->fid.Fid.Volume == afid->Fid.Volume)
2495             && ((tvc->fid.Fid.Unique & 0xffffff) == afid->Fid.Unique)
2496             && (tvc->fid.Cell == afid->Cell)) {
2497 #ifdef  AFS_OSF_ENV
2498             /* Grab this vnode, possibly reactivating from the free list */
2499             int vg;
2500             AFS_GUNLOCK();
2501             vg = vget((struct vnode *)tvc);
2502             AFS_GLOCK();
2503             if (vg) {
2504                 /* This vnode no longer exists. */
2505                 continue;
2506             }
2507 #endif  /* AFS_OSF_ENV */
2508             count ++;
2509             if (found_tvc) {
2510                 /* Duplicates */
2511 #ifdef AFS_OSF_ENV
2512                 /* Drop our reference counts. */
2513                 vrele((struct vnode *)tvc);
2514                 vrele((struct vnode *)found_tvc);
2515 #endif
2516                 afs_duplicate_nfs_fids++;
2517                 ReleaseSharedLock(&afs_xvcache);
2518                 return count;
2519             }
2520             found_tvc = tvc;
2521         }
2522     }
2523
2524     tvc = found_tvc;
2525     /* should I have a read lock on the vnode here? */
2526     if (tvc) {
2527 #if defined(AFS_SGI_ENV) && !defined(AFS_SGI53_ENV)
2528         osi_vnhold(tvc, &retry); 
2529         if (retry) {
2530             count = 0;
2531             found_tvc = (struct vcache*)0;
2532             ReleaseSharedLock(&afs_xvcache);
2533             spunlock_psema(tvc->v.v_lock, retry, &tvc->v.v_sync, PINOD);
2534             goto loop;
2535         }
2536 #else
2537 #if !defined(AFS_OSF_ENV)
2538         osi_vnhold(tvc, (int*)0);  /* already held, above */
2539 #endif
2540 #endif
2541         /*
2542          * We obtained the xvcache lock above.
2543          */
2544         if ((VLRU.next->prev != &VLRU) || (VLRU.prev->next != &VLRU)) {
2545             refpanic ("FindVC VLRU inconsistent1");
2546         }
2547         if (tvc->vlruq.next->prev != &(tvc->vlruq)) {
2548             refpanic ("FindVC VLRU inconsistent1");
2549         }
2550         if (tvc->vlruq.prev->next != &(tvc->vlruq)) {
2551             refpanic ("FindVC VLRU inconsistent2");
2552         }
2553         UpgradeSToWLock(&afs_xvcache,568);
2554         QRemove(&tvc->vlruq);
2555         QAdd(&VLRU, &tvc->vlruq);
2556         ConvertWToSLock(&afs_xvcache);
2557         if ((VLRU.next->prev != &VLRU) || (VLRU.prev->next != &VLRU)) {
2558             refpanic ("FindVC VLRU inconsistent1");
2559         }
2560         if (tvc->vlruq.next->prev != &(tvc->vlruq)) {
2561             refpanic ("FindVC VLRU inconsistent2");
2562         }
2563         if (tvc->vlruq.prev->next != &(tvc->vlruq)) {
2564             refpanic ("FindVC VLRU inconsistent3");
2565         }
2566     }
2567     vcachegen++;
2568
2569     if (tvc)    afs_stats_cmperf.vcacheHits++;
2570     else        afs_stats_cmperf.vcacheMisses++;
2571     if (afid->Cell == LOCALCELL)
2572         afs_stats_cmperf.vlocalAccesses++;
2573     else
2574         afs_stats_cmperf.vremoteAccesses++;
2575
2576     *avcp = tvc; /* May be null */
2577
2578     ReleaseSharedLock(&afs_xvcache);
2579     return (tvc ? 1 : 0);
2580
2581 } /*afs_NFSFindVCache*/
2582
2583
2584
2585
2586 /*
2587  * afs_vcacheInit
2588  *
2589  * Initialize vcache related variables
2590  */
2591 void afs_vcacheInit(int astatSize)
2592 {
2593     register struct vcache *tvp;
2594     int i;
2595 #if     defined(AFS_OSF_ENV)
2596     if (!afs_maxvcount) {
2597 #if     defined(AFS_OSF30_ENV)
2598         afs_maxvcount = max_vnodes/2;  /* limit ourselves to half the total */
2599 #else
2600         afs_maxvcount = nvnode/2;  /* limit ourselves to half the total */  
2601 #endif 
2602         if (astatSize < afs_maxvcount) {
2603             afs_maxvcount = astatSize;
2604         }
2605     }
2606 #else   /* AFS_OSF_ENV */
2607     freeVCList = (struct vcache *)0;
2608 #endif
2609
2610     RWLOCK_INIT(&afs_xvcache, "afs_xvcache");
2611     LOCK_INIT(&afs_xvcb, "afs_xvcb");
2612
2613 #if     !defined(AFS_OSF_ENV)
2614     /* Allocate and thread the struct vcache entries */
2615     tvp = (struct vcache *) afs_osi_Alloc(astatSize * sizeof(struct vcache));
2616     memset((char *)tvp, 0, sizeof(struct vcache)*astatSize);
2617
2618     Initial_freeVCList = tvp;
2619     freeVCList = &(tvp[0]);
2620     for(i=0; i < astatSize-1; i++) {
2621        tvp[i].nextfree = &(tvp[i+1]);
2622     }   
2623     tvp[astatSize-1].nextfree = (struct vcache *) 0;
2624 #ifdef  AFS_AIX32_ENV
2625     pin((char *)tvp, astatSize * sizeof(struct vcache));        /* XXX */    
2626 #endif
2627 #endif
2628
2629
2630 #if defined(AFS_SGI_ENV)
2631     for(i=0; i < astatSize; i++) {
2632         char name[METER_NAMSZ];
2633         struct vcache *tvc = &tvp[i];
2634
2635         tvc->v.v_number = ++afsvnumbers;
2636         tvc->vc_rwlockid = OSI_NO_LOCKID;
2637         initnsema(&tvc->vc_rwlock, 1, makesname(name, "vrw", tvc->v.v_number));
2638 #ifndef AFS_SGI53_ENV
2639         initnsema(&tvc->v.v_sync, 0, makesname(name, "vsy", tvc->v.v_number));
2640 #endif
2641 #ifndef AFS_SGI62_ENV
2642         initnlock(&tvc->v.v_lock, makesname(name, "vlk", tvc->v.v_number));
2643 #endif /* AFS_SGI62_ENV */
2644     }
2645 #endif
2646
2647     QInit(&VLRU);
2648
2649
2650 }
2651
2652 /*
2653  * shutdown_vcache
2654  *
2655  */
2656 void shutdown_vcache(void)
2657 {
2658     int i;
2659     struct afs_cbr *tsp, *nsp;
2660     /*
2661      * XXX We may potentially miss some of the vcaches because if when there're no
2662      * free vcache entries and all the vcache entries are active ones then we allocate
2663      * an additional one - admittedly we almost never had that occur.
2664      */
2665 #if     !defined(AFS_OSF_ENV)
2666     afs_osi_Free(Initial_freeVCList, afs_cacheStats * sizeof(struct vcache));
2667 #endif
2668 #ifdef  AFS_AIX32_ENV
2669     unpin(Initial_freeVCList, afs_cacheStats * sizeof(struct vcache));
2670 #endif
2671
2672     {
2673         register struct afs_q *tq, *uq;
2674         register struct vcache *tvc;
2675         for (tq = VLRU.prev; tq != &VLRU; tq = uq) {
2676             tvc = QTOV(tq);
2677             uq = QPrev(tq);
2678             if (tvc->mvid) {
2679                 osi_FreeSmallSpace(tvc->mvid);
2680                 tvc->mvid = (struct VenusFid*)0;
2681             }
2682 #ifdef  AFS_AIX_ENV
2683             aix_gnode_rele((struct vnode *)tvc);
2684 #endif
2685             if (tvc->linkData) {
2686                 afs_osi_Free(tvc->linkData, strlen(tvc->linkData)+1);
2687                 tvc->linkData = 0;
2688             }
2689         }
2690         /* 
2691          * Also free the remaining ones in the Cache 
2692          */
2693         for (i=0; i < VCSIZE; i++) {
2694             for (tvc = afs_vhashT[i]; tvc; tvc = tvc->hnext) {
2695                 if (tvc->mvid) {
2696                     osi_FreeSmallSpace(tvc->mvid);
2697                     tvc->mvid = (struct VenusFid*)0;
2698                 }
2699 #ifdef  AFS_AIX_ENV
2700                 if (tvc->v.v_gnode)
2701                     afs_osi_Free(tvc->v.v_gnode, sizeof(struct gnode));
2702 #ifdef  AFS_AIX32_ENV
2703                 if (tvc->segid) {
2704                     AFS_GUNLOCK();
2705                     vms_delete(tvc->segid);
2706                     AFS_GLOCK();
2707                     tvc->segid = tvc->vmh = NULL;
2708                     if (VREFCOUNT(tvc)) osi_Panic("flushVcache: vm race");
2709                 }
2710                 if (tvc->credp) {
2711                     crfree(tvc->credp);
2712                     tvc->credp = NULL;
2713                 }
2714 #endif
2715 #endif
2716 #if     defined(AFS_SUN5_ENV)
2717                 if (tvc->credp) {
2718                     crfree(tvc->credp);
2719                     tvc->credp = NULL;
2720                 }
2721 #endif
2722                 if (tvc->linkData) {
2723                     afs_osi_Free(tvc->linkData, strlen(tvc->linkData)+1);
2724                     tvc->linkData = 0;
2725                 }
2726
2727                 afs_FreeAllAxs(&(tvc->Access));
2728             }
2729             afs_vhashT[i] = 0;
2730         }
2731     }
2732     /*
2733      * Free any leftover callback queue
2734      */
2735     for (tsp = afs_cbrSpace; tsp; tsp = nsp ) {
2736         nsp = tsp->next;
2737         afs_osi_Free((char *)tsp, AFS_NCBRS * sizeof(struct afs_cbr));
2738     }
2739     afs_cbrSpace = 0;
2740
2741 #if     !defined(AFS_OSF_ENV)
2742     freeVCList = Initial_freeVCList = 0;
2743 #endif
2744     RWLOCK_INIT(&afs_xvcache, "afs_xvcache");
2745     LOCK_INIT(&afs_xvcb, "afs_xvcb");
2746     QInit(&VLRU);
2747
2748 }