btohex(3TSOL)

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

NAME

btohex, bcltoh, bsltoh, biltoh, bcleartoh, bcltoh_r, bsltoh_r, biltoh_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:

---

0x information_label_hexadecimal_value [0x sensitivity_label_hexadecimal_value ]

---

bsltoh() and bsltoh_r() convert a binary sensitivity label into a string of the form:

---

[0x sensitivity_label_hexadecimal_value ]

---

bcleartoh() and bcleartoh_r() convert a binary clearance into a string of the form:

---

0x clearance_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 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.

Information labels ( IL s) are not supported in Trusted Solaris 7 and later releases. Trusted Solaris software interprets any IL s on communications and files from systems running earlier releases as ADMIN_LOW .

Objects still have CMW labels, and CMW labels still include the IL component: IL[SL] ; however, the IL component is fixed at ADMIN_LOW .

As a result, Trusted Solaris 7 and later releases have the following characteristics:

• IL s do not display in window labels; SL s (Sensitivity Labels) display alone within brackets.

• IL s do not float.

• Setting an IL on an object has no effect.

• Getting an object's IL will always return ADMIN_LOW .

• Although certain utilities, library functions, and system calls can manipulate IL strings, the resulting IL s are always ADMIN_LOW , and cannot be set on any objects.

Trusted Solaris 8  Last Revised 1 Mar 2000

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