NAME | Synopsis | Interface Level | Description | Return Values | Attributes | See Also | Notes
cc [flag...] file... -ltsol [library...]
#include <tsol/label.h> char *bsltoh(const m_label_t *label);
char *bcleartoh(const m_label_t *clearance);
char *bsltoh_r(const m_label_t *label, char *hex);
char *bcleartoh_r(const m_label_t *clearance, char *hex);
char *h_alloc(const unsigned char type);
void h_free(char *hex);
The bsltoh(), bcleartoh(), bsltoh_r(), bcleartoh_r(), h_alloc(), and h_free() functions are obsolete. Use the label_to_str(3TSOL) function instead.
These functions convert binary labels into hexadecimal strings that represent the internal value.
bsltoh() and bsltoh_r() convert a binary sensitivity label into a string of the form:
[0xsensitivity_label_hexadecimal_value] |
bcleartoh() and bcleartoh_r() convert a binary clearance into a string of the form:
0xclearance_hexadecimal_value |
h_alloc() allocates memory for the hexadecimal value type for use by bsltoh_r() and bcleartoh_r().
Valid values for type are:
label is a binary sensitivity label.
label is a binary clearance.
h_free() frees memory allocated by h_alloc().
These functions return a pointer to a string that contains the result of the translation, or (char *)0 if the parameter is not of the required type.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE |
ATTRIBUTE VALUE |
---|---|
Availability |
SUNWtsu |
Stability Level |
Obsolete |
MT-Level |
MT-Safe with exceptions |
These functions are obsolete and retained for ease of porting. They might be removed in a future Solaris Trusted Extensions release.
The functions bsltoh() and bcleartoh() share the same statically allocated string storage. They are not MT-Safe. Subsequent calls to any of these functions will overwrite that string with the newly translated string.
For multithreaded applications, the functions bsltoh_r() and bcleartoh_r() should be used.
NAME | Synopsis | Interface Level | Description | Return Values | Attributes | See Also | Notes