186d7f5d3SJohn Marino.\"- 286d7f5d3SJohn Marino.\" Copyright (c) 1999 Robert N. M. Watson 386d7f5d3SJohn Marino.\" All rights reserved. 486d7f5d3SJohn Marino.\" 586d7f5d3SJohn Marino.\" Redistribution and use in source and binary forms, with or without 686d7f5d3SJohn Marino.\" modification, are permitted provided that the following conditions 786d7f5d3SJohn Marino.\" are met: 886d7f5d3SJohn Marino.\" 1. Redistributions of source code must retain the above copyright 986d7f5d3SJohn Marino.\" notice, this list of conditions and the following disclaimer. 1086d7f5d3SJohn Marino.\" 2. Redistributions in binary form must reproduce the above copyright 1186d7f5d3SJohn Marino.\" notice, this list of conditions and the following disclaimer in the 1286d7f5d3SJohn Marino.\" documentation and/or other materials provided with the distribution. 1386d7f5d3SJohn Marino.\" 1486d7f5d3SJohn Marino.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 1586d7f5d3SJohn Marino.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 1686d7f5d3SJohn Marino.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 1786d7f5d3SJohn Marino.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 1886d7f5d3SJohn Marino.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 1986d7f5d3SJohn Marino.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 2086d7f5d3SJohn Marino.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 2186d7f5d3SJohn Marino.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 2286d7f5d3SJohn Marino.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 2386d7f5d3SJohn Marino.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 2486d7f5d3SJohn Marino.\" SUCH DAMAGE. 2586d7f5d3SJohn Marino.\" 2686d7f5d3SJohn Marino.\" $FreeBSD: src/share/man/man9/VOP_GETACL.9,v 1.1.2.3 2001/12/17 11:30:18 ru Exp $ 2786d7f5d3SJohn Marino.\" 2886d7f5d3SJohn Marino.Dd December 23, 1999 2986d7f5d3SJohn Marino.Dt VOP_GETACL 9 3086d7f5d3SJohn Marino.Os 3186d7f5d3SJohn Marino.Sh NAME 3286d7f5d3SJohn Marino.Nm VOP_GETACL 3386d7f5d3SJohn Marino.Nd retrieve access control list for a vnode 3486d7f5d3SJohn Marino.Sh SYNOPSIS 3586d7f5d3SJohn Marino.In sys/param.h 3686d7f5d3SJohn Marino.In sys/vnode.h 3786d7f5d3SJohn Marino.In sys/acl.h 3886d7f5d3SJohn Marino.Ft int 3986d7f5d3SJohn Marino.Fn VOP_GETACL "struct vnode *vp" "acl_type_t type" "struct acl *aclp" "struct ucred *cred" "struct proc *p" 4086d7f5d3SJohn Marino.Sh DESCRIPTION 4186d7f5d3SJohn MarinoThis vnode call may be used to retrieve the access control list (ACL) from a 4286d7f5d3SJohn Marinofile or directory. 4386d7f5d3SJohn Marino.Pp 4486d7f5d3SJohn MarinoIts arguments are: 4586d7f5d3SJohn Marino.Bl -tag -width type 4686d7f5d3SJohn Marino.It Fa vp 4786d7f5d3SJohn Marinothe vnode of the file or directory 4886d7f5d3SJohn Marino.It Fa type 4986d7f5d3SJohn Marinothe type of ACL to retrieve 5086d7f5d3SJohn Marino.It Fa aclp 5186d7f5d3SJohn Marinoa pointer to an ACL structure to receive the ACL data 5286d7f5d3SJohn Marino.It Fa cred 5386d7f5d3SJohn Marinothe user credentials to use in authorizing the request 5486d7f5d3SJohn Marino.It Fa p 5586d7f5d3SJohn Marinothe process requesting the ACL 5686d7f5d3SJohn Marino.El 5786d7f5d3SJohn Marino.Pp 5886d7f5d3SJohn MarinoThe 5986d7f5d3SJohn Marino.Fa cred 6086d7f5d3SJohn Marinopointer may be 6186d7f5d3SJohn Marino.Dv NULL 6286d7f5d3SJohn Marinoto indicate that access control checks are not to be performed, if possible. 6386d7f5d3SJohn MarinoThis cred setting might be used to allow the kernel to authorize ACL 6486d7f5d3SJohn Marinoretrieval that the active process might not be permitted to do. 6586d7f5d3SJohn Marino.Pp 6686d7f5d3SJohn MarinoThe vnode ACL interface defines the syntax, and not semantics, of file and 6786d7f5d3SJohn Marinodirectory ACL interfaces. More information about ACL management in kernel 6886d7f5d3SJohn Marinomay be found in 6986d7f5d3SJohn Marino.Xr acl 9 . 7086d7f5d3SJohn Marino.Sh LOCKS 7186d7f5d3SJohn MarinoNo locks are required to call this vnode method, and any locks held on 7286d7f5d3SJohn Marinoentry will be held on exit. 7386d7f5d3SJohn Marino.Sh RETURN VALUES 7486d7f5d3SJohn MarinoIf the 7586d7f5d3SJohn Marino.Fa aclp 7686d7f5d3SJohn Marinopointer will point to a valid ACL, then zero is returned. Otherwise, 7786d7f5d3SJohn Marinoan appropriate error code is returned. 7886d7f5d3SJohn Marino.Sh ERRORS 7986d7f5d3SJohn Marino.Bl -tag -width Er 8086d7f5d3SJohn Marino.It Bq Er EINVAL 8186d7f5d3SJohn MarinoThe ACL type passed is invalid for this vnode 8286d7f5d3SJohn Marino.It Bq Er EACCES 8386d7f5d3SJohn MarinoPermission denied 8486d7f5d3SJohn Marino.It Bq Er ENOMEM 8586d7f5d3SJohn MarinoInsufficient memory available to fulfill request 8686d7f5d3SJohn Marino.It Bq Er EOPNOTSUPP 8786d7f5d3SJohn MarinoThe file system does not support 8886d7f5d3SJohn Marino.Fn VOP_GETACL 8986d7f5d3SJohn Marino.El 9086d7f5d3SJohn Marino.Sh SEE ALSO 9186d7f5d3SJohn Marino.Xr acl 9 , 9286d7f5d3SJohn Marino.Xr vnode 9 , 9386d7f5d3SJohn Marino.Xr VOP_ACLCHECK 9 , 9486d7f5d3SJohn Marino.Xr VOP_SETACL 9 9586d7f5d3SJohn Marino.Sh AUTHORS 9686d7f5d3SJohn MarinoThis man page was written by 9786d7f5d3SJohn Marino.An Robert Watson . 98