htobsl(3tsol) [opensolaris man page]

hextob(3TSOL)					       Trusted Extensions Library Functions					     hextob(3TSOL)

NAME

       hextob, htobsl, htobclear - convert hexadecimal string to binary label

SYNOPSIS

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

       #include <tsol/label.h>

       int htobsl(const char *s, m_label_t *label);

       int htobclear(const char *s, m_label_t *clearance);

DESCRIPTION

       These functions convert hexadecimal string representations of internal label values into binary labels.

       The htobsl() function converts into a binary sensitivity label, a hexadecimal string of the form:

	 0xsensitivity_label_hexadecimal_value

       The htobclear() function converts into a binary clearance, a hexadecimal string of the form:

	 0xclearance_hexadecimal_value

RETURN VALUES

       These functions return non-zero if the conversion was successful, otherwise zero is returned.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Obsolete			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

       These  functions  are  obsolete and retained for ease of porting. They might be removed in a future Solaris Trusted Extensions release. Use
       the str_to_label(3TSOL) function instead.

SEE ALSO

       libtsol(3LIB), str_to_label(3TSOL), 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 						     hextob(3TSOL)

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)