bsde_set_rule(3) [freebsd man page]

BSDE_GET_RULE(3)					   BSD Library Functions Manual 					  BSDE_GET_RULE(3)

NAME

     bsde_add_rule, bsde_get_rule, bsde_set_rule, bsde_delete_rule -- file system firewall rules list management

LIBRARY

     File System Firewall Interface Library (libugidfw, -lugidfw)

SYNOPSIS

     #include <ugidfw.h>

     int
     bsde_add_rule(int *rulenum, struct mac_bsdextended_rule *rule, size_t buflen, char *errstr);

     int
     bsde_get_rule(int rulenum, struct mac_bsdextended_rule *rule, size_t errlen, char *errstr);

     int
     bsde_set_rule(int rulenum, struct mac_bsdextended_rule *rule, size_t errlen, char *errstr);

     int
     bsde_delete_rule(int rulenum, size_t errlen, char *errstr);

DESCRIPTION

     The bsde_add_rule() function fills the next available rule (in struct mac_bsdextended_rule form, either from bsde_get_rule() or
     bsde_parse_rule(3)).  If an error occurs, *errstr is filled with the error string (up to errlen characters, including the terminating NUL).
     If successful and rulenum is non-NULL, the rule number used will be returned in *rulenum.

     The bsde_get_rule() function fills in *rule with the rule numbered rulenum.  If an error occurs, *errstr is filled in with the error string
     (up to errlen characters, including the terminating NUL).

     The bsde_set_rule() function fills the slot numbered rulenum with the specified rule (in struct mac_bsdextended_rule form, either from
     bsde_get_rule() or bsde_parse_rule(3)).  If an error occurs, *errstr is filled with the error string (up to errlen characters, including the
     terminating NUL).

     The bsde_delete_rule() function deletes the rule numbered rulenum.  If an error occurs, *errstr is filled with the error string (up to errlen
     characters, including the terminating NUL).

RETURN VALUES

     The bsde_get_rule(), bsde_set_rule(), and bsde_delete_rule() functions return 0 if successful; otherwise the value -1 is returned and the
     value of *errstr is filled in as documented in DESCRIPTION.

SEE ALSO

     bsde_get_rule_count(3), bsde_get_rule_slots(3), bsde_parse_rule(3), bsde_parse_rule_string(3), bsde_rule_to_string(3), libugidfw(3),
     mac_bsdextended(4), ugidfw(8)

AUTHORS

     This software was contributed to the FreeBSD Project by Network Associates Labs, the Security Research Division of Network Associates Inc.
     under DARPA/SPAWAR contract N66001-01-C-8035 (``CBOSS''), as part of the DARPA CHATS research program.

BSD
								 February 24, 2004							       BSD

MAC_BSDEXTENDED(4)					   BSD Kernel Interfaces Manual 					MAC_BSDEXTENDED(4)

NAME

     mac_bsdextended -- file system firewall policy

SYNOPSIS

     To compile the file system firewall policy into your kernel, place the following lines in your kernel configuration file:

	   options MAC
	   options MAC_BSDEXTENDED

     Alternately, to load the file system firewall policy module at boot time, place the following line in your kernel configuration file:

	   options MAC

     and in loader.conf(5):

	   mac_bsdextended_load="YES"

DESCRIPTION

     The mac_bsdextended security policy module provides an interface for the system administrator to impose mandatory rules regarding users and
     some system objects.  Rules are uploaded to the module (typically using ugidfw(8), or some other tool utilizing libugidfw(3)) where they are
     stored internally and used to determine whether to allow or deny specific accesses (see ugidfw(8)).

IMPLEMENTATION NOTES

     While the traditional mac(9) entry points are implemented, policy labels are not used; instead, access control decisions are made by iterat-
     ing through the internal list of rules until a rule which denies the particular access is found, or the end of the list is reached.  The
     mac_bsdextended policy works similar to ipfw(8) or by using a first match semantic.  This means that not all rules are applied, only the
     first matched rule; thus if Rule A allows access and Rule B blocks access, Rule B will never be applied.

   Sysctls
     The following sysctls may be used to tweak the behavior of mac_bsdextended:

     security.mac.bsdextended.enabled
	     Set to zero or one to toggle the policy off or on.

     security.mac.bsdextended.rule_count
	     List the number of defined rules, the maximum rule count is current set at 256.

     security.mac.bsdextended.rule_slots
	     List the number of rule slots currently being used.

     security.mac.bsdextended.firstmatch_enabled
	     Toggle between the old all rules match functionality and the new first rule matches functionality.  This is enabled by default.

     security.mac.bsdextended.logging
	     Log all access violations via the AUTHPRIV syslog(3) facility.

     security.mac.bsdextended.rules
	     Currently does nothing interesting.

SEE ALSO

     libugidfw(3), syslog(3), mac(4), mac_biba(4), mac_ifoff(4), mac_lomac(4), mac_mls(4), mac_none(4), mac_partition(4), mac_portacl(4),
     mac_seeotheruids(4), mac_test(4), ipfw(8), ugidfw(8), mac(9)

HISTORY

     The mac_bsdextended policy module first appeared in FreeBSD 5.0 and was developed by the TrustedBSD Project.

     The "match first case" and logging capabilities were later added by Tom Rhodes <trhodes@FreeBSD.org>.

AUTHORS

     This software was contributed to the FreeBSD Project by NAI Labs, the Security Research Division of Network Associates Inc. under
     DARPA/SPAWAR contract N66001-01-C-8035 (``CBOSS''), as part of the DARPA CHATS research program.

BSD
								   May 21, 2005 							       BSD