2 * Copyright (c) 1999, 2000 Robert N. M. Watson
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
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.
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 * $FreeBSD: src/sys/kern/kern_acl.c,v 1.2.2.1 2000/07/28 18:48:16 rwatson Exp $
30 * Generic routines to support file system ACLs, at a syntactic level
31 * Semantics are the responsibility of the underlying file system
34 #include <sys/param.h>
35 #include <sys/systm.h>
36 #include <sys/sysproto.h>
37 #include <sys/kernel.h>
38 #include <sys/malloc.h>
39 #include <sys/vnode.h>
41 #include <sys/namei.h>
44 #include <sys/sysent.h>
45 #include <sys/errno.h>
49 static MALLOC_DEFINE(M_ACL, "acl", "access control list");
51 static int vacl_set_acl(struct proc *p, struct vnode *vp, acl_type_t type,
53 static int vacl_get_acl(struct proc *p, struct vnode *vp, acl_type_t type,
55 static int vacl_aclcheck(struct proc *p, struct vnode *vp, acl_type_t type,
59 * These calls wrap the real vnode operations, and are called by the
60 * syscall code once the syscall has converted the path or file
61 * descriptor to a vnode (unlocked). The aclp pointer is assumed
62 * still to point to userland, so this should not be consumed within
63 * the kernel except by syscall code. Other code should directly
64 * invoke VOP_{SET,GET}ACL.
68 * Given a vnode, set its ACL.
71 vacl_set_acl(struct proc *p, struct vnode *vp, acl_type_t type,
77 error = copyin(aclp, &inkernacl, sizeof(struct acl));
80 VOP_LEASE(vp, p, p->p_ucred, LEASE_WRITE);
81 vn_lock(vp, LK_EXCLUSIVE | LK_RETRY, p);
82 error = VOP_SETACL(vp, type, &inkernacl, p->p_ucred, p);
88 * Given a vnode, get its ACL.
91 vacl_get_acl(struct proc *p, struct vnode *vp, acl_type_t type,
94 struct acl inkernelacl;
97 error = VOP_GETACL(vp, type, &inkernelacl, p->p_ucred, p);
99 error = copyout(&inkernelacl, aclp, sizeof(struct acl));
104 * Given a vnode, delete its ACL.
107 vacl_delete(struct proc *p, struct vnode *vp, acl_type_t type)
111 VOP_LEASE(vp, p, p->p_ucred, LEASE_WRITE);
112 vn_lock(vp, LK_EXCLUSIVE | LK_RETRY, p);
113 error = VOP_SETACL(vp, ACL_TYPE_DEFAULT, 0, p->p_ucred, p);
114 VOP_UNLOCK(vp, 0, p);
119 * Given a vnode, check whether an ACL is appropriate for it
122 vacl_aclcheck(struct proc *p, struct vnode *vp, acl_type_t type,
125 struct acl inkernelacl;
128 error = copyin(aclp, &inkernelacl, sizeof(struct acl));
131 error = VOP_ACLCHECK(vp, type, &inkernelacl, p->p_ucred, p);
136 * syscalls -- convert the path/fd to a vnode, and call vacl_whatever.
137 * Don't need to lock, as the vacl_ code will get/release any locks
142 * Given a file path, get an ACL for it
145 __acl_get_file(struct proc *p, struct __acl_get_file_args *uap)
150 /* what flags are required here -- possible not LOCKLEAF? */
151 NDINIT(&nd, LOOKUP, FOLLOW, UIO_USERSPACE, SCARG(uap, path), p);
155 error = vacl_get_acl(p, nd.ni_vp, SCARG(uap, type), SCARG(uap, aclp));
161 * Given a file path, set an ACL for it
164 __acl_set_file(struct proc *p, struct __acl_set_file_args *uap)
169 NDINIT(&nd, LOOKUP, FOLLOW, UIO_USERSPACE, SCARG(uap, path), p);
173 error = vacl_set_acl(p, nd.ni_vp, SCARG(uap, type), SCARG(uap, aclp));
179 * Given a file descriptor, get an ACL for it
182 __acl_get_fd(struct proc *p, struct __acl_get_fd_args *uap)
187 error = getvnode(p->p_fd, SCARG(uap, filedes), &fp);
190 return vacl_get_acl(p, (struct vnode *)fp->f_data, SCARG(uap, type),
195 * Given a file descriptor, set an ACL for it
198 __acl_set_fd(struct proc *p, struct __acl_set_fd_args *uap)
203 error = getvnode(p->p_fd, SCARG(uap, filedes), &fp);
206 return vacl_set_acl(p, (struct vnode *)fp->f_data, SCARG(uap, type),
211 * Given a file path, delete an ACL from it.
214 __acl_delete_file(struct proc *p, struct __acl_delete_file_args *uap)
219 NDINIT(&nd, LOOKUP, FOLLOW, UIO_USERSPACE, SCARG(uap, path), p);
223 error = vacl_delete(p, nd.ni_vp, SCARG(uap, type));
229 * Given a file path, delete an ACL from it.
232 __acl_delete_fd(struct proc *p, struct __acl_delete_fd_args *uap)
237 error = getvnode(p->p_fd, SCARG(uap, filedes), &fp);
240 error = vacl_delete(p, (struct vnode *)fp->f_data, SCARG(uap, type));
245 * Given a file path, check an ACL for it
248 __acl_aclcheck_file(struct proc *p, struct __acl_aclcheck_file_args *uap)
253 NDINIT(&nd, LOOKUP, FOLLOW, UIO_USERSPACE, SCARG(uap, path), p);
257 error = vacl_aclcheck(p, nd.ni_vp, SCARG(uap, type), SCARG(uap, aclp));
263 * Given a file descriptor, check an ACL for it
266 __acl_aclcheck_fd(struct proc *p, struct __acl_aclcheck_fd_args *uap)
271 error = getvnode(p->p_fd, SCARG(uap, filedes), &fp);
274 return vacl_aclcheck(p, (struct vnode *)fp->f_data, SCARG(uap, type),