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