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