d2f7ae9f88
kernel ACL interfaces and system call names. Break out UFS2 and FFS extattr delete and list vnode operations from setextattr and getextattr to deleteextattr and listextattr, which cleans up the implementations, and makes the results more readable, and makes the APIs more clear. Obtained from: TrustedBSD Project Sponsored by: DARPA, Network Associates Laboratories
631 lines
11 KiB
Plaintext
631 lines
11 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.
|
|
# 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.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;
|
|
};
|