|
Chris PeBenito |
fedd3c |
1) Reference Policy make targets:
|
|
Chris PeBenito |
fedd3c |
|
|
Chris PeBenito |
fedd3c |
General Make targets:
|
|
Chris PeBenito |
fedd3c |
|
|
Chris PeBenito |
fedd3c |
install-src Install the policy sources into
|
|
Chris PeBenito |
fedd3c |
/etc/selinux/NAME/src/policy, where NAME is defined in
|
|
Chris PeBenito |
fedd3c |
the Makefile. If not defined, the TYPE, as defined in
|
|
Chris PeBenito |
fedd3c |
the Makefile, is used. The default NAME is refpolicy.
|
|
Chris PeBenito |
fedd3c |
A pre-existing source policy will be moved to
|
|
Chris PeBenito |
fedd3c |
/etc/selinux/NAME/src/policy.bak.
|
|
Chris PeBenito |
fedd3c |
|
|
Chris PeBenito |
fedd3c |
conf Regenerate policy.xml, and update/create modules.conf
|
|
Chris PeBenito |
fedd3c |
and booleans.conf. This should be done after adding
|
|
Chris PeBenito |
fedd3c |
or removing modules, or after running the bare target.
|
|
Chris PeBenito |
fedd3c |
If the configuration files exist, their settings will
|
|
Chris PeBenito |
fedd3c |
be preserved. This must be ran on policy sources that
|
|
Chris PeBenito |
fedd3c |
are checked out from the CVS repository before they can
|
|
Chris PeBenito |
fedd3c |
be used.
|
|
Chris PeBenito |
fedd3c |
|
|
Chris PeBenito |
fedd3c |
clean Delete all temporary files, compiled policies,
|
|
Chris PeBenito |
fedd3c |
and file_contexts. Configuration files are left intact.
|
|
Chris PeBenito |
fedd3c |
|
|
Chris PeBenito |
fedd3c |
bare Do the clean make target and also delete configuration
|
|
Chris PeBenito |
fedd3c |
files, web page documentation, and policy.xml.
|
|
Chris PeBenito |
fedd3c |
|
|
Chris PeBenito |
fedd3c |
html Regenerate policy.xml and create web page documentation
|
|
Chris PeBenito |
fedd3c |
in the doc/html directory.
|
|
Chris PeBenito |
fedd3c |
|
|
Chris PeBenito |
fedd3c |
Make targets specific to modular (loadable modules) policies:
|
|
Chris PeBenito |
fedd3c |
|
|
Chris PeBenito |
fedd3c |
base Compile and package the base module. This is the
|
|
Chris PeBenito |
fedd3c |
default target for modular policies.
|
|
Chris PeBenito |
fedd3c |
|
|
Chris PeBenito |
fedd3c |
modules Compile and package all Reference Policy modules
|
|
Chris PeBenito |
fedd3c |
configured to be built as loadable modules.
|
|
Chris PeBenito |
fedd3c |
|
|
Chris PeBenito |
fedd3c |
MODULENAME.pp Compile and package the MODULENAME Reference Policy
|
|
Chris PeBenito |
fedd3c |
module.
|
|
Chris PeBenito |
fedd3c |
|
|
Chris PeBenito |
c767b1 |
all Compile and package the base module and all Reference
|
|
Chris PeBenito |
c767b1 |
Policy modules configured to be built as loadable
|
|
Chris PeBenito |
c767b1 |
modules.
|
|
Chris PeBenito |
c767b1 |
|
|
Chris PeBenito |
c767b1 |
install Compile, package, and install the base module and
|
|
Chris PeBenito |
c767b1 |
Reference Policy modules configured to be built as
|
|
Chris PeBenito |
c767b1 |
loadable modules.
|
|
Chris PeBenito |
c767b1 |
|
|
Chris PeBenito |
c767b1 |
load Compile, package, and install the base module and
|
|
Chris PeBenito |
c767b1 |
Reference Policy modules configured to be built as
|
|
Chris PeBenito |
c767b1 |
loadable modules, then insert them into the module
|
|
Chris PeBenito |
c767b1 |
store.
|
|
Chris PeBenito |
c767b1 |
|
|
Chris PeBenito |
ea5333 |
validate Validate if the configured modules can successfully
|
|
Chris PeBenito |
ea5333 |
link and expand.
|
|
Chris PeBenito |
ea5333 |
|
|
Chris PeBenito |
fedd3c |
Make targets specific to monolithic policies:
|
|
Chris PeBenito |
fedd3c |
|
|
Chris PeBenito |
fedd3c |
policy Compile a policy locally for development and testing.
|
|
Chris PeBenito |
fedd3c |
This is the default target for monolithic policies.
|
|
Chris PeBenito |
fedd3c |
|
|
Chris PeBenito |
fedd3c |
install Compile and install the policy and file contexts.
|
|
Chris PeBenito |
fedd3c |
|
|
Chris PeBenito |
fedd3c |
load Compile and install the policy and file contexts, then
|
|
Chris PeBenito |
fedd3c |
load the policy.
|
|
Chris PeBenito |
fedd3c |
|
|
Chris PeBenito |
fedd3c |
enableaudit Remove all dontaudit rules from policy.conf.
|
|
Chris PeBenito |
fedd3c |
|
|
Chris PeBenito |
fedd3c |
relabel Relabel the filesystem.
|
|
Chris PeBenito |
fedd3c |
|
|
Chris PeBenito |
fedd3c |
checklabels Check the labels on the filesystem, and report when
|
|
Chris PeBenito |
fedd3c |
a file would be relabeled, but do not change its label.
|
|
Chris PeBenito |
fedd3c |
|
|
Chris PeBenito |
fedd3c |
restorelabels Relabel the filesystem and report each file that is
|
|
Chris PeBenito |
fedd3c |
relabeled.
|
|
Chris PeBenito |
97749e |
|
|
Chris PeBenito |
75c1c2 |
|
|
Chris PeBenito |
75c1c2 |
2) Reference Policy Build Options (build.conf)
|
|
Chris PeBenito |
75c1c2 |
|
|
Chris PeBenito |
75c1c2 |
TYPE String. Available options are strict, targeted,
|
|
Chris PeBenito |
75c1c2 |
strict-mls, targeted-mls, strict-mcs, and targeted-mcs.
|
|
Chris PeBenito |
75c1c2 |
This sets the policy type as strict or targeted, and
|
|
Chris PeBenito |
75c1c2 |
optionally enables multi-leve security (MLS) or
|
|
Chris PeBenito |
75c1c2 |
multi-category security (MCS) features. This option
|
|
Chris PeBenito |
75c1c2 |
controls strict_policy, targeted_policy, enable_mls,
|
|
Chris PeBenito |
75c1c2 |
and enable_mcs policy blocks.
|
|
Chris PeBenito |
75c1c2 |
|
|
Chris PeBenito |
75c1c2 |
NAME String (optional). Sets the name of the policy; the
|
|
Chris PeBenito |
75c1c2 |
NAME is used when installing files to e.g.,
|
|
Chris PeBenito |
75c1c2 |
/etc/selinux/NAME and /usr/share/selinux/NAME. If not
|
|
Chris PeBenito |
75c1c2 |
set, the policy type (TYPE) is used.
|
|
Chris PeBenito |
75c1c2 |
|
|
Chris PeBenito |
75c1c2 |
DISTRO String (optional). Enable distribution-specific policy.
|
|
Chris PeBenito |
75c1c2 |
Available options are redhat, rhel4, gentoo, debian,
|
|
Chris PeBenito |
75c1c2 |
and suse. This option controls distro_redhat,
|
|
Chris PeBenito |
75c1c2 |
distro_rhel4, distro_gentoo, distro_debian, and
|
|
Chris PeBenito |
75c1c2 |
distro_suse policy blocks.
|
|
Chris PeBenito |
75c1c2 |
|
|
Chris PeBenito |
75c1c2 |
MONOLITHIC Boolean. If set, a monolithic policy is built,
|
|
Chris PeBenito |
75c1c2 |
otherwise a modular policy is built.
|
|
Chris PeBenito |
75c1c2 |
|
|
Chris PeBenito |
75c1c2 |
DIRECT_INITRC Boolean. If set, sysadm will be allowed to directly
|
|
Chris PeBenito |
75c1c2 |
run init scripts, instead of requiring the run_init
|
|
Chris PeBenito |
75c1c2 |
tool. This is a build option instead of a tunable since
|
|
Chris PeBenito |
75c1c2 |
role transitions do not work in conditional policy.
|
|
Chris PeBenito |
75c1c2 |
This option controls direct_sysadm_daemon policy
|
|
Chris PeBenito |
75c1c2 |
blocks.
|
|
Chris PeBenito |
75c1c2 |
|
|
Chris PeBenito |
75c1c2 |
POLY Boolean. If set, policy for polyinstantiated
|
|
Chris PeBenito |
75c1c2 |
directories will be enabled. This option controls
|
|
Chris PeBenito |
75c1c2 |
enable_polyinstantiation policy blocks.
|
|
Chris PeBenito |
75c1c2 |
|
|
Chris PeBenito |
75c1c2 |
OUTPUT_POLICY Integer. Set the version of the policy created when
|
|
Chris PeBenito |
75c1c2 |
building a monolithic policy. This option has no effect
|
|
Chris PeBenito |
75c1c2 |
on modular policy.
|
|
Chris PeBenito |
75c1c2 |
|
|
Chris PeBenito |
75c1c2 |
QUIET Boolean. If set, the build system will only display
|
|
Chris PeBenito |
75c1c2 |
status messages and error messages. This option has no
|
|
Chris PeBenito |
75c1c2 |
effect on policy.
|
|
Chris PeBenito |
75c1c2 |
|
|
Chris PeBenito |
75c1c2 |
|
|
Chris PeBenito |
75c1c2 |
3) Reference Policy Files and Directories
|
|
Chris PeBenito |
97749e |
All directories relative to the root of the Reference Policy sources directory.
|
|
Chris PeBenito |
97749e |
|
|
Chris PeBenito |
8e0ef1 |
Makefile General rules for building the policy.
|
|
Chris PeBenito |
8e0ef1 |
|
|
Chris PeBenito |
35bb02 |
Rules.modular Makefile rules specific to building loadable module
|
|
Chris PeBenito |
35bb02 |
policies.
|
|
Chris PeBenito |
8e0ef1 |
|
|
Chris PeBenito |
35bb02 |
Rules.monolithic Makefile rules specific to building monolithic policies.
|
|
Chris PeBenito |
8e0ef1 |
|
|
Chris PeBenito |
8e0ef1 |
build.conf Options which influence the building of the policy,
|
|
Chris PeBenito |
8e0ef1 |
such as the policy type (strict, targeted, etc.)
|
|
Chris PeBenito |
8e0ef1 |
and distribution.
|
|
Chris PeBenito |
8e0ef1 |
|
|
Chris PeBenito |
97749e |
config/appconfig-* Application configuration files for all configurations
|
|
Chris PeBenito |
97749e |
of the Reference Policy (targeted/strict with or without
|
|
Chris PeBenito |
97749e |
MLS or MCS). These are used by SELinux-aware programs.
|
|
Chris PeBenito |
97749e |
|
|
Chris PeBenito |
97749e |
config/local.users The file read by load policy for adding SELinux users
|
|
Chris PeBenito |
97749e |
to the policy on the fly.
|
|
Chris PeBenito |
97749e |
|
|
Chris PeBenito |
97749e |
doc/html/* This contains the contents of the in-policy XML
|
|
Chris PeBenito |
97749e |
documentation, presented in web page form.
|
|
Chris PeBenito |
97749e |
|
|
Chris PeBenito |
97749e |
doc/policy.dtd The doc/policy.xml file is validated against this DTD.
|
|
Chris PeBenito |
97749e |
|
|
Chris PeBenito |
97749e |
doc/policy.xml This file is generated/updated by the conf and html make
|
|
Chris PeBenito |
97749e |
targets. It contains the complete XML documentation
|
|
Chris PeBenito |
97749e |
included in the policy.
|
|
Chris PeBenito |
97749e |
|
|
Chris PeBenito |
97749e |
doc/templates/* Templates used for documentation web pages.
|
|
Chris PeBenito |
97749e |
|
|
Chris PeBenito |
97749e |
policy/booleans.conf This file is generated/updated by the conf make target.
|
|
Chris PeBenito |
97749e |
It contains the booleans in the policy, and their
|
|
Chris PeBenito |
97749e |
default values. If tunables are implemented as
|
|
Chris PeBenito |
97749e |
booleans, tunables will also be included. This file
|
|
Chris PeBenito |
97749e |
will be installed as the /etc/selinux/NAME/booleans
|
|
Chris PeBenito |
97749e |
file.
|
|
Chris PeBenito |
97749e |
|
|
Chris PeBenito |
97749e |
policy/constraints This file defines additional constraints on permissions
|
|
Chris PeBenito |
97749e |
in the form of boolean expressions that must be
|
|
Chris PeBenito |
97749e |
satisfied in order for specified permissions to be
|
|
Chris PeBenito |
97749e |
granted. These constraints are used to further refine
|
|
Chris PeBenito |
97749e |
the type enforcement rules and the role allow rules.
|
|
Chris PeBenito |
97749e |
Typically, these constraints are used to restrict
|
|
Chris PeBenito |
97749e |
changes in user identity or role to certain domains.
|
|
Chris PeBenito |
97749e |
|
|
Chris PeBenito |
97749e |
policy/global_booleans This file defines all booleans that have a global scope,
|
|
Chris PeBenito |
97749e |
their default value, and documentation.
|
|
Chris PeBenito |
97749e |
|
|
Chris PeBenito |
97749e |
policy/global_tunables This file defines all tunables that have a global scope,
|
|
Chris PeBenito |
97749e |
their default value, and documentation.
|
|
Chris PeBenito |
97749e |
|
|
Chris PeBenito |
97749e |
policy/flask/initial_sids This file has declarations for each initial SID.
|
|
Chris PeBenito |
97749e |
|
|
Chris PeBenito |
97749e |
policy/flask/security_classes This file has declarations for each security class.
|
|
Chris PeBenito |
97749e |
|
|
Chris PeBenito |
97749e |
policy/flask/access_vectors This file defines the access vectors. Common
|
|
Chris PeBenito |
97749e |
prefixes for access vectors may be defined at the
|
|
Chris PeBenito |
97749e |
beginning of the file. After the common prefixes are
|
|
Chris PeBenito |
97749e |
defined, an access vector may be defined for each
|
|
Chris PeBenito |
97749e |
security class.
|
|
Chris PeBenito |
97749e |
|
|
Chris PeBenito |
35bb02 |
policy/mcs The multi-category security (MCS) configuration.
|
|
Chris PeBenito |
35bb02 |
|
|
Chris PeBenito |
35bb02 |
policy/mls The multi-level security (MLS) configuration.
|
|
Chris PeBenito |
35bb02 |
|
|
Chris PeBenito |
97749e |
policy/modules/* Each directory represents a layer in Reference Policy
|
|
Chris PeBenito |
97749e |
all of the modules are contained in one of these layers.
|
|
Chris PeBenito |
97749e |
|
|
Chris PeBenito |
97749e |
policy/modules.conf This file contains a listing of available modules, and
|
|
Chris PeBenito |
97749e |
how they will be used when building Reference Policy. To
|
|
Chris PeBenito |
97749e |
prevent a module from being used, set the module to
|
|
Chris PeBenito |
97749e |
"off". For monolithic policies, modules set to "base"
|
|
Chris PeBenito |
97749e |
and "module" will be included in the policy. For
|
|
Chris PeBenito |
97749e |
modular policies, modules set to "base" will be included
|
|
Chris PeBenito |
97749e |
in the base module; those set to "module" will be
|
|
Chris PeBenito |
97749e |
compiled as individual loadable modules.
|
|
Chris PeBenito |
97749e |
|
|
Chris PeBenito |
6259d8 |
policy/rolemap This file contains prefix and user domain type that
|
|
Chris PeBenito |
6259d8 |
corresponds to each user role. The contents of this
|
|
Chris PeBenito |
6259d8 |
file will be used to expand the per-user domain
|
|
Chris PeBenito |
6259d8 |
templates for each module.
|
|
Chris PeBenito |
6259d8 |
|
|
Chris PeBenito |
97749e |
policy/support/* Support macros.
|
|
Chris PeBenito |
97749e |
|
|
Chris PeBenito |
35bb02 |
policy/users This file defines the users included in the policy.
|
|
Chris PeBenito |
35bb02 |
|
|
Chris PeBenito |
75c1c2 |
support/* Tools used in the build process.
|