reindent-20030715
[openafs.git] / src / afs / OBSD / osi_vm.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 /* osi_vm.c implements:
12  *
13  * osi_VM_FlushVCache(avc, slept)
14  * osi_ubc_flush_dirty_and_wait(vp, flags)
15  * osi_VM_StoreAllSegments(avc)
16  * osi_VM_TryToSmush(avc, acred, sync)
17  * osi_VM_FlushPages(avc, credp)
18  * osi_VM_Truncate(avc, alen, acred)
19  */
20
21 #include <afsconfig.h>
22 #include "afs/param.h"
23
24 RCSID
25     ("$Header$");
26
27 #include "afs/sysincludes.h"    /* Standard vendor system headers */
28 #include "afs/afsincludes.h"    /* Afs-based standard headers */
29 #include "afs/afs_stats.h"      /* statistics */
30 /* #include <vm/vm_ubc.h> */
31 #include <limits.h>
32 #include <float.h>
33
34 /* Try to discard pages, in order to recycle a vcache entry.
35  *
36  * We also make some sanity checks:  ref count, open count, held locks.
37  *
38  * We also do some non-VM-related chores, such as releasing the cred pointer
39  * (for AIX and Solaris) and releasing the gnode (for AIX).
40  *
41  * Locking:  afs_xvcache lock is held.  If it is dropped and re-acquired,
42  *   *slept should be set to warn the caller.
43  *
44  * Formerly, afs_xvcache was dropped and re-acquired for Solaris, but now it
45  * is not dropped and re-acquired for any platform.  It may be that *slept is
46  * therefore obsolescent.
47  *
48  * OSF/1 Locking:  VN_LOCK has been called.
49  */
50 int
51 osi_VM_FlushVCache(struct vcache *avc, int *slept)
52 {
53     return 0;
54 }
55
56 /* Try to store pages to cache, in order to store a file back to the server.
57  *
58  * Locking:  the vcache entry's lock is held.  It will usually be dropped and
59  * re-obtained.
60  */
61 void
62 osi_VM_StoreAllSegments(struct vcache *avc)
63 {
64 }
65
66 /* Try to invalidate pages, for "fs flush" or "fs flushv"; or
67  * try to free pages, when deleting a file.
68  *
69  * Locking:  the vcache entry's lock is held.  It may be dropped and
70  * re-obtained.
71  *
72  * Since we drop and re-obtain the lock, we can't guarantee that there won't
73  * be some pages around when we return, newly created by concurrent activity.
74  */
75 void
76 osi_VM_TryToSmush(struct vcache *avc, struct AFS_UCRED *acred, int sync)
77 {
78 }
79
80 /* Purge VM for a file when its callback is revoked.
81  *
82  * Locking:  No lock is held, not even the global lock.
83  */
84 void
85 osi_VM_FlushPages(struct vcache *avc, struct AFS_UCRED *credp)
86 {
87 }
88
89 /* Purge pages beyond end-of-file, when truncating a file.
90  *
91  * Locking:  no lock is held, not even the global lock.
92  * activeV is raised.  This is supposed to block pageins, but at present
93  * it only works on Solaris.
94  */
95 void
96 osi_VM_Truncate(struct vcache *avc, int alen, struct AFS_UCRED *acred)
97 {
98 }