RepoMirrors
/
selinux
mirror of https://github.com/SELinuxProject/selinux
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
selinux/checkpolicy/checkpolicy.8

69 lines
2.1 KiB
Groff
Raw Normal View History

initial import from svn trunk revision 2950
2008-08-19 19:30:36 +00:00
.TH CHECKPOLICY 8
.SH NAME
checkpolicy \- SELinux policy compiler
.SH SYNOPSIS
.B checkpolicy
checkpolicy: Update manpage - Add description of -S option - Sort the option descriptions based on the synopsis - Add missing options to synopsis Signed-off-by: Vit Mojzis <vmojzis@redhat.com>
2019-02-07 10:25:45 +00:00
.I "[\-b[F]] [\-C] [\-d] [\-U handle_unknown (allow,deny,reject)] [\-M] [\-c policyvers] [\-o output_file] [\-S] [\-t target_platform (selinux,xen)] [\-V] [input_file]"
initial import from svn trunk revision 2950
2008-08-19 19:30:36 +00:00
.br
.SH "DESCRIPTION"
This manual page describes the
.BR checkpolicy
command.
.PP
.B checkpolicy
is a program that checks and compiles a SELinux security policy configuration
into a binary representation that can be loaded into the kernel. If no
input file name is specified, checkpolicy will attempt to read from
checkpolicy: Fix cases where hyphen were used as minus sign in manpages
2013-05-10 12:45:18 +00:00
policy.conf or policy, depending on whether the \-b flag is specified.
initial import from svn trunk revision 2950
2008-08-19 19:30:36 +00:00
.SH OPTIONS
.TP
Patch for Ticket #1 [1672486] (checkpolicy/checkmodule) This patch is proposed to solve Ticket #1 [1672486] (command line binaries should support --version and --help). It adds handling of -h, -V and the long formats --help and --version to all binaries (checkpolicy/checkmodule). It also adds handling of long options for some of the available options. Manual pages have also been updated accordingly (and a few undocumented options have been documented). Guido Trentalancia Signed-off-by: Joshua Brindle <method@manicmethod.com>
2009-11-02 17:14:28 +00:00
.B \-b,\-\-binary
initial import from svn trunk revision 2950
2008-08-19 19:30:36 +00:00
Read an existing binary policy file rather than a source policy.conf file.
.TP
checkpolicy: Update manpage - Add description of -S option - Sort the option descriptions based on the synopsis - Add missing options to synopsis Signed-off-by: Vit Mojzis <vmojzis@redhat.com>
2019-02-07 10:25:45 +00:00
.B \-F,\-\-conf
Write policy.conf file rather than binary policy file. Can only be used with binary policy file.
.TP
checkpolicy: Add support for generating CIL Add support to checkpolicy and checkmodule for generating CIL as their output. Add new options "-C" and "--cil" to specify CIL as the output format. Signed-off-by: James Carter <jwcart2@tycho.nsa.gov>
2015-04-01 14:05:04 +00:00
.B \-C,\-\-cil
Write CIL policy file rather than binary policy file.
.TP
Patch for Ticket #1 [1672486] (checkpolicy/checkmodule) This patch is proposed to solve Ticket #1 [1672486] (command line binaries should support --version and --help). It adds handling of -h, -V and the long formats --help and --version to all binaries (checkpolicy/checkmodule). It also adds handling of long options for some of the available options. Manual pages have also been updated accordingly (and a few undocumented options have been documented). Guido Trentalancia Signed-off-by: Joshua Brindle <method@manicmethod.com>
2009-11-02 17:14:28 +00:00
.B \-d,\-\-debug
initial import from svn trunk revision 2950
2008-08-19 19:30:36 +00:00
Enter debug mode after loading the policy.
.TP
checkpolicy: Update manpage - Add description of -S option - Sort the option descriptions based on the synopsis - Add missing options to synopsis Signed-off-by: Vit Mojzis <vmojzis@redhat.com>
2019-02-07 10:25:45 +00:00
.B \-U,\-\-handle-unknown <action>
Specify how the kernel should handle unknown classes or permissions (deny, allow or reject).
checkpolicy: Add options to convert binary policy to CIL or a policy.conf Use the same option "-C" used to ouput CIL from a policy.conf, but now generate CIL from a binary policy instead of giving an error.i Use the option "-F" to generate a policy.conf file from a binary policy. Signed-off-by: James Carter <jwcart2@tycho.nsa.gov>
2017-03-21 20:00:30 +00:00
.TP
Patch for Ticket #1 [1672486] (checkpolicy/checkmodule) This patch is proposed to solve Ticket #1 [1672486] (command line binaries should support --version and --help). It adds handling of -h, -V and the long formats --help and --version to all binaries (checkpolicy/checkmodule). It also adds handling of long options for some of the available options. Manual pages have also been updated accordingly (and a few undocumented options have been documented). Guido Trentalancia Signed-off-by: Joshua Brindle <method@manicmethod.com>
2009-11-02 17:14:28 +00:00
.B \-M,\-\-mls
initial import from svn trunk revision 2950
2008-08-19 19:30:36 +00:00
Enable the MLS policy when checking and compiling the policy.
.TP
checkpolicy: Update manpage - Add description of -S option - Sort the option descriptions based on the synopsis - Add missing options to synopsis Signed-off-by: Vit Mojzis <vmojzis@redhat.com>
2019-02-07 10:25:45 +00:00
.B \-c policyvers
Specify the policy version, defaults to the latest.
.TP
Patch for Ticket #1 [1672486] (checkpolicy/checkmodule) This patch is proposed to solve Ticket #1 [1672486] (command line binaries should support --version and --help). It adds handling of -h, -V and the long formats --help and --version to all binaries (checkpolicy/checkmodule). It also adds handling of long options for some of the available options. Manual pages have also been updated accordingly (and a few undocumented options have been documented). Guido Trentalancia Signed-off-by: Joshua Brindle <method@manicmethod.com>
2009-11-02 17:14:28 +00:00
.B \-o,\-\-output filename
initial import from svn trunk revision 2950
2008-08-19 19:30:36 +00:00
Write a binary policy file to the specified filename.
.TP
checkpolicy: Update manpage - Add description of -S option - Sort the option descriptions based on the synopsis - Add missing options to synopsis Signed-off-by: Vit Mojzis <vmojzis@redhat.com>
2019-02-07 10:25:45 +00:00
.B \-S,\-\-sort
Sort ocontexts before writing out the binary policy. This option makes output of checkpolicy consistent with binary policies created by semanage and secilc.
Patch for Ticket #1 [1672486] (checkpolicy/checkmodule) This patch is proposed to solve Ticket #1 [1672486] (command line binaries should support --version and --help). It adds handling of -h, -V and the long formats --help and --version to all binaries (checkpolicy/checkmodule). It also adds handling of long options for some of the available options. Manual pages have also been updated accordingly (and a few undocumented options have been documented). Guido Trentalancia Signed-off-by: Joshua Brindle <method@manicmethod.com>
2009-11-02 17:14:28 +00:00
.TP
.B \-t,\-\-target
Specify the target platform (selinux or xen).
.TP
checkpolicy: add flag to enable policy optimization Add the command-line option 'O' to checkpolicy to cause kernel policies to be optimized by calling policydb_optimize() before being written out. This option can be used on conf files and binary kernel policies, but not when converting a conf file to CIL. Signed-off-by: James Carter <jwcart2@tycho.nsa.gov> [omosnace: make commit desc more consistent with the other patches] [omosnace: fix a typo in the commit message] [omosnace: directly use policydb_optimize() as also the rest of code already uses other policydb_*() functions...] [omosnace: update man page] Signed-off-by: Ondrej Mosnacek <omosnace@redhat.com>
2019-06-13 11:45:58 +00:00
.B \-O,\-\-optimize
Optimize the final kernel policy (remove redundant rules).
.TP
Patch for Ticket #1 [1672486] (checkpolicy/checkmodule) This patch is proposed to solve Ticket #1 [1672486] (command line binaries should support --version and --help). It adds handling of -h, -V and the long formats --help and --version to all binaries (checkpolicy/checkmodule). It also adds handling of long options for some of the available options. Manual pages have also been updated accordingly (and a few undocumented options have been documented). Guido Trentalancia Signed-off-by: Joshua Brindle <method@manicmethod.com>
2009-11-02 17:14:28 +00:00
.B \-V,\-\-version
Show version information.
.TP
.B \-h,\-\-help
Show usage information.
initial import from svn trunk revision 2950
2008-08-19 19:30:36 +00:00
.SH "SEE ALSO"
checkpolicy: libselinux: Fix dead links to www.nsa.gov/selinux Signed-off-by: Eric Paris <eparis@redhat.com> Acked-by: Dan Walsh <dwalsh@redhat.com>
2012-01-16 17:09:43 +00:00
SELinux documentation at http://www.nsa.gov/research/selinux,
initial import from svn trunk revision 2950
2008-08-19 19:30:36 +00:00
especially "Configuring the SELinux Policy".
.SH AUTHOR
This manual page was written by Arpad Magosanyi <mag@bunuel.tii.matav.hu>,
checkpolicy,libselinux,libsepol,policycoreutils: Update my email address Update my email address since epoch.ncsc.mil no longer exists. Signed-off-by: Stephen Smalley <sds@tycho.nsa.gov>
2017-08-17 18:16:06 +00:00
and edited by Stephen Smalley <sds@tycho.nsa.gov>.
The program was written by Stephen Smalley <sds@tycho.nsa.gov>.