selinux/secilc
Yuli Khodorkovskiy 71dd7b7133 secilc: Add support for unordered classes
Resolves https://github.com/SELinuxProject/cil/issues/3

An 'unordered' keyword provides the ability to append classes to the current
list of ordered classes. This allows users to not need knowledge of existing
classes when creating a class and fixes dependencies on classes when removing a
module. This enables userspace object managers with custom objects to be
modularized.

If a class is declared in both an unordered and ordered statement, then the
ordered statement will supercede the unordered declaration.

Example usage:

    ; Appends new_class to the existing list of classes
    (class new_class ())
    (classorder (unordered new_class))

Signed-off-by: Yuli Khodorkovskiy <ykhodorkovskiy@tresys.com>
Signed-off-by: James Carter <jwcart2@tycho.nsa.gov>
2015-11-10 13:26:52 -05:00
..
docs secilc: Add support for unordered classes 2015-11-10 13:26:52 -05:00
test secilc: Add support for unordered classes 2015-11-10 13:26:52 -05:00
.gitignore libsepol: Move secilc out of libsepol 2015-03-31 12:31:38 -04:00
Android.mk Remove uses of -Wno-return-type. 2015-06-15 09:14:10 -04:00
COPYING libsepol: Move secilc out of libsepol 2015-03-31 12:31:38 -04:00
ChangeLog Updated libselinux and secilc ChangeLog. 2015-09-02 16:05:56 -04:00
Makefile Add an empty relabel target to secilc Makfile. 2015-04-10 09:50:57 -04:00
README libsepol: Move secilc out of libsepol 2015-03-31 12:31:38 -04:00
VERSION Add VERSION and (empty) ChangeLog files to secilc. 2015-03-31 12:40:24 -04:00
secilc.8.xml libsepol: Move secilc out of libsepol 2015-03-31 12:31:38 -04:00
secilc.c libsepol, secilc: Fix build for Android 2015-04-02 12:01:10 -04:00

README

SELinux Common Intermediate Language (CIL) Compiler

INTRODUCTION

	The SELinux CIL Compiler is a compiler that converts the CIL language as
	described on the CIL design wiki into a kernel binary policy file.
	Please see the CIL Design Wiki at:
	http://github.com/SELinuxProject/cil/wiki/
	for more information about the goals and features on the CIL language.

DEPENDENCIES

	gcc >= 4.5.1
	libsepol >= 2.4


BUILD STEPS

	Run "make" with one of the following targets:

	make
		Build the CIL compiler (secilc).

	make test
		Pass a sample policy to test with the compiler.

	make install
		Install the secilc compiler and man page to disk.

	make clean
		Remove temporary build files.

	make man
		Build the secilc man page.

	make bare
		Remove temporary build files and compile binaries.


USAGE

	Execute 'secilc' with any number of CIL files as arguments. A binary policy and
	file_contexts file will be created.

	Use the '--help' option for more details.


DOCUMENTATION

	There is a Docbook CIL Reference Guide in the docs directory, to build
	this in HTML and PDF format change to the docs directory and run:
		make html pdf

	There is also an secilc man page that can be built with:
		make man

	The documents will be located in the docs/html, docs/pdf and docs/man8
	directories.

	To build the html and manpage the xmlto package is required.
	To build the pdf document the xmlto and dblatex packages are required.


KNOWN ISSUES

	- Blocks inside of macros causes undefined behavior

	- Policy must be well formed. For example, invalid usage of
	  sensitivities/categories/levels may create an unloaded binary

	- Recursive limits are not handled