Crate selinux_sys[−][src]
Expand description
selinux-sys: Unsafe Rust bindings for libselinux
SELinux is a flexible Mandatory Access Control (MAC) for Linux.
This crate exposes neither deprecated nor undocumented SELinux API functions and types.
This crate is Linux-specific. Building it for non-Linux platforms, or for the Linux kernel, results in an empty crate.
Supported environment variables
This crate depends on some environment variables, and variants of those.
For each environment variable (e.g., CC), the following are the accepted
variants of it:
<var>_<target>, e.g.,CC_aarch64-unknown-linux-gnu.<var>_<target-with-underscores>, e.g.,CC_aarch64_unknown_linux_gnu.TARGET_<var>, e.g.,TARGET_CC.<var>, e.g.,CC.
The following environment variables (and their variants) affect how this crate is built:
SELINUX_STATICSELINUX_PATHSELINUX_INCLUDE_DIRSELINUX_LIB_DIRCCCFLAGS
Dynamic or static linking
This crate links to libselinux dynamically if possible, except when targeting
platforms based on the musl C library.
This behavior can be changed either by setting the environment variable
SELINUX_STATIC to 1, or by enabling the crate feature static.
If both are defined, then the value of SELINUX_STATIC takes precedence.
Setting SELINUX_STATIC to 0 mandates dynamic linking.
Finding SELinux library and headers
By default, this crate finds SELinux headers and library based on the default target C compiler.
This behavior can be changed by:
- Either defining the environment variable
SELINUX_PATHto the path of a directory containing the sub-directoriesincludeandlibwhere the headers and library are installed. - Or by defining one or both of the environment variables
SELINUX_INCLUDE_DIRandSELINUX_LIB_DIRto paths to the directories where headers and library are present. IfSELINUX_PATHis also defined, thenSELINUX_INCLUDE_DIRandSELINUX_LIB_DIRtake precedence.
Depending on this crate
This crate provides the following variables to other crates that depend on it:
DEP_SELINUX_INCLUDE: Path of the directory where library C header files reside.DEP_SELINUX_LIB: Path of the directory where the library binary resides.
Versioning
This project adheres to Semantic Versioning.
The CHANGELOG.md file details notable changes over time.
Modules
Structs
Constants
Unspecified SID.
Functions
Initialize an avc_entry_ref structure.