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(zoneidt zoneid);


     char *getzonerootbylabel(const mlabelt *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  ZONEISREADY. 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 NUL and set errno to indicate the error.

ERORS
     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.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
         ATRIBUTE TYPE               ATRIBUTE 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