Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ./../../../../../../usr/man/man3c/getzoneid.3c
Real path: /usr/share/man/man3c/getzoneid.3c
Zurück

'\" te .\" Copyright (c) 1998, 2018, Oracle and/or its affiliates. All rights reserved. .TH getzoneid 3C "17 Aug 2018" "Oracle Solaris 11.4" "Standard C Library Functions" .SH NAME getzoneid, getzoneidbyname, getzonenamebyid \- map between zone id and name .SH SYNOPSIS .LP .nf #include <zone.h> \fBzoneid_t\fR \fBgetzoneid\fR(\fBvoid\fR); .fi .LP .nf \fBzoneid_t\fR \fBgetzoneidbyname\fR(\fBconst char *\fR\fIname\fR); .fi .LP .nf \fBssize_t\fR \fBgetzonenamebyid\fR(\fBzoneid_t\fR \fIid\fR, \fBchar *\fR\fIbuf\fR, \fBsize_t\fR \fIbuflen\fR); .fi .SH DESCRIPTION .sp .LP The \fBgetzoneid()\fR function returns the zone ID of the calling process. .sp .LP The \fBgetzoneidbyname()\fR function returns the zone ID corresponding to the named zone, if that zone is currently active. If \fIname\fR is \fINULL\fR, the function returns the zone ID of the calling process. .sp .LP The \fBgetzonenamebyid()\fR function stores the name of the zone with ID specified by \fIid\fR in the location specified by \fIbuf\fR. The \fIbuflen\fR argument specifies the size in bytes of the buffer. If the buffer is too small to hold the complete null-terminated name, the first \fIbuflen\fR bytes of the name are stored in the buffer. A buffer of size {\fBZONENAME_MAX\fR} is sufficient to hold any zone name. If \fIbuf\fR is \fINULL\fR or \fIbuflen\fR is 0, the name is not copied into the buffer. .sp .LP From a \fBsolaris-kz\fR brand zone, the returned ID will be 0, equivalent to a global zone, rather than the ID visible from the host global zone. .SH RETURN VALUES .sp .LP On successful completion, \fBgetzoneid()\fR and \fBgetzoneidbyname()\fR return a non-negative zone ID. Otherwise, \fBgetzoneidbyname()\fR returns \(mi1 and sets \fBerrno\fR to indicate the error. .sp .LP On successful completion, the \fBgetzonenamebyid()\fR function returns the buffer size required to hold the full null-terminated name. Otherwise, it returns \(mi1 and sets \fBerrno\fR to indicate the error. .SH ERRORS .sp .LP The \fBgetzoneidbyname()\fR function will fail if: .sp .ne 2 .mk .na \fB\fBEFAULT\fR\fR .ad .RS 16n .rt The \fIname\fR argument is non-null and points to an illegal address. .RE .sp .ne 2 .mk .na \fB\fBEINVAL\fR\fR .ad .RS 16n .rt A zone with the indicated \fIname\fR is not active. .RE .sp .ne 2 .mk .na \fB\fBENAMETOOLONG\fR\fR .ad .RS 16n .rt The length of the \fIname\fR argument exceeds {\fBZONENAME_MAX\fR}. .RE .sp .LP The \fBgetzonenamebyid()\fR function will fail if: .sp .ne 2 .mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n .rt A zone with the specified ID is not active. .RE .sp .ne 2 .mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n .rt The \fIbuf\fR argument points to an illegal address. .RE .SH ATTRIBUTES .sp .LP See \fBattributes\fR(7) for descriptions of the following attributes: .sp .TS tab( ) box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) . ATTRIBUTE TYPE ATTRIBUTE VALUE _ Interface Stability Committed _ MT-Level Safe .TE .sp .SH SEE ALSO .sp .LP \fBchroot\fR(2), \fBIntro\fR(2), \fBmalloc\fR(3C), \fBattributes\fR(7), \fBzones\fR(7)