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(7) 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(7),
zones(7) November 1, 2004
GETZONEID(3C)