atohexlabel(1m) [opensolaris man page]

atohexlabel(1M) 					  System Administration Commands					   atohexlabel(1M)

NAME

       atohexlabel - convert a human readable label to its internal text equivalent

SYNOPSIS

       /usr/sbin/atohexlabel [human-readable-sensitivity-label]

       /usr/sbin/atohexlabel -c [human-readable-clearance]

DESCRIPTION

       atohexlabel  converts a human readable label into an internal text representation that is safe for storing in a public object. If no option
       is supplied, the label is assumed to be a sensitivity label.

       Internal conversions can later be parsed to their same value. This internal form is often hexadecimal. The converted label  is  written	to
       the standard output file. If no human readable label is specified, the label is read from the standard input file. The expected use of this
       command is emergency repair of labels that are stored in internal databases.

OPTIONS

       -c    Identifies the human readable label as a clearance.

EXIT STATUS

       The following exit values are returned:

       0	    On success.

       1	    On failure, and writes diagnostics to the standard error file.

FILES

       /etc/security/tsol/label_encodings

	   The label encodings file contains the classification names, words, constraints, and values for the defined labels of this system.

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWtsu			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |See below.		   |
       +-----------------------------+-----------------------------+

       The command output is Committed for systems with the same label_encodings file. The command invocation is Committed for systems that imple-
       ment the DIA MAC policy.

SEE ALSO

       hextoalabel(1M), label_to_str(3TSOL), str_to_label(3TSOL), label_encodings(4), attributes(5)

       How to Get the Hexadecimal Equivalent for a Label in Solaris Trusted Extensions Administrator's Procedures

NOTES

       The functionality described on this manual page is available only if the system is configured with Trusted Extensions.

       This  file  is  part  of  the Defense Intelligence Agency (DIA) Mandatory Access Control (MAC) policy. This file might not be applicable to
       other MAC policies that might be developed for future releases of Solaris Trusted Extensions software.

SunOS 5.11							    20 Jul 2007 						   atohexlabel(1M)

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)