Skip to contentSkip to conversation

libselinux: Add security_reject_unknown(3) man page

PATCH Superseded Petr Lautrbach 2 participants 9 messages Mar 4, 2019 – Mar 11, 2019 SELinux security module

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 libselinux: Add security_reject_unknown(3) man page

Commit c19395d7 added a new interface security_reject_unknown() which needs to be documented.

---
 libselinux/man/man3/security_getenforce.3     | 9 ++++++++-
 libselinux/man/man3/security_reject_unknown.3 | 1 +
 2 files changed, 9 insertions(+), 1 deletion(-)
 create mode 100644 libselinux/man/man3/security_reject_unknown.3
libselinux/man/man3/security_getenforce.3 +8 -1
index 29cf3de7..8d72afb6 100644
@@ -1,6 +1,7 @@
 .TH "security_getenforce" "3" "1 January 2004" "[email protected]" "SELinux API documentation"
 .SH "NAME"
-security_getenforce, security_setenforce, security_deny_unknown, security_get_checkreqprot\- get or set the enforcing state of SELinux
+security_getenforce, security_setenforce, security_deny_unknown, security_reject_unknown,
+security_get_checkreqprot\- get or set the enforcing state of SELinux
 .
 .SH "SYNOPSIS"
 .B #include <selinux/selinux.h>
@@ -11,6 +12,8 @@ security_getenforce, security_setenforce, security_deny_unknown, security_get_ch
 .sp
 .B int security_deny_unknown(void);
 .sp
+.B int security_reject_unknown(void);
+.sp
 .B int security_get_checkreqprot(void);
 .
 .SH "DESCRIPTION"
@@ -27,6 +30,10 @@ returned.
 returns 0 if SELinux treats policy queries on undefined object classes or
 permissions as being allowed, 1 if such queries are denied, and \-1 on error.
 
+.BR security_reject_unknown ()
+returns 0 if SELinux allows to load a policy which doesn't define all object
+classes and permissions, 1 if loading such policy is rejected, and \-1 on error.
+
 .BR security_get_checkreqprot ()
 can be used to determine whether SELinux is configured to check the
 protection requested by the application or the actual protection that will
libselinux/man/man3/security_reject_unknown.3 new file +1 -0
new file mode 100644
index 00000000..d59e5c2c
@@ -0,0 +1 @@
+.so man3/security_getenforce.3
Signature · 1 line
2.20.1
#1 lore raw
Quoted 33 lines · Petr Lautrbach

Commit c19395d7 added a new interface security_reject_unknown() which needs to be documented.

---
  libselinux/man/man3/security_getenforce.3     | 9 ++++++++-
  libselinux/man/man3/security_reject_unknown.3 | 1 +
  2 files changed, 9 insertions(+), 1 deletion(-)

create mode 100644 libselinux/man/man3/security_reject_unknown.3

libselinux/man/man3/security_getenforce.3 +4 -1
index 29cf3de7..8d72afb6 100644
@@ -1,6 +1,7 @@
  .TH "security_getenforce" "3" "1 January 2004" "[email protected]" "SELinux API documentation"
  .SH "NAME"
-security_getenforce, security_setenforce, security_deny_unknown, security_get_checkreqprot\- get or set the enforcing state of SELinux
+security_getenforce, security_setenforce, security_deny_unknown, security_reject_unknown,
+security_get_checkreqprot\- get or set the enforcing state of SELinux
  .
  .SH "SYNOPSIS"
  .B #include <selinux/selinux.h>
@@ -11,6 +12,8 @@ security_getenforce, security_setenforce, security_deny_unknown, security_get_ch
  .sp
  .B int security_deny_unknown(void);
  .sp
+.B int security_reject_unknown(void);
+.sp
  .B int security_get_checkreqprot(void);
  .
  .SH "DESCRIPTION"

libselinux/man/man3/security_getenforce.3 returned. · line 35

Quoted 6 lines
libselinux/man/man3/security_getenforce.3 +3 -0
@@ -27,6 +30,10 @@ returned.
  returns 0 if SELinux treats policy queries on undefined object classes or
  permissions as being allowed, 1 if such queries are denied, and \-1 on error.
 
+.BR security_reject_unknown ()
+returns 0 if SELinux allows to load a policy which doesn't define all object
+classes and permissions, 1 if loading such policy is rejected, and \-1 on error.

s/all object classes and permissions/all kernel object classes and permissions/

A policy can still be loaded if it is missing userspace object classes and permissions regardless of security_reject_unknown(), although the object manager may later encounter a failure upon selinux_set_mapping(), which internally calls security_reject_unknown() to decide how to proceed, or direct attempts to lookup the class or permission via string_to_security_class() or string_to_av_perm().

I don't know of anyone building policies with handle_unknown == reject so it is unlikely that anyone is testing this case. deny is the default. allow is set in Fedora/RHEL. Android uses deny.

Quoted 12 lines
libselinux/man/man3/security_getenforce.3 +1 -0
+
  .BR security_get_checkreqprot ()
  can be used to determine whether SELinux is configured to check the
  protection requested by the application or the actual protection that will
libselinux/man/man3/security_reject_unknown.3 new file +1 -0
new file mode 100644
index 00000000..d59e5c2c
@@ -0,0 +1 @@
+.so man3/security_getenforce.3
#2 lore raw
Quoted 52 lines · Stephen Smalley
Quoted 45 lines · Petr Lautrbach

Commit c19395d7 added a new interface security_reject_unknown() which needs to be documented.

---
  libselinux/man/man3/security_getenforce.3     | 9 ++++++++-
  libselinux/man/man3/security_reject_unknown.3 | 1 +
  2 files changed, 9 insertions(+), 1 deletion(-)

create mode 100644
libselinux/man/man3/security_reject_unknown.3

libselinux/man/man3/security_getenforce.3 +0 -1
index 29cf3de7..8d72afb6 100644
@@ -1,6 +1,7 @@
  .TH "security_getenforce" "3" "1 January 2004" 
  "[email protected]" "SELinux API documentation"
  .SH "NAME"
-security_getenforce, security_setenforce, 

security_deny_unknown, security_get_checkreqprot\- get or set the enforcing state of SELinux +security_getenforce, security_setenforce,
security_deny_unknown, security_reject_unknown,
+security_get_checkreqprot\- get or set the enforcing state of
SELinux
.
.SH "SYNOPSIS"
.B #include <selinux/selinux.h>

libselinux/man/man3/security_getenforce.3 +0 -0
@@ -11,6 +12,8 @@ security_getenforce, security_setenforce, 

security_deny_unknown, security_get_ch
.sp
.B int security_deny_unknown(void);
.sp
+.B int security_reject_unknown(void);
+.sp
.B int security_get_checkreqprot(void);
.
.SH "DESCRIPTION"

libselinux/man/man3/security_getenforce.3 +1 -0
@@ -27,6 +30,10 @@ returned.
  returns 0 if SELinux treats policy queries on undefined 
  object classes or
  permissions as being allowed, 1 if such queries are denied, 
  and \-1 on error.
  +.BR security_reject_unknown ()
+returns 0 if SELinux allows to load a policy which doesn't 
Quoted 3 lines

define all object
+classes and permissions, 1 if loading such policy is rejected, and \-1 on error.

s/all object classes and permissions/all kernel object classes and permissions/

Quoted 5 lines

A policy can still be loaded if it is missing userspace object classes and permissions regardless of security_reject_unknown(), although the object manager may later encounter a failure upon selinux_set_mapping(), which internally calls security_reject_unknown() to decide how to proceed, or direct attempts to lookup the class or permission via string_to_security_class() or string_to_av_perm().

I'll update the text.

Quoted 3 lines

I don't know of anyone building policies with handle_unknown == reject so it is unlikely that anyone is testing this case. deny is the default. allow is set in Fedora/RHEL. Android uses deny.

We're considering to use handle_unknown = reject for nightly builds to detect whether there's a new kernel class or permission defined in kernel which is not covered by policy.

Quoted 14 lines
Quoted 14 lines
libselinux/man/man3/security_getenforce.3 +1 -0
+
  .BR security_get_checkreqprot ()
  can be used to determine whether SELinux is configured to 
  check the
  protection requested by the application or the actual 
  protection that will
libselinux/man/man3/security_reject_unknown.3 new file +1 -0
new file mode 100644
index 00000000..d59e5c2c
@@ -0,0 +1 @@
+.so man3/security_getenforce.3
#3 lore raw

PATCH v2 1/1 libselinux: Add security_reject_unknown(3) man page

Commit c19395d7 added a new interface security_reject_unknown() which needs to be documented.

---
 libselinux/man/man3/security_getenforce.3     | 15 ++++++++++++++-
 libselinux/man/man3/security_reject_unknown.3 |  1 +
 2 files changed, 15 insertions(+), 1 deletion(-)
 create mode 100644 libselinux/man/man3/security_reject_unknown.3
libselinux/man/man3/security_getenforce.3 +14 -1
index 29cf3de7..7b0a069f 100644
@@ -1,6 +1,7 @@
 .TH "security_getenforce" "3" "1 January 2004" "[email protected]" "SELinux API documentation"
 .SH "NAME"
-security_getenforce, security_setenforce, security_deny_unknown, security_get_checkreqprot\- get or set the enforcing state of SELinux
+security_getenforce, security_setenforce, security_deny_unknown, security_reject_unknown,
+security_get_checkreqprot \- get or set the enforcing state of SELinux
 .
 .SH "SYNOPSIS"
 .B #include <selinux/selinux.h>
@@ -11,6 +12,8 @@ security_getenforce, security_setenforce, security_deny_unknown, security_get_ch
 .sp
 .B int security_deny_unknown(void);
 .sp
+.B int security_reject_unknown(void);
+.sp
 .B int security_get_checkreqprot(void);
 .
 .SH "DESCRIPTION"
@@ -27,6 +30,16 @@ returned.
 returns 0 if SELinux treats policy queries on undefined object classes or
 permissions as being allowed, 1 if such queries are denied, and \-1 on error.
 
+.BR security_reject_unknown ()
+returns 1 if SELinux rejects loading a policy which doesn't define all kernel
+object classes and permissions. In this state SELinux treats policy queries on
+undefined object classes or permissions as being denied.
+
+It returns 0 if SELinux allows to load such policy and policy queries are
+treated according to
+.BR security_deny_unknown(),
+\-1 is returned on error.
+
 .BR security_get_checkreqprot ()
 can be used to determine whether SELinux is configured to check the
 protection requested by the application or the actual protection that will
libselinux/man/man3/security_reject_unknown.3 new file +1 -0
new file mode 100644
index 00000000..d59e5c2c
@@ -0,0 +1 @@
+.so man3/security_getenforce.3
Signature · 1 line
2.20.1
#4 lore raw
Quoted 2 lines · Petr Lautrbach

Commit c19395d7 added a new interface security_reject_unknown() which needs to be documented.

For the kernel, checkpatch.pl requires that one specify at least 12 characters of the sha1 followed by the one line summary log message quoted within parentheses, ala:
commit c19395d72295 ("libselinux: selinux_set_mapping: fix handling of unknown classes/perms")

selinux userspace obviously isn't bound by the kernel checkpatch.pl requirements but this is probably a good practice to follow so that reviewers don't necessarily have to look up the commit hash to have some idea as to what the commit was and so that there is less risk of ambiguity.

Quoted 31 lines
---
  libselinux/man/man3/security_getenforce.3     | 15 ++++++++++++++-
  libselinux/man/man3/security_reject_unknown.3 |  1 +
  2 files changed, 15 insertions(+), 1 deletion(-)

create mode 100644 libselinux/man/man3/security_reject_unknown.3

libselinux/man/man3/security_getenforce.3 +4 -1
index 29cf3de7..7b0a069f 100644
@@ -1,6 +1,7 @@
  .TH "security_getenforce" "3" "1 January 2004" "[email protected]" "SELinux API documentation"
  .SH "NAME"
-security_getenforce, security_setenforce, security_deny_unknown, security_get_checkreqprot\- get or set the enforcing state of SELinux
+security_getenforce, security_setenforce, security_deny_unknown, security_reject_unknown,
+security_get_checkreqprot \- get or set the enforcing state of SELinux
  .
  .SH "SYNOPSIS"
  .B #include <selinux/selinux.h>
@@ -11,6 +12,8 @@ security_getenforce, security_setenforce, security_deny_unknown, security_get_ch
  .sp
  .B int security_deny_unknown(void);
  .sp
+.B int security_reject_unknown(void);
+.sp
  .B int security_get_checkreqprot(void);
  .
  .SH "DESCRIPTION"

libselinux/man/man3/security_getenforce.3 returned. · line 36

Quoted 7 lines
libselinux/man/man3/security_getenforce.3 +4 -0
@@ -27,6 +30,16 @@ returned.
  returns 0 if SELinux treats policy queries on undefined object classes or
  permissions as being allowed, 1 if such queries are denied, and \-1 on error.
 
+.BR security_reject_unknown ()
+returns 1 if SELinux rejects loading a policy which doesn't define all kernel
+object classes and permissions. In this state SELinux treats policy queries on
+undefined object classes or permissions as being denied.

I'm not sure if the last part is quite correct. If handle_unknown=reject and the policy doesn't define all kernel classes/permissions, then the policy load fails, which leaves the system without a policy at all (or with its previously loaded policy if one was already loaded successfully). If the system is enforcing and this is the initial policy load, then init should halt the system due to the failed load. Since no policy was ever loaded, security_reject_unknown() is still going to return 0 in that case, but security_deny_unknown() should be 1.

If handle_unknown=reject and the policy defines all kernel classes/permissions but omits some userspace classes/permissions, then the policy load succeeds and the behavior of the userspace object managers will vary depending on what interfaces they use and how they handle error conditions. If they use selinux_set_mapping() to map all of the classes/permissions up front prior to using security_compute_av() or avc_has_perm(), then selinux_set_mapping() will return an error and the object manager likely treats this as a fatal error during startup (e.g. dbus-daemon appears to exit in this case; XSELinux in contrast appears to just disable itself). If they instead use selinux_check_access(), then it will return an error and the object manager likely treats this like any other permission denial (but errno will differ: EINVAL vs EACCES, so they could distinguish if they wanted). If they directly call string_to_security_class() and string_to_av_perm() prior to calling security_compute_av() or avc_has_perm(), then the string_*() functions will return an error on the undefined class/perm and the object manager likely treats that like any other permission denial.

Quoted 17 lines
libselinux/man/man3/security_getenforce.3 +6 -0
+
+It returns 0 if SELinux allows to load such policy and policy queries are
+treated according to
+.BR security_deny_unknown(),
+\-1 is returned on error.
+
  .BR security_get_checkreqprot ()
  can be used to determine whether SELinux is configured to check the
  protection requested by the application or the actual protection that will
libselinux/man/man3/security_reject_unknown.3 new file +1 -0
new file mode 100644
index 00000000..d59e5c2c
@@ -0,0 +1 @@
+.so man3/security_getenforce.3
#5 lore raw
Quoted 10 lines · Stephen Smalley
Quoted 2 lines · Petr Lautrbach

Commit c19395d7 added a new interface security_reject_unknown() which needs to be documented.

For the kernel, checkpatch.pl requires that one specify at least 12 characters of the sha1 followed by the one line summary log message quoted within parentheses, ala:
commit c19395d72295 ("libselinux: selinux_set_mapping: fix handling of unknown classes/perms")

Quoted 4 lines

selinux userspace obviously isn't bound by the kernel checkpatch.pl requirements but this is probably a good practice to follow so that reviewers don't necessarily have to look up the commit hash to have some idea as to what the commit was and so that there is less risk of ambiguity.

This makes sense. I'll try to do better next time.

Quoted 58 lines
Quoted 44 lines
---
  libselinux/man/man3/security_getenforce.3     | 15 
  ++++++++++++++-
  libselinux/man/man3/security_reject_unknown.3 |  1 +
  2 files changed, 15 insertions(+), 1 deletion(-)

create mode 100644
libselinux/man/man3/security_reject_unknown.3

libselinux/man/man3/security_getenforce.3 +0 -1
index 29cf3de7..7b0a069f 100644
@@ -1,6 +1,7 @@
  .TH "security_getenforce" "3" "1 January 2004" 
  "[email protected]" "SELinux API documentation"
  .SH "NAME"
-security_getenforce, security_setenforce, 

security_deny_unknown, security_get_checkreqprot\- get or set the enforcing state of SELinux +security_getenforce, security_setenforce,
security_deny_unknown, security_reject_unknown,
+security_get_checkreqprot \- get or set the enforcing state of
SELinux
.
.SH "SYNOPSIS"
.B #include <selinux/selinux.h>

libselinux/man/man3/security_getenforce.3 +0 -0
@@ -11,6 +12,8 @@ security_getenforce, security_setenforce, 

security_deny_unknown, security_get_ch
.sp
.B int security_deny_unknown(void);
.sp
+.B int security_reject_unknown(void);
+.sp
.B int security_get_checkreqprot(void);
.
.SH "DESCRIPTION"

libselinux/man/man3/security_getenforce.3 +1 -0
@@ -27,6 +30,16 @@ returned.
  returns 0 if SELinux treats policy queries on undefined 
  object classes or
  permissions as being allowed, 1 if such queries are denied, 
  and \-1 on error.
  +.BR security_reject_unknown ()
+returns 1 if SELinux rejects loading a policy which doesn't 
Quoted 4 lines

define all kernel
+object classes and permissions. In this state SELinux treats policy queries on
+undefined object classes or permissions as being denied.

I'm not sure if the last part is quite correct. If handle_unknown=reject and the policy doesn't define all kernel classes/permissions, then the policy load fails, which leaves the system without a policy at all (or with its previously loaded policy if one was already loaded successfully). If the system is enforcing and this is the initial policy load, then init should halt the system due to the failed load. Since no policy was ever loaded, security_reject_unknown() is still going to return 0 in that case, but security_deny_unknown() should be 1.

Quoted 16 lines

If handle_unknown=reject and the policy defines all kernel classes/permissions but omits some userspace classes/permissions, then the policy load succeeds and the behavior of the userspace object managers will vary depending on what interfaces they use and how they handle error conditions. If they use selinux_set_mapping() to map all of the classes/permissions up front prior to using security_compute_av() or avc_has_perm(), then selinux_set_mapping() will return an error and the object manager likely treats this as a fatal error during startup (e.g. dbus-daemon appears to exit in this case; XSELinux in contrast appears to just disable itself). If they instead use selinux_check_access(), then it will return an error and the object manager likely treats this like any other permission denial (but errno will differ:
EINVAL vs EACCES, so they could distinguish if they wanted). If they directly call string_to_security_class() and string_to_av_perm() prior to calling security_compute_av() or avc_has_perm(), then the string_*() functions will return an error on the undefined class/perm and the object manager likely treats that like any other permission denial.

There's also an inaccuracy that security_reject_unknown() is related only to the current loaded policy. Even when a policy is incomplete it could be still loaded if it's built using handle-unknown=allow:

# checkpolicy -U reject -M -o /etc/selinux/dummy/policy/policy.31 
 policy.conf.complete 
# load_policy # cat /sys/fs/selinux/reject_unknown 1
#checkpolicy -U reject -M -o /etc/selinux/dummy/policy/policy.31 policy.conf
# load_policy SELinux:  Could not load policy file /etc/selinux/dummy/policy/policy.31:  Invalid argument
load_policy:  Can't load policy:  Invalid argument
# checkpolicy -U allow -M -o /etc/selinux/dummy/policy/policy.31 
 policy.conf
# load_policy # cat /sys/fs/selinux/reject_unknown 0
Quoted 20 lines
Quoted 20 lines
libselinux/man/man3/security_getenforce.3 +2 -0
+
+It returns 0 if SELinux allows to load such policy and policy 

queries are

libselinux/man/man3/security_getenforce.3 +4 -0
+treated according to
+.BR security_deny_unknown(),
+\-1 is returned on error.
+
  .BR security_get_checkreqprot ()
  can be used to determine whether SELinux is configured to 
  check the
  protection requested by the application or the actual 
  protection that will
libselinux/man/man3/security_reject_unknown.3 new file +1 -0
new file mode 100644
index 00000000..d59e5c2c
@@ -0,0 +1 @@
+.so man3/security_getenforce.3
#6 lore raw

PATCH v3 1/1 libselinux: Add security_reject_unknown(3) man page

Commit c19395d72295 ("libselinux: selinux_set_mapping: fix handling of unknown classes/perms") added a new interface security_reject_unknown() which needs to be documented.

---
 libselinux/man/man3/security_getenforce.3     | 20 ++++++++++++++++++-
 libselinux/man/man3/security_reject_unknown.3 |  1 +
 2 files changed, 20 insertions(+), 1 deletion(-)
 create mode 100644 libselinux/man/man3/security_reject_unknown.3
libselinux/man/man3/security_getenforce.3 +19 -1
index 29cf3de7..f339b8b0 100644
@@ -1,6 +1,7 @@
 .TH "security_getenforce" "3" "1 January 2004" "[email protected]" "SELinux API documentation"
 .SH "NAME"
-security_getenforce, security_setenforce, security_deny_unknown, security_get_checkreqprot\- get or set the enforcing state of SELinux
+security_getenforce, security_setenforce, security_deny_unknown, security_reject_unknown,
+security_get_checkreqprot \- get or set the enforcing state of SELinux
 .
 .SH "SYNOPSIS"
 .B #include <selinux/selinux.h>
@@ -11,6 +12,8 @@ security_getenforce, security_setenforce, security_deny_unknown, security_get_ch
 .sp
 .B int security_deny_unknown(void);
 .sp
+.B int security_reject_unknown(void);
+.sp
 .B int security_get_checkreqprot(void);
 .
 .SH "DESCRIPTION"
@@ -27,6 +30,21 @@ returned.
 returns 0 if SELinux treats policy queries on undefined object classes or
 permissions as being allowed, 1 if such queries are denied, and \-1 on error.
 
+.BR security_reject_unknown ()
+returns 1 if the current policy was built with handle-unknown=reject and SELinux
+would reject loading it, if it did not define all kernel object classes and
+permissions. In this state, when
+.BR selinux_set_mapping()
+and
+.BR selinux_check_access()
+are used with an undefined userspace class or permission, an error is returned
+and errno is set to EINVAL.
+
+It returns 0 if the current policy was built with handle-unknown=allow or
+handle-unknown=deny. In this state, policy queries are treated according to
+.BR security_deny_unknown().
+\-1 is returned on error.
+
 .BR security_get_checkreqprot ()
 can be used to determine whether SELinux is configured to check the
 protection requested by the application or the actual protection that will
libselinux/man/man3/security_reject_unknown.3 new file +1 -0
new file mode 100644
index 00000000..d59e5c2c
@@ -0,0 +1 @@
+.so man3/security_getenforce.3
Signature · 1 line
2.20.1
Acked-by on v3 1/1
#7 lore raw
Quoted 5 lines · Petr Lautrbach

Commit c19395d72295 ("libselinux: selinux_set_mapping: fix handling of unknown classes/perms") added a new interface security_reject_unknown() which needs to be documented.

Quoted 58 lines
---
  libselinux/man/man3/security_getenforce.3     | 20 ++++++++++++++++++-
  libselinux/man/man3/security_reject_unknown.3 |  1 +
  2 files changed, 20 insertions(+), 1 deletion(-)

create mode 100644 libselinux/man/man3/security_reject_unknown.3

libselinux/man/man3/security_getenforce.3 +19 -1
index 29cf3de7..f339b8b0 100644
@@ -1,6 +1,7 @@
  .TH "security_getenforce" "3" "1 January 2004" "[email protected]" "SELinux API documentation"
  .SH "NAME"
-security_getenforce, security_setenforce, security_deny_unknown, security_get_checkreqprot\- get or set the enforcing state of SELinux
+security_getenforce, security_setenforce, security_deny_unknown, security_reject_unknown,
+security_get_checkreqprot \- get or set the enforcing state of SELinux
  .
  .SH "SYNOPSIS"
  .B #include <selinux/selinux.h>
@@ -11,6 +12,8 @@ security_getenforce, security_setenforce, security_deny_unknown, security_get_ch
  .sp
  .B int security_deny_unknown(void);
  .sp
+.B int security_reject_unknown(void);
+.sp
  .B int security_get_checkreqprot(void);
  .
  .SH "DESCRIPTION"
@@ -27,6 +30,21 @@ returned.
  returns 0 if SELinux treats policy queries on undefined object classes or
  permissions as being allowed, 1 if such queries are denied, and \-1 on error.
 
+.BR security_reject_unknown ()
+returns 1 if the current policy was built with handle-unknown=reject and SELinux
+would reject loading it, if it did not define all kernel object classes and
+permissions. In this state, when
+.BR selinux_set_mapping()
+and
+.BR selinux_check_access()
+are used with an undefined userspace class or permission, an error is returned
+and errno is set to EINVAL.
+
+It returns 0 if the current policy was built with handle-unknown=allow or
+handle-unknown=deny. In this state, policy queries are treated according to
+.BR security_deny_unknown().
+\-1 is returned on error.
+
  .BR security_get_checkreqprot ()
  can be used to determine whether SELinux is configured to check the
  protection requested by the application or the actual protection that will
libselinux/man/man3/security_reject_unknown.3 new file +1 -0
new file mode 100644
index 00000000..d59e5c2c
@@ -0,0 +1 @@
+.so man3/security_getenforce.3
#8 lore raw
Quoted 8 lines · Stephen Smalley
Quoted 5 lines · Petr Lautrbach

Commit c19395d72295 ("libselinux: selinux_set_mapping: fix handling of unknown classes/perms") added a new interface security_reject_unknown() which needs to be documented.

Thanks, applied.

Quoted 67 lines
Quoted 66 lines

---
  libselinux/man/man3/security_getenforce.3     | 20 ++++++++++++++++++- libselinux/man/man3/security_reject_unknown.3 |  1 +

  2 files changed, 20 insertions(+), 1 deletion(-)

  create mode 100644 libselinux/man/man3/security_reject_unknown.3

libselinux/man/man3/security_getenforce.3 +0 -0
index 29cf3de7..f339b8b0 100644
@@ -1,6 +1,7 @@

  .TH "security_getenforce" "3" "1 January 2004" "[email protected]" "SELinux API documentation" .SH "NAME"
-security_getenforce, security_setenforce, security_deny_unknown, security_get_checkreqprot\- get or set the enforcing state of SELinux +security_getenforce, security_setenforce, security_deny_unknown, security_reject_unknown,
+security_get_checkreqprot \- get or set the enforcing state of SELinux
  .
  .SH "SYNOPSIS"
  .B #include <selinux/selinux.h>

libselinux/man/man3/security_getenforce.3 +0 -0
@@ -11,6 +12,8 @@ security_getenforce, security_setenforce, 

security_deny_unknown, security_get_ch
  .sp
  .B int security_deny_unknown(void);
  .sp
+.B int security_reject_unknown(void);
+.sp
  .B int security_get_checkreqprot(void);
  .
  .SH "DESCRIPTION"

libselinux/man/man3/security_getenforce.3 +0 -0
@@ -27,6 +30,21 @@ returned.

  returns 0 if SELinux treats policy queries on undefined object classes or permissions as being allowed, 1 if such queries are denied, and \-1 on error. +.BR security_reject_unknown ()
+returns 1 if the current policy was built with handle-unknown=reject and SELinux
+would reject loading it, if it did not define all kernel object classes and

libselinux/man/man3/security_getenforce.3 +5 -0
+permissions. In this state, when
+.BR selinux_set_mapping()
+and
+.BR selinux_check_access()
+are used with an undefined userspace class or permission, an error is 

returned

libselinux/man/man3/security_getenforce.3 +3 -0
+and errno is set to EINVAL.
+
+It returns 0 if the current policy was built with 

handle-unknown=allow or
+handle-unknown=deny. In this state, policy queries are treated according to
+.BR security_deny_unknown().
+\-1 is returned on error.
+
  .BR security_get_checkreqprot ()
  can be used to determine whether SELinux is configured to check the protection requested by the application or the actual protection that will

libselinux/man/man3/security_reject_unknown.3 new file +1 -0
new file mode 100644
index 00000000..d59e5c2c
@@ -0,0 +1 @@
+.so man3/security_getenforce.3