Reformatting page.  Please Wait... done


Standard C Library Functions                        GETZONEID(3C)


NAME
     getzoneid, getzoneidbyname, getzonenamebyid -   map  between
     zone id and name

SYNOPSIS
     #include <zone.h>

     zoneid_t getzoneid(void);


     zoneid_t getzoneidbyname(const char *name);


     ssize_t getzonenamebyid(zoneid_t id, char *buf, size_t buflen);


DESCRIPTION
     The getzoneid() function returns the zone ID of the  calling
     process.


     The  getzoneidbyname()  function   returns   the   zone   ID
     corresponding  to  the named zone, if that zone is currently
     active. If name is NULL, the function returns the zone ID of
     the calling process.


     The getzonenamebyid() function stores the name of  the  zone
     with  ID  specified  by id in the location specified by buf.
     The bufsize argument specifies the  size  in  bytes  of  the
     buffer.  If  the  buffer  is  too small to hold the complete
     null-terminated name, the first bufsize bytes  of  the  name
     are stored in the buffer. A buffer of size {ZONENAME_MAX} is
     sufficient to hold any zone name. If buf is NULL or  bufsize
     is 0, the name is not copied into the buffer.

RETURN VALUES
     On successful completion, getzoneid() and  getzoneidbyname()
     return  a non-negative zone ID. Otherwise, getzoneidbyname()
     returns -1 and sets errno to indicate the error.


     On successful  completion,  the  getzonenamebyid()  function
     returns  the  buffer  size  required  to hold the full null-
     terminated name. Otherwise, it returns -1 and sets errno  to
     indicate the error.

ERRORS
     The getzoneidbyname() function will fail if:

     EFAULT
                     The name argument is non-null and points  to


Illumos             Last change: Nov 1, 2004                    1


Standard C Library Functions                        GETZONEID(3C)


                     an illegal address.


     EINVAL
                     A  zone  with  the  indicated  name  is  not
                     active.


     ENAMETOOLONG
                     The length  of  the  name  argument  exceeds
                     {ZONENAME_MAX}.


     The getzonenamebyid() function will fail if:

     EINVAL
               A zone with the specified ID is not active.


     EFAULT
               The buf argument points to an illegal address.


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


     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|_________________|
    | Interface Stability|  Evolving       |
    |____________________|_________________|
    | MT-Level           |  Safe           |
    |____________________|_________________|


SEE ALSO
     Intro(2)chroot(2)malloc(3C)attributes(5)zones(5)


Illumos             Last change: Nov 1, 2004                    2