btohex(3TSOL) Trusted Extensions Library Functions btohex(3TSOL)NAME
btohex, bsltoh, bcleartoh, bsltoh_r, bcleartoh_r, h_alloc, h_free -
convert binary label to hexadecimal
SYNOPSIS
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);
DESCRIPTION
These functions convert binary labels into hexadecimal strings that
represent the internal value.
The bsltoh() and bsltoh_r() functions convert a binary sensitivity
label into a string of the form:
[0xsensitivity_label_hexadecimal_value]
The bcleartoh() and bcleartoh_r() functions convert a binary clearance
into a string of the form:
0xclearance_hexadecimal_value
The h_alloc() function allocates memory for the hexadecimal value type
for use by bsltoh_r() and bcleartoh_r().
Valid values for type are:
SUN_SL_ID label is a binary sensitivity label.
SUN_CLR_ID label is a binary clearance.
The h_free() function frees memory allocated by h_alloc().
RETURN VALUES
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.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Obsolete │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │MT-Safe with exceptions │
└─────────────────────────────┴─────────────────────────────┘
The bsltoh(), bcleartoh(), bsltoh_r(), bcleartoh_r(), h_alloc(), and
h_free() functions are Obsolete. Use the label_to_str(3TSOL) function
instead.
The bsltoh() and bcleartoh() functions share the same statically allo‐
cated string storage. They are not MT-Safe. Subsequent calls to any of
these functions will overwrite that string with the newly translated
string. The bsltoh_r() and bcleartoh_r() functions should be used in
multithreaded applications.
SEE ALSOatohexlabel(1M), hextoalabel(1M),label_to_str(3TSOL), libtsol(3LIB),
attributes(5), labels(5)NOTES
The functionality described on this manual page is available only if
the system is configured with Trusted Extensions.
SunOS 5.11 20 Jul 2007 btohex(3TSOL)