mac_policy.h revision 147784
1/*-
2 * Copyright (c) 1999-2002 Robert N. M. Watson
3 * Copyright (c) 2001-2005 Networks Associates Technology, Inc.
4 * Copyright (c) 2005 SPARTA, Inc.
5 * All rights reserved.
6 *
7 * This software was developed by Robert Watson for the TrustedBSD Project.
8 *
9 * This software was developed for the FreeBSD Project in part by Network
10 * Associates Laboratories, the Security Research Division of Network
11 * Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"),
12 * as part of the DARPA CHATS research program.
13 *
14 * Redistribution and use in source and binary forms, with or without
15 * modification, are permitted provided that the following conditions
16 * are met:
17 * 1. Redistributions of source code must retain the above copyright
18 *    notice, this list of conditions and the following disclaimer.
19 * 2. Redistributions in binary form must reproduce the above copyright
20 *    notice, this list of conditions and the following disclaimer in the
21 *    documentation and/or other materials provided with the distribution.
22 *
23 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
24 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
27 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33 * SUCH DAMAGE.
34 *
35 * $FreeBSD: head/sys/security/mac/mac_policy.h 147784 2005-07-05 22:49:10Z rwatson $
36 */
37/*
38 * Kernel interface for MAC policy modules.
39 */
40#ifndef _SYS_MAC_POLICY_H_
41#define _SYS_MAC_POLICY_H_
42
43/*-
44 * Pluggable access control policy definition structure.
45 *
46 * List of operations that are performed as part of the implementation
47 * of a MAC policy.  Policy implementors declare operations with a
48 * mac_policy_ops structure, and using the MAC_POLICY_SET() macro.
49 * If an entry point is not declared, then then the policy will be ignored
50 * during evaluation of that event or check.
51 *
52 * Operations are sorted first by general class of operation, then
53 * alphabetically.
54 */
55struct acl;
56struct bpf_d;
57struct componentname;
58struct devfs_dirent;
59struct ifnet;
60struct image_params;
61struct inpcb;
62struct ipq;
63struct ksem;
64struct label;
65struct mac_policy_conf;
66struct mbuf;
67struct mount;
68struct msqid_kernel;
69struct pipepair;
70struct proc;
71struct sbuf;
72struct semid_kernel;
73struct shmid_kernel;
74struct sockaddr;
75struct socket;
76struct sysctl_oid;
77struct sysctl_req;
78struct thread;
79struct ucred;
80struct uio;
81struct vattr;
82struct vnode;
83struct mac_policy_ops {
84	/*
85	 * Policy module operations.
86	 */
87	void	(*mpo_destroy)(struct mac_policy_conf *mpc);
88	void	(*mpo_init)(struct mac_policy_conf *mpc);
89
90	/*
91	 * General policy-directed security system call so that policies may
92	 * implement new services without reserving explicit system call
93	 * numbers.
94	 */
95	int	(*mpo_syscall)(struct thread *td, int call, void *arg);
96
97	/*
98	 * Label operations.  Initialize label storage, destroy label
99	 * storage, recycle for re-use without init/destroy, copy a label to
100	 * initialized storage, and externalize/internalize from/to
101	 * initialized storage.
102	 */
103	void	(*mpo_init_bpfdesc_label)(struct label *label);
104	void	(*mpo_init_cred_label)(struct label *label);
105	void	(*mpo_init_devfsdirent_label)(struct label *label);
106	void	(*mpo_init_ifnet_label)(struct label *label);
107	int	(*mpo_init_inpcb_label)(struct label *label, int flag);
108	void	(*mpo_init_sysv_msgmsg_label)(struct label *label);
109	void	(*mpo_init_sysv_msgqueue_label)(struct label *label);
110	void	(*mpo_init_sysv_sem_label)(struct label *label);
111	void	(*mpo_init_sysv_shm_label)(struct label *label);
112	int	(*mpo_init_ipq_label)(struct label *label, int flag);
113	int	(*mpo_init_mbuf_label)(struct label *label, int flag);
114	void	(*mpo_init_mount_label)(struct label *label);
115	void	(*mpo_init_mount_fs_label)(struct label *label);
116	int	(*mpo_init_socket_label)(struct label *label, int flag);
117	int	(*mpo_init_socket_peer_label)(struct label *label, int flag);
118	void	(*mpo_init_pipe_label)(struct label *label);
119	void    (*mpo_init_posix_sem_label)(struct label *label);
120	void	(*mpo_init_proc_label)(struct label *label);
121	void	(*mpo_init_vnode_label)(struct label *label);
122	void	(*mpo_destroy_bpfdesc_label)(struct label *label);
123	void	(*mpo_destroy_cred_label)(struct label *label);
124	void	(*mpo_destroy_devfsdirent_label)(struct label *label);
125	void	(*mpo_destroy_ifnet_label)(struct label *label);
126	void	(*mpo_destroy_inpcb_label)(struct label *label);
127	void	(*mpo_destroy_sysv_msgmsg_label)(struct label *label);
128	void	(*mpo_destroy_sysv_msgqueue_label)(struct label *label);
129	void	(*mpo_destroy_sysv_sem_label)(struct label *label);
130	void	(*mpo_destroy_sysv_shm_label)(struct label *label);
131	void	(*mpo_destroy_ipq_label)(struct label *label);
132	void	(*mpo_destroy_mbuf_label)(struct label *label);
133	void	(*mpo_destroy_mount_label)(struct label *label);
134	void	(*mpo_destroy_mount_fs_label)(struct label *label);
135	void	(*mpo_destroy_socket_label)(struct label *label);
136	void	(*mpo_destroy_socket_peer_label)(struct label *label);
137	void	(*mpo_destroy_pipe_label)(struct label *label);
138	void    (*mpo_destroy_posix_sem_label)(struct label *label);
139	void	(*mpo_destroy_proc_label)(struct label *label);
140	void	(*mpo_destroy_vnode_label)(struct label *label);
141	void	(*mpo_cleanup_sysv_msgmsg)(struct label *msglabel);
142	void	(*mpo_cleanup_sysv_msgqueue)(struct label *msqlabel);
143	void	(*mpo_cleanup_sysv_sem)(struct label *semalabel);
144	void	(*mpo_cleanup_sysv_shm)(struct label *shmlabel);
145	void	(*mpo_copy_cred_label)(struct label *src,
146		    struct label *dest);
147	void	(*mpo_copy_ifnet_label)(struct label *src,
148		    struct label *dest);
149	void	(*mpo_copy_mbuf_label)(struct label *src,
150		    struct label *dest);
151	void	(*mpo_copy_pipe_label)(struct label *src,
152		    struct label *dest);
153	void	(*mpo_copy_socket_label)(struct label *src,
154		    struct label *dest);
155	void	(*mpo_copy_vnode_label)(struct label *src,
156		    struct label *dest);
157	int	(*mpo_externalize_cred_label)(struct label *label,
158		    char *element_name, struct sbuf *sb, int *claimed);
159	int	(*mpo_externalize_ifnet_label)(struct label *label,
160		    char *element_name, struct sbuf *sb, int *claimed);
161	int	(*mpo_externalize_pipe_label)(struct label *label,
162		    char *element_name, struct sbuf *sb, int *claimed);
163	int	(*mpo_externalize_socket_label)(struct label *label,
164		    char *element_name, struct sbuf *sb, int *claimed);
165	int	(*mpo_externalize_socket_peer_label)(struct label *label,
166		    char *element_name, struct sbuf *sb, int *claimed);
167	int	(*mpo_externalize_vnode_label)(struct label *label,
168		    char *element_name, struct sbuf *sb, int *claimed);
169	int	(*mpo_internalize_cred_label)(struct label *label,
170		    char *element_name, char *element_data, int *claimed);
171	int	(*mpo_internalize_ifnet_label)(struct label *label,
172		    char *element_name, char *element_data, int *claimed);
173	int	(*mpo_internalize_pipe_label)(struct label *label,
174		    char *element_name, char *element_data, int *claimed);
175	int	(*mpo_internalize_socket_label)(struct label *label,
176		    char *element_name, char *element_data, int *claimed);
177	int	(*mpo_internalize_vnode_label)(struct label *label,
178		    char *element_name, char *element_data, int *claimed);
179
180	/*
181	 * Labeling event operations: file system objects, and things that
182	 * look a lot like file system objects.
183	 */
184	void	(*mpo_associate_vnode_devfs)(struct mount *mp,
185		    struct label *fslabel, struct devfs_dirent *de,
186		    struct label *delabel, struct vnode *vp,
187		    struct label *vlabel);
188	int	(*mpo_associate_vnode_extattr)(struct mount *mp,
189		    struct label *fslabel, struct vnode *vp,
190		    struct label *vlabel);
191	void	(*mpo_associate_vnode_singlelabel)(struct mount *mp,
192		    struct label *fslabel, struct vnode *vp,
193		    struct label *vlabel);
194	void	(*mpo_create_devfs_device)(struct mount *mp, struct cdev *dev,
195		    struct devfs_dirent *de, struct label *label);
196	void	(*mpo_create_devfs_directory)(struct mount *mp, char *dirname,
197		    int dirnamelen, struct devfs_dirent *de,
198		    struct label *label);
199	void	(*mpo_create_devfs_symlink)(struct ucred *cred,
200		    struct mount *mp, struct devfs_dirent *dd,
201		    struct label *ddlabel, struct devfs_dirent *de,
202		    struct label *delabel);
203	int	(*mpo_create_vnode_extattr)(struct ucred *cred,
204		    struct mount *mp, struct label *fslabel,
205		    struct vnode *dvp, struct label *dlabel,
206		    struct vnode *vp, struct label *vlabel,
207		    struct componentname *cnp);
208	void	(*mpo_create_mount)(struct ucred *cred, struct mount *mp,
209		    struct label *mntlabel, struct label *fslabel);
210	void	(*mpo_create_root_mount)(struct ucred *cred, struct mount *mp,
211		    struct label *mountlabel, struct label *fslabel);
212	void	(*mpo_relabel_vnode)(struct ucred *cred, struct vnode *vp,
213		    struct label *vnodelabel, struct label *label);
214	int	(*mpo_setlabel_vnode_extattr)(struct ucred *cred,
215		    struct vnode *vp, struct label *vlabel,
216		    struct label *intlabel);
217	void	(*mpo_update_devfsdirent)(struct mount *mp,
218		    struct devfs_dirent *devfs_dirent,
219		    struct label *direntlabel, struct vnode *vp,
220		    struct label *vnodelabel);
221
222	/*
223	 * Labeling event operations: IPC objects.
224	 */
225	void	(*mpo_create_mbuf_from_socket)(struct socket *so,
226		    struct label *socketlabel, struct mbuf *m,
227		    struct label *mbuflabel);
228	void	(*mpo_create_socket)(struct ucred *cred, struct socket *so,
229		    struct label *socketlabel);
230	void	(*mpo_create_socket_from_socket)(struct socket *oldsocket,
231		    struct label *oldsocketlabel, struct socket *newsocket,
232		    struct label *newsocketlabel);
233	void	(*mpo_relabel_socket)(struct ucred *cred, struct socket *so,
234		    struct label *oldlabel, struct label *newlabel);
235	void	(*mpo_relabel_pipe)(struct ucred *cred, struct pipepair *pp,
236		    struct label *oldlabel, struct label *newlabel);
237	void	(*mpo_set_socket_peer_from_mbuf)(struct mbuf *mbuf,
238		    struct label *mbuflabel, struct socket *so,
239		    struct label *socketpeerlabel);
240	void	(*mpo_set_socket_peer_from_socket)(struct socket *oldsocket,
241		    struct label *oldsocketlabel, struct socket *newsocket,
242		    struct label *newsocketpeerlabel);
243	void	(*mpo_create_pipe)(struct ucred *cred, struct pipepair *pp,
244		    struct label *pipelabel);
245
246	/*
247	 * Labeling event operations: System V IPC primitives.
248	 */
249	void	(*mpo_create_sysv_msgmsg)(struct ucred *cred,
250		    struct msqid_kernel *msqkptr, struct label *msqlabel,
251		    struct msg *msgptr, struct label *msglabel);
252	void	(*mpo_create_sysv_msgqueue)(struct ucred *cred,
253		    struct msqid_kernel *msqkptr, struct label *msqlabel);
254	void	(*mpo_create_sysv_sem)(struct ucred *cred,
255		    struct semid_kernel *semakptr, struct label *semalabel);
256	void	(*mpo_create_sysv_shm)(struct ucred *cred,
257		    struct shmid_kernel *shmsegptr, struct label *shmlabel);
258
259	/*
260	 * Labeling event operations: POSIX (global/inter-process) semaphores.
261	 */
262	void	(*mpo_create_posix_sem)(struct ucred *cred,
263		    struct ksem *ksemptr, struct label *ks_label);
264
265	/*
266	 * Labeling event operations: network objects.
267	 */
268	void	(*mpo_create_bpfdesc)(struct ucred *cred, struct bpf_d *bpf_d,
269		    struct label *bpflabel);
270	void	(*mpo_create_ifnet)(struct ifnet *ifnet,
271		    struct label *ifnetlabel);
272	void	(*mpo_create_inpcb_from_socket)(struct socket *so,
273		    struct label *solabel, struct inpcb *inp,
274		    struct label *inplabel);
275	void	(*mpo_create_ipq)(struct mbuf *fragment,
276		    struct label *fragmentlabel, struct ipq *ipq,
277		    struct label *ipqlabel);
278	void	(*mpo_create_datagram_from_ipq)
279		    (struct ipq *ipq, struct label *ipqlabel,
280		    struct mbuf *datagram, struct label *datagramlabel);
281	void	(*mpo_create_fragment)(struct mbuf *datagram,
282		    struct label *datagramlabel, struct mbuf *fragment,
283		    struct label *fragmentlabel);
284	void	(*mpo_create_mbuf_from_inpcb)(struct inpcb *inp,
285		    struct label *inplabel, struct mbuf *m,
286		    struct label *mlabel);
287	void	(*mpo_create_mbuf_from_mbuf)(struct mbuf *oldmbuf,
288		    struct label *oldlabel, struct mbuf *newmbuf,
289		    struct label *newlabel);
290	void	(*mpo_create_mbuf_linklayer)(struct ifnet *ifnet,
291		    struct label *ifnetlabel, struct mbuf *mbuf,
292		    struct label *mbuflabel);
293	void	(*mpo_create_mbuf_from_bpfdesc)(struct bpf_d *bpf_d,
294		    struct label *bpflabel, struct mbuf *mbuf,
295		    struct label *mbuflabel);
296	void	(*mpo_create_mbuf_from_ifnet)(struct ifnet *ifnet,
297		    struct label *ifnetlabel, struct mbuf *mbuf,
298		    struct label *mbuflabel);
299	void	(*mpo_create_mbuf_multicast_encap)(struct mbuf *oldmbuf,
300		    struct label *oldmbuflabel, struct ifnet *ifnet,
301		    struct label *ifnetlabel, struct mbuf *newmbuf,
302		    struct label *newmbuflabel);
303	void	(*mpo_create_mbuf_netlayer)(struct mbuf *oldmbuf,
304		    struct label *oldmbuflabel, struct mbuf *newmbuf,
305		    struct label *newmbuflabel);
306	int	(*mpo_fragment_match)(struct mbuf *fragment,
307		    struct label *fragmentlabel, struct ipq *ipq,
308		    struct label *ipqlabel);
309	void	(*mpo_reflect_mbuf_icmp)(struct mbuf *m,
310		    struct label *mlabel);
311	void	(*mpo_reflect_mbuf_tcp)(struct mbuf *m, struct label *mlabel);
312	void	(*mpo_relabel_ifnet)(struct ucred *cred, struct ifnet *ifnet,
313		    struct label *ifnetlabel, struct label *newlabel);
314	void	(*mpo_update_ipq)(struct mbuf *fragment,
315		    struct label *fragmentlabel, struct ipq *ipq,
316		    struct label *ipqlabel);
317	void	(*mpo_inpcb_sosetlabel)(struct socket *so,
318		    struct label *label, struct inpcb *inp,
319		    struct label *inplabel);
320
321	/*
322	 * Labeling event operations: processes.
323	 */
324	void	(*mpo_execve_transition)(struct ucred *old, struct ucred *new,
325		    struct vnode *vp, struct label *vnodelabel,
326		    struct label *interpvnodelabel,
327		    struct image_params *imgp, struct label *execlabel);
328	int	(*mpo_execve_will_transition)(struct ucred *old,
329		    struct vnode *vp, struct label *vnodelabel,
330		    struct label *interpvnodelabel,
331		    struct image_params *imgp, struct label *execlabel);
332	void	(*mpo_create_proc0)(struct ucred *cred);
333	void	(*mpo_create_proc1)(struct ucred *cred);
334	void	(*mpo_relabel_cred)(struct ucred *cred,
335		    struct label *newlabel);
336	void	(*mpo_thread_userret)(struct thread *thread);
337
338	/*
339	 * Access control checks.
340	 */
341	int	(*mpo_check_bpfdesc_receive)(struct bpf_d *bpf_d,
342		    struct label *bpflabel, struct ifnet *ifnet,
343		    struct label *ifnetlabel);
344	int	(*mpo_check_cred_relabel)(struct ucred *cred,
345		    struct label *newlabel);
346	int	(*mpo_check_cred_visible)(struct ucred *u1, struct ucred *u2);
347	int	(*mpo_check_ifnet_relabel)(struct ucred *cred,
348		    struct ifnet *ifnet, struct label *ifnetlabel,
349		    struct label *newlabel);
350	int	(*mpo_check_ifnet_transmit)(struct ifnet *ifnet,
351		    struct label *ifnetlabel, struct mbuf *m,
352		    struct label *mbuflabel);
353	int	(*mpo_check_inpcb_deliver)(struct inpcb *inp,
354		    struct label *inplabel, struct mbuf *m,
355		    struct label *mlabel);
356	int	(*mpo_check_sysv_msgmsq)(struct ucred *cred,
357		    struct msg *msgptr, struct label *msglabel,
358		    struct msqid_kernel *msqkptr, struct label *msqklabel);
359	int	(*mpo_check_sysv_msgrcv)(struct ucred *cred,
360		    struct msg *msgptr, struct label *msglabel);
361	int	(*mpo_check_sysv_msgrmid)(struct ucred *cred,
362		    struct msg *msgptr, struct label *msglabel);
363	int	(*mpo_check_sysv_msqget)(struct ucred *cred,
364		    struct msqid_kernel *msqkptr, struct label *msqklabel);
365	int	(*mpo_check_sysv_msqsnd)(struct ucred *cred,
366		    struct msqid_kernel *msqkptr, struct label *msqklabel);
367	int	(*mpo_check_sysv_msqrcv)(struct ucred *cred,
368		    struct msqid_kernel *msqkptr, struct label *msqklabel);
369	int	(*mpo_check_sysv_msqctl)(struct ucred *cred,
370		    struct msqid_kernel *msqkptr, struct label *msqklabel,
371		    int cmd);
372	int	(*mpo_check_sysv_semctl)(struct ucred *cred,
373		    struct semid_kernel *semakptr, struct label *semaklabel,
374		    int cmd);
375	int	(*mpo_check_sysv_semget)(struct ucred *cred,
376		    struct semid_kernel *semakptr, struct label *semaklabel);
377	int	(*mpo_check_sysv_semop)(struct ucred *cred,
378		    struct semid_kernel *semakptr, struct label *semaklabel,
379		    size_t accesstype);
380	int	(*mpo_check_sysv_shmat)(struct ucred *cred,
381		    struct shmid_kernel *shmsegptr,
382		    struct label *shmseglabel, int shmflg);
383	int	(*mpo_check_sysv_shmctl)(struct ucred *cred,
384		    struct shmid_kernel *shmsegptr,
385		    struct label *shmseglabel, int cmd);
386	int	(*mpo_check_sysv_shmdt)(struct ucred *cred,
387		    struct shmid_kernel *shmsegptr,
388		    struct label *shmseglabel);
389	int	(*mpo_check_sysv_shmget)(struct ucred *cred,
390		    struct shmid_kernel *shmsegptr,
391		    struct label *shmseglabel, int shmflg);
392	int	(*mpo_check_kenv_dump)(struct ucred *cred);
393	int	(*mpo_check_kenv_get)(struct ucred *cred, char *name);
394	int	(*mpo_check_kenv_set)(struct ucred *cred, char *name,
395		    char *value);
396	int	(*mpo_check_kenv_unset)(struct ucred *cred, char *name);
397	int	(*mpo_check_kld_load)(struct ucred *cred, struct vnode *vp,
398		    struct label *vlabel);
399	int	(*mpo_check_kld_stat)(struct ucred *cred);
400	int	(*mpo_check_kld_unload)(struct ucred *cred);
401	int	(*mpo_check_mount_stat)(struct ucred *cred, struct mount *mp,
402		    struct label *mntlabel);
403	int	(*mpo_check_pipe_ioctl)(struct ucred *cred,
404		    struct pipepair *pp, struct label *pipelabel,
405		    unsigned long cmd, void *data);
406	int	(*mpo_check_pipe_poll)(struct ucred *cred,
407		    struct pipepair *pp, struct label *pipelabel);
408	int	(*mpo_check_pipe_read)(struct ucred *cred,
409		    struct pipepair *pp, struct label *pipelabel);
410	int	(*mpo_check_pipe_relabel)(struct ucred *cred,
411		    struct pipepair *pp, struct label *pipelabel,
412		    struct label *newlabel);
413	int	(*mpo_check_pipe_stat)(struct ucred *cred,
414		    struct pipepair *pp, struct label *pipelabel);
415	int	(*mpo_check_pipe_write)(struct ucred *cred,
416		    struct pipepair *pp, struct label *pipelabel);
417	int	(*mpo_check_posix_sem_destroy)(struct ucred *cred,
418		    struct ksem *ksemptr, struct label *ks_label);
419	int	(*mpo_check_posix_sem_getvalue)(struct ucred *cred,
420		    struct ksem *ksemptr, struct label *ks_label);
421	int	(*mpo_check_posix_sem_open)(struct ucred *cred,
422		    struct ksem *ksemptr, struct label *ks_label);
423	int	(*mpo_check_posix_sem_post)(struct ucred *cred,
424		    struct ksem *ksemptr, struct label *ks_label);
425	int	(*mpo_check_posix_sem_unlink)(struct ucred *cred,
426		    struct ksem *ksemptr, struct label *ks_label);
427	int	(*mpo_check_posix_sem_wait)(struct ucred *cred,
428		    struct ksem *ksemptr, struct label *ks_label);
429	int	(*mpo_check_proc_debug)(struct ucred *cred,
430		    struct proc *proc);
431	int	(*mpo_check_proc_sched)(struct ucred *cred,
432		    struct proc *proc);
433	int	(*mpo_check_proc_setuid)(struct ucred *cred, uid_t uid);
434	int	(*mpo_check_proc_seteuid)(struct ucred *cred, uid_t euid);
435	int	(*mpo_check_proc_setgid)(struct ucred *cred, gid_t gid);
436	int	(*mpo_check_proc_setegid)(struct ucred *cred, gid_t egid);
437	int	(*mpo_check_proc_setgroups)(struct ucred *cred, int ngroups,
438		    gid_t *gidset);
439	int	(*mpo_check_proc_setreuid)(struct ucred *cred, uid_t ruid,
440		    uid_t euid);
441	int	(*mpo_check_proc_setregid)(struct ucred *cred, gid_t rgid,
442		    gid_t egid);
443	int	(*mpo_check_proc_setresuid)(struct ucred *cred, uid_t ruid,
444		    uid_t euid, uid_t suid);
445	int	(*mpo_check_proc_setresgid)(struct ucred *cred, gid_t rgid,
446		    gid_t egid, gid_t sgid);
447	int	(*mpo_check_proc_signal)(struct ucred *cred,
448		    struct proc *proc, int signum);
449	int	(*mpo_check_proc_wait)(struct ucred *cred,
450		    struct proc *proc);
451	int	(*mpo_check_socket_accept)(struct ucred *cred,
452		    struct socket *so, struct label *socketlabel);
453	int	(*mpo_check_socket_bind)(struct ucred *cred,
454		    struct socket *so, struct label *socketlabel,
455		    struct sockaddr *sockaddr);
456	int	(*mpo_check_socket_connect)(struct ucred *cred,
457		    struct socket *so, struct label *socketlabel,
458		    struct sockaddr *sockaddr);
459	int	(*mpo_check_socket_create)(struct ucred *cred, int domain,
460		    int type, int protocol);
461	int	(*mpo_check_socket_deliver)(struct socket *so,
462		    struct label *socketlabel, struct mbuf *m,
463		    struct label *mbuflabel);
464	int	(*mpo_check_socket_listen)(struct ucred *cred,
465		    struct socket *so, struct label *socketlabel);
466	int	(*mpo_check_socket_poll)(struct ucred *cred,
467		    struct socket *so, struct label *socketlabel);
468	int	(*mpo_check_socket_receive)(struct ucred *cred,
469		    struct socket *so, struct label *socketlabel);
470	int	(*mpo_check_socket_relabel)(struct ucred *cred,
471		    struct socket *so, struct label *socketlabel,
472		    struct label *newlabel);
473	int	(*mpo_check_socket_send)(struct ucred *cred,
474		    struct socket *so, struct label *socketlabel);
475	int	(*mpo_check_socket_stat)(struct ucred *cred,
476		    struct socket *so, struct label *socketlabel);
477	int	(*mpo_check_socket_visible)(struct ucred *cred,
478		    struct socket *so, struct label *socketlabel);
479	int	(*mpo_check_sysarch_ioperm)(struct ucred *cred);
480	int	(*mpo_check_system_acct)(struct ucred *cred,
481		    struct vnode *vp, struct label *vlabel);
482	int	(*mpo_check_system_nfsd)(struct ucred *cred);
483	int	(*mpo_check_system_reboot)(struct ucred *cred, int howto);
484	int	(*mpo_check_system_settime)(struct ucred *cred);
485	int	(*mpo_check_system_swapon)(struct ucred *cred,
486		    struct vnode *vp, struct label *label);
487	int	(*mpo_check_system_swapoff)(struct ucred *cred,
488		    struct vnode *vp, struct label *label);
489	int	(*mpo_check_system_sysctl)(struct ucred *cred,
490		    struct sysctl_oid *oidp, void *arg1, int arg2,
491		    struct sysctl_req *req);
492	int	(*mpo_check_vnode_access)(struct ucred *cred,
493		    struct vnode *vp, struct label *label, int acc_mode);
494	int	(*mpo_check_vnode_chdir)(struct ucred *cred,
495		    struct vnode *dvp, struct label *dlabel);
496	int	(*mpo_check_vnode_chroot)(struct ucred *cred,
497		    struct vnode *dvp, struct label *dlabel);
498	int	(*mpo_check_vnode_create)(struct ucred *cred,
499		    struct vnode *dvp, struct label *dlabel,
500		    struct componentname *cnp, struct vattr *vap);
501	int	(*mpo_check_vnode_delete)(struct ucred *cred,
502		    struct vnode *dvp, struct label *dlabel,
503		    struct vnode *vp, struct label *label,
504		    struct componentname *cnp);
505	int	(*mpo_check_vnode_deleteacl)(struct ucred *cred,
506		    struct vnode *vp, struct label *label, acl_type_t type);
507	int	(*mpo_check_vnode_deleteextattr)(struct ucred *cred,
508		    struct vnode *vp, struct label *label, int attrnamespace,
509		    const char *name);
510	int	(*mpo_check_vnode_exec)(struct ucred *cred, struct vnode *vp,
511		    struct label *label, struct image_params *imgp,
512		    struct label *execlabel);
513	int	(*mpo_check_vnode_getacl)(struct ucred *cred,
514		    struct vnode *vp, struct label *label, acl_type_t type);
515	int	(*mpo_check_vnode_getextattr)(struct ucred *cred,
516		    struct vnode *vp, struct label *label, int attrnamespace,
517		    const char *name, struct uio *uio);
518	int	(*mpo_check_vnode_link)(struct ucred *cred, struct vnode *dvp,
519		    struct label *dlabel, struct vnode *vp,
520		    struct label *label, struct componentname *cnp);
521	int	(*mpo_check_vnode_listextattr)(struct ucred *cred,
522		    struct vnode *vp, struct label *label, int attrnamespace);
523	int	(*mpo_check_vnode_lookup)(struct ucred *cred,
524		    struct vnode *dvp, struct label *dlabel,
525		    struct componentname *cnp);
526	int	(*mpo_check_vnode_mmap)(struct ucred *cred, struct vnode *vp,
527		    struct label *label, int prot, int flags);
528	void	(*mpo_check_vnode_mmap_downgrade)(struct ucred *cred,
529		    struct vnode *vp, struct label *label, int *prot);
530	int	(*mpo_check_vnode_mprotect)(struct ucred *cred,
531		    struct vnode *vp, struct label *label, int prot);
532	int	(*mpo_check_vnode_open)(struct ucred *cred, struct vnode *vp,
533		    struct label *label, int acc_mode);
534	int	(*mpo_check_vnode_poll)(struct ucred *active_cred,
535		    struct ucred *file_cred, struct vnode *vp,
536		    struct label *label);
537	int	(*mpo_check_vnode_read)(struct ucred *active_cred,
538		    struct ucred *file_cred, struct vnode *vp,
539		    struct label *label);
540	int	(*mpo_check_vnode_readdir)(struct ucred *cred,
541		    struct vnode *dvp, struct label *dlabel);
542	int	(*mpo_check_vnode_readlink)(struct ucred *cred,
543		    struct vnode *vp, struct label *label);
544	int	(*mpo_check_vnode_relabel)(struct ucred *cred,
545		    struct vnode *vp, struct label *vnodelabel,
546		    struct label *newlabel);
547	int	(*mpo_check_vnode_rename_from)(struct ucred *cred,
548		    struct vnode *dvp, struct label *dlabel, struct vnode *vp,
549		    struct label *label, struct componentname *cnp);
550	int	(*mpo_check_vnode_rename_to)(struct ucred *cred,
551		    struct vnode *dvp, struct label *dlabel, struct vnode *vp,
552		    struct label *label, int samedir,
553		    struct componentname *cnp);
554	int	(*mpo_check_vnode_revoke)(struct ucred *cred,
555		    struct vnode *vp, struct label *label);
556	int	(*mpo_check_vnode_setacl)(struct ucred *cred,
557		    struct vnode *vp, struct label *label, acl_type_t type,
558		    struct acl *acl);
559	int	(*mpo_check_vnode_setextattr)(struct ucred *cred,
560		    struct vnode *vp, struct label *label, int attrnamespace,
561		    const char *name, struct uio *uio);
562	int	(*mpo_check_vnode_setflags)(struct ucred *cred,
563		    struct vnode *vp, struct label *label, u_long flags);
564	int	(*mpo_check_vnode_setmode)(struct ucred *cred,
565		    struct vnode *vp, struct label *label, mode_t mode);
566	int	(*mpo_check_vnode_setowner)(struct ucred *cred,
567		    struct vnode *vp, struct label *label, uid_t uid,
568		    gid_t gid);
569	int	(*mpo_check_vnode_setutimes)(struct ucred *cred,
570		    struct vnode *vp, struct label *label,
571		    struct timespec atime, struct timespec mtime);
572	int	(*mpo_check_vnode_stat)(struct ucred *active_cred,
573		    struct ucred *file_cred, struct vnode *vp,
574		    struct label *label);
575	int	(*mpo_check_vnode_write)(struct ucred *active_cred,
576		    struct ucred *file_cred, struct vnode *vp,
577		    struct label *label);
578};
579
580/*
581 * struct mac_policy_conf is the registration structure for policies, and is
582 * provided to the MAC Framework using MAC_POLICY_SET() to invoke a SYSINIT
583 * to register the policy.  In general, the fields are immutable, with the
584 * exception of the "security field", run-time flags, and policy list entry,
585 * which are managed by the MAC Framework.  Be careful when modifying this
586 * structure, as its layout is statically compiled into all policies.
587 */
588struct mac_policy_conf {
589	char				*mpc_name;	/* policy name */
590	char				*mpc_fullname;	/* policy full name */
591	struct mac_policy_ops		*mpc_ops;	/* policy operations */
592	int				 mpc_loadtime_flags;	/* flags */
593	int				*mpc_field_off; /* security field */
594	int				 mpc_runtime_flags; /* flags */
595	LIST_ENTRY(mac_policy_conf)	 mpc_list;	/* global list */
596};
597
598/* Flags for the mpc_loadtime_flags field. */
599#define	MPC_LOADTIME_FLAG_NOTLATE	0x00000001
600#define	MPC_LOADTIME_FLAG_UNLOADOK	0x00000002
601#define	MPC_LOADTIME_FLAG_LABELMBUFS	0x00000004
602
603/* Flags for the mpc_runtime_flags field. */
604#define	MPC_RUNTIME_FLAG_REGISTERED	0x00000001
605
606#define	MAC_POLICY_SET(mpops, mpname, mpfullname, mpflags, privdata_wanted) \
607	static struct mac_policy_conf mpname##_mac_policy_conf = {	\
608		#mpname,						\
609		mpfullname,						\
610		mpops,							\
611		mpflags,						\
612		privdata_wanted,					\
613		0,							\
614	};								\
615	static moduledata_t mpname##_mod = {				\
616		#mpname,						\
617		mac_policy_modevent,					\
618		&mpname##_mac_policy_conf				\
619	};								\
620	MODULE_DEPEND(mpname, kernel_mac_support, 2, 2, 2);		\
621	DECLARE_MODULE(mpname, mpname##_mod, SI_SUB_MAC_POLICY,		\
622	    SI_ORDER_MIDDLE)
623
624int	mac_policy_modevent(module_t mod, int type, void *data);
625
626#define	LABEL_TO_SLOT(l, s)	(l)->l_perpolicy[s]
627
628#endif /* !_SYS_MAC_POLICY_H_ */
629