getzonerootbylabel(3tsol) [opensolaris man page]
getzonerootbyid(3TSOL) Trusted Extensions Library Functions getzonerootbyid(3TSOL) NAME
getzonerootbyid, getzonerootbylabel, getzonerootbyname - map between zone root pathnames and labels SYNOPSIS
cc [flags...] file... -ltsol [library...] #include <tsol/label.h> char *getzonerootbyid(zoneid_t zoneid); char *getzonerootbylabel(const m_label_t *label); char *getzonerootbyname(const char *zonename); DESCRIPTION
The getzonerootbyid() function returns the root pathname of zoneid. The getzonerootbylabel() function returns the root pathname of the zone whose label is label. The getzonerootbyname() function returns the root pathname of zonename. All of these functions require that the specified zone's state is at least ZONE_IS_READY. The zone of the calling process must dominate the specified zone's label, or the calling process must be in the global zone. The returned pathname is relative to the root path of the call- er's zone. RETURN VALUES
On successful completion, the getzonerootbyid(), getzonerootbylabel(), and getzonerootbyname() functions return a pointer to a pathname that is allocated within these functions. To free the storage, use free(3C). On failure, these functions return NULL and set errno to indi- cate the error. ERRORS
These functions will fail if: EFAULT Invalid argument; pointer location is invalid. EINVAL zoneid invalid, or zone not found or not ready. ENOENT Zone does not exist. ENOMEM Unable to allocate pathname. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------+-----------------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------+-----------------------------------+ |Interface Stability | Committed | +-----------------------+-----------------------------------+ |MT-Level | Safe | +-----------------------+-----------------------------------+ SEE ALSO
Intro(2), free(3C), getzonenamebyid(3C), 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 getzonerootbyid(3TSOL)
Check Out this Related Man Page
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)