usr/src/man/man1/getzonepath.1

   1 '\" te
   2 .\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH GETZONEPATH 1 "Jul 20, 2007"
   7 .SH NAME
   8 getzonepath \- display root path of the zone corresponding to the specified
   9 label
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fB/usr/bin/getzonepath\fR  {\fIsensitivity-label\fR}
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 \fBgetzonepath\fR displays the root pathname of the running labeled zone that
  20 corresponds to the specified sensitivity label. The returned pathname is
  21 relative to the caller's root pathname, and has the specified sensitivity
  22 label.
  23 .sp
  24 .LP
  25 If the caller is in the global zone, the returned pathname is not traversable
  26 unless the caller's processes have the \fBfile_dac_search\fR privilege.
  27 .sp
  28 .LP
  29 If the caller is in a labeled zone, the caller's label must dominate the
  30 specified label. Access to files under the returned pathname is restricted to
  31 read-only operations.
  32 .SH ATTRIBUTES
  33 .sp
  34 .LP
  35 See \fBattributes\fR(5) for descriptions of the following attributes:
  36 .sp
  37
  38 .sp
  39 .TS
  40 box;
  41 c | c
  42 l | l .
  43 ATTRIBUTE TYPE  ATTRIBUTE VALUE
  44 _
  45 Stability       Committed
  46 .TE
  47
  48 .SH DIAGNOSTICS
  49 .sp
  50 .LP
  51 \fBgetzonepath\fR exits with one of the following values:
  52 .sp
  53 .ne 2
  54 .na
  55 \fB\fB0\fR\fR
  56 .ad
  57 .RS 5n
  58 Success
  59 .RE
  60
  61 .sp
  62 .ne 2
  63 .na
  64 \fB\fB1\fR\fR
  65 .ad
  66 .RS 5n
  67 Usage error
  68 .RE
  69
  70 .sp
  71 .ne 2
  72 .na
  73 \fB\fB2\fR\fR
  74 .ad
  75 .RS 5n
  76 Failure; error message is the system error number from
  77 \fBgetzonerootbylabel\fR(3TSOL)
  78 .RE
  79
  80 .SH SEE ALSO
  81 .sp
  82 .LP
  83 \fBgetzonerootbylabel\fR(3TSOL), \fBattributes\fR(5)
  84 .sp
  85 .LP
  86 \fIAcquiring a Sensitivity Label\fR in \fISolaris Trusted Extensions
  87 Developer\&'s Guide\fR
  88 .SH NOTES
  89 .sp
  90 .LP
  91 The functionality described on this manual page is available only if the system
  92 is configured with Trusted Extensions.