FreeBSD/Linux Kernel Cross Reference
sys/sys/mac_policy.h
1 /*-
2 * Copyright (c) 1999, 2000, 2001, 2002 Robert N. M. Watson
3 * Copyright (c) 2001, 2002 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: releng/5.0/sys/sys/mac_policy.h 107698 2002-12-09 03:44: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 */
54 struct mac_policy_conf;
55 struct mac_policy_ops {
56 /*
57 * Policy module operations.
58 */
59 void (*mpo_destroy)(struct mac_policy_conf *mpc);
60 void (*mpo_init)(struct mac_policy_conf *mpc);
61
62 /*
63 * General policy-directed security system call so that policies
64 * may implement new services without reserving explicit
65 * system call numbers.
66 */
67 int (*mpo_syscall)(struct thread *td, int call, void *arg);
68
69 /*
70 * Label operations.
71 */
72 void (*mpo_init_bpfdesc_label)(struct label *label);
73 void (*mpo_init_cred_label)(struct label *label);
74 void (*mpo_init_devfsdirent_label)(struct label *label);
75 void (*mpo_init_ifnet_label)(struct label *label);
76 void (*mpo_init_ipq_label)(struct label *label);
77 int (*mpo_init_mbuf_label)(struct label *label, int flag);
78 void (*mpo_init_mount_label)(struct label *label);
79 void (*mpo_init_mount_fs_label)(struct label *label);
80 int (*mpo_init_socket_label)(struct label *label, int flag);
81 int (*mpo_init_socket_peer_label)(struct label *label, int flag);
82 void (*mpo_init_pipe_label)(struct label *label);
83 void (*mpo_init_proc_label)(struct label *label);
84 void (*mpo_init_vnode_label)(struct label *label);
85 void (*mpo_destroy_bpfdesc_label)(struct label *label);
86 void (*mpo_destroy_cred_label)(struct label *label);
87 void (*mpo_destroy_devfsdirent_label)(struct label *label);
88 void (*mpo_destroy_ifnet_label)(struct label *label);
89 void (*mpo_destroy_ipq_label)(struct label *label);
90 void (*mpo_destroy_mbuf_label)(struct label *label);
91 void (*mpo_destroy_mount_label)(struct label *label);
92 void (*mpo_destroy_mount_fs_label)(struct label *label);
93 void (*mpo_destroy_socket_label)(struct label *label);
94 void (*mpo_destroy_socket_peer_label)(struct label *label);
95 void (*mpo_destroy_pipe_label)(struct label *label);
96 void (*mpo_destroy_proc_label)(struct label *label);
97 void (*mpo_destroy_vnode_label)(struct label *label);
98 void (*mpo_copy_pipe_label)(struct label *src,
99 struct label *dest);
100 void (*mpo_copy_vnode_label)(struct label *src,
101 struct label *dest);
102 int (*mpo_externalize_cred_label)(struct label *label,
103 char *element_name, char *buffer, size_t buflen,
104 size_t *len, int *claimed);
105 int (*mpo_externalize_ifnet_label)(struct label *label,
106 char *element_name, char *buffer, size_t buflen,
107 size_t *len, int *claimed);
108 int (*mpo_externalize_pipe_label)(struct label *label,
109 char *element_name, char *buffer, size_t buflen,
110 size_t *len, int *claimed);
111 int (*mpo_externalize_socket_label)(struct label *label,
112 char *element_name, char *buffer, size_t buflen,
113 size_t *len, int *claimed);
114 int (*mpo_externalize_socket_peer_label)(struct label *label,
115 char *element_name, char *buffer, size_t buflen,
116 size_t *len, int *claimed);
117 int (*mpo_externalize_vnode_label)(struct label *label,
118 char *element_name, char *buffer, size_t buflen,
119 size_t *len, int *claimed);
120 int (*mpo_internalize_cred_label)(struct label *label,
121 char *element_name, char *element_data, int *claimed);
122 int (*mpo_internalize_ifnet_label)(struct label *label,
123 char *element_name, char *element_data, int *claimed);
124 int (*mpo_internalize_pipe_label)(struct label *label,
125 char *element_name, char *element_data, int *claimed);
126 int (*mpo_internalize_socket_label)(struct label *label,
127 char *element_name, char *element_data, int *claimed);
128 int (*mpo_internalize_vnode_label)(struct label *label,
129 char *element_name, char *element_data, int *claimed);
130
131 /*
132 * Labeling event operations: file system objects, and things that
133 * look a lot like file system objects.
134 */
135 void (*mpo_associate_vnode_devfs)(struct mount *mp,
136 struct label *fslabel, struct devfs_dirent *de,
137 struct label *delabel, struct vnode *vp,
138 struct label *vlabel);
139 int (*mpo_associate_vnode_extattr)(struct mount *mp,
140 struct label *fslabel, struct vnode *vp,
141 struct label *vlabel);
142 void (*mpo_associate_vnode_singlelabel)(struct mount *mp,
143 struct label *fslabel, struct vnode *vp,
144 struct label *vlabel);
145 void (*mpo_create_devfs_device)(struct mount *mp, dev_t dev,
146 struct devfs_dirent *de, struct label *label);
147 void (*mpo_create_devfs_directory)(struct mount *mp, char *dirname,
148 int dirnamelen, struct devfs_dirent *de,
149 struct label *label);
150 void (*mpo_create_devfs_symlink)(struct ucred *cred,
151 struct mount *mp, struct devfs_dirent *dd,
152 struct label *ddlabel, struct devfs_dirent *de,
153 struct label *delabel);
154 int (*mpo_create_vnode_extattr)(struct ucred *cred,
155 struct mount *mp, struct label *fslabel,
156 struct vnode *dvp, struct label *dlabel,
157 struct vnode *vp, struct label *vlabel,
158 struct componentname *cnp);
159 void (*mpo_create_mount)(struct ucred *cred, struct mount *mp,
160 struct label *mntlabel, struct label *fslabel);
161 void (*mpo_create_root_mount)(struct ucred *cred, struct mount *mp,
162 struct label *mountlabel, struct label *fslabel);
163 void (*mpo_relabel_vnode)(struct ucred *cred, struct vnode *vp,
164 struct label *vnodelabel, struct label *label);
165 int (*mpo_setlabel_vnode_extattr)(struct ucred *cred,
166 struct vnode *vp, struct label *vlabel,
167 struct label *intlabel);
168 void (*mpo_update_devfsdirent)(struct mount *mp,
169 struct devfs_dirent *devfs_dirent,
170 struct label *direntlabel, struct vnode *vp,
171 struct label *vnodelabel);
172
173 /*
174 * Labeling event operations: IPC objects.
175 */
176 void (*mpo_create_mbuf_from_socket)(struct socket *so,
177 struct label *socketlabel, struct mbuf *m,
178 struct label *mbuflabel);
179 void (*mpo_create_socket)(struct ucred *cred, struct socket *so,
180 struct label *socketlabel);
181 void (*mpo_create_socket_from_socket)(struct socket *oldsocket,
182 struct label *oldsocketlabel, struct socket *newsocket,
183 struct label *newsocketlabel);
184 void (*mpo_relabel_socket)(struct ucred *cred, struct socket *so,
185 struct label *oldlabel, struct label *newlabel);
186 void (*mpo_relabel_pipe)(struct ucred *cred, struct pipe *pipe,
187 struct label *oldlabel, struct label *newlabel);
188 void (*mpo_set_socket_peer_from_mbuf)(struct mbuf *mbuf,
189 struct label *mbuflabel, struct socket *so,
190 struct label *socketpeerlabel);
191 void (*mpo_set_socket_peer_from_socket)(struct socket *oldsocket,
192 struct label *oldsocketlabel, struct socket *newsocket,
193 struct label *newsocketpeerlabel);
194 void (*mpo_create_pipe)(struct ucred *cred, struct pipe *pipe,
195 struct label *pipelabel);
196
197 /*
198 * Labeling event operations: network objects.
199 */
200 void (*mpo_create_bpfdesc)(struct ucred *cred, struct bpf_d *bpf_d,
201 struct label *bpflabel);
202 void (*mpo_create_ifnet)(struct ifnet *ifnet,
203 struct label *ifnetlabel);
204 void (*mpo_create_ipq)(struct mbuf *fragment,
205 struct label *fragmentlabel, struct ipq *ipq,
206 struct label *ipqlabel);
207 void (*mpo_create_datagram_from_ipq)
208 (struct ipq *ipq, struct label *ipqlabel,
209 struct mbuf *datagram, struct label *datagramlabel);
210 void (*mpo_create_fragment)(struct mbuf *datagram,
211 struct label *datagramlabel, struct mbuf *fragment,
212 struct label *fragmentlabel);
213 void (*mpo_create_mbuf_from_mbuf)(struct mbuf *oldmbuf,
214 struct label *oldlabel, struct mbuf *newmbuf,
215 struct label *newlabel);
216 void (*mpo_create_mbuf_linklayer)(struct ifnet *ifnet,
217 struct label *ifnetlabel, struct mbuf *mbuf,
218 struct label *mbuflabel);
219 void (*mpo_create_mbuf_from_bpfdesc)(struct bpf_d *bpf_d,
220 struct label *bpflabel, struct mbuf *mbuf,
221 struct label *mbuflabel);
222 void (*mpo_create_mbuf_from_ifnet)(struct ifnet *ifnet,
223 struct label *ifnetlabel, struct mbuf *mbuf,
224 struct label *mbuflabel);
225 void (*mpo_create_mbuf_multicast_encap)(struct mbuf *oldmbuf,
226 struct label *oldmbuflabel, struct ifnet *ifnet,
227 struct label *ifnetlabel, struct mbuf *newmbuf,
228 struct label *newmbuflabel);
229 void (*mpo_create_mbuf_netlayer)(struct mbuf *oldmbuf,
230 struct label *oldmbuflabel, struct mbuf *newmbuf,
231 struct label *newmbuflabel);
232 int (*mpo_fragment_match)(struct mbuf *fragment,
233 struct label *fragmentlabel, struct ipq *ipq,
234 struct label *ipqlabel);
235 void (*mpo_relabel_ifnet)(struct ucred *cred, struct ifnet *ifnet,
236 struct label *ifnetlabel, struct label *newlabel);
237 void (*mpo_update_ipq)(struct mbuf *fragment,
238 struct label *fragmentlabel, struct ipq *ipq,
239 struct label *ipqlabel);
240
241 /*
242 * Labeling event operations: processes.
243 */
244 void (*mpo_create_cred)(struct ucred *parent_cred,
245 struct ucred *child_cred);
246 void (*mpo_execve_transition)(struct ucred *old, struct ucred *new,
247 struct vnode *vp, struct label *vnodelabel,
248 struct label *interpvnodelabel,
249 struct image_params *imgp, struct label *execlabel);
250 int (*mpo_execve_will_transition)(struct ucred *old,
251 struct vnode *vp, struct label *vnodelabel,
252 struct label *interpvnodelabel,
253 struct image_params *imgp, struct label *execlabel);
254 void (*mpo_create_proc0)(struct ucred *cred);
255 void (*mpo_create_proc1)(struct ucred *cred);
256 void (*mpo_relabel_cred)(struct ucred *cred,
257 struct label *newlabel);
258 void (*mpo_thread_userret)(struct thread *thread);
259
260 /*
261 * Access control checks.
262 */
263 int (*mpo_check_bpfdesc_receive)(struct bpf_d *bpf_d,
264 struct label *bpflabel, struct ifnet *ifnet,
265 struct label *ifnetlabel);
266 int (*mpo_check_cred_relabel)(struct ucred *cred,
267 struct label *newlabel);
268 int (*mpo_check_cred_visible)(struct ucred *u1, struct ucred *u2);
269 int (*mpo_check_ifnet_relabel)(struct ucred *cred,
270 struct ifnet *ifnet, struct label *ifnetlabel,
271 struct label *newlabel);
272 int (*mpo_check_ifnet_transmit)(struct ifnet *ifnet,
273 struct label *ifnetlabel, struct mbuf *m,
274 struct label *mbuflabel);
275 int (*mpo_check_kenv_dump)(struct ucred *cred);
276 int (*mpo_check_kenv_get)(struct ucred *cred, char *name);
277 int (*mpo_check_kenv_set)(struct ucred *cred, char *name,
278 char *value);
279 int (*mpo_check_kenv_unset)(struct ucred *cred, char *name);
280 int (*mpo_check_kld_load)(struct ucred *cred, struct vnode *vp,
281 struct label *vlabel);
282 int (*mpo_check_kld_stat)(struct ucred *cred);
283 int (*mpo_check_kld_unload)(struct ucred *cred);
284 int (*mpo_check_mount_stat)(struct ucred *cred, struct mount *mp,
285 struct label *mntlabel);
286 int (*mpo_check_pipe_ioctl)(struct ucred *cred, struct pipe *pipe,
287 struct label *pipelabel, unsigned long cmd, void *data);
288 int (*mpo_check_pipe_poll)(struct ucred *cred, struct pipe *pipe,
289 struct label *pipelabel);
290 int (*mpo_check_pipe_read)(struct ucred *cred, struct pipe *pipe,
291 struct label *pipelabel);
292 int (*mpo_check_pipe_relabel)(struct ucred *cred,
293 struct pipe *pipe, struct label *pipelabel,
294 struct label *newlabel);
295 int (*mpo_check_pipe_stat)(struct ucred *cred, struct pipe *pipe,
296 struct label *pipelabel);
297 int (*mpo_check_pipe_write)(struct ucred *cred, struct pipe *pipe,
298 struct label *pipelabel);
299 int (*mpo_check_proc_debug)(struct ucred *cred,
300 struct proc *proc);
301 int (*mpo_check_proc_sched)(struct ucred *cred,
302 struct proc *proc);
303 int (*mpo_check_proc_signal)(struct ucred *cred,
304 struct proc *proc, int signum);
305 int (*mpo_check_socket_bind)(struct ucred *cred,
306 struct socket *so, struct label *socketlabel,
307 struct sockaddr *sockaddr);
308 int (*mpo_check_socket_connect)(struct ucred *cred,
309 struct socket *so, struct label *socketlabel,
310 struct sockaddr *sockaddr);
311 int (*mpo_check_socket_deliver)(struct socket *so,
312 struct label *socketlabel, struct mbuf *m,
313 struct label *mbuflabel);
314 int (*mpo_check_socket_listen)(struct ucred *cred,
315 struct socket *so, struct label *socketlabel);
316 int (*mpo_check_socket_receive)(struct ucred *cred,
317 struct socket *so, struct label *socketlabel);
318 int (*mpo_check_socket_relabel)(struct ucred *cred,
319 struct socket *so, struct label *socketlabel,
320 struct label *newlabel);
321 int (*mpo_check_socket_send)(struct ucred *cred,
322 struct socket *so, struct label *socketlabel);
323 int (*mpo_check_socket_visible)(struct ucred *cred,
324 struct socket *so, struct label *socketlabel);
325 int (*mpo_check_system_acct)(struct ucred *cred,
326 struct vnode *vp, struct label *vlabel);
327 int (*mpo_check_system_nfsd)(struct ucred *cred);
328 int (*mpo_check_system_reboot)(struct ucred *cred, int howto);
329 int (*mpo_check_system_settime)(struct ucred *cred);
330 int (*mpo_check_system_swapon)(struct ucred *cred,
331 struct vnode *vp, struct label *label);
332 int (*mpo_check_system_sysctl)(struct ucred *cred, int *name,
333 u_int namelen, void *old, size_t *oldlenp, int inkernel,
334 void *new, size_t newlen);
335 int (*mpo_check_vnode_access)(struct ucred *cred,
336 struct vnode *vp, struct label *label, int acc_mode);
337 int (*mpo_check_vnode_chdir)(struct ucred *cred,
338 struct vnode *dvp, struct label *dlabel);
339 int (*mpo_check_vnode_chroot)(struct ucred *cred,
340 struct vnode *dvp, struct label *dlabel);
341 int (*mpo_check_vnode_create)(struct ucred *cred,
342 struct vnode *dvp, struct label *dlabel,
343 struct componentname *cnp, struct vattr *vap);
344 int (*mpo_check_vnode_delete)(struct ucred *cred,
345 struct vnode *dvp, struct label *dlabel,
346 struct vnode *vp, struct label *label,
347 struct componentname *cnp);
348 int (*mpo_check_vnode_deleteacl)(struct ucred *cred,
349 struct vnode *vp, struct label *label, acl_type_t type);
350 int (*mpo_check_vnode_exec)(struct ucred *cred, struct vnode *vp,
351 struct label *label, struct image_params *imgp,
352 struct label *execlabel);
353 int (*mpo_check_vnode_getacl)(struct ucred *cred,
354 struct vnode *vp, struct label *label, acl_type_t type);
355 int (*mpo_check_vnode_getextattr)(struct ucred *cred,
356 struct vnode *vp, struct label *label, int attrnamespace,
357 const char *name, struct uio *uio);
358 int (*mpo_check_vnode_link)(struct ucred *cred, struct vnode *dvp,
359 struct label *dlabel, struct vnode *vp,
360 struct label *label, struct componentname *cnp);
361 int (*mpo_check_vnode_lookup)(struct ucred *cred,
362 struct vnode *dvp, struct label *dlabel,
363 struct componentname *cnp);
364 int (*mpo_check_vnode_mmap)(struct ucred *cred, struct vnode *vp,
365 struct label *label, int prot);
366 void (*mpo_check_vnode_mmap_downgrade)(struct ucred *cred,
367 struct vnode *vp, struct label *label, int *prot);
368 int (*mpo_check_vnode_mprotect)(struct ucred *cred,
369 struct vnode *vp, struct label *label, int prot);
370 int (*mpo_check_vnode_open)(struct ucred *cred, struct vnode *vp,
371 struct label *label, int acc_mode);
372 int (*mpo_check_vnode_poll)(struct ucred *active_cred,
373 struct ucred *file_cred, struct vnode *vp,
374 struct label *label);
375 int (*mpo_check_vnode_read)(struct ucred *active_cred,
376 struct ucred *file_cred, struct vnode *vp,
377 struct label *label);
378 int (*mpo_check_vnode_readdir)(struct ucred *cred,
379 struct vnode *dvp, struct label *dlabel);
380 int (*mpo_check_vnode_readlink)(struct ucred *cred,
381 struct vnode *vp, struct label *label);
382 int (*mpo_check_vnode_relabel)(struct ucred *cred,
383 struct vnode *vp, struct label *vnodelabel,
384 struct label *newlabel);
385 int (*mpo_check_vnode_rename_from)(struct ucred *cred,
386 struct vnode *dvp, struct label *dlabel, struct vnode *vp,
387 struct label *label, struct componentname *cnp);
388 int (*mpo_check_vnode_rename_to)(struct ucred *cred,
389 struct vnode *dvp, struct label *dlabel, struct vnode *vp,
390 struct label *label, int samedir,
391 struct componentname *cnp);
392 int (*mpo_check_vnode_revoke)(struct ucred *cred,
393 struct vnode *vp, struct label *label);
394 int (*mpo_check_vnode_setacl)(struct ucred *cred,
395 struct vnode *vp, struct label *label, acl_type_t type,
396 struct acl *acl);
397 int (*mpo_check_vnode_setextattr)(struct ucred *cred,
398 struct vnode *vp, struct label *label, int attrnamespace,
399 const char *name, struct uio *uio);
400 int (*mpo_check_vnode_setflags)(struct ucred *cred,
401 struct vnode *vp, struct label *label, u_long flags);
402 int (*mpo_check_vnode_setmode)(struct ucred *cred,
403 struct vnode *vp, struct label *label, mode_t mode);
404 int (*mpo_check_vnode_setowner)(struct ucred *cred,
405 struct vnode *vp, struct label *label, uid_t uid,
406 gid_t gid);
407 int (*mpo_check_vnode_setutimes)(struct ucred *cred,
408 struct vnode *vp, struct label *label,
409 struct timespec atime, struct timespec mtime);
410 int (*mpo_check_vnode_stat)(struct ucred *active_cred,
411 struct ucred *file_cred, struct vnode *vp,
412 struct label *label);
413 int (*mpo_check_vnode_write)(struct ucred *active_cred,
414 struct ucred *file_cred, struct vnode *vp,
415 struct label *label);
416 };
417
418 struct mac_policy_conf {
419 char *mpc_name; /* policy name */
420 char *mpc_fullname; /* policy full name */
421 struct mac_policy_ops *mpc_ops; /* policy operations */
422 int mpc_loadtime_flags; /* flags */
423 int *mpc_field_off; /* security field */
424 int mpc_runtime_flags; /* flags */
425 LIST_ENTRY(mac_policy_conf) mpc_list; /* global list */
426 };
427
428 /* Flags for the mpc_loadtime_flags field. */
429 #define MPC_LOADTIME_FLAG_NOTLATE 0x00000001
430 #define MPC_LOADTIME_FLAG_UNLOADOK 0x00000002
431
432 /* Flags for the mpc_runtime_flags field. */
433 #define MPC_RUNTIME_FLAG_REGISTERED 0x00000001
434
435 #define MAC_POLICY_SET(mpops, mpname, mpfullname, mpflags, privdata_wanted) \
436 static struct mac_policy_conf mpname##_mac_policy_conf = { \
437 #mpname, \
438 mpfullname, \
439 mpops, \
440 mpflags, \
441 privdata_wanted, \
442 0, \
443 }; \
444 static moduledata_t mpname##_mod = { \
445 #mpname, \
446 mac_policy_modevent, \
447 &mpname##_mac_policy_conf \
448 }; \
449 MODULE_DEPEND(mpname, kernel_mac_support, 1, 1, 1); \
450 DECLARE_MODULE(mpname, mpname##_mod, SI_SUB_MAC_POLICY, \
451 SI_ORDER_MIDDLE)
452
453 int mac_policy_modevent(module_t mod, int type, void *data);
454
455 #define LABEL_TO_SLOT(l, s) (l)->l_perpolicy[s]
456
457 #endif /* !_SYS_MAC_POLICY_H */
Cache object: 99dc5eeee61e201eccf77a856d6b929c
|