File: security_load_booleans.3

package info (click to toggle)
libselinux 2.0.96-1
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 2,348 kB
  • ctags: 4,345
  • sloc: ansic: 24,218; python: 2,086; sh: 232; makefile: 219
file content (71 lines) | stat: -rw-r--r-- 2,203 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
.TH "security_get_boolean_names" "3" "15 November 2004" "dwalsh@redhat.com" "SELinux API Documentation"
.SH "NAME"
security_load_booleans, security_set_boolean, security_commit_booleans, 
security_get_boolean_names, security_get_boolean_active,
security_get_boolean_pending \- routines for manipulating SELinux boolean values
.SH "SYNOPSIS"
.B #include <selinux/selinux.h>
.sp
.BI "int security_load_booleans(char *" path ");"
.sp 
.BI "int security_get_boolean_names(char ***" names ", int *" len ");"
.sp
.BI "int security_get_boolean_pending(const char *" name ");"
.sp
.BI "int security_get_boolean_active(const char *" name ");"
.sp
.BI "int security_set_boolean(const char *" name ", int " value ");"
.sp
.BI "int security_set_boolean_list(size_t " boolcnt ", SELboolean *" boollist ", int " permanent ");"
.sp
.BI "int security_commit_booleans(void);"


.SH "DESCRIPTION"

The SELinux policy can include conditional rules that are enabled or
disabled based on the current values of a set of policy booleans.
These policy booleans allow runtime modification of the security
policy without having to load a new policy.  

The SELinux API allows for a transaction based update. So you can
set several boolean values and then commit them all at once.

.B security_load_booleans

loads policy boolean settings. Path may be NULL, in which case the
booleans are loaded from the active policy boolean configuration file.

.B security_get_boolean_names

provides a list of boolean names, currently supported by the loaded policy.

.B security_get_boolean_pending

returns the pending value for boolean or \-1 on failure.

.B security_get_boolean_active

returns the active value for boolean or \-1 on failure.

.B security_set_boolean 

sets the pending value for boolean 

.B security_set_boolean_list

saves a list of booleans in a single transaction.

.B security_commit_booleans

commits all pending values for the booleans.

.SH "RETURN VALUE"
Where not otherwise stated, functions described in this manual page return
zero on success or \-1 on error. 

.SH AUTHOR	
This manual page was written by Dan Walsh <dwalsh@redhat.com>.

.SH "SEE ALSO"
selinux(8), getsebool(8), booleans(8), togglesebool(8)