checkmodule - Man Page

SELinux policy module compiler

Synopsis

checkmodule [-h] [-b] [-c policy_version] [-C] [-E] [-m] [-M] [-N] [-L] [-U handle_unknown] [-V] [-o output_file] [input_file]

Description

This manual page describes the checkmodule command.

checkmodule is a program that checks and compiles a SELinux security policy module into a binary representation.  It can generate either a base policy module (default) or a non-base policy module (-m option); typically, you would build a non-base policy module to add to an existing module store that already has a base module provided by the base policy.  Use semodule_package(8) to combine this module with its optional file contexts to create a policy package, and then use semodule(8) to install the module package into the module store and load the resulting policy.

Options

-b,--binary

Read an existing binary policy module file rather than a source policy module file.  This option is a development/debugging aid.

-C,--cil

Write CIL policy file rather than binary policy file.

-E,--werror

Treat warnings as errors

-h,--help

Print usage.

-m

Generate a non-base policy module.

-M,--mls

Enable the MLS/MCS support when checking and compiling the policy module.

-N,--disable-neverallow

Do not check neverallow rules.

-L,--line-marker-for-allow

Output line markers for allow rules, in addition to neverallow rules. This option increases the size of the output CIL policy file, but the additional line markers helps debugging, especially neverallow failure reports. Can only be used when writing a CIL policy file.

-V,--version

Show policy versions created by this program.

-o,--output filename

Write a binary policy module file to the specified filename. Otherwise, checkmodule will only check the syntax of the module source file and will not generate a binary module at all.

-U,--handle-unknown <action>

Specify how the kernel should handle unknown classes or permissions (deny, allow or reject).

-c policyvers

Specify the policy version, defaults to the latest.

Example

# Build a MLS/MCS-enabled non-base policy module.
$ checkmodule -M -m httpd.te -o httpd.mod

See Also

semodule(8), semodule_package(8) SELinux Reference Policy documentation at https://github.com/SELinuxProject/refpolicy/wiki

Author

This manual page was copied from the checkpolicy man page  written by Árpád Magosányi <mag@bunuel.tii.matav.hu>, and edited by Dan Walsh <dwalsh@redhat.com>.

Referenced By

semodule(8), semodule_expand(8), semodule_link(8), semodule_package(8).