#Contributing to SELinux

Contributing to the SELinux userspace project is a similar process to other open source projects. Bug reports, new features to the existing code, additional tools, or updated documentation are all welcome.

The Todo page has a list of requested changes.

See the selinuxproject.org user resources page for more information on mailing lists, documentation, and other resources.

##Reporting Bugs

New Ticket is available in the menu above for everyone (no need to register). Please always add versions of SELinux related libraries and tools (libsepol, libselinux, libsemanage, checkpoolicy) and if you are using a custom policy please include it.

##Compiling

There are a number of dependencies required to build the userspace tools/libraries. On a Fedora system you can install them with yum:

# yum install pcre-devel ustr-devel bzip2-devel bison flex flex-devel python-devel setools-devel libcgroup-devel libcap-ng-devel glib2-devel dbus-devel dbus-glib-devel

The tools and libraries can be built from the top level with make:

$ make

##Contributing Code

After obtaining the code of the repository (see below), create a patch against the repository, and post that patch to the SELinux mailing list. When preparing patches, please follow these guidelines:

• Patches should apply with -P1
• Must apply against HEAD of the master branch (or HEAD of the stable_1_0 branch if you are writing a patch for stable)
• Separate large patches in to logical patches

When adding new, large features or tools it is best to discuss the design on the mailing list prior to submitting the patch.

##Development Repository

Git is a modern source code management system. For more information about Git please see the Git website.

To get an anonymous checkout of the SELinux userland repository you can run:

$ git clone https://github.com/SELinuxProject/selinux