74cf37bd00
per letter dated July 22, 1999. Approved by: core
627 lines
10 KiB
Plaintext
627 lines
10 KiB
Plaintext
#
|
|
# Copyright (c) 1992, 1993
|
|
# The Regents of the University of California. All rights reserved.
|
|
#
|
|
# Redistribution and use in source and binary forms, with or without
|
|
# modification, are permitted provided that the following conditions
|
|
# are met:
|
|
# 1. Redistributions of source code must retain the above copyright
|
|
# notice, this list of conditions and the following disclaimer.
|
|
# 2. Redistributions in binary form must reproduce the above copyright
|
|
# notice, this list of conditions and the following disclaimer in the
|
|
# documentation and/or other materials provided with the distribution.
|
|
# 4. Neither the name of the University nor the names of its contributors
|
|
# may be used to endorse or promote products derived from this software
|
|
# without specific prior written permission.
|
|
#
|
|
# THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|
# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
# ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
# OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
# SUCH DAMAGE.
|
|
#
|
|
# @(#)vnode_if.src 8.12 (Berkeley) 5/14/95
|
|
# $FreeBSD$
|
|
#
|
|
|
|
#
|
|
# Above each of the vop descriptors is a specification of the locking
|
|
# protocol used by each vop call. The first column is the name of
|
|
# the variable, the remaining three columns are in, out and error
|
|
# respectively. The "in" column defines the lock state on input,
|
|
# the "out" column defines the state on succesful return, and the
|
|
# "error" column defines the locking state on error exit.
|
|
#
|
|
# The locking value can take the following values:
|
|
# L: locked; not converted to type of lock.
|
|
# A: any lock type.
|
|
# S: locked with shared lock.
|
|
# E: locked with exclusive lock for this process.
|
|
# O: locked with exclusive lock for other process.
|
|
# U: unlocked.
|
|
# -: not applicable. vnode does not yet (or no longer) exists.
|
|
# =: the same on input and output, may be either L or U.
|
|
# X: locked if not nil.
|
|
#
|
|
# The paramater named "vpp" is assumed to be always used with double
|
|
# indirection (**vpp) and that name is hard-codeed in vnode_if.awk !
|
|
#
|
|
# If other such parameters are introduced, they have to be added to
|
|
# the AWK script at the head of the definition of "add_debug_code()".
|
|
#
|
|
|
|
#
|
|
# islocked vp = = =
|
|
#
|
|
vop_islocked {
|
|
IN struct vnode *vp;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
# lookup dvp L ? ?
|
|
# lookup vpp - L -
|
|
#! lookup pre vop_lookup_pre
|
|
#! lookup post vop_lookup_post
|
|
#
|
|
# XXX - the lookup locking protocol defies simple description and depends
|
|
# on the flags and operation fields in the (cnp) structure. Note
|
|
# especially that *vpp may equal dvp and both may be locked.
|
|
#
|
|
vop_lookup {
|
|
IN struct vnode *dvp;
|
|
INOUT struct vnode **vpp;
|
|
IN struct componentname *cnp;
|
|
};
|
|
|
|
#
|
|
#% cachedlookup dvp L ? ?
|
|
#% cachedlookup vpp - L -
|
|
#
|
|
# This must be an exact copy of lookup. See kern/vfs_cache.c for details.
|
|
#
|
|
vop_cachedlookup {
|
|
IN struct vnode *dvp;
|
|
INOUT struct vnode **vpp;
|
|
IN struct componentname *cnp;
|
|
};
|
|
|
|
#
|
|
#% create dvp L L L
|
|
#% create vpp - L -
|
|
#
|
|
vop_create {
|
|
IN struct vnode *dvp;
|
|
OUT struct vnode **vpp;
|
|
IN struct componentname *cnp;
|
|
IN struct vattr *vap;
|
|
};
|
|
|
|
#
|
|
#% whiteout dvp L L L
|
|
#
|
|
vop_whiteout {
|
|
IN struct vnode *dvp;
|
|
IN struct componentname *cnp;
|
|
IN int flags;
|
|
};
|
|
|
|
#
|
|
#% mknod dvp L L L
|
|
#% mknod vpp - L -
|
|
#
|
|
vop_mknod {
|
|
IN struct vnode *dvp;
|
|
OUT struct vnode **vpp;
|
|
IN struct componentname *cnp;
|
|
IN struct vattr *vap;
|
|
};
|
|
|
|
#
|
|
#% open vp L L L
|
|
#
|
|
vop_open {
|
|
IN struct vnode *vp;
|
|
IN int mode;
|
|
IN struct ucred *cred;
|
|
IN struct thread *td;
|
|
IN int fdidx;
|
|
};
|
|
|
|
#
|
|
#% close vp U U U
|
|
#
|
|
vop_close {
|
|
IN struct vnode *vp;
|
|
IN int fflag;
|
|
IN struct ucred *cred;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#% access vp L L L
|
|
#
|
|
vop_access {
|
|
IN struct vnode *vp;
|
|
IN int mode;
|
|
IN struct ucred *cred;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#% getattr vp L L L
|
|
#
|
|
vop_getattr {
|
|
IN struct vnode *vp;
|
|
OUT struct vattr *vap;
|
|
IN struct ucred *cred;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#% setattr vp L L L
|
|
#
|
|
vop_setattr {
|
|
IN struct vnode *vp;
|
|
IN struct vattr *vap;
|
|
IN struct ucred *cred;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#% read vp L L L
|
|
#
|
|
vop_read {
|
|
IN struct vnode *vp;
|
|
INOUT struct uio *uio;
|
|
IN int ioflag;
|
|
IN struct ucred *cred;
|
|
};
|
|
|
|
#
|
|
#% write vp L L L
|
|
#
|
|
vop_write {
|
|
IN struct vnode *vp;
|
|
INOUT struct uio *uio;
|
|
IN int ioflag;
|
|
IN struct ucred *cred;
|
|
};
|
|
|
|
#
|
|
#% lease vp = = =
|
|
#
|
|
vop_lease {
|
|
IN struct vnode *vp;
|
|
IN struct thread *td;
|
|
IN struct ucred *cred;
|
|
IN int flag;
|
|
};
|
|
|
|
#
|
|
#% ioctl vp U U U
|
|
#
|
|
vop_ioctl {
|
|
IN struct vnode *vp;
|
|
IN u_long command;
|
|
IN caddr_t data;
|
|
IN int fflag;
|
|
IN struct ucred *cred;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#% poll vp U U U
|
|
#
|
|
vop_poll {
|
|
IN struct vnode *vp;
|
|
IN int events;
|
|
IN struct ucred *cred;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#% kqfilter vp U U U
|
|
#
|
|
vop_kqfilter {
|
|
IN struct vnode *vp;
|
|
IN struct knote *kn;
|
|
};
|
|
|
|
#
|
|
#% revoke vp U U U
|
|
#
|
|
vop_revoke {
|
|
IN struct vnode *vp;
|
|
IN int flags;
|
|
};
|
|
|
|
#
|
|
#% fsync vp L L L
|
|
#
|
|
vop_fsync {
|
|
IN struct vnode *vp;
|
|
IN struct ucred *cred;
|
|
IN int waitfor;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#% remove dvp L L L
|
|
#% remove vp L L L
|
|
#
|
|
vop_remove {
|
|
IN struct vnode *dvp;
|
|
IN struct vnode *vp;
|
|
IN struct componentname *cnp;
|
|
};
|
|
|
|
#
|
|
#% link tdvp L L L
|
|
#% link vp L L L
|
|
#
|
|
vop_link {
|
|
IN struct vnode *tdvp;
|
|
IN struct vnode *vp;
|
|
IN struct componentname *cnp;
|
|
};
|
|
|
|
#
|
|
# rename fdvp U U U
|
|
# rename fvp U U U
|
|
# rename tdvp L U U
|
|
# rename tvp X U U
|
|
#! rename pre vop_rename_pre
|
|
#
|
|
vop_rename {
|
|
IN WILLRELE struct vnode *fdvp;
|
|
IN WILLRELE struct vnode *fvp;
|
|
IN struct componentname *fcnp;
|
|
IN WILLRELE struct vnode *tdvp;
|
|
IN WILLRELE struct vnode *tvp;
|
|
IN struct componentname *tcnp;
|
|
};
|
|
|
|
#
|
|
#% mkdir dvp L L L
|
|
#% mkdir vpp - L -
|
|
#
|
|
vop_mkdir {
|
|
IN struct vnode *dvp;
|
|
OUT struct vnode **vpp;
|
|
IN struct componentname *cnp;
|
|
IN struct vattr *vap;
|
|
};
|
|
|
|
#
|
|
#% rmdir dvp L L L
|
|
#% rmdir vp L L L
|
|
#
|
|
vop_rmdir {
|
|
IN struct vnode *dvp;
|
|
IN struct vnode *vp;
|
|
IN struct componentname *cnp;
|
|
};
|
|
|
|
#
|
|
#% symlink dvp L L L
|
|
#% symlink vpp - L -
|
|
#
|
|
vop_symlink {
|
|
IN struct vnode *dvp;
|
|
OUT struct vnode **vpp;
|
|
IN struct componentname *cnp;
|
|
IN struct vattr *vap;
|
|
IN char *target;
|
|
};
|
|
|
|
#
|
|
#% readdir vp L L L
|
|
#
|
|
vop_readdir {
|
|
IN struct vnode *vp;
|
|
INOUT struct uio *uio;
|
|
IN struct ucred *cred;
|
|
INOUT int *eofflag;
|
|
OUT int *ncookies;
|
|
INOUT u_long **cookies;
|
|
};
|
|
|
|
#
|
|
#% readlink vp L L L
|
|
#
|
|
vop_readlink {
|
|
IN struct vnode *vp;
|
|
INOUT struct uio *uio;
|
|
IN struct ucred *cred;
|
|
};
|
|
|
|
#
|
|
#% inactive vp L U U
|
|
#
|
|
vop_inactive {
|
|
IN struct vnode *vp;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#% reclaim vp U U U
|
|
#
|
|
vop_reclaim {
|
|
IN struct vnode *vp;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#lock vp ? ? ?
|
|
#! lock pre vop_lock_pre
|
|
#! lock post vop_lock_post
|
|
#
|
|
vop_lock {
|
|
IN struct vnode *vp;
|
|
IN int flags;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#unlock vp L ? L
|
|
#! unlock pre vop_unlock_pre
|
|
#! unlock post vop_unlock_post
|
|
#
|
|
vop_unlock {
|
|
IN struct vnode *vp;
|
|
IN int flags;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#% bmap vp L L L
|
|
#% bmap vpp - U -
|
|
#
|
|
vop_bmap {
|
|
IN struct vnode *vp;
|
|
IN daddr_t bn;
|
|
OUT struct vnode **vpp;
|
|
IN daddr_t *bnp;
|
|
OUT int *runp;
|
|
OUT int *runb;
|
|
};
|
|
|
|
#
|
|
# strategy vp L L L
|
|
#! strategy pre vop_strategy_pre
|
|
#
|
|
vop_strategy {
|
|
IN struct vnode *vp;
|
|
IN struct buf *bp;
|
|
};
|
|
|
|
#
|
|
# specstrategy vp L L L
|
|
#! specstrategy pre vop_strategy_pre
|
|
#
|
|
vop_specstrategy {
|
|
IN struct vnode *vp;
|
|
IN struct buf *bp;
|
|
};
|
|
|
|
#
|
|
#% getwritemount vp = = =
|
|
#
|
|
vop_getwritemount {
|
|
IN struct vnode *vp;
|
|
OUT struct mount **mpp;
|
|
};
|
|
|
|
#
|
|
#% print vp = = =
|
|
#
|
|
vop_print {
|
|
IN struct vnode *vp;
|
|
};
|
|
|
|
#
|
|
#% pathconf vp L L L
|
|
#
|
|
vop_pathconf {
|
|
IN struct vnode *vp;
|
|
IN int name;
|
|
OUT register_t *retval;
|
|
};
|
|
|
|
#
|
|
#% advlock vp U U U
|
|
#
|
|
vop_advlock {
|
|
IN struct vnode *vp;
|
|
IN caddr_t id;
|
|
IN int op;
|
|
IN struct flock *fl;
|
|
IN int flags;
|
|
};
|
|
|
|
#
|
|
#% reallocblks vp L L L
|
|
#
|
|
vop_reallocblks {
|
|
IN struct vnode *vp;
|
|
IN struct cluster_save *buflist;
|
|
};
|
|
|
|
#
|
|
#% getpages vp L L L
|
|
#
|
|
vop_getpages {
|
|
IN struct vnode *vp;
|
|
IN vm_page_t *m;
|
|
IN int count;
|
|
IN int reqpage;
|
|
IN vm_ooffset_t offset;
|
|
};
|
|
|
|
#
|
|
#% putpages vp L L L
|
|
#
|
|
vop_putpages {
|
|
IN struct vnode *vp;
|
|
IN vm_page_t *m;
|
|
IN int count;
|
|
IN int sync;
|
|
IN int *rtvals;
|
|
IN vm_ooffset_t offset;
|
|
};
|
|
|
|
#
|
|
#% freeblks vp - - -
|
|
#
|
|
# This call is used by the filesystem to release blocks back to
|
|
# device-driver. This is useful if the driver has a lengthy
|
|
# erase handling or similar.
|
|
#
|
|
|
|
vop_freeblks {
|
|
IN struct vnode *vp;
|
|
IN daddr_t addr;
|
|
IN daddr_t length;
|
|
};
|
|
|
|
#
|
|
#% getacl vp L L L
|
|
#
|
|
vop_getacl {
|
|
IN struct vnode *vp;
|
|
IN acl_type_t type;
|
|
OUT struct acl *aclp;
|
|
IN struct ucred *cred;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#% setacl vp L L L
|
|
#
|
|
vop_setacl {
|
|
IN struct vnode *vp;
|
|
IN acl_type_t type;
|
|
IN struct acl *aclp;
|
|
IN struct ucred *cred;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#% aclcheck vp = = =
|
|
#
|
|
vop_aclcheck {
|
|
IN struct vnode *vp;
|
|
IN acl_type_t type;
|
|
IN struct acl *aclp;
|
|
IN struct ucred *cred;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#% closeextattr vp L L L
|
|
#
|
|
vop_closeextattr {
|
|
IN struct vnode *vp;
|
|
IN int commit;
|
|
IN struct ucred *cred;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#% getextattr vp L L L
|
|
#
|
|
vop_getextattr {
|
|
IN struct vnode *vp;
|
|
IN int attrnamespace;
|
|
IN const char *name;
|
|
INOUT struct uio *uio;
|
|
OUT size_t *size;
|
|
IN struct ucred *cred;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#% listextattr vp L L L
|
|
#
|
|
vop_listextattr {
|
|
IN struct vnode *vp;
|
|
IN int attrnamespace;
|
|
INOUT struct uio *uio;
|
|
OUT size_t *size;
|
|
IN struct ucred *cred;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#% openextattr vp L L L
|
|
#
|
|
vop_openextattr {
|
|
IN struct vnode *vp;
|
|
IN struct ucred *cred;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#% deleteextattr vp L L L
|
|
#
|
|
vop_deleteextattr {
|
|
IN struct vnode *vp;
|
|
IN int attrnamespace;
|
|
IN const char *name;
|
|
IN struct ucred *cred;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#% setextattr vp L L L
|
|
#
|
|
vop_setextattr {
|
|
IN struct vnode *vp;
|
|
IN int attrnamespace;
|
|
IN const char *name;
|
|
INOUT struct uio *uio;
|
|
IN struct ucred *cred;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#% createvobject vp L L L
|
|
#
|
|
vop_createvobject {
|
|
IN struct vnode *vp;
|
|
IN struct ucred *cred;
|
|
IN struct thread *td;
|
|
};
|
|
|
|
#
|
|
#% destroyvobject vp L L L
|
|
#
|
|
vop_destroyvobject {
|
|
IN struct vnode *vp;
|
|
};
|
|
|
|
#
|
|
#% getvobject vp L L L
|
|
#
|
|
vop_getvobject {
|
|
IN struct vnode *vp;
|
|
OUT struct vm_object **objpp;
|
|
};
|
|
|
|
#
|
|
#% setlabel vp L L L
|
|
#
|
|
vop_setlabel {
|
|
IN struct vnode *vp;
|
|
IN struct label *label;
|
|
IN struct ucred *cred;
|
|
IN struct thread *td;
|
|
};
|