Change *_pager_allocate() to take off_t instead of vm_ooffset_t. The
[dragonfly.git] / sys / sys / vnode.h
1 /*
2  * Copyright (c) 1989, 1993
3  *      The Regents of the University of California.  All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  * 3. All advertising materials mentioning features or use of this software
14  *    must display the following acknowledgement:
15  *      This product includes software developed by the University of
16  *      California, Berkeley and its contributors.
17  * 4. Neither the name of the University nor the names of its contributors
18  *    may be used to endorse or promote products derived from this software
19  *    without specific prior written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31  * SUCH DAMAGE.
32  *
33  *      @(#)vnode.h     8.7 (Berkeley) 2/4/94
34  * $FreeBSD: src/sys/sys/vnode.h,v 1.111.2.19 2002/12/29 18:19:53 dillon Exp $
35  * $DragonFly: src/sys/sys/vnode.h,v 1.43 2006/03/27 01:54:16 dillon Exp $
36  */
37
38 #ifndef _SYS_VNODE_H_
39 #define _SYS_VNODE_H_
40
41 #include <sys/queue.h>
42 #include <sys/lock.h>
43 #include <sys/select.h>
44 #include <sys/biotrack.h>
45 #include <sys/uio.h>
46 #include <sys/acl.h>
47 #include <sys/namecache.h>
48 #if defined(_KERNEL) || defined(_KERNEL_STRUCTURES)
49 #include <sys/thread.h>
50 #endif
51 #include <sys/vfsops.h>
52 #include <sys/vfscache.h>
53 #include <sys/tree.h>
54
55 #include <machine/lock.h>
56
57 /*
58  * The vnode is the focus of all file activity in UNIX.  There is a
59  * unique vnode allocated for each active file, each current directory,
60  * each mounted-on file, text file, and the root.
61  */
62
63 /*
64  * Each underlying filesystem allocates its own private area and hangs
65  * it from v_data.  If non-null, this area is freed in getnewvnode().
66  */
67 TAILQ_HEAD(buflists, buf);
68
69 /*
70  * Range locks protect offset ranges in files and directories at a high
71  * level, allowing the actual I/O to be broken down into smaller pieces.
72  * Range locks will eventually be integrated into the clustered cache
73  * coherency infrastructure.
74  *
75  * We use a simple data structure for now, but eventually this should 
76  * probably be a btree or red-black tree.
77  */
78 struct vrangelock;
79
80 TAILQ_HEAD(vrangelock_list, vrangelock);
81
82 struct vrangehead {
83         struct vrangelock_list  vh_list;
84 };
85
86 struct vrangelock {
87         TAILQ_ENTRY(vrangelock) vr_node;
88         int             vr_flags;
89         off_t           vr_offset;
90         off_t           vr_length;
91 };
92
93 #define RNGL_WAITING    0x0001          /* waiting for lock, else has lock */
94 #define RNGL_CHECK      0x0002          /* check for work on unlock */
95 #define RNGL_SHARED     0x0004          /* shared lock, else exclusive */
96 #define RNGL_ONLIST     0x0008          /* sanity check */
97
98 static __inline
99 void
100 vrange_init(struct vrangelock *vr, int flags, off_t offset, off_t length)
101 {
102         vr->vr_flags = flags;
103         vr->vr_offset = offset;
104         vr->vr_length = length;
105 }
106
107 #ifdef _KERNEL
108
109 void    vrange_lock(struct vnode *vp, struct vrangelock *vr);
110 void    vrange_unlock(struct vnode *vp, struct vrangelock *vr);
111
112 static __inline
113 void
114 vrange_lock_shared(struct vnode *vp, struct vrangelock *vr, 
115                     off_t offset, off_t length)
116 {
117         vrange_init(vr, RNGL_SHARED, offset, length);
118         vrange_lock(vp, vr);
119 }
120
121 static __inline
122 void
123 vrange_lock_excl(struct vnode *vp, struct vrangelock *vr,
124                     off_t offset, off_t length)
125 {
126         vrange_init(vr, 0, offset, length);
127         vrange_lock(vp, vr);
128 }
129
130 #endif
131
132 /*
133  * The vnode infrastructure is being reorgranized.  Most reference-related
134  * fields are locked by the BGL, and most file I/O related operations and
135  * vnode teardown functions are locked by the vnode lock.
136  *
137  * File read operations require a shared lock, file write operations require
138  * an exclusive lock.  Most directory operations (read or write) currently
139  * require an exclusive lock due to the side effects stored in the directory
140  * inode (which we intend to fix).
141  *
142  * File reads and writes are further protected by a range lock.  The intention
143  * is to be able to break I/O operations down into more easily managed pieces
144  * so vm_page arrays can be passed through rather then UIOs.  This work will
145  * occur in multiple stages.  The range locks will also eventually be used to
146  * deal with clustered cache coherency issues and, more immediately, to
147  * protect operations associated with the kernel-managed journaling module.
148  *
149  * NOTE: XXX v_opencount currently only used by specfs.  It should be used
150  *       universally.  
151  *
152  * NOTE: The vnode operations vector, v_ops, is a double-indirect that
153  *       typically points to &v_mount->mnt_vn_use_ops.  We use a double
154  *       pointer because mnt_vn_use_ops may change dynamically when e.g.
155  *       journaling is turned on or off.
156  *
157  * NOTE: v_filesize is currently only applicable when a VM object is
158  *       associated with the vnode.  Otherwise it will be set to NOOFFSET.
159  */
160 RB_HEAD(buf_rb_tree, buf);
161 RB_HEAD(buf_rb_hash, buf);
162
163 struct vnode {
164         u_long  v_flag;                         /* vnode flags (see below) */
165         int     v_usecount;                     /* reference count of users */
166         int     v_writecount;
167         int     v_holdcnt;                      /* page & buffer references */
168         int     v_opencount;                    /* number of explicit opens */
169         struct bio_track v_track_read;          /* track I/O's in progress */
170         struct bio_track v_track_write;         /* track I/O's in progress */
171         u_long  v_id;                           /* capability identifier */
172         struct  mount *v_mount;                 /* ptr to vfs we are in */
173         struct  vop_ops **v_ops;                /* vnode operations vector */
174         TAILQ_ENTRY(vnode) v_freelist;          /* vnode freelist */
175         TAILQ_ENTRY(vnode) v_nmntvnodes;        /* vnodes for mount point */
176         struct buf_rb_tree v_rbclean_tree;      /* RB tree of clean bufs */
177         struct buf_rb_tree v_rbdirty_tree;      /* RB tree of dirty bufs */
178         struct buf_rb_hash v_rbhash_tree;       /* RB tree general lookup */
179         LIST_ENTRY(vnode) v_synclist;           /* vnodes with dirty buffers */
180         enum    vtype v_type;                   /* vnode type */
181         union {
182                 struct mount    *vu_mountedhere;/* ptr to mounted vfs (VDIR) */
183                 struct socket   *vu_socket;     /* unix ipc (VSOCK) */
184                 struct {
185                         udev_t  vu_udev;        /* device number for attach */
186                         struct specinfo *vu_specinfo; /* device (VCHR, VBLK) */
187                         SLIST_ENTRY(vnode) vu_specnext;
188                 } vu_spec;
189                 struct fifoinfo *vu_fifoinfo;   /* fifo (VFIFO) */
190         } v_un;
191         struct  nqlease *v_lease;               /* Soft reference to lease */
192         off_t   v_filesize;                     /* file EOF or NOOFFSET */
193         off_t   v_lazyw;                        /* lazy write iterator */
194         off_t   v_lastw;                        /* last write (write cluster) */
195         off_t   v_cstart;                       /* start block of cluster */
196         off_t   v_lasta;                        /* last allocation */
197         int     v_clen;                         /* length of current cluster */
198         struct vm_object *v_object;             /* Place to store VM object */
199         struct  lock v_lock;                    /* file/dir ops lock */
200         enum    vtagtype v_tag;                 /* type of underlying data */
201         void    *v_data;                        /* private data for fs */
202         struct namecache_list v_namecache;      /* associated nc entries */
203         struct  {
204                 struct  lwkt_token vpi_token;   /* lock to protect below */
205                 struct  selinfo vpi_selinfo;    /* identity of poller(s) */
206                 short   vpi_events;             /* what they are looking for */
207                 short   vpi_revents;            /* what has happened */
208         } v_pollinfo;
209         struct vmresident *v_resident;          /* optional vmresident */
210         struct vrangehead v_range;              /* range lock */
211 #ifdef  DEBUG_LOCKS
212         const char *filename;                   /* Source file doing locking */
213         int line;                               /* Line number doing locking */
214 #endif
215         void    *v_xaddr;
216 };
217 #define v_mountedhere   v_un.vu_mountedhere
218 #define v_socket        v_un.vu_socket
219 #define v_udev          v_un.vu_spec.vu_udev
220 #define v_rdev          v_un.vu_spec.vu_specinfo
221 #define v_specnext      v_un.vu_spec.vu_specnext
222 #define v_fifoinfo      v_un.vu_fifoinfo
223
224 #define VN_POLLEVENT(vp, events)                                \
225         do {                                                    \
226                 if ((vp)->v_pollinfo.vpi_events & (events))     \
227                         vn_pollevent((vp), (events));           \
228         } while (0)
229
230 /*
231  * Vnode flags.
232  */
233 #define VROOT           0x00001 /* root of its file system */
234 #define VTEXT           0x00002 /* vnode is a pure text prototype */
235 #define VSYSTEM         0x00004 /* vnode being used by kernel */
236 #define VISTTY          0x00008 /* vnode represents a tty */
237 #define VCTTYISOPEN     0x00010 /* controlling terminal tty is open */
238 #define VCKPT           0x00020 /* checkpoint-restored vnode */
239 /* open for business    0x00040 */
240 /* open for business    0x00080 */
241 /* open for business    0x00100 */
242 /* open for business    0x00200 */
243 /* open for business    0x00400 */
244 /* open for business    0x00800 */
245 /* open for business    0x01000 */
246 #define VOBJBUF         0x02000 /* Allocate buffers in VM object */
247 #define VINACTIVE       0x04000 /* The vnode is inactive */
248 #define VAGE            0x08000 /* Insert vnode at head of free list */
249 #define VOLOCK          0x10000 /* vnode is locked waiting for an object */
250 #define VOWANT          0x20000 /* a process is waiting for VOLOCK */
251 #define VRECLAIMED      0x40000 /* This vnode has been destroyed */
252 #define VFREE           0x80000 /* This vnode is on the freelist */
253 /* open for business    0x100000 */
254 #define VONWORKLST      0x200000 /* On syncer work-list */
255 #define VMOUNT          0x400000 /* Mount in progress */
256 #define VOBJDIRTY       0x800000 /* object might be dirty */
257
258 /*
259  * vmntvnodescan() flags
260  */
261 #define VMSC_GETVP      1
262 #define VMSC_GETVX      2
263 #define VMSC_REFVP      3
264 #define VMSC_NOWAIT     0x10
265
266 /*
267  * Flags for ioflag. (high 16 bits used to ask for read-ahead and
268  * help with write clustering)
269  */
270 #define IO_UNIT         0x0001          /* do I/O as atomic unit */
271 #define IO_APPEND       0x0002          /* append write to end */
272 #define IO_SYNC         0x0004          /* do I/O synchronously */
273 #define IO_NODELOCKED   0x0008          /* underlying node already locked */
274 #define IO_NDELAY       0x0010          /* FNDELAY flag set in file table */
275 #define IO_VMIO         0x0020          /* data already in VMIO space */
276 #define IO_INVAL        0x0040          /* invalidate after I/O */
277 #define IO_ASYNC        0x0080          /* bawrite rather then bdwrite */
278 #define IO_DIRECT       0x0100          /* attempt to bypass buffer cache */
279 #define IO_NOWDRAIN     0x0200          /* do not block on wdrain */
280 #define IO_CORE         0x0400          /* I/O is part of core dump */
281
282 #define IO_SEQMAX       0x7F            /* seq heuristic max value */
283 #define IO_SEQSHIFT     16              /* seq heuristic in upper 16 bits */
284
285 /*
286  * Modes.  Note that these V-modes must match file S_I*USR, SUID, SGID,
287  * and SVTX flag bits.
288  *
289  * VCREATE, VDELETE, and VEXCL may only be used in naccess() calls.
290  */
291 #define VDELETE 040000          /* delete if the file/dir exists */
292 #define VCREATE 020000          /* create if the file/dir does not exist */
293 #define VEXCL   010000          /* error if the file/dir already exists */
294
295 #define VSUID   04000           /* set user id on execution */
296 #define VSGID   02000           /* set group id on execution */
297 #define VSVTX   01000           /* save swapped text even after use */
298 #define VREAD   00400           /* read, write, execute permissions */
299 #define VWRITE  00200
300 #define VEXEC   00100
301
302 /*
303  * Token indicating no attribute value yet assigned.
304  */
305 #define VNOVAL  (-1)
306
307 /*
308  * LK_TIMELOCK timeout for vnode locks (used mainly by the pageout daemon)
309  */
310 #define VLKTIMEOUT     (hz / 20 + 1)
311
312 #ifdef _KERNEL
313
314 /*
315  * Convert between vnode types and inode formats (since POSIX.1
316  * defines mode word of stat structure in terms of inode formats).
317  */
318 extern  enum vtype      iftovt_tab[];
319 extern  int             vttoif_tab[];
320 #define IFTOVT(mode)    (iftovt_tab[((mode) & S_IFMT) >> 12])
321 #define VTTOIF(indx)    (vttoif_tab[(int)(indx)])
322 #define MAKEIMODE(indx, mode)   (int)(VTTOIF(indx) | (mode))
323
324 /*
325  * Flags to various vnode functions.
326  */
327 #define SKIPSYSTEM      0x0001          /* vflush: skip vnodes marked VSYSTEM */
328 #define FORCECLOSE      0x0002          /* vflush: force file closure */
329 #define WRITECLOSE      0x0004          /* vflush: only close writable files */
330 #define DOCLOSE         0x0008          /* vclean: close active files */
331 #define V_SAVE          0x0001          /* vinvalbuf: sync file first */
332 #define REVOKEALL       0x0001          /* vop_revoke: revoke all aliases */
333
334 #ifdef DIAGNOSTIC
335 #define VATTR_NULL(vap) vattr_null(vap)
336 #else
337 #define VATTR_NULL(vap) (*(vap) = va_null)      /* initialize a vattr */
338 #endif /* DIAGNOSTIC */
339
340 #define NULLVP  ((struct vnode *)NULL)
341
342 #define VNODEOP_SET(f) \
343         C_SYSINIT(f##init, SI_SUB_VFS, SI_ORDER_SECOND, vfs_add_vnodeops_sysinit, &f); \
344         C_SYSUNINIT(f##uninit, SI_SUB_VFS, SI_ORDER_SECOND,vfs_rm_vnodeops_sysinit, &f);
345
346 /*
347  * Global vnode data.
348  */
349 extern  struct vnode *rootvnode;        /* root (i.e. "/") vnode */
350 extern  struct namecache *rootncp;      /* root (i.e. "/") namecache */
351 extern  int desiredvnodes;              /* number of vnodes desired */
352 extern  time_t syncdelay;               /* max time to delay syncing data */
353 extern  time_t filedelay;               /* time to delay syncing files */
354 extern  time_t dirdelay;                /* time to delay syncing directories */
355 extern  time_t metadelay;               /* time to delay syncing metadata */
356 extern  struct vm_zone *namei_zone;
357 extern  int prtactive;                  /* nonzero to call vprint() */
358 extern  struct vattr va_null;           /* predefined null vattr structure */
359 extern  int vfs_ioopt;
360 extern  int numvnodes;
361 extern  int freevnodes;
362 extern  int vfs_fastdev;                /* fast specfs device access */
363
364 /*
365  * Macro/function to check for client cache inconsistency w.r.t. leasing.
366  */
367 #define LEASE_READ      0x1             /* Check lease for readers */
368 #define LEASE_WRITE     0x2             /* Check lease for modifiers */
369
370
371 extern void     (*lease_updatetime) (int deltat);
372
373 #endif /* _KERNEL */
374
375 /*
376  * Mods for extensibility.
377  */
378
379 /*
380  * Flags for vdesc_flags:
381  */
382 #define VDESC_MAX_VPS           8
383 /* Low order 8 flag bits are reserved for willrele flags for vp arguments. */
384 #define VDESC_VP0_WILLRELE      0x00000001
385 #define VDESC_VP1_WILLRELE      0x00000002
386 #define VDESC_VP2_WILLRELE      0x00000004
387 #define VDESC_VP3_WILLRELE      0x00000008
388 #define VDESC_VP4_WILLRELE      0x00000010
389 #define VDESC_VP5_WILLRELE      0x00000020
390 #define VDESC_VP6_WILLRELE      0x00000040
391 #define VDESC_VP7_WILLRELE      0x00000080
392 #define VDESC_NOMAP_VPP         0x00000100
393 #define VDESC_VPP_WILLRELE      0x00000200
394 #define VDESC_VP0_WILLUNLOCK    0x00010000
395 #define VDESC_VP1_WILLUNLOCK    0x00020000
396 #define VDESC_VP2_WILLUNLOCK    0x00040000
397 #define VDESC_VP3_WILLUNLOCK    0x00080000
398 #define VDESC_VP4_WILLUNLOCK    0x00100000
399 #define VDESC_VP5_WILLUNLOCK    0x00200000
400 #define VDESC_VP6_WILLUNLOCK    0x00400000
401 #define VDESC_VP7_WILLUNLOCK    0x00800000
402
403 /*
404  * VDESC_NO_OFFSET is used to identify the end of the offset list
405  * and in places where no such field exists.
406  */
407 #define VDESC_NO_OFFSET -1
408
409 /*
410  * This structure describes the vnode operation taking place.
411  */
412 struct vnodeop_desc {
413         int     vdesc_offset;           /* offset in vector--first for speed */
414         char    *vdesc_name;            /* a readable name for debugging */
415         int     vdesc_flags;            /* VDESC_* flags */
416
417         /*
418          * These ops are used by bypass routines to map and locate arguments.
419          * Creds and procs are not needed in bypass routines, but sometimes
420          * they are useful to (for example) transport layers.
421          * Nameidata is useful because it has a cred in it.
422          */
423         int     *vdesc_vp_offsets;      /* list ended by VDESC_NO_OFFSET */
424         int     vdesc_vpp_offset;       /* return vpp location */
425         int     vdesc_cred_offset;      /* cred location, if any */
426         int     vdesc_proc_offset;      /* proc location, if any */
427         int     vdesc_componentname_offset; /* if any */
428 };
429
430 #ifdef _KERNEL
431 /*
432  * A list of all the operation descs.
433  */
434 extern struct vnodeop_desc *vnodeop_descs[];
435
436 /*
437  * Interlock for scanning list of vnodes attached to a mountpoint
438  */
439 extern struct lwkt_token mntvnode_token;
440
441 /*
442  * This macro is very helpful in defining those offsets in the vdesc struct.
443  *
444  * This is stolen from X11R4.  I ignored all the fancy stuff for
445  * Crays, so if you decide to port this to such a serious machine,
446  * you might want to consult Intrinsic.h's XtOffset{,Of,To}.
447  */
448 #define VOPARG_OFFSET(p_type,field) \
449         ((int) (((char *) (&(((p_type)NULL)->field))) - ((char *) NULL)))
450 #define VOPARG_OFFSETOF(s_type,field) \
451         VOPARG_OFFSET(s_type*,field)
452 #define VOPARG_OFFSETTO(S_TYPE,S_OFFSET,STRUCT_P) \
453         ((S_TYPE)(((char*)(STRUCT_P))+(S_OFFSET)))
454
455 typedef int (*vnodeopv_entry_t)(struct vop_generic_args *);
456
457 /*
458  * This structure is used to configure the new vnodeops vector.  The entry
459  * descriptor describes a patricular VOP function while the operations
460  * vector descriptor recursively describes arrays of entry descriptors.
461  */
462 struct vnodeopv_entry_desc {
463         struct vnodeop_desc *opve_op;
464         vnodeopv_entry_t opve_func;
465 };
466
467 struct vnodeopv_desc {
468         struct vop_ops **opv_desc_vector;           /* vect to allocate/fill*/
469         struct vnodeopv_entry_desc *opv_desc_ops;   /* null terminated list */
470         int opv_flags;
471 };
472
473 struct vnodeopv_node {
474         TAILQ_ENTRY(vnodeopv_node)      entry;
475         struct vop_ops                  *ops;       /* allocated vector */
476         struct vnodeopv_entry_desc      *descs;     /* null terminated list */
477 };
478
479 #ifdef DEBUG_VFS_LOCKS
480 /*
481  * Macros to aid in tracing VFS locking problems.  Not totally
482  * reliable since if the process sleeps between changing the lock
483  * state and checking it with the assert, some other process could
484  * change the state.  They are good enough for debugging a single
485  * filesystem using a single-threaded test.  I find that 'cvs co src'
486  * is a pretty good test.
487  */
488
489 /*
490  * [dfr] Kludge until I get around to fixing all the vfs locking.
491  */
492 #define IS_LOCKING_VFS(vp)      ((vp)->v_tag == VT_UFS          \
493                                  || (vp)->v_tag == VT_MFS       \
494                                  || (vp)->v_tag == VT_NFS       \
495                                  || (vp)->v_tag == VT_LFS       \
496                                  || (vp)->v_tag == VT_ISOFS     \
497                                  || (vp)->v_tag == VT_MSDOSFS)
498
499 #define ASSERT_VOP_LOCKED(vp, str) assert_vop_locked(vp, str)
500 #define ASSERT_VOP_UNLOCKED(vp, str) assert_vop_unlocked(vp, str);
501
502 #define ASSERT_VOP_ELOCKED(vp, str)                                     \
503 do {                                                                    \
504         struct vnode *_vp = (vp);                                       \
505                                                                         \
506         if (_vp && IS_LOCKING_VFS(_vp) &&                               \
507             VOP_ISLOCKED(_vp, curthread) != LK_EXCLUSIVE)               \
508                 panic("%s: %p is not exclusive locked but should be",   \
509                     str, _vp);                                          \
510 } while (0)
511
512 #define ASSERT_VOP_ELOCKED_OTHER(vp, str)                               \
513 do {                                                                    \
514         struct vnode *_vp = (vp);                                       \
515                                                                         \
516         if (_vp && IS_LOCKING_VFS(_vp) &&                               \
517             VOP_ISLOCKED(_vp, curthread) != LK_EXCLOTHER)               \
518                 panic("%s: %p is not exclusive locked by another proc", \
519                     str, _vp);                                          \
520 } while (0)
521
522 #define ASSERT_VOP_SLOCKED(vp, str)                                     \
523 do {                                                                    \
524         struct vnode *_vp = (vp);                                       \
525                                                                         \
526         if (_vp && IS_LOCKING_VFS(_vp) &&                               \
527             VOP_ISLOCKED(_vp, NULL) != LK_SHARED)                       \
528                 panic("%s: %p is not locked shared but should be",      \
529                     str, _vp);                                          \
530 } while (0)
531
532 void    assert_vop_locked(struct vnode *vp, const char *str);
533 void    assert_vop_unlocked(struct vnode *vp, const char *str);
534
535 #else
536
537 #define ASSERT_VOP_LOCKED(vp, str)
538 #define ASSERT_VOP_UNLOCKED(vp, str)
539
540 #endif /* DEBUG_VFS_LOCKS */
541
542 /*
543  * VOCALL calls an op given an ops vector.  We break it out because BSD's
544  * vclean changes the ops vector and then wants to call ops with the old
545  * vector.
546  */
547
548 typedef int (*vocall_func_t)(struct vop_generic_args *);
549
550 /*
551  * This call executes the vops vector for the offset stored in the ap's
552  * descriptor of the passed vops rather then the one related to the
553  * ap's vop_ops structure.  It is used to chain VOPS calls on behalf of
554  * filesystems from a VFS's context ONLY (that is, from a VFS's own vops
555  * vector function).
556  */
557 #define VOCALL(vops, ap)                \
558         (*(vocall_func_t *)((char *)(vops)+((ap)->a_desc->vdesc_offset)))(ap)
559
560 #define VDESC(OP) (& __CONCAT(OP,_desc))
561 #define VOFFSET(OP) (VDESC(OP)->vdesc_offset)
562
563 /*
564  * VMIO support inline
565  */
566
567 extern int vmiodirenable;
568  
569 static __inline int
570 vn_canvmio(struct vnode *vp) 
571 {
572     if (vp && (vp->v_type == VREG || (vmiodirenable && vp->v_type == VDIR)))
573         return(TRUE); 
574     return(FALSE); 
575 }
576
577 /*
578  * Public vnode manipulation functions.
579  */
580 struct file;
581 struct mount;
582 struct nlookupdata;
583 struct proc;
584 struct thread;
585 struct stat;
586 struct ucred;
587 struct uio;
588 struct vattr;
589 struct vnode;
590 struct vop_bwrite_args;
591
592 extern int      (*lease_check_hook) (struct vop_lease_args *);
593
594 void    addaliasu (struct vnode *vp, udev_t nvp_udev);
595 int     v_associate_rdev(struct vnode *vp, dev_t dev);
596 void    v_release_rdev(struct vnode *vp);
597 int     bdevvp (dev_t dev, struct vnode **vpp);
598 struct vnode *allocvnode(int lktimeout, int lkflags);
599 int     getnewvnode (enum vtagtype tag, struct mount *mp, 
600                     struct vnode **vpp, int timo, int lkflags);
601 int     getspecialvnode (enum vtagtype tag, struct mount *mp, 
602                     struct vop_ops **ops, struct vnode **vpp, int timo, 
603                     int lkflags);
604 int     lease_check (struct vop_lease_args *ap);
605 int     spec_vnoperate (struct vop_generic_args *);
606 int     speedup_syncer (void);
607 void    vattr_null (struct vattr *vap);
608 int     vcount (struct vnode *vp);
609 int     vfinddev (dev_t dev, enum vtype type, struct vnode **vpp);
610 void    vfs_add_vnodeops_sysinit (const void *);
611 void    vfs_rm_vnodeops_sysinit (const void *);
612 void    vfs_add_vnodeops(struct mount *, struct vop_ops **,
613                         struct vnodeopv_entry_desc *, int);
614 void    vfs_rm_vnodeops(struct vop_ops **);
615 int     vflush (struct mount *mp, int rootrefs, int flags);
616 int     vmntvnodescan(struct mount *mp, int flags,
617             int (*fastfunc)(struct mount *mp, struct vnode *vp, void *data),
618             int (*slowfunc)(struct mount *mp, struct vnode *vp, void *data),
619             void *data);
620 void    insmntque(struct vnode *vp, struct mount *mp);
621
622 void    vclean (struct vnode *vp, int flags, struct thread *td);
623 void    vgone (struct vnode *vp);
624 int     vinvalbuf (struct vnode *vp, int save, 
625             struct thread *td, int slpflag, int slptimeo);
626 int     vtruncbuf (struct vnode *vp, struct thread *td,
627                 off_t length, int blksize);
628 int     vfsync(struct vnode *vp, int waitfor, int passes, off_t loffset,
629                 int (*checkdef)(struct buf *),
630                 int (*waitoutput)(struct vnode *, struct thread *));
631 void    vprint (char *label, struct vnode *vp);
632 int     vrecycle (struct vnode *vp, struct thread *td);
633 void    vn_strategy(struct vnode *vp, struct bio *bio);
634 int     vn_close (struct vnode *vp, int flags, struct thread *td);
635 int     vn_isdisk (struct vnode *vp, int *errp);
636 int     vn_lock (struct vnode *vp, int flags, struct thread *td);
637 #ifdef  DEBUG_LOCKS
638 int     debug_vn_lock (struct vnode *vp, int flags, struct thread *td,
639             const char *filename, int line);
640 #define vn_lock(vp,flags,p) debug_vn_lock(vp,flags,p,__FILE__,__LINE__)
641 #endif
642
643 int     vn_get_namelen(struct vnode *, int *);
644 void    vn_setspecops (struct file *fp);
645 int     vn_fullpath (struct proc *p, struct vnode *vn, char **retbuf, char **freebuf);
646 int     vn_open (struct nlookupdata *ndp, struct file *fp, int fmode, int cmode);
647 void    vn_pollevent (struct vnode *vp, int events);
648 void    vn_pollgone (struct vnode *vp);
649 int     vn_pollrecord (struct vnode *vp, struct thread *td, int events);
650 int     vn_rdwr (enum uio_rw rw, struct vnode *vp, caddr_t base,
651             int len, off_t offset, enum uio_seg segflg, int ioflg,
652             struct ucred *cred, int *aresid, struct thread *td);
653 int     vn_rdwr_inchunks (enum uio_rw rw, struct vnode *vp, caddr_t base,
654             int len, off_t offset, enum uio_seg segflg, int ioflg,
655             struct ucred *cred, int *aresid, struct thread *td);
656 int     vn_stat (struct vnode *vp, struct stat *sb, struct thread *td);
657 dev_t   vn_todev (struct vnode *vp);
658 int     vfs_object_create (struct vnode *vp, struct thread *td);
659 void    vfs_timestamp (struct timespec *);
660 int     vn_writechk (struct vnode *vp);
661 int     vop_stdbwrite (struct vop_bwrite_args *ap);
662 int     vop_stdislocked (struct vop_islocked_args *ap);
663 int     vop_stdlock (struct vop_lock_args *ap);
664 int     vop_stdrlock (struct vop_lock_args *ap);
665 int     vop_stdunlock (struct vop_unlock_args *ap);
666 int     vop_nopoll (struct vop_poll_args *ap);
667 int     vop_stdpathconf (struct vop_pathconf_args *ap);
668 int     vop_stdpoll (struct vop_poll_args *ap);
669 int     vop_stdrevoke (struct vop_revoke_args *ap);
670 int     vop_eopnotsupp (struct vop_generic_args *ap);
671 int     vop_ebadf (struct vop_generic_args *ap);
672 int     vop_einval (struct vop_generic_args *ap);
673 int     vop_enotty (struct vop_generic_args *ap);
674 int     vop_defaultop (struct vop_generic_args *ap);
675 int     vop_null (struct vop_generic_args *ap);
676 int     vop_panic (struct vop_generic_args *ap);
677 int     vop_stdcreatevobject (struct vop_createvobject_args *ap);
678 int     vop_stddestroyvobject (struct vop_destroyvobject_args *ap);
679 int     vop_stdgetvobject (struct vop_getvobject_args *ap);
680 int     vop_write_dirent(int *, struct uio *, ino_t, uint8_t, uint16_t,
681                          const char *);
682
683 int     vop_compat_nresolve(struct vop_nresolve_args *ap);
684 int     vop_compat_nlookupdotdot(struct vop_nlookupdotdot_args *ap);
685 int     vop_compat_ncreate(struct vop_ncreate_args *ap);
686 int     vop_compat_nmkdir(struct vop_nmkdir_args *ap);
687 int     vop_compat_nmknod(struct vop_nmknod_args *ap);
688 int     vop_compat_nlink(struct vop_nlink_args *ap);
689 int     vop_compat_nsymlink(struct vop_nsymlink_args *ap);
690 int     vop_compat_nwhiteout(struct vop_nwhiteout_args *ap);
691 int     vop_compat_nremove(struct vop_nremove_args *ap);
692 int     vop_compat_nrmdir(struct vop_nrmdir_args *ap);
693 int     vop_compat_nrename(struct vop_nrename_args *ap);
694
695 int     vx_lock (struct vnode *vp);
696 void    vx_unlock (struct vnode *vp);
697 int     vx_get (struct vnode *vp);
698 int     vx_get_nonblock (struct vnode *vp);
699 void    vx_put (struct vnode *vp);
700 int     vget (struct vnode *vp, int lockflag, struct thread *td);
701 void    vput (struct vnode *vp);
702 void    vhold (struct vnode *);
703 void    vdrop (struct vnode *);
704 void    vref (struct vnode *vp);
705 void    vrele (struct vnode *vp);
706 void    vsetflags (struct vnode *vp, int flags);
707 void    vclrflags (struct vnode *vp, int flags);
708
709 void    vfs_subr_init(void);
710 void    vfs_mount_init(void);
711 void    vfs_lock_init(void);
712 void    vfs_sync_init(void);
713
714 void    vn_syncer_add_to_worklist(struct vnode *, int);
715 void    vnlru_proc_wait(void);
716
717 extern  struct vop_ops *default_vnode_vops;
718 extern  struct vop_ops *spec_vnode_vops;
719 extern  struct vop_ops *dead_vnode_vops;
720
721 #endif /* _KERNEL */
722
723 #endif /* !_SYS_VNODE_H_ */