btohex(3TSOL)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ATTRIBUTES | SEE ALSO | NOTES

NAME

btohex, bcltoh, bsltoh, bcleartoh, bcltoh_r, bsltoh_r, bcleartoh_r, h_alloc, h_free- convert binary label to hexadecimal

SYNOPSIS

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


#include <tsol/label.h>

char *bcltoh(const bclabel_t *label);
char *bsltoh(const bslabel_t *label);
char *bcleartoh(const bclear_t *clearance);
char *bcltoh_r(const bclabel_t *label, char *hex);
char *bsltoh_r(const bslabel_t *label, char *hex);
char *bcleartoh_r(const bclear_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.

bcltoh() and bcltoh_r() convert a binary CMW label into a string of the form:

0xADMIN_LOW_hex_value [0xsensitivity_label_hexadecimal_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 bcltoh_r(), bsltoh_r(), and bcleartoh_r().

Valid values for type are:

SUN_CMW_ID

label is a binary CMW label.

SUN_SL_ID

label is a binary sensitivity label.

SUN_CLR_ID

label is a binary clearance.

h_free() 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
Availability	SUNWtsu
MT-Level	MT-Safe with exceptions

SEE ALSO

Trusted Solaris 8 4/01 Reference Manual

atohexlabel(1M), hextoalabel(1M), bcltobanner(3TSOL), blmanifest(3TSOL), bltocolor(3TSOL), bltype(3TSOL), labelinfo(3TSOL), sbltos(3TSOL)

Trusted Solaris Developer's Guide

SunOS 5.8 Reference Manual

attributes(5)

NOTES

The functions bcltoh(), 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 bcltoh_r(), bsltoh_r(), and bcleartoh_r() should be used.

Trusted Solaris 8 4/01  Last Revised 24 May 2001

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ATTRIBUTES | SEE ALSO | NOTES