58 lines
2.2 KiB
Groff
58 lines
2.2 KiB
Groff
.TH "security_load_policy" "3" "3 November 2009" "guido@trentalancia.com" "SELinux API documentation"
|
|
.SH "NAME"
|
|
security_load_policy \- load a new SELinux policy
|
|
.
|
|
.SH "SYNOPSIS"
|
|
.B #include <selinux/selinux.h>
|
|
.sp
|
|
.BI "int security_load_policy(const void *" data ", size_t "len );
|
|
.sp
|
|
.BI "int selinux_mkload_policy(int " preservebools ");"
|
|
.sp
|
|
.BI "int selinux_init_load_policy(int *" enforce ");"
|
|
.
|
|
.SH "DESCRIPTION"
|
|
.BR security_load_policy ()
|
|
loads a new policy, returns 0 for success and \-1 for error.
|
|
|
|
.BR selinux_mkload_policy ()
|
|
makes a policy image and loads it. This function provides a higher level
|
|
interface for loading policy than
|
|
.BR \%security_load_policy (),
|
|
internally determining the right policy version, locating and opening
|
|
the policy file, mapping it into memory, manipulating it as needed for
|
|
current boolean settings and/or local definitions, and then calling
|
|
security_load_policy to load it.
|
|
.I preservebools
|
|
is a boolean flag indicating whether current policy boolean values should
|
|
be preserved into the new policy (if 1) or reset to the saved policy
|
|
settings (if 0). The former case is the default for policy reloads, while
|
|
the latter case is an option for policy reloads but is primarily used for
|
|
the initial policy load.
|
|
.BR selinux_init_load_policy ()
|
|
performs the initial policy load. This function determines the desired
|
|
enforcing mode, sets the
|
|
.I enforce
|
|
argument accordingly for the caller to use, sets the SELinux kernel
|
|
enforcing status to match it, and loads the policy. It also internally
|
|
handles the initial selinuxfs mount required to perform these actions.
|
|
.sp
|
|
It should also be noted that after the initial policy load, the SELinux
|
|
kernel code cannot anymore be disabled and the selinuxfs cannot be
|
|
unmounted using a call to
|
|
.BR security_disable (3).
|
|
Therefore, after the initial policy load, the only operational changes
|
|
are those permitted by
|
|
.BR security_setenforce (3)
|
|
(i.e. eventually setting the framework in permissive mode rather than
|
|
in enforcing one).
|
|
.
|
|
.SH "RETURN VALUE"
|
|
Returns zero on success or \-1 on error.
|
|
.
|
|
.SH "AUTHOR"
|
|
This manual page has been written by Guido Trentalancia <guido@trentalancia.com>
|
|
.
|
|
.SH "SEE ALSO"
|
|
.BR selinux "(8), " security_disable "(3), " setenforce "(8)
|