All of lore.kernel.org
 help / color / mirror / Atom feed
From: Richard Haines <richard_c_haines@btinternet.com>
To: paul@paul-moore.com, selinux@vger.kernel.org
Cc: Richard Haines <richard_c_haines@btinternet.com>
Subject: [PATCH 18/22] userspace_libraries: Tidy up formatting, add toc
Date: Wed,  9 Sep 2020 14:30:35 +0100	[thread overview]
Message-ID: <20200909133039.44498-19-richard_c_haines@btinternet.com> (raw)
In-Reply-To: <20200909133039.44498-1-richard_c_haines@btinternet.com>

Signed-off-by: Richard Haines <richard_c_haines@btinternet.com>
---
 src/userspace_libraries.md | 58 ++++++++++++++++++++------------------
 1 file changed, 31 insertions(+), 27 deletions(-)

diff --git a/src/userspace_libraries.md b/src/userspace_libraries.md
index 4f70321..5be703a 100644
--- a/src/userspace_libraries.md
+++ b/src/userspace_libraries.md
@@ -1,5 +1,9 @@
 # SELinux Userspace Libraries
 
+- [libselinux Library](#libselinux-library)
+- [libsepol Library](#libsepol-library)
+- [libsemanage Library](#libsemanage-library)
+
 The versions of kernel and SELinux tools and libraries influence the
 features available, therefore it is important to establish what level of
 functionality is required for the application. The
@@ -19,13 +23,13 @@ Python, Ruby and PHP languages.
 
 The library hides the low level functionality of (but not limited to):
 
--   The SELinux filesystem that interfaces to the SELinux kernel
-    security server.
--   The proc filesystem that maintains process state information and
-    security contexts - see ***proc**(5)*.
--   Extended attribute services that manage the extended attributes
-    associated to files, sockets etc. - see ***attr**(5)*.
--   The SELinux policy and its associated configuration files.
+- The SELinux filesystem that interfaces to the SELinux kernel
+  security server.
+- The proc filesystem that maintains process state information and
+  security contexts - see ***proc**(5)*.
+- Extended attribute services that manage the extended attributes
+  associated to files, sockets etc. - see ***attr**(5)*.
+- The SELinux policy and its associated configuration files.
 
 The general category of functions available in *libselinux* are shown below,
 with [**Appendix B - *libselinux* API Summary**](libselinux_functions.md#appendix-b---libselinux-api-summary)
@@ -102,24 +106,23 @@ Retrieve default contexts for user sessions.
 The *libselinux* functions make use of a number of files within the
 SELinux sub-system:
 
-1.  The SELinux configuration file *config* that is described in the
-    [*/etc/selinux/config*](global_config_files.md#etcselinuxconfig) section.
-2.  The SELinux filesystem interface between userspace and kernel that
-    is generally mounted as */selinux* or */sys/fs/selinux* and
-    described in the
-    [**SELinux Filesystem**](lsm_selinux.md#selinux-filesystem)
-    section.
-3.  The *proc* filesystem that maintains process state information and
-    security contexts - see ***proc**(5)*.
-4.  The extended attribute services that manage the extended attributes
-    associated to files, sockets etc. - see ***attr**(5)*.
-5.  The SELinux kernel binary policy that describes the enforcement
-    policy.
-6.  A number of *libselinux* functions have their own configuration
-    files that in conjunction with the policy, allow additional levels
-    of configuration. These are described in the
-    [**Policy Configuration Files**](policy_config_files.md#policy-configuration-files)
-    section.
+1. The SELinux configuration file *config* that is described in the
+   [*/etc/selinux/config*](global_config_files.md#etcselinuxconfig) section.
+2. The SELinux filesystem interface between userspace and kernel that
+   is generally mounted as */selinux* or */sys/fs/selinux* and
+   described in the
+   [**SELinux Filesystem**](lsm_selinux.md#selinux-filesystem) section.
+3. The *proc* filesystem that maintains process state information and
+   security contexts - see ***proc**(5)*.
+4. The extended attribute services that manage the extended attributes
+   associated to files, sockets etc. - see ***attr**(5)*.
+5. The SELinux kernel binary policy that describes the enforcement
+   policy.
+6. A number of *libselinux* functions have their own configuration
+   files that in conjunction with the policy, allow additional levels
+   of configuration. These are described in the
+   [**Policy Configuration Files**](policy_config_files.md#policy-configuration-files)
+   section.
 
 There is a static version of the library that is not installed by default:
 
@@ -140,10 +143,11 @@ dnf install libsepol-static
 
 This is used by commands such as ***audit2allow**(8)* and ***checkpolicy**(8)*
 as they require access to functions that are not available in the dynamic
-library (such as sepol_compute_av(), sepol_compute_av_reason() and
-sepol_context_to_sid().
+library, such as *sepol_compute_av()*, *sepol_compute_av_reason()* and
+*sepol_context_to_sid()*.
 
 ## libsemanage Library
+
 *libsemanage* - To manage the policy infrastructure.
 
 <!-- %CUTHERE% -->
-- 
2.26.2


  parent reply	other threads:[~2020-09-10 17:14 UTC|newest]

Thread overview: 24+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-09-09 13:30 [PATCH 00/22] SELinux Notebook: Convert batch 3 to markdown/tidy up Richard Haines
2020-09-09 13:30 ` [PATCH 01/22] kernel_policy_language: Tidy up formatting Richard Haines
2020-09-09 13:30 ` [PATCH 02/22] mls_statements: Convert to markdown Richard Haines
2020-09-09 13:30 ` [PATCH 03/22] object_classes_permissions: : Tidy up formatting Richard Haines
2020-09-09 13:30 ` [PATCH 04/22] policy_config_files: " Richard Haines
2020-09-09 13:30 ` [PATCH 05/22] policy_validation_example: " Richard Haines
2020-09-09 13:30 ` [PATCH 06/22] postgresql: " Richard Haines
2020-09-09 13:30 ` [PATCH 07/22] security_context: Convert to markdown Richard Haines
2020-09-09 13:30 ` [PATCH 08/22] selinux_cmds: " Richard Haines
2020-09-09 13:30 ` [PATCH 09/22] selinux_overview: " Richard Haines
2020-09-09 13:30 ` [PATCH 10/22] sid_statement: " Richard Haines
2020-09-09 13:30 ` [PATCH 11/22] subjects: " Richard Haines
2020-09-09 13:30 ` [PATCH 12/22] toc: Tidy up formatting Richard Haines
2020-09-09 13:30 ` [PATCH 13/22] type_enforcement: Convert to markdown Richard Haines
2020-09-09 13:30 ` [PATCH 14/22] type_statements: Add toc, tidy up formatting Richard Haines
2020-09-09 13:30 ` [PATCH 15/22] types_of_policy: Convert to markdown Richard Haines
2020-09-09 13:30 ` [PATCH 16/22] user_statements:: Tidy up formatting Richard Haines
2020-09-09 13:30 ` [PATCH 17/22] users: " Richard Haines
2020-09-09 13:30 ` Richard Haines [this message]
2020-09-09 13:30 ` [PATCH 19/22] vm_support: " Richard Haines
2020-09-09 13:30 ` [PATCH 20/22] x_windows: " Richard Haines
2020-09-09 13:30 ` [PATCH 21/22] xen_statements: " Richard Haines
2020-09-09 13:30 ` [PATCH 22/22] xperm_rules: " Richard Haines
2020-09-11 14:57 ` [PATCH 00/22] SELinux Notebook: Convert batch 3 to markdown/tidy up Paul Moore

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20200909133039.44498-19-richard_c_haines@btinternet.com \
    --to=richard_c_haines@btinternet.com \
    --cc=paul@paul-moore.com \
    --cc=selinux@vger.kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body. 
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.