getzonerootbyid(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)

getpathbylabel(3TSOL)				       Trusted Extensions Library Functions				     getpathbylabel(3TSOL)

NAME

       getpathbylabel - return the zone pathname

SYNOPSIS

       cc [flags...] file... -ltsol [library...]

       #include <tsol/label.h>

       char *getpathbylabel(const char *path, char *resolved_path,
	    size_t bufsize, const m_label_t *sl);

DESCRIPTION

       The  getpathbylabel()  function	expands  all symbolic links and resolves references to '/./', '/../', extra '/' characters, and stores the
       zone pathname in the buffer named by resolved_path. The bufsize argument specifies the size in bytes of this  buffer.  The  resulting  path
       will have no symbolic links components, nor any '/./', '/../'. This function can only be called from the global zone.

       The zone pathname is relative to the sensitivity label sl. To specify a sensitivity label for a zone name which does not exist, the process
       must assert either the PRIV_FILE_UPGRADE_SL or PRIV_FILE_DOWNGRADE_SL privilege depending on whether the specified sensitivity label  domi-
       nates or does not dominate the process sensitivity label.

RETURN VALUES

       The  getpathbylabel()  function returns a pointer to the resolved_path on success. Otherwise it returns NULL and sets errno to indicate the
       error.

ERRORS

       The getpathbylabel() function will fail if:

       EACCES	       Search permission is denied for a component of the path prefix of path.

       EFAULT	       resolved_path extends outside the process's allocated address space or beyond bufsize bytes.

       EINVAL	       path or resolved_path was NULL, current zone is not the global zone, or sl is invalid.

       EIO	       An I/O error occurred while reading from or writing to the file system.

       ELOOP	       Too many symbolic links were encountered in translating path.

       ENAMETOOLONG    The length of the path argument exceeds PATH_MAX, or a pathname component is longer than NAME_MAX (see  sysconf(3C))  while
		       _POSIX_NO_TRUNC is in effect (see pathconf(2)).

       ENOENT	       The named file does not exist.

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Committed 		   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       readlink(2), getzonerootbyid(3TSOL), libtsol(3LIB), attributes(5), labels(5)

WARNINGS

       The getpathbylabel() function indirectly invokes the readlink(2) system call, and hence inherits the possibility of hanging due to inacces-
       sible file system resources.

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 					     getpathbylabel(3TSOL)