Manual Pages for UNIX Operating System command usage for man getzonerootbyname

Trusted Extensions Library Functions       getzonerootbyid(3TSOL)



NAME
     getzonerootbyid, getzonerootbylabel, getzonerootbyname - map
     between zone root pathnames and labels

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


     #include 

     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 caller's zone.

RETURN VALUES
     On  successful  completion,  the  getzonerootbyid(),  getzo-
     nerootbylabel(),  and getzonerootbyname() functions return a
     pointer to a pathname that is allocated within  these  func-
     tions.  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.






SunOS 5.11          Last change: 20 Jul 2007                    1






Trusted Extensions Library Functions       getzonerootbyid(3TSOL)



     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  attri-
     butes:



     ____________________________________________________________
    |     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          Last change: 20 Jul 2007                    2