~ubuntu-branches/ubuntu/hardy/checkpolicy/hardy

« back to all changes in this revision

Viewing changes to checkmodule.8

  • Committer: Bazaar Package Importer
  • Author(s): Manoj Srivastava
  • Date: 2005-12-29 23:57:12 UTC
  • mfrom: (1.1.4 upstream)
  • Revision ID: james.westby@ubuntu.com-20051229235712-chhn3y0v2av6cf22
Tags: 1.28-1
* New upstream release
  * Updated version for release.
  * Merged checkmodule man page from Dan Walsh, and edited it.
  * Added error checking of all ebitmap_set_bit calls for out of
    memory conditions.
  * Merged removal of compatibility handling of netlink classes
    (requirement that policies with newer versions include the
     netlink class definitions, remapping of fine-grained netlink
     classes in newer source policies to single netlink class when
     generating older policies) from George Coker.
  * Merged dismod fix from Joshua Brindle.
  * Removed obsolete cond_check_type_rules() function and call and 
    cond_optimize_lists() call from checkpolicy.c; these are handled
    during parsing and expansion now.
  * Updated calls to expand_module for interface change.
  * Changed checkmodule to verify that expand_module succeeds 
    when building base modules.
  * Merged module compiler fixes from Joshua Brindle.
  * Removed direct calls to hierarchy_check_constraints() and 
    check_assertions() from checkpolicy since they are now called 
    internally by expand_module().
  * Updated for changes to sepol policydb_index_others interface.
  * Updated for changes to sepol expand_module and link_modules interfaces.
  * Merged support for require blocks inside conditionals from
    Joshua Brindle (Tresys).
  * Updated for changes to libsepol.
  * Merged several bug fixes from Joshua Brindle (Tresys).
  * Merged MLS in modules patch from Joshua Brindle (Tresys).
  * Merged error handling improvement in checkmodule from Karl MacMillan (Tresys).
  * Merged bugfix for dup role transition error messages from
    Karl MacMillan (Tresys).
  * Merged policyver/modulever patches from Joshua Brindle (Tresys).
  * Fixed parse_categories handling of undefined category.
  * Merged bug fix for role dominance handling from Darrel Goeddel (TCS). 

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH CHECKMODULE 8
 
2
.SH NAME
 
3
checkmodule \- SELinux policy module compiler
 
4
.SH SYNOPSIS
 
5
.B checkmodule
 
6
.I "[-b] [-d] [-m] [-M] [-o output_file] [input_file]"
 
7
.SH "DESCRIPTION"
 
8
This manual page describes the
 
9
.BR checkmodule
 
10
command.
 
11
.PP
 
12
.B checkmodule
 
13
is a program that checks and compiles a SELinux security policy module
 
14
into a binary representation.  It can generate either a base policy
 
15
module (default) or a non-base policy module (-m option); typically,
 
16
you would build a non-base policy module to add to an existing module
 
17
store that already has a base module provided by the base policy.  Use
 
18
semodule_package to combine this module with its optional file
 
19
contexts to create a policy package, and then use semodule to install
 
20
the module package into the module store and load the resulting policy.
 
21
 
 
22
.SH OPTIONS
 
23
.TP
 
24
.B \-b
 
25
Read an existing binary policy module file rather than a source policy
 
26
module file.  This option is a development/debugging aid.
 
27
.TP
 
28
.B \-d
 
29
Enter debug mode after loading the policy.  This option is a 
 
30
development/debugging aid.
 
31
.TP
 
32
.B \-m
 
33
Generate a non-base policy module.
 
34
.TP
 
35
.B \-M
 
36
Enable the MLS/MCS support when checking and compiling the policy module.
 
37
.TP
 
38
.B \-o filename
 
39
Write a binary policy module file to the specified filename.
 
40
Otherwise, checkmodule will only check the syntax of the module source file
 
41
and will not generate a binary module at all.
 
42
 
 
43
.SH EXAMPLE
 
44
.nf
 
45
# Build a MLS/MCS-enabled non-base policy module.
 
46
$ checkmodule -M -m httpd.te -o httpd.mod
 
47
.fi
 
48
 
 
49
.SH "SEE ALSO"
 
50
.B semodule(8), semodule_package(8)
 
51
SELinux documentation at http://www.nsa.gov/selinux/docs.html,
 
52
especially "Configuring the SELinux Policy".
 
53
 
 
54
 
 
55
.SH AUTHOR
 
56
This manual page was copied from the checkpolicy man page 
 
57
written by Arpad Magosanyi <mag@bunuel.tii.matav.hu>, 
 
58
and edited by Dan Walsh <dwalsh@redhat.com>.
 
59
The program was written by Stephen Smalley <sds@epoch.ncsc.mil>.