getzonerootbyname man page on OpenIndiana

Man page or keyword search:  
man Server   20441 pages
apropos Keyword Search (all sections)
Output format
OpenIndiana logo
[printable version]

getzonerootbyid(3TSOLTrusted Extensions Library Functiongetzonerootbyid(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	 indicate  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)
[top]

List of man pages available for OpenIndiana

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net