Blame SOURCES/secolor.conf.8

a85796
.TH "secolor.conf" "8" "08 April 2011" "SELinux API documentation"
a85796
.SH "NAME"
a85796
secolor.conf \- The SELinux color configuration file
a85796
.
a85796
.SH "DESCRIPTION"
a85796
The 
a85796
.I /etc/selinux/{SELINUXTYPE}/secolor.conf
a85796
configuation file controls the color to be associated to the context components associated to the 
a85796
.I raw
a85796
context passed by 
a85796
.BR selinux_raw_context_to_color "(3),"
a85796
when context related information is to be displayed in color by an SELinux-aware application. 
a85796
.sp
a85796
.BR selinux_raw_context_to_color "(3)"
a85796
obtains this color information from the active policy 
a85796
.B secolor.conf
a85796
file as returned by 
a85796
.BR selinux_colors_path "(3)."
a85796
.
a85796
.SH "FILE FORMAT"
a85796
The file format is as follows:
a85796
.RS
a85796
.B color
a85796
.I color_name
a85796
.BI "= #"color_mask
a85796
.br
a85796
[...]
a85796
.sp
a85796
.I context_component string
a85796
.B =
a85796
.I fg_color_name bg_color_name
a85796
.br
a85796
[...]
a85796
.sp 
a85796
.RE
a85796
a85796
Where:
a85796
.br
a85796
.B color
a85796
.RS
a85796
The color keyword. Each color entry is on a new line.
a85796
.RE
a85796
.I color_name
a85796
.RS
a85796
A single word name for the color (e.g. red).
a85796
.RE
a85796
.I color_mask
a85796
.RS
a85796
A color mask starting with a hash (#) that describes the hexadecimal RGB colors with black being #000000 and white being #ffffff.
a85796
.RE
a85796
.I context_component
a85796
.RS
a85796
The context component name that must be one of the following:
a85796
.br
a85796
.RS
a85796
user, role, type or range 
a85796
.RE
a85796
Each
a85796
.IR context_component " " string " ..."
a85796
entry is on a new line.
a85796
.RE
a85796
.I string
a85796
.RS
a85796
This is the 
a85796
.I context_component
a85796
string that will be matched with the 
a85796
.I raw
a85796
context component passed by
a85796
.BR selinux_raw_context_to_color "(3)."
a85796
.br
a85796
A wildcard '*' may be used to match any undefined string for the user, role and type 
a85796
.I context_component
a85796
entries only.
a85796
.RE
a85796
a85796
.I fg_color_name
a85796
.RS
a85796
The color_name string that will be used as the foreground color.
a85796
A 
a85796
.I color_mask
a85796
may also be used.
a85796
.RE
a85796
.I bg_color_name
a85796
.RS
a85796
The color_name string that will be used as the background color.
a85796
A 
a85796
.I color_mask
a85796
may also be used.
a85796
.RE
a85796
.
a85796
.SH "EXAMPLES"
a85796
Example 1 entries are:
a85796
.RS
a85796
color black  = #000000
a85796
.br
a85796
color green  = #008000
a85796
.br
a85796
color yellow = #ffff00
a85796
.br
a85796
color blue   = #0000ff
a85796
.br
a85796
color white  = #ffffff
a85796
.br
a85796
color red    = #ff0000
a85796
.br
a85796
color orange = #ffa500
a85796
.br
a85796
color tan    = #D2B48C
a85796
.sp
a85796
user * = black white
a85796
.br
a85796
role * = white black
a85796
.br
a85796
type * = tan orange
a85796
.br
a85796
range s0\-s0:c0.c1023 = black green
a85796
.br
a85796
range s1\-s1:c0.c1023 = white green
a85796
.br
a85796
range s3\-s3:c0.c1023 = black tan
a85796
.br
a85796
range s5\-s5:c0.c1023 = white blue
a85796
.br
a85796
range s7\-s7:c0.c1023 = black red
a85796
.br
a85796
range s9\-s9:c0.c1023 = black orange
a85796
.br
a85796
range s15:c0.c1023   = black yellow
a85796
.RE
a85796
a85796
.sp
a85796
Example 2 entries are:
a85796
.RS
a85796
color black  = #000000
a85796
.br
a85796
color green  = #008000
a85796
.br
a85796
color yellow = #ffff00
a85796
.br
a85796
color blue   = #0000ff
a85796
.br
a85796
color white  = #ffffff
a85796
.br
a85796
color red    = #ff0000
a85796
.br
a85796
color orange = #ffa500
a85796
.br
a85796
color tan    = #d2b48c
a85796
.sp
a85796
user unconfined_u = #ff0000 green
a85796
.br
a85796
role unconfined_r = red #ffffff
a85796
.br
a85796
type unconfined_t = red orange
a85796
.br
a85796
user user_u       = black green
a85796
.br
a85796
role user_r       = white black
a85796
.br
a85796
type user_t       = tan red
a85796
.br
a85796
user xguest_u     = black yellow
a85796
.br
a85796
role xguest_r     = black red
a85796
.br
a85796
type xguest_t     = black green
a85796
.br
a85796
user sysadm_u     = white black
a85796
.br
a85796
range s0:c0.c1023 = black white
a85796
.br
a85796
user *            = black white
a85796
.br
a85796
role *            = black white
a85796
.br
a85796
type *            = black white
a85796
.RE
a85796
.
a85796
.SH "SEE ALSO"
a85796
.BR mcstransd "(8), " selinux_raw_context_to_color "(3), " selinux_colors_path "(3)"