btohex man page on SunOS

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
SunOS logo
[printable version]

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	 allo‐
       cated  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.10			  20 Jul 2007			 btohex(3TSOL)
[top]

List of man pages available for SunOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net