1.\" Copyright (c) 2002 Networks Associates Technology, Inc. 2.\" All rights reserved. 3.\" 4.\" This software was developed for the FreeBSD Project by Chris Costello 5.\" at Safeport Network Services and Network Associates Laboratories, the 6.\" Security Research Division of Network Associates, Inc. under 7.\" DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part of the 8.\" DARPA CHATS research program. 9.\" 10.\" Redistribution and use in source and binary forms, with or without 11.\" modification, are permitted provided that the following conditions 12.\" are met: 13.\" 1. Redistributions of source code must retain the above copyright 14.\" notice, this list of conditions and the following disclaimer. 15.\" 2. Redistributions in binary form must reproduce the above copyright 16.\" notice, this list of conditions and the following disclaimer in the 17.\" documentation and/or other materials provided with the distribution. 18.\" 19.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND 20.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 21.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 22.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE 23.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 24.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 25.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 26.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 27.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 28.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 29.\" SUCH DAMAGE. 30.\" 31.\" $FreeBSD$ 32.\" 33.Dd October 16, 2002 34.Os 35.Dt MAC_BSDEXTENDED 4 36.Sh NAME 37.Nm mac_bsdextended 38.Nd "file system firewall policy" 39.Sh SYNOPSIS 40To compile the file system firewall policy into your kernel, 41place the following lines in your kernel configuration file: 42.Bd -ragged -offset indent 43.Cd "options MAC" 44.Cd "options MAC_BSDEXTENDED" 45.Ed 46.Pp 47Alternately, to load the file system firewall policy module at boot time, 48place the following line in your kernel configuration file: 49.Bd -ragged -offset indent 50.Cd "options MAC" 51.Ed 52.Pp 53and in 54.Xr loader.conf 5 : 55.Bd -literal -offset indent 56mac_bsdextended_load="YES" 57.Ed 58.Sh DESCRIPTION 59The 60.Nm 61interface provides an interface for the system administrator 62to impose mandatory rules regarding users and some system objects. 63Rules are uploaded to the module 64(typically using 65.Xr ugidfw 8 , 66or some other tool utilizing 67.Xr libugidfw 3 ) 68where they are stored internally 69and used to determine whether to allow or deny specific accesses 70(see 71.Xr ugidfw 8 ) . 72.Sh IMPLEMENTATION NOTES 73While the traditional 74.Xr mac 9 75entry points are implemented, 76policy labels are not used; 77instead, access control decisions are made by iterating through the internal 78list of rules until a rule 79which denies the particular access 80is found, 81or the end of the list is reached. 82.Sh SEE ALSO 83.Xr libugidfw 3 , 84.Xr mac 4 , 85.Xr mac_biba 4 , 86.Xr mac_ifoff 4 , 87.Xr mac_lomac 4 , 88.Xr mac_mls 4 , 89.Xr mac_none 4 , 90.Xr mac_partition 4 , 91.Xr mac_portacl 4 , 92.Xr mac_seeotheruids 4 , 93.Xr mac_test 4 , 94.Xr ugidfw 8 , 95.Xr mac 9 96.Sh HISTORY 97The 98.Nm 99policy module first appeared in 100.Fx 5.0 101and was developed by the 102.Tn TrustedBSD 103Project. 104.Sh AUTHORS 105This software was contributed to the 106.Fx 107Project by NAI Labs, the Security Research Division of Network Associates 108Inc.\& under DARPA/SPAWAR contract N66001-01-C-8035 109.Pq Dq CBOSS , 110as part of the DARPA CHATS research program. 111