Chris PeBenito 473ea7
.TH "booleans" "8" "11 Aug 2004" "dwalsh@redhat.com" "SELinux Command Line documentation"
Chris PeBenito 473ea7
.SH "NAME"
Chris PeBenito 473ea7
booleans \- Policy booleans enable runtime customization of SELinux policy.
Chris PeBenito 473ea7
Chris PeBenito 473ea7
.SH "DESCRIPTION"
Chris PeBenito 473ea7
This manual page describes SELinux policy booleans.
Chris PeBenito 473ea7
.BR
Chris PeBenito 473ea7
Chris PeBenito 473ea7
The SELinux policy can include conditional rules that are enabled or
Chris PeBenito 473ea7
disabled based on the current values of a set of policy booleans.
Chris PeBenito 473ea7
These policy booleans allow runtime modification of the security
Chris PeBenito 473ea7
policy without having to load a new policy.  
Chris PeBenito 473ea7
Chris PeBenito 473ea7
For example, the boolean httpd_enable_cgi allows the httpd daemon to
Chris PeBenito 473ea7
run cgi scripts if it is enabled.  If the administrator does not want
Chris PeBenito 473ea7
to allow execution of cgi scripts, he can simply disable this boolean
Chris PeBenito 473ea7
value.  
Chris PeBenito 473ea7
Chris PeBenito 473ea7
The policy defines a default value for each boolean, typically false.
Chris PeBenito 473ea7
These default values can be overridden at boot-time based on the
Chris PeBenito 473ea7
settings in the
Chris PeBenito 473ea7
.I /etc/selinux/SELINUXTYPE/booleans
Chris PeBenito 473ea7
file, where
Chris PeBenito 473ea7
SELINUXTYPE is the type of policy currently being run on the system as
Chris PeBenito 473ea7
defined in the
Chris PeBenito 473ea7
.I /etc/selinux/config
Chris PeBenito 473ea7
file.  The
Chris PeBenito 473ea7
.B system-config-securitylevel
Chris PeBenito 473ea7
tool provides an interface for altering
Chris PeBenito 473ea7
the settings in this file.  The
Chris PeBenito 473ea7
.B load_policy(8)
Chris PeBenito 473ea7
program will preserve
Chris PeBenito 473ea7
current boolean settings upon a policy reload by default, or can
Chris PeBenito 473ea7
optionally reset booleans to the boot-time defaults via the -b option.
Chris PeBenito 473ea7
Chris PeBenito 473ea7
Boolean values can be listed by using the
Chris PeBenito 473ea7
.B getsebool(8)
Chris PeBenito 473ea7
utility and passing it the -a option.
Chris PeBenito 473ea7
Chris PeBenito 473ea7
Boolean values can also be changed at runtime via the
Chris PeBenito 473ea7
.B setsebool(8)
Chris PeBenito 473ea7
utility or the
Chris PeBenito 473ea7
.B togglesebool
Chris PeBenito 473ea7
utility.  These utilities only change the
Chris PeBenito 473ea7
current boolean value and do not affect the boot-time settings.
Chris PeBenito 473ea7
Chris PeBenito 473ea7
.SH AUTHOR	
Chris PeBenito 473ea7
This manual page was written by Dan Walsh <dwalsh@redhat.com>.
Chris PeBenito 473ea7
The SELinux conditional policy support was developed by Tresys Technology.
Chris PeBenito 473ea7
Chris PeBenito 473ea7
.SH "SEE ALSO"
Chris PeBenito 473ea7
getsebool(8), setsebool(8), selinux(8), togglesebool(8)
Chris PeBenito 473ea7
Chris PeBenito 473ea7
.SH FILES
Chris PeBenito 473ea7
/etc/selinux/SELINUXTYPE/booleans, /etc/selinux/config