Manual Reference Pages  - CHECKMODULE (8)

NAME

checkmodule - SELinux policy module compiler

CONTENTS

Synopsis
Options
Example
Author

SYNOPSIS

checkmodule [-b] [-d] [-h] [-m] [-M] [-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 to combine this module with its optional file contexts to create a policy package, and then use semodule to install the module package into the module store and load the resulting policy.

OPTIONS

-b Read an existing binary policy module file rather than a source policy module file. This option is a development/debugging aid.
-d Enter debug mode after loading the policy. This option is a development/debugging aid.
-h Print the usage message.
-m Generate a non-base policy module.
-M Enable the MLS/MCS support when checking and compiling the policy module.

-o 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 OPTION
  Tells the kernel how to handle unknown classes and permissions, where OPTION is one of the following:

deny Deny unknown kernel checks

reject Reject loading of policy with unknowns

allow Allow unknown kernel checks

-V Show policy versions created by this program

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 documentation at http://www.nsa.gov/selinux, especially "Configuring the SELinux Policy".

AUTHOR

This manual page was copied from the checkpolicy man page written by Arpad Magosanyi <mag@bunuel.tii.matav.hu>, and edited by Dan Walsh <dwalsh@redhat.com>. The program was written by Stephen Smalley <sds@epoch.ncsc.mil>.


CHECKMODULE (8)
blog comments powered by Disqus