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
m_label(3TSOL) Trusted Extensions Library Functions m_label(3TSOL)NAME
m_label, m_label_alloc, m_label_dup, m_label_free - m_label functions
SYNOPSIS
cc [flag...] file... -ltsol [library...]
#include <tsol/label.h>
m_label_t *m_label_alloc(const m_label_type_t label_type);
int m_label_dup(m_label_t **dst, const m_label_t *src);
void m_label_free(m_label_t *label);
DESCRIPTION
The m_label_alloc() function allocates resources for a new label. The label_type argument defines the type for a newly allocated label. The
label type can be:
MAC_LABEL A Mandatory Access Control (MAC) label.
USER_CLEAR A user clearance.
The m_label_dup() function allocates resources for a new dst label. The function returns a pointer to the allocated label, which is an
exact copy of the src label. The caller is responsible for freeing the allocated resources by calling m_label_free().
The m_label_free() function frees resources that are associated with the previously allocated label.
RETURN VALUES
Upon successful completion, the m_label_alloc() function returns a pointer to the newly allocated label. Otherwise, m_label_alloc() returns
NULL and errno is set to indicate the error.
Upon successful completion, the m_label_dup() function returns 0. Otherwise, -1 is returned and errno is set to indicate the error.
ERRORS
The m_label_alloc() function will fail if:
EINVAL Invalid parameter.
ENOMEM The physical limits of the system are exceeded by size bytes of memory which cannot be allocated.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Interface Stability |Committed |
+-----------------------------+-----------------------------+
|MT-Level |Safe |
+-----------------------------+-----------------------------+
SEE ALSO label_to_str(3TSOL), libtsol(3LIB), str_to_label(3TSOL), label_encodings(4), attributes(5), labels(5)
Determining Whether the Printing Service Is Running in a Labeled Environment in Solaris Trusted Extensions Developer's Guide
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 m_label(3TSOL)