Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
getzoneid(3C)		 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 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 attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

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

SunOS 5.10			  1 Nov	2004			 getzoneid(3C)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=getzoneid&sektion=3c&manpath=SunOS+5.10>

home | help