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