bltocolor(3TSOL)

NAME | Synopsis | Interface Level | Description | Return Values | Files | Attributes | See Also | Notes

NAME

bltocolor, bltocolor_r – get character-coded color name of label

Synopsis

cc [flag...] file... -ltsol [library...]

#include <tsol/label.h>

char *bltocolor(const m_label_t *label);

char *bltocolor_r(const m_label_t *label, const int size, char *color_name);

Interface Level

The bltocolor() and bltocolor_r() functions are obsolete. Use the label_to_str(3TSOL) function instead.

Description

The calling process must have PRIV_SYS_TRANS_LABEL in its set of effective privileges to get color names of labels that dominate the current process's sensitivity label.

bltocolor() and bltocolor_r() get the character-coded color name associated with the binary label label.

Return Values

bltocolor() returns a pointer to a statically allocated string that contains the character-coded color name specified for the label or returns (char *)0 if, for any reason, no character-coded color name is available for this binary label.

bltocolor_r() returns a pointer to the color_name string which contains the character-coded color name specified for the label or returns (char *)0 if, for any reason, no character-coded color name is available for this binary label. color_name must provide for a string of at least size characters.

Files

/etc/security/tsol/label_encodings

The label encodings file contains the classification names, words, constraints, and values for the defined labels of this system.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWtsu
Stability Level	Obsolete
MT-Level	MT-Safe with exceptions

See Also

label_to_str(3TSOL), attributes(5)

Notes

These functions are obsolete and retained for ease of porting. They might be removed in a future Solaris Trusted Extensions release.

The function bltocolor() returns a pointer to a statically allocated string. Subsequent calls to it will overwrite that string with a new character-coded color name. It is not MT-Safe.

For multithreaded applications the function bltocolor_r() should be used.

If label includes a specified word or words, the character-coded color name associated with the first word specified in the label encodings file is returned. Otherwise, if no character-coded color name is specified for label, the first character-coded color name specified in the label encodings file with the same classification as the binary label is returned.

SunOS 5.10  Last Revised 31 May 2006

NAME | Synopsis | Interface Level | Description | Return Values | Files | Attributes | See Also | Notes