'\" te
.\" Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
.TH libtsol 3LIB "20 Jul 2010" "SunOS 5.11" "Interface Libraries"
.SH NAME
libtsol \- Solaris Trusted Extensions library
.SH SYNOPSIS
.LP
.nf
\fBcc\fR [\fIflag\fR...] \fIfile\fR... \fB-ltsol\fR [\fIlibrary\fR...]
#include <tsol.h>
.fi

.SH DESCRIPTION
.sp
.LP
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.
.SH INTERFACES
.sp
.LP
The shared object \fBlibtsol.so.2\fR provides the public interfaces that are defined below. See \fBIntro\fR(3) for additional information on shared object interfaces.
.SS "Committed Functions"
.sp

.sp
.TS
tab();
lw(2.75i) lw(2.75i) 
lw(2.75i) lw(2.75i) 
.
\fBbldominates\fR\fBblequal\fR
\fBblstrictdom\fR\fBgetpathbylabel\fR
\fBgetplabel\fR\fBgetuserrange\fR
\fBgetzoneidbylabel\fR\fBgetzonelabelbyid\fR
\fBgetzonerootbyid\fR\fBgetzonerootbylabel\fR
\fBgetzonerootbyname\fR\fBlabel_to_str\fR
\fBlabelbuilder\fR\fBlabelclipping\fR
\fBm_label_alloc\fR\fBm_label_dup\fR
\fBm_label_free\fR\fBsetflabel\fR
\fBstr_to_label\fR\fBtsol_lbuild_create\fR
\fBtsol_lbuild_destroy\fR\fBtsol_lbuild_get\fR
\fBtsol_lbuild_set\fR\fBXbcleartos\fR
\fBXbsltos\fR
.TE

.SS "Obsolete Functions"
.sp
.LP
The following functions are preserved to aid porting.
.sp

.sp
.TS
tab();
cw(2.75i) cw(2.75i) 
lw(2.75i) lw(2.75i) 
.
FunctionCommitted Replacement
\fBbcleartoh\fR\fBlabel_to_str\fR
\fBbcleartoh_r\fR\fBlabel_to_str\fR
\fBbcleartos\fR\fBlabel_to_str\fR
\fBbltocolor\fR\fBlabel_to_str\fR
\fBbltocolor_r\fR\fBlabel_to_str\fR
\fBbsltoh\fR\fBlabel_to_str\fR
\fBbsltoh_r\fR\fBlabel_to_str\fR
\fBbsltos\fR\fBlabel_to_str\fR
\fBh_alloc\fR\fBlabel_to_str\fR
\fBh_free\fR\fBlabel_to_str\fR
\fBhtobclear\fR\fBstr_to_label\fR
\fBhtobsl\fR\fBstr_to_label\fR
\fBsbcleartos\fR\fBstr_to_label\fR
\fBsbsltos\fR\fBstr_to_label\fR
\fBstobsl\fR\fBstr_to_label\fR
\fBstobclear\fR\fBstr_to_label\fR
.TE

.SH FILES
.sp
.ne 2
.mk
.na
\fB\fB/lib/libtsol.so.2\fR\fR
.ad
.RS 24n
.rt  
shared object
.RE

.sp
.ne 2
.mk
.na
\fB\fB/lib/64/libtsol.so.2\fR\fR
.ad
.RS 24n
.rt  
64-bit shared object
.RE

.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Availabilitysystem/library
_
Interface StabilityT{
See the manual pages for the individual functions.  
T}
_
MT-LevelSafe
.TE

.SH SEE ALSO
.sp
.LP
\fBIntro\fR(3), \fBlibtsnet\fR(3LIB), \fBattributes\fR(5)
.SH NOTES
.sp
.LP
The functionality described on this manual page is available only if the system has been configured with Trusted Extensions.