selinux/secilc
Jason Zaman 3ccea01c69
Update VERSIONs to 3.5-rc2 for release.
Signed-off-by: Jason Zaman <jason@perfinion.com>
2023-01-15 15:40:55 -08:00
..
docs secilc/doc: classmap is also allowed in permissionx 2022-10-05 08:14:11 -04:00
test libsepol/cil: add support for self keyword in type transitions 2022-05-16 10:37:05 -04:00
.gitignore
LICENSE docs: provide a top level LICENSE file 2022-10-05 08:20:38 -04:00
Makefile
README
VERSION Update VERSIONs to 3.5-rc2 for release. 2023-01-15 15:40:55 -08:00
secil2conf.8.xml libsepol/cil: Add support for using qualified names to secil2conf 2021-07-03 16:00:30 +02:00
secil2conf.c secilc: fix memory leaks in secilc2conf 2021-07-19 10:42:45 -04:00
secil2tree.8.xml libsepol/cil: Add support for using qualified names to secil2tree 2021-07-03 16:00:30 +02:00
secil2tree.c libsepol/cil: Add support for using qualified names to secil2tree 2021-07-03 16:00:30 +02:00
secilc.8.xml secilc: Add support for using qualified names to secilc 2021-07-03 16:00:30 +02:00
secilc.c secilc: fix memory leaks in secilc 2021-07-19 10:42:45 -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.5


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 github markdown CIL Reference Guide in the docs directory. To
	view the table of contents, see README.md in the docs directory.

	To convert the github markdown content to HTML and PDF, change to the docs
	directory and run:
		make

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

	To build the html and pdf, the pandoc package is 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