Solaris Trusted Extensions Label Administration

Specifying Colors for Labels

In the LOCAL DEFINITIONS section, the COLOR NAMES keyword is followed by zero or more color assignments. If no color is defined for a classification in the COLOR NAMES section of the label_encodings file, the color black is used. The default color values are shown in the following excerpt.


     label= Admin_Low;           color= #bdbdbd;

     label= PUB;                 color= blue violet;
     label= SBX PLAYGROUND;      color= yellow;
     label= CNF;                 color= navy blue;
     label= CNF : INTERNAL USE ONLY;  color= blue;
     label= CNF : NEED TO KNOW;  color= #00bfff;
     label= CNF : RESTRICTED;    color= #87ceff;

     label= Admin_High;          color= #636363;

Colors are assigned to labels and to words within labels with the following syntax:

label= label-name;     color= color-name;
word= label-name;     color= color-name;

The value of color-name can be either a text color name or a hexadecimal color value. The color is associated with a word or a label. The color that is assigned to a label's component displays as a background color whenever a label includes the specified label components. The windows software computes a complementary color for the lettering.

For an introduction to color values, see Color Values. A full discussion of how to specify color is outside the scope of this guide. For more information, see the X11(5) man page in the /usr/openwin/share/man directory. For a fuller description, see “Color Specification” in the O`Reilly and Associates, Inc. XWindows Systems User's Guide (Vol. III), ISBN number 0-937175-29-3.

Color is assigned to a label's components according to the ordering rules that are described in the following section. For a desktop example of color use, see Figure 5–2. The PUBLIC, INTERNAL, and NTK_SALES workspace buttons are colored differently from each other and from standard workspace buttons.

Figure 5–2 Window Labels With Colors from COLOR NAMES

Illustration shows a green Public button, a yellow Internal
button, and a blue NTK_Sales button in the Front Panel.

Order of Color Specification

The color that is used for any label is determined according to the following rules.

  1. If a label contains a compartment word that has one or more colors specified, then the color value associated with the first word= value is used.

  2. If a label contains none of the compartment words that are associated with colors, and an exact match exists for the label name, then the specified label color is used.

  3. If there is no exact match for the label name, then the color that is associated with the first specified label= value for the classification of the label is used.

  4. If the classification has no assigned color, then the color that is assigned to the first label that contains the same classification is used.

Example 5–1 Colors Assigned According to Ordering Rules

In this example, a system has the following color definitions:

label= u;       color= green
label= c;       color= blue
label= S;       color= red;
word= B;        color= orange;
label= TS;      color= yellow;
label= TS SA;   color= khaki;

The rules result in the following color display:

Example 5–2 Color Assigned to a Label With No Assigned Color

This example illustrates rule 4. The label TS displays the color khaki, because TS SA is the only label that includes the TS classification. TS SA is defined to display the color khaki.

        label= u;       color= green
        label= c;       color= blue
        label= S;       color= red;
        word= B;        color= orange;
        label= TS SA;   color= khaki;

Color Values

The /usr/openwin/lib/rgb.txt database translates color names into red, green, blue values. You can refer to the rgb.txt file for color names to use for your site's labels. You can also use hexadecimal color values.

Briefly, here are a few high-level points about color values:

For a sample color name planner, see Table 6–8. To assign colors, see How to Assign a Color to a Label or Word.