User Tools

Site Tools


solaris:btohex.3tsol

btohex


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(7) for descriptions of the following attributes:

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 allocated 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 ALSO

libtsol(3LIB), label_to_str(3TSOL), attributes(7), labels(7), atohexlabel(8), hextoalabel(8)

NOTES

The functionality described on this manual page is available only if the system is configured with Trusted Extensions.


solaris/btohex.3tsol.txt · Last modified: 2023/07/19 08:58 by A User Not Logged in