Manual Pages for UNIX Operating System command usage for man btohex

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 

     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  sen-
     sitivity 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().




SunOS 5.11          Last change: 20 Jul 2007                    1






Trusted Extensions Library Functions                btohex(3TSOL)



     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  attri-
     butes:



     ____________________________________________________________
    |       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 stati-
     cally allocated string storage. They are not MT-Safe. Subse-
     quent 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          Last change: 20 Jul 2007                    2