"selinux_file_context_verify" "3" "08 March 2011" "SELinux API documentation"
"NAME"
selinux_file_context_verify - Compare the SELinux security context on disk to the default security context required by the policy file contexts file
.
"SYNOPSIS"
#include <selinux/selinux.h> "int selinux_file_context_verify(const char *" path ", mode_t " mode ");" .
"DESCRIPTION"
selinux_file_context_verify () compares the context of the specified
path that is held on disk (in the extended attribute), to the system default entry held in the file contexts series of files.
The
mode may be zero.
Note that the two contexts are compared for "significant" differences (i.e. the user component of the contexts are ignored) as shown in the
EXAMPLE section.
.
"RETURN VALUE"
If the contexts significantly match, 1 (one) is returned.
If the contexts do not match 0 (zero) is returned and
errno is set to either
ENOENT or
EINVAL for the reasons listed in the
ERRORS section, or if
errno = 0 then the contexts did not match.
On failure -1 is returned and
errno set appropriately.
.
"ERRORS"
ENOTSUP if extended attributes are not supported by the file system.
ENOENT if there is no entry in the file contexts series of files or path does not exist.
EINVAL if the entry in the file contexts series of files or path are invalid, or the returned context fails validation.
ENOMEM if attempt to allocate memory failed. .
"FILES"
The following configuration files (the file contexts series of files) supporting the active policy will be used (should they exist) to determine the
path default context:
contexts/files/file_contexts - This file must exist.
contexts/files/file_contexts.local - If exists has local customizations.
contexts/files/file_contexts.homedirs - If exists has users home directory customizations.
contexts/files/file_contexts.subs - If exists has substitutions that are then applied to the 'in memory' version of the file contexts files.
.
"EXAMPLE"
If the files context is:
unconfined_u:object_r:admin_home_t:s0
and the default context defined in the file contexts file is:
system_u:object_r:admin_home_t:s0
then the actual strings compared are:
:object_r:admin_home_t:s0 and :object_r:admin_home_t:s0
Therefore they will match and
selinux_file_context_verify () will return 1.
.
"SEE ALSO"
selinux "(8)"
