selinux_colors_path(3) Library Functions Manual selinux_colors_path(3)NAME
selinux_colors_path - Return a path to the active SELinux policy color configuration file.
SYNOPSIS
#include <selinux/selinux.h>
const char *selinux_colors_path(void);
DESCRIPTION
selinux_colors_path returns the path to the active policy color configuration file.
The path is built from the path returned by selinux_policy_root(3) with /secolor.conf appended.
This optional configuration file whose format is shown in secolor.conf(5), controls the colors to be associated with the raw context compo-
nents of the selinux_raw_context_to_color(3) function when information is to be displayed by an SELinux color-aware application.
RETURN VALUE
On success, the path to the active policy color configuration file is returned. If a path is not available NULL is returned.
ERRORS
None.
SEE ALSO selinux(8), selinux_policy_root(3), selinux_config(5), selinux_raw_context_to_color(3), secolor.conf(5)SELinux API documentation 08 April 2011 selinux_colors_path(3)
Check Out this Related Man Page
secolor.conf(5) File Formats Manual secolor.conf(5)NAME
secolor.conf - The SELinux color configuration file
DESCRIPTION
This optional file controls the color to be associated to the context components associated to the raw context passed by selinux_raw_con-
text_to_color(3), when context related information is to be displayed in color by an SELinux-aware application.
selinux_raw_context_to_color(3) obtains this color information from the active policy secolor.conf file as returned by selinux_col-
ors_path(3).
FILE FORMAT
The file format is as follows:
color color_name = #color_mask
[...]
context_component string = fg_color_name bg_color_name
[...]
Where:
color
The color keyword. Each color entry is on a new line.
color_name
A single word name for the color (e.g. red).
color_mask
A color mask starting with a hash (#) that describes the hexadecimal RGB colors with black being #000000 and white being #ffffff.
context_component
The context component name that must be one of the following:
user, role, type or range
Each context_component string ... entry is on a new line.
string
This is the context_component string that will be matched with the raw context component passed by selinux_raw_context_to_color(3).
A wildcard '*' may be used to match any undefined string for the user, role and type context_component entries only.
fg_color_name
The color_name string that will be used as the foreground color. A color_mask may also be used.
bg_color_name
The color_name string that will be used as the background color. A color_mask may also be used.
EXAMPLES
Example 1 entries are:
color black = #000000
color green = #008000
color yellow = #ffff00
color blue = #0000ff
color white = #ffffff
color red = #ff0000
color orange = #ffa500
color tan = #D2B48C
user * = black white
role * = white black
type * = tan orange
range s0-s0:c0.c1023 = black green
range s1-s1:c0.c1023 = white green
range s3-s3:c0.c1023 = black tan
range s5-s5:c0.c1023 = white blue
range s7-s7:c0.c1023 = black red
range s9-s9:c0.c1023 = black orange
range s15:c0.c1023 = black yellow
Example 2 entries are:
color black = #000000
color green = #008000
color yellow = #ffff00
color blue = #0000ff
color white = #ffffff
color red = #ff0000
color orange = #ffa500
color tan = #d2b48c
user unconfined_u = #ff0000 green
role unconfined_r = red #ffffff
type unconfined_t = red orange
user user_u = black green
role user_r = white black
type user_t = tan red
user xguest_u = black yellow
role xguest_r = black red
type xguest_t = black green
user sysadm_u = white black
range s0:c0.c1023 = black white
user * = black white
role * = black white
type * = black white
SEE ALSO selinux(8), selinux_raw_context_to_color(3), selinux_colors_path(3)SELinux API documentation 08 April 2011 secolor.conf(5)