528 lines
10 KiB
Plaintext
528 lines
10 KiB
Plaintext
# $NetBSD: vnode_if.src,v 1.20 1999/08/11 00:20:50 wrstuden Exp $
|
|
#
|
|
# 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.
|
|
# 3. All advertising materials mentioning features or use of this software
|
|
# must display the following acknowledgement:
|
|
# This product includes software developed by the University of
|
|
# California, Berkeley and its contributors.
|
|
# 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.14 (Berkeley) 8/6/95
|
|
#
|
|
#
|
|
|
|
#
|
|
# 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.
|
|
# 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.
|
|
#
|
|
|
|
#
|
|
#% lookup dvp L ? ?
|
|
#% lookup vpp - L -
|
|
#
|
|
# 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.
|
|
#
|
|
# More details:
|
|
# There are three types of lookups: ".", ".." (ISDOTDOT), and other.
|
|
# On successful lookup of ".", a reference is added to dvp, and it
|
|
# is returned in *vpp.
|
|
# To look up ISDOTDOT, dvp is unlocked, the ".." node is locked, and
|
|
# then dvp is relocked iff LOCKPARENT is set and this is the last
|
|
# component name (ISLASTCN set). This preserves the
|
|
# protocol of always locking nodes from root ("/") downward and
|
|
# prevents deadlock.
|
|
# Other lookups find the named node (creating the vnode if needed) and
|
|
# return it, locked, in *vpp.
|
|
# For non-"." lookups, if LOCKPARENT is not set or this was not the
|
|
# last component name, dvp is returned unlocked on a successful
|
|
# lookup.
|
|
# On failure, *vpp is NULL, and *dvp is left locked. If there was
|
|
# an error re-locking dvp in the ISDOTDOT case, an error is
|
|
# returned with PDIRUNLOCK set.
|
|
#
|
|
# *vpp is always locked on return if the operation succeeds.
|
|
# typically, if *vpp == dvp, you need to release twice, but unlock once.
|
|
#
|
|
# The PDIRUNLOCK flag is set when dvp is unlocked in the lookup routine.
|
|
# It signals the caller that dvp's lock state changed. It will
|
|
# be set on exit if either a successful lookup unlocked the
|
|
# parrent, or there was an error re-locking dvp in the ISDOTDOT case.
|
|
#
|
|
vop_lookup {
|
|
IN struct vnode *dvp;
|
|
INOUT struct vnode **vpp;
|
|
IN struct componentname *cnp;
|
|
};
|
|
|
|
#
|
|
#% create dvp L U U
|
|
#% create vpp - L -
|
|
#
|
|
vop_create {
|
|
IN WILLPUT struct vnode *dvp;
|
|
OUT struct vnode **vpp;
|
|
IN struct componentname *cnp;
|
|
IN struct vattr *vap;
|
|
};
|
|
|
|
#
|
|
#% mknod dvp L U U
|
|
#% mknod vpp - X -
|
|
#
|
|
vop_mknod {
|
|
IN WILLPUT struct vnode *dvp;
|
|
OUT WILLRELE 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 proc *p;
|
|
};
|
|
|
|
#
|
|
#% close vp L L L
|
|
#
|
|
vop_close {
|
|
IN struct vnode *vp;
|
|
IN int fflag;
|
|
IN struct ucred *cred;
|
|
IN struct proc *p;
|
|
};
|
|
|
|
#
|
|
#% access vp L L L
|
|
#
|
|
vop_access {
|
|
IN struct vnode *vp;
|
|
IN int mode;
|
|
IN struct ucred *cred;
|
|
IN struct proc *p;
|
|
};
|
|
|
|
#
|
|
#% getattr vp = = =
|
|
#
|
|
vop_getattr {
|
|
IN struct vnode *vp;
|
|
IN struct vattr *vap;
|
|
IN struct ucred *cred;
|
|
IN struct proc *p;
|
|
};
|
|
|
|
#
|
|
#% setattr vp L L L
|
|
#
|
|
vop_setattr {
|
|
IN struct vnode *vp;
|
|
IN struct vattr *vap;
|
|
IN struct ucred *cred;
|
|
IN struct proc *p;
|
|
};
|
|
|
|
#
|
|
#% 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;
|
|
};
|
|
|
|
#
|
|
#% 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 proc *p;
|
|
};
|
|
|
|
#
|
|
#% fcntl vp L L L
|
|
#
|
|
vop_fcntl {
|
|
IN struct vnode *vp;
|
|
IN u_int command;
|
|
IN caddr_t data;
|
|
IN int fflag;
|
|
IN struct ucred *cred;
|
|
IN struct proc *p;
|
|
};
|
|
|
|
#
|
|
#% poll vp U U U
|
|
#
|
|
vop_poll {
|
|
IN struct vnode *vp;
|
|
IN int events;
|
|
IN struct proc *p;
|
|
};
|
|
|
|
#
|
|
#% revoke vp U U U
|
|
#
|
|
vop_revoke {
|
|
IN struct vnode *vp;
|
|
IN int flags;
|
|
};
|
|
|
|
#
|
|
# XXX - not used
|
|
#
|
|
vop_mmap {
|
|
IN struct vnode *vp;
|
|
IN int fflags;
|
|
IN struct ucred *cred;
|
|
IN struct proc *p;
|
|
};
|
|
|
|
#
|
|
#% fsync vp L L L
|
|
#
|
|
vop_fsync {
|
|
IN struct vnode *vp;
|
|
IN struct ucred *cred;
|
|
IN int flags;
|
|
IN struct proc *p;
|
|
};
|
|
|
|
#
|
|
# Needs work: Is newoff right? What's it mean?
|
|
#
|
|
vop_seek {
|
|
IN struct vnode *vp;
|
|
IN off_t oldoff;
|
|
IN off_t newoff;
|
|
IN struct ucred *cred;
|
|
};
|
|
|
|
#
|
|
#% remove dvp L U U
|
|
#% remove vp L U U
|
|
#
|
|
vop_remove {
|
|
IN WILLPUT struct vnode *dvp;
|
|
IN WILLPUT struct vnode *vp;
|
|
IN struct componentname *cnp;
|
|
};
|
|
|
|
#
|
|
#% link vp U U U
|
|
#% link tdvp L U U
|
|
#
|
|
vop_link {
|
|
IN WILLPUT struct vnode *dvp;
|
|
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
|
|
#
|
|
vop_rename {
|
|
IN WILLRELE struct vnode *fdvp;
|
|
IN WILLRELE struct vnode *fvp;
|
|
IN struct componentname *fcnp;
|
|
IN WILLPUT struct vnode *tdvp;
|
|
IN WILLRELE struct vnode *tvp;
|
|
IN struct componentname *tcnp;
|
|
};
|
|
|
|
#
|
|
#% mkdir dvp L U U
|
|
#% mkdir vpp - L -
|
|
#
|
|
vop_mkdir {
|
|
IN WILLPUT struct vnode *dvp;
|
|
OUT struct vnode **vpp;
|
|
IN struct componentname *cnp;
|
|
IN struct vattr *vap;
|
|
};
|
|
|
|
#
|
|
#% rmdir dvp L U U
|
|
#% rmdir vp L U U
|
|
#
|
|
vop_rmdir {
|
|
IN WILLPUT struct vnode *dvp;
|
|
IN WILLPUT struct vnode *vp;
|
|
IN struct componentname *cnp;
|
|
};
|
|
|
|
#
|
|
#% symlink dvp L U U
|
|
#% symlink vpp - U -
|
|
#
|
|
# XXX - note that the return vnode has already been VRELE'ed
|
|
# by the filesystem layer. To use it you must use vget,
|
|
# possibly with a further namei.
|
|
#
|
|
vop_symlink {
|
|
IN WILLPUT struct vnode *dvp;
|
|
OUT WILLRELE 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;
|
|
OUT int *eofflag;
|
|
OUT off_t **cookies;
|
|
IN int *ncookies;
|
|
};
|
|
|
|
#
|
|
#% readlink vp L L L
|
|
#
|
|
vop_readlink {
|
|
IN struct vnode *vp;
|
|
INOUT struct uio *uio;
|
|
IN struct ucred *cred;
|
|
};
|
|
|
|
#
|
|
#% abortop dvp = = =
|
|
#
|
|
vop_abortop {
|
|
IN struct vnode *dvp;
|
|
IN struct componentname *cnp;
|
|
};
|
|
|
|
#
|
|
#% inactive vp L U U
|
|
#
|
|
vop_inactive {
|
|
IN WILLUNLOCK struct vnode *vp;
|
|
IN struct proc *p;
|
|
};
|
|
|
|
#
|
|
#% reclaim vp U U U
|
|
#
|
|
vop_reclaim {
|
|
IN struct vnode *vp;
|
|
IN struct proc *p;
|
|
};
|
|
|
|
#
|
|
#% lock vp U L U
|
|
#
|
|
vop_lock {
|
|
IN struct vnode *vp;
|
|
IN int flags;
|
|
};
|
|
|
|
#
|
|
#% unlock vp L U L
|
|
#
|
|
vop_unlock {
|
|
IN struct vnode *vp;
|
|
IN int flags;
|
|
};
|
|
|
|
#
|
|
#% 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;
|
|
};
|
|
|
|
#
|
|
# Needs work: no vp?
|
|
#
|
|
#vop_strategy {
|
|
# IN struct buf *bp;
|
|
#};
|
|
|
|
#
|
|
#% print vp = = =
|
|
#
|
|
vop_print {
|
|
IN struct vnode *vp;
|
|
};
|
|
|
|
#
|
|
#% islocked vp = = =
|
|
#
|
|
vop_islocked {
|
|
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;
|
|
};
|
|
|
|
#
|
|
#% blkatoff vp L L L
|
|
#
|
|
vop_blkatoff {
|
|
IN struct vnode *vp;
|
|
IN off_t offset;
|
|
OUT char **res;
|
|
OUT struct buf **bpp;
|
|
};
|
|
|
|
#
|
|
#% valloc pvp L L L
|
|
#
|
|
vop_valloc {
|
|
IN struct vnode *pvp;
|
|
IN int mode;
|
|
IN struct ucred *cred;
|
|
OUT struct vnode **vpp;
|
|
};
|
|
|
|
#
|
|
#% reallocblks vp L L L
|
|
#
|
|
vop_reallocblks {
|
|
IN struct vnode *vp;
|
|
IN struct cluster_save *buflist;
|
|
};
|
|
|
|
#
|
|
#% vfree pvp L L L
|
|
#
|
|
vop_vfree {
|
|
IN struct vnode *pvp;
|
|
IN ino_t ino;
|
|
IN int mode;
|
|
};
|
|
|
|
#
|
|
#% truncate vp L L L
|
|
#
|
|
vop_truncate {
|
|
IN struct vnode *vp;
|
|
IN off_t length;
|
|
IN int flags;
|
|
IN struct ucred *cred;
|
|
IN struct proc *p;
|
|
};
|
|
|
|
#
|
|
#% update vp L L L
|
|
#
|
|
vop_update {
|
|
IN struct vnode *vp;
|
|
IN struct timespec *access;
|
|
IN struct timespec *modify;
|
|
IN int waitfor;
|
|
};
|
|
|
|
#
|
|
#% lease vp = = =
|
|
#
|
|
vop_lease {
|
|
IN struct vnode *vp;
|
|
IN struct proc *p;
|
|
IN struct ucred *cred;
|
|
IN int flag;
|
|
};
|
|
|
|
#
|
|
#% whiteout dvp L L L
|
|
#% whiteout cnp - - -
|
|
#% whiteout flag - - -
|
|
#
|
|
vop_whiteout {
|
|
IN struct vnode *dvp;
|
|
IN struct componentname *cnp;
|
|
IN int flags;
|
|
};
|
|
|
|
#
|
|
# Needs work: no vp?
|
|
#
|
|
#vop_bwrite {
|
|
# IN struct buf *bp;
|
|
#};
|