getzoneid man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

GETZONEID(3C)							 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)

				  Nov 1, 2004			 GETZONEID(3C)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net