summaryrefslogtreecommitdiff
path: root/usr/src/man/man1m/zonecfg.1m
diff options
context:
space:
mode:
Diffstat (limited to 'usr/src/man/man1m/zonecfg.1m')
-rw-r--r--usr/src/man/man1m/zonecfg.1m148
1 files changed, 40 insertions, 108 deletions
diff --git a/usr/src/man/man1m/zonecfg.1m b/usr/src/man/man1m/zonecfg.1m
index 1fd52ec5bc..313f25a051 100644
--- a/usr/src/man/man1m/zonecfg.1m
+++ b/usr/src/man/man1m/zonecfg.1m
@@ -4,7 +4,7 @@
.\" 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. 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. 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]
-.TH zonecfg 1M "8 March 2011" "SunOS 5.11" "System Administration Commands"
+.TH ZONECFG 1M "Jul 29, 2009"
.SH NAME
zonecfg \- set up zone configuration
.SH SYNOPSIS
@@ -77,7 +77,6 @@ man page.
The following resource types are supported:
.sp
.ne 2
-.mk
.na
\fB\fBattr\fR\fR
.ad
@@ -88,7 +87,6 @@ Generic attribute.
.sp
.ne 2
-.mk
.na
\fB\fBcapped-cpu\fR\fR
.ad
@@ -99,7 +97,6 @@ Limits for CPU usage.
.sp
.ne 2
-.mk
.na
\fB\fBcapped-memory\fR\fR
.ad
@@ -110,7 +107,6 @@ Limits for physical, swap, and locked memory.
.sp
.ne 2
-.mk
.na
\fB\fBdataset\fR\fR
.ad
@@ -121,7 +117,6 @@ Limits for physical, swap, and locked memory.
.sp
.ne 2
-.mk
.na
\fB\fBdedicated-cpu\fR\fR
.ad
@@ -132,7 +127,6 @@ Subset of the system's processors dedicated to this zone while it is running.
.sp
.ne 2
-.mk
.na
\fB\fBdevice\fR\fR
.ad
@@ -143,7 +137,6 @@ Device.
.sp
.ne 2
-.mk
.na
\fB\fBfs\fR\fR
.ad
@@ -154,7 +147,21 @@ file-system
.sp
.ne 2
-.mk
+.na
+\fB\fBinherit-pkg-dir\fR\fR
+.ad
+.sp .6
+.RS 4n
+Directory inherited from the global zone. Used for sparse root zones (see the
+discussion of "Sparse and Whole Root Non-Global Zones," below). Software
+packages whose contents have been transferred into that directory are inherited
+in read-only mode by the non-global zone and the non-global zone's packaging
+database is updated to reflect those packages. Such resources are not
+modifiable or removable once a zone has been installed with \fBzoneadm\fR.
+.RE
+
+.sp
+.ne 2
.na
\fB\fBnet\fR\fR
.ad
@@ -165,7 +172,6 @@ Network interface.
.sp
.ne 2
-.mk
.na
\fB\fBrctl\fR\fR
.ad
@@ -186,7 +192,6 @@ some particular resource.
The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB(global)\fR
.ad
@@ -197,7 +202,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB(global)\fR
.ad
@@ -208,7 +212,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB(global)\fR
.ad
@@ -219,7 +222,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB(global)\fR
.ad
@@ -230,7 +232,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB(global)\fR
.ad
@@ -241,7 +242,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB(global)\fR
.ad
@@ -252,7 +252,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB(global)\fR
.ad
@@ -263,7 +262,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB(global)\fR
.ad
@@ -274,7 +272,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB(global)\fR
.ad
@@ -285,7 +282,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB(global)\fR
.ad
@@ -296,7 +292,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB(global)\fR
.ad
@@ -307,7 +302,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB(global)\fR
.ad
@@ -318,7 +312,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB(global)\fR
.ad
@@ -329,7 +322,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB(global)\fR
.ad
@@ -340,7 +332,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB(global)\fR
.ad
@@ -351,7 +342,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB(global)\fR
.ad
@@ -362,7 +352,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB(global)\fR
.ad
@@ -384,7 +373,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB\fBnet\fR\fR
.ad
@@ -395,7 +383,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB\fBdevice\fR\fR
.ad
@@ -406,7 +393,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB\fBrctl\fR\fR
.ad
@@ -417,7 +403,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB\fBattr\fR\fR
.ad
@@ -428,7 +413,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB\fBdataset\fR\fR
.ad
@@ -439,7 +423,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB\fBdedicated-cpu\fR\fR
.ad
@@ -450,7 +433,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB\fBcapped-memory\fR\fR
.ad
@@ -461,7 +443,6 @@ The following properties are supported:
.sp
.ne 2
-.mk
.na
\fB\fBcapped-cpu\fR\fR
.ad
@@ -511,7 +492,6 @@ specified in \fBfnmatch\fR(5). See \fBEXAMPLES\fR.
The property types are described as follows:
.sp
.ne 2
-.mk
.na
\fBglobal: \fBzonename\fR\fR
.ad
@@ -522,7 +502,6 @@ The name of the zone.
.sp
.ne 2
-.mk
.na
\fBglobal: \fBzonepath\fR\fR
.ad
@@ -533,7 +512,6 @@ Path to zone's file system.
.sp
.ne 2
-.mk
.na
\fBglobal: \fBautoboot\fR\fR
.ad
@@ -557,7 +535,6 @@ Replace \fBenable\fR with \fBdisable\fR to disable the zones service. See
.sp
.ne 2
-.mk
.na
\fBglobal: \fBbootargs\fR\fR
.ad
@@ -570,7 +547,6 @@ precedence. The valid arguments are described in \fBzoneadm\fR(1M).
.sp
.ne 2
-.mk
.na
\fBglobal: \fBpool\fR\fR
.ad
@@ -582,7 +558,6 @@ property is incompatible with the \fBdedicated-cpu\fR resource.
.sp
.ne 2
-.mk
.na
\fBglobal: \fBlimitpriv\fR\fR
.ad
@@ -617,7 +592,6 @@ would specify it in this property, is listed in \fBprivileges\fR(5) as
.sp
.ne 2
-.mk
.na
\fBglobal: \fBbrand\fR\fR
.ad
@@ -628,7 +602,6 @@ The zone's brand type.
.sp
.ne 2
-.mk
.na
\fBglobal: \fBip-type\fR\fR
.ad
@@ -642,7 +615,6 @@ This property takes the values \fBshared\fR and \fBexclusive\fR.
.sp
.ne 2
-.mk
.na
\fBglobal: \fBhostid\fR\fR
.ad
@@ -657,7 +629,6 @@ uppercase and lowercase hexadecimal digits are acceptable.
.sp
.ne 2
-.mk
.na
\fB\fBfs\fR: dir, special, raw, type, options\fR
.ad
@@ -669,7 +640,16 @@ Values needed to determine how, where, and so forth to mount file systems. See
.sp
.ne 2
-.mk
+.na
+\fB\fBinherit-pkg-dir\fR: dir\fR
+.ad
+.sp .6
+.RS 4n
+The directory path.
+.RE
+
+.sp
+.ne 2
.na
\fB\fBnet\fR: address, allowed-address, defrouter, global-nic, mac-addr, physical, property, vlan-id\fR
.ad
@@ -720,7 +700,6 @@ default router properties cannot be set.
.sp
.ne 2
-.mk
.na
\fB\fBdevice\fR: match\fR
.ad
@@ -731,7 +710,6 @@ Device name to match.
.sp
.ne 2
-.mk
.na
\fB\fBrctl\fR: name, value\fR
.ad
@@ -744,7 +722,6 @@ is to use the global property name associated with a specific rctl.
.sp
.ne 2
-.mk
.na
\fB\fBattr\fR: name, type, value\fR
.ad
@@ -757,7 +734,6 @@ that type. \fBuint\fR means unsigned , that is, a non-negative integer.
.sp
.ne 2
-.mk
.na
\fB\fBdataset\fR: name\fR
.ad
@@ -769,7 +745,6 @@ The name of a \fBZFS\fR dataset to be accessed from within the zone. See
.sp
.ne 2
-.mk
.na
\fBglobal: \fBcpu-shares\fR\fR
.ad
@@ -782,7 +757,6 @@ is the preferred way to set the \fBzone.cpu-shares\fR rctl.
.sp
.ne 2
-.mk
.na
\fBglobal: \fBmax-lwps\fR\fR
.ad
@@ -794,7 +768,6 @@ is the preferred way to set the \fBzone.max-lwps\fR rctl.
.sp
.ne 2
-.mk
.na
\fBglobal: \fBmax-msg-ids\fR\fR
.ad
@@ -806,7 +779,6 @@ the preferred way to set the \fBzone.max-msg-ids\fR rctl.
.sp
.ne 2
-.mk
.na
\fBglobal: \fBmax-sem-ids\fR\fR
.ad
@@ -818,7 +790,6 @@ preferred way to set the \fBzone.max-sem-ids\fR rctl.
.sp
.ne 2
-.mk
.na
\fBglobal: \fBmax-shm-ids\fR\fR
.ad
@@ -830,7 +801,6 @@ the preferred way to set the \fBzone.max-shm-ids\fR rctl.
.sp
.ne 2
-.mk
.na
\fBglobal: \fBmax-shm-memory\fR\fR
.ad
@@ -843,7 +813,6 @@ can be applied to the value for this number (for example, 1M is one megabyte).
.sp
.ne 2
-.mk
.na
\fBglobal: \fBscheduling-class\fR\fR
.ad
@@ -876,7 +845,6 @@ Under any other conditions, the system default scheduling class is used.
.sp
.ne 2
-.mk
.na
\fB\fBdedicated-cpu\fR: ncpus, importance\fR
.ad
@@ -897,7 +865,6 @@ single instance of this resource can be added to the zone.
.sp
.ne 2
-.mk
.na
\fB\fBcapped-memory\fR: physical, swap, locked\fR
.ad
@@ -916,7 +883,6 @@ rctl. The \fBlocked\fR property is the preferred way to set the
.sp
.ne 2
-.mk
.na
\fB\fBcapped-cpu\fR: ncpus\fR
.ad
@@ -1060,7 +1026,6 @@ that zone and for projects in that zone. See \fBEXAMPLES\fR.
The following are cap-related arguments for use with \fBkstat\fR(1M):
.sp
.ne 2
-.mk
.na
\fB\fBcaps\fR\fR
.ad
@@ -1071,7 +1036,6 @@ The \fBkstat\fR module.
.sp
.ne 2
-.mk
.na
\fB\fBproject_caps\fR or \fBzone_caps\fR\fR
.ad
@@ -1082,7 +1046,6 @@ The \fBkstat\fR module.
.sp
.ne 2
-.mk
.na
\fB\fBcpucaps_project_\fR\fIid\fR or \fBcpucaps_zone_\fR\fIid\fR\fR
.ad
@@ -1098,7 +1061,6 @@ The following fields are displayed in response to a \fBkstat\fR(1M) command
requesting statistics for all CPU caps.
.sp
.ne 2
-.mk
.na
\fB\fBmodule\fR\fR
.ad
@@ -1109,7 +1071,6 @@ In this usage of \fBkstat\fR, this field will have the value \fBcaps\fR.
.sp
.ne 2
-.mk
.na
\fB\fBname\fR\fR
.ad
@@ -1121,7 +1082,6 @@ As described above, \fBcpucaps_project_\fR\fIid\fR or
.sp
.ne 2
-.mk
.na
\fB\fBabove_sec\fR\fR
.ad
@@ -1132,7 +1092,6 @@ Total time, in seconds, spent above the cap.
.sp
.ne 2
-.mk
.na
\fB\fBbelow_sec\fR\fR
.ad
@@ -1143,7 +1102,6 @@ Total time, in seconds, spent below the cap.
.sp
.ne 2
-.mk
.na
\fB\fBmaxusage\fR\fR
.ad
@@ -1154,7 +1112,6 @@ Maximum observed CPU usage.
.sp
.ne 2
-.mk
.na
\fB\fBnwait\fR\fR
.ad
@@ -1165,7 +1122,6 @@ Number of threads on cap wait queue.
.sp
.ne 2
-.mk
.na
\fB\fBusage\fR\fR
.ad
@@ -1177,7 +1133,6 @@ zone, in terms of a percentage of a single CPU.
.sp
.ne 2
-.mk
.na
\fB\fBvalue\fR\fR
.ad
@@ -1188,7 +1143,6 @@ The cap value, in terms of a percentage of a single CPU.
.sp
.ne 2
-.mk
.na
\fB\fBzonename\fR\fR
.ad
@@ -1206,7 +1160,6 @@ See \fBEXAMPLES\fR for sample output from a \fBkstat\fR command.
The following options are supported:
.sp
.ne 2
-.mk
.na
\fB\fB-f\fR \fIcommand_file\fR\fR
.ad
@@ -1218,7 +1171,6 @@ file of \fBzonecfg\fR subcommands, one per line.
.sp
.ne 2
-.mk
.na
\fB\fB-z\fR \fIzonename\fR\fR
.ad
@@ -1263,7 +1215,6 @@ error.
The following subcommands are supported:
.sp
.ne 2
-.mk
.na
\fB\fBadd\fR \fIresource-type\fR (global scope)\fR
.ad
@@ -1284,7 +1235,6 @@ brackets, separated by commas (\fB[foo,bar,baz]\fR). See \fBPROPERTIES\fR.
.sp
.ne 2
-.mk
.na
\fB\fBcancel\fR\fR
.ad
@@ -1297,7 +1247,6 @@ scope.
.sp
.ne 2
-.mk
.na
\fB\fBclear\fR \fIproperty-name\fR\fR
.ad
@@ -1308,7 +1257,6 @@ Clear the value for the property.
.sp
.ne 2
-.mk
.na
\fB\fBcommit\fR\fR
.ad
@@ -1324,7 +1272,6 @@ correct to be committed, this operation automatically does a verify.
.sp
.ne 2
-.mk
.na
\fB\fBcreate [\fR\fB-F\fR\fB] [\fR \fB-a\fR \fIpath\fR |\fB-b\fR \fB|\fR \fB-t\fR \fItemplate\fR\fB] [\fR\fB-X\fR\fB]\fR\fR
.ad
@@ -1354,7 +1301,6 @@ Use the \fB-X\fR option to facilitate creating a zone whose XML definition alrea
.sp
.ne 2
-.mk
.na
\fB\fBdelete [\fR\fB-F\fR\fB]\fR\fR
.ad
@@ -1369,7 +1315,6 @@ Specify the \fB-F\fR option to force the action.
.sp
.ne 2
-.mk
.na
\fB\fBend\fR\fR
.ad
@@ -1385,7 +1330,6 @@ message.
.sp
.ne 2
-.mk
.na
\fB\fBexport [\fR\fB-f\fR \fIoutput-file\fR\fB]\fR\fR
.ad
@@ -1398,7 +1342,6 @@ suitable for use in a command file.
.sp
.ne 2
-.mk
.na
\fB\fBhelp [usage] [\fIsubcommand\fR] [syntax] [\fR\fIcommand-name\fR\fB]\fR\fR
.ad
@@ -1409,7 +1352,6 @@ Print general help or help about given topic.
.sp
.ne 2
-.mk
.na
\fB\fBinfo zonename | zonepath | autoboot | brand | pool | limitpriv\fR\fR
.ad
@@ -1430,7 +1372,6 @@ which is currently being added or modified.
.sp
.ne 2
-.mk
.na
\fB\fBremove\fR \fIresource-type\fR\fB{\fR\fIproperty-name\fR\fB=\fR\fIproperty
-value\fR\fB}\fR(global scope)\fR
@@ -1448,7 +1389,6 @@ option.
.sp
.ne 2
-.mk
.na
\fB\fBselect\fR \fIresource-type\fR
\fB{\fR\fIproperty-name\fR\fB=\fR\fIproperty-value\fR\fB}\fR\fR
@@ -1465,7 +1405,6 @@ for the resource to be uniquely identified.
.sp
.ne 2
-.mk
.na
\fB\fBset\fR \fIproperty-name\fR\fB=\fR\fIproperty\fR\fB-\fR\fIvalue\fR\fR
.ad
@@ -1479,7 +1418,6 @@ resource scopes.
.sp
.ne 2
-.mk
.na
\fB\fBverify\fR\fR
.ad
@@ -1502,7 +1440,6 @@ A \fBzonepath\fR is specified.
.sp
.ne 2
-.mk
.na
\fB\fBrevert\fR \fB[\fR\fB-F\fR\fB]\fR\fR
.ad
@@ -1514,7 +1451,6 @@ can be used to force the action.
.sp
.ne 2
-.mk
.na
\fB\fBexit [\fR\fB-F\fR\fB]\fR\fR
.ad
@@ -1796,7 +1732,7 @@ The following command displays information about all CPU caps.
.in +2
.nf
# \fBkstat -n /cpucaps/\fR
-module: caps instance: 0
+module: caps instance: 0
name: cpucaps_project_0 class: project_caps
above_sec 0
below_sec 2157
@@ -1808,7 +1744,7 @@ name: cpucaps_project_0 class: project_caps
value 18446743151372347932
zonename global
-module: caps instance: 0
+module: caps instance: 0
name: cpucaps_project_1 class: project_caps
above_sec 0
below_sec 0
@@ -1820,7 +1756,7 @@ name: cpucaps_project_1 class: project_caps
value 18446743151372347932
zonename global
-module: caps instance: 0
+module: caps instance: 0
name: cpucaps_project_201 class: project_caps
above_sec 0
below_sec 235105
@@ -1832,7 +1768,7 @@ name: cpucaps_project_201 class: project_caps
value 100
zonename global
-module: caps instance: 0
+module: caps instance: 0
name: cpucaps_project_202 class: project_caps
above_sec 0
below_sec 235094
@@ -1844,7 +1780,7 @@ name: cpucaps_project_202 class: project_caps
value 100
zonename global
-module: caps instance: 0
+module: caps instance: 0
name: cpucaps_project_203 class: project_caps
above_sec 0
below_sec 235034
@@ -1856,7 +1792,7 @@ name: cpucaps_project_203 class: project_caps
value 100
zonename global
-module: caps instance: 0
+module: caps instance: 0
name: cpucaps_project_86710 class: project_caps
above_sec 22
below_sec 235166
@@ -1868,7 +1804,7 @@ name: cpucaps_project_86710 class: project_caps
value 100
zonename global
-module: caps instance: 0
+module: caps instance: 0
name: cpucaps_zone_0 class: zone_caps
above_sec 100733
below_sec 134332
@@ -1880,7 +1816,7 @@ name: cpucaps_zone_0 class: zone_caps
value 200
zonename global
-module: caps instance: 1
+module: caps instance: 1
name: cpucaps_project_0 class: project_caps
above_sec 0
below_sec 0
@@ -1892,7 +1828,7 @@ name: cpucaps_project_0 class: project_caps
value 18446743151372347932
zonename test_001
-module: caps instance: 1
+module: caps instance: 1
name: cpucaps_zone_1 class: zone_caps
above_sec 2
below_sec 10524
@@ -1931,7 +1867,6 @@ for a specific project, the second for the same project within zone 1.
The following exit values are returned:
.sp
.ne 2
-.mk
.na
\fB\fB0\fR\fR
.ad
@@ -1942,7 +1877,6 @@ Successful completion.
.sp
.ne 2
-.mk
.na
\fB\fB1\fR\fR
.ad
@@ -1953,7 +1887,6 @@ An error occurred.
.sp
.ne 2
-.mk
.na
\fB\fB2\fR\fR
.ad
@@ -1970,13 +1903,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
.TS
-tab() box;
-cw(2.75i) |cw(2.75i)
-lw(2.75i) |lw(2.75i)
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
+box;
+c | c
+l | l .
+ATTRIBUTE TYPE ATTRIBUTE VALUE
_
-Interface StabilityVolatile
+Interface Stability Volatile
.TE
.SH SEE ALSO
generated by cgit v1.2.3 (git 2.39.1) at 2025-06-21 17:58:43 +0000