Manual Pages for UNIX Operating System command usage for man getzoneidbylabel

Trusted Extensions Library Functions      getzonelabelbyid(3TSOL)



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

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


     #include 

     m_label_t *getzonelabelbyid(zoneid_t zoneid);


     m_label_t *getzonelabelbyname(const char *zonename);


     zoneid_t *getzoneidbylabel(const m_label_t *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  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.

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  m_label_free(3TSOL).  If  the  zone  does not
     exist, NULL 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.

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


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