opensolaris man page for btohex

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 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
       atohexlabel(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)