libtsol(3LIB) Interface Libraries libtsol(3LIB)NAME
libtsol - Solaris Trusted Extensions library
SYNOPSIS
cc [flag...] file... -ltsol [library...]
#include <tsol.h>
DESCRIPTION
Functions in this library provide programmatic access to Solaris Trusted Extensions features such as labels and Mandatory Access Policy
(MAC) on systems that are configured with Trusted Extensions software.
INTERFACES
The shared object libtsol.so.2 provides the public interfaces that are defined below. See Intro(3) for additional information on shared
object interfaces.
Committed Functions
bldominates blequal
blstrictdom getpathbylabel
getplabel getdevicerange
getuserrange getzoneidbylabel
getzonelabelbyid getzonerootbyid
getzonerootbylabel getzonerootbyname
label_to_str labelbuilder
labelclipping m_label_alloc
m_label_dup m_label_free
setflabel str_to_label
tsol_lbuild_create tsol_lbuild_destroy
tsol_lbuild_get tsol_lbuild_set
Xbcleartos Xbsltos
Obsolete Functions
The following functions are preserved to aid porting.
Function Committed Replacement
bcleartoh label_to_str
bcleartoh_r label_to_str
bcleartos label_to_str
bltocolor label_to_str
bltocolor_r label_to_str
bsltoh label_to_str
bsltoh_r label_to_str
bsltos label_to_str
h_alloc label_to_str
h_free label_to_str
htobclear str_to_label
htobsl str_to_label
sbcleartos str_to_label
sbsltos str_to_label
stobsl str_to_label
stobclear str_to_label
FILES
/lib/libtsol.so.2 shared object
/lib/64/libtsol.so.2 64-bit shared object
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWcsl |
+-----------------------------+-----------------------------+
|Interface Stability |See the manual pages for |
| |the individual functions. |
+-----------------------------+-----------------------------+
|MT-Level |Safe |
+-----------------------------+-----------------------------+
SEE ALSO Intro(3), libtsnet(3LIB), attributes(5)NOTES
The functionality described on this manual page is available only if the system has been configured with Trusted Extensions.
SunOS 5.11 20 Jul 2007 libtsol(3LIB)
Check Out this Related Man Page
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)