Skip to content

Contributing

Stephen Smalley edited this page Jun 6, 2025 · 17 revisions

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.

You can find a list of open issues to the SELinux userspace code at https://github.com/SELinuxProject/selinux/issues.

Mailing list

SELinux has a public mailing list for developers, subscribe via https://subspace.kernel.org/vger.kernel.org.html#selinux. It is generally wise to read relevant postings to the list before beginning any area of new work. Searchable mailing list archives are available externally at https://lore.kernel.org/selinux/ . Patches for SELinux are tracked via https://patchwork.kernel.org/project/selinux/list/ .

IRC

An unofficial SELinux IRC channel is #selinux on Libera.Chat .

Reporting Bugs

All bugs and patches should be submitted to the SELinux mailing list at [email protected].

When reporting bugs please include versions of SELinux related libraries and tools (libsepol, libselinux, libsemanage, checkpolicy). If you are using a custom policy please include it as well.

Compiling

There are a number of dependencies required to build the userspace tools/libraries. Consult the README.md for the current list of dependencies and how to build the userspace code.

Contributing Code

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

  • Patches should apply with git am
  • Must apply against HEAD of the main branch
  • Separate large patches into 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 a copy of the SELinux userland repository you can run:

$ git clone https://github.com/SELinuxProject/selinux
Clone this wiki locally