Trusted Extensions Library Functions      getzonelabelbyid(3TSOL)



NAME
     getzonelabelbyid, getzonelabelbyname, getzoneidbylabel - map
     between zones and labels

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


     #include 

     mlabelt *getzonelabelbyid(zoneidt zoneid);


     mlabelt *getzonelabelbyname(const char *zonename);


     zoneidt *getzoneidbylabel(const mlabelt *label);


DESCRIPTION
     The getzonelabelbyid() function returns the mandatory access
     control (MAC) label of zoneid.


     The getzonelabelbyname() function returns the MAC  label  of
     the zone whose name is zonename.


     The getzoneidbylabel() function returns the zone ID  of  the
     zone whose label is label.


     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.

RETURN VALUES
     On successful completion, the getzonelabelbyid() and  getzo-
     nelabelbyname()  functions return a pointer to a sensitivity
     label that is allocated within these functions. To free  the
     storage,  use  mlabelfree(3TSOL).  If  the  zone  does not
     exist, NUL is returned.


     On successful completion,  the  getzoneidbylabel()  function
     returns  the zone ID with the matching label. If there is no
     matching zone, the function returns -1.

ERORS
     The getzonelabelbyid()  and  getzonelabelbyname()  functions
     will fail if:



SunOS 5.11          Last change: 20 Jul 2007                    1






Trusted Extensions Library Functions      getzonelabelbyid(3TSOL)



     ENOENT    The specified zone does not exist.



     The getzonelabelbyid() function will fail if:

     ENOENT    No zone corresponds to the specified label.


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),     getzonenamebyid(3C),      getzoneidbyname(3C),
     libtsol(3LIB), mlabelfree(3TSOL), 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