Commands Used on a System With Zones Installed

Language:

The commands identified in Table 10–3 provide the primary administrative interface to the zones facility.

Table 10-3 Commands Used to Administer and Monitor Zones

Command Reference	Description
`zlogin`(1)	Log in to a non-global zone
`zonename`(1)	Prints the name of the current zone
`zonestat`(1)	Used to observe zone resource usage.
`zoneadm`(1M)	Administers zones on a system
`zonecfg`(1M)	Used to set up a zone configuration
`getzoneid`(3C)	Used to map between zone ID and name
`zones`(5)	Provides description of zones facility
`zcons`(7D)	Zone console device driver

The zoneadmd daemon is the primary process for managing the zone's virtual platform. The man page for the zoneadmd daemon is zoneadmd(1M). The daemon does not constitute a programming interface.

The commands in the next table are used with the resource capping daemon.

Table 10-4 Commands Used With rcapd

Command Reference	Description
`rcapstat`(1)	Monitors the resource utilization of capped projects.
`rcapadm`(1M)	Configures the resource capping daemon, displays the current status of the resource capping daemon if it has been configured, and enables or disables resource capping
`rcapd`(1M)	The resource capping daemon.

The commands identified in the following table have been modified for use on an Oracle Solaris system with zones installed. These commands have options that are specific to zones or present information differently. The commands are listed by man page section.

Table 10-5 Commands Modified for Use on an Oracle Solaris System With Zones Installed

Command Reference	Description
`ipcrm`(1)	Added `–z` `zone` option. This option is only useful when the command is executed in the global zone.
`ipcs`(1)	Added `–z` `zone` option. This option is only useful when the command is executed in the global zone.
`pgrep`(1)	Added `–z` `zoneidlist` option. This option is only useful when the command is executed in the global zone.
`ppriv`(1)	Added the expression `zone` for use with the `–l` option to list all privileges available in the current zone. Also use the option `–v` after `zone` to obtain verbose output.
`priocntl`(1)	Zone ID can be used in `idlist` and `–i` `idtype` to specify processes. You can use the `priocntl` `–i` `zoneid` command to move running processes into a different scheduling class in a non-global zone.
`proc`(1)	Added `–z` `zone` option to `ptree` only. This option is only useful when the command is executed in the global zone.
`ps`(1)	Added `zonename` and `zoneid` to list of recognized `format` names used with the `–o` option. Added `–z` `zonelist` to list only processes in the specified zones. Zones can be specified either by zone name or by zone ID. This option is only useful when the command is executed in the global zone. Added `–Z` to print the name of the zone associated with the process. The name is printed under an additional column header, `ZONE`.
`renice`(1)	Added `zoneid` to list of valid arguments used with the `–i` option.
`sar`(1)	If executed in a non-global zone in which the pools facility is enabled, the `–b`, `–c` `–g`, `–m`, `–p`, `–u`, `–w`, and `–y` options display values only for processors that are in the processor set of the pool to which the zone is bound.
`auditconfig`(1M)	Added `zonename` token.
`auditreduce`(1M)	Added `–z` `zone-name` option. Added ability to get an audit log of a zone.
`coreadm`(1M)	Added variable `%z` to identify the zone in which process executed.
`df`(1M)	Added `–Z` option to display mounts in all visible zones. This option has no effect in a non-global zone.
`dladm`(1M)	Added `–Z` option to `show` subcommands, which adds a zone column to the default command output. The zone column indicates the zone to which the resource is currently assigned.
`dlstat`(1M)	Added `–Z` option to `show` subcommands, which adds a zone column to the default command output. The zone column indicates the zone to which the resource is currently assigned.
`fsstat`(1M)	Added `–z` option to report on file system activity per zone. Multiple `–z` options can be used to monitor activity in selected zones. The option has no effect if only used to monitor `mountpoints` and not `fstypes`. Added `–A` option to report aggregate file system activity for the specified `fstypes` across all zones. This is the default behavior if neither `–z` or the `–Z` option is used. The `–A` option has no effect if only used to monitor `mountpoints` and not `fstypes`. When used with either the `–z` or the `–Z` option, the `–A` option displays the aggregate for the specified `fstypes` across all zones on a separate line. Added `–Z` option to report file system activity in all zones on the system. This option has no effect if used with `–z` option. The option has no effect if only used to monitor `mountpoints` and not `fstypes`.
`iostat`(1M)	If executed in a non-global zone in which the pools facility is enabled, information is provided only for those processors that are in the processor set of the pool to which the zone is bound.
`ipadm`(1M)	Configure Internet Protocol network interfaces and TCP/IP tunables. The `from-gz` type is only displayed in non-global zones, and indicates that the address was configured based on the `allowed-address` property configured for the non-global exclusive-IP zone from the global zone. The `zone` address property specifies the zone in which all the addresses referenced by `allowed-address` should be placed. The zone must be configured as a shared-IP zone.
`kstat`(1M)	If executed in the global zone, `kstat`s are displayed for all zones. If executed in a non-global zone, only `kstat`s with a matching `zoneid` are displayed.
`mpstat`(1M)	If executed in a non-global zone in which the pools facility is enabled, command only displays lines for the processors that are in the processor set of the pool to which the zone is bound.
`ndd`(1M)	When used in the global zone, displays information for all zones. `ndd` on the TCP/IP modules in an exclusive-IP zone only displays information for that zone.
`netstat`(1M)	Displays information for the current zone only.
`nfsstat`(1M)	Displays statistics for the current zone only.
`poolbind`(1M)	Added `zoneid` list. Also see Resource Pools Used in Zones in Administering Resource Management in Oracle Solaris 11.2 for information about using zones with resource pools.
`prstat`(1M)	Added `–z` `zoneidlist` option. Also added `–Z` option. If executed in a non-global zone in which the pools facility is enabled, the percentage of recent CPU time used by the process is displayed only for the processors in the processor set of the pool to which the zone is bound. Output of the `–a`, `–t`, `–T`, `–J`, and `–Z` options displays a SWAP instead of a SIZE column. The swap reported is the total swap consumed by the zone's processes and `tmpfs` mounts. This value assists in monitoring the swap reserved by each zone, which can be used to choose a reasonable `zone.max-swap` setting.
`psrinfo`(1M)	If executed in a non-global zone, only information about the processors visible to the zone is displayed.
`traceroute`(1M)	Usage change. When specified from within a non-global zone, the `–F` option has no effect because the “don't fragment” bit is always set.
`vmstat`(1M)	When executed in a non-global zone in which the pools facility is enabled, statistics are reported only for the processors in the processor set of the pool to which the zone is bound. Applies to output from the `–p` option and the `page`, `faults`, and `cpu` report fields.
`priocntl`(2)	Added `P_ZONEID` `id` argument.
`processor_info`(2)	If the caller is in a non-global zone and the pools facility is enabled, but the processor is not in the processor set of the pool to which the zone is bound, an error is returned.
`p_online`(2)	If the caller is in a non-global zone and the pools facility is enabled, but the processor is not in the processor set of the pool to which the zone is bound, an error is returned.
`pset_bind`(2)	Added `P_ZONEID` as `idtype`. Added zone to possible choices for `P_MYID` specification. Added `P_ZONEID` to valid `idtype` list in `EINVAL` error description.
`pset_info`(2)	If the caller is in a non-global zone and the pools facility is enabled, but the processor is not in the processor set of the pool to which the zone is bound, an error is returned.
`pset_list`(2)	If the caller is in a non-global zone and the pools facility is enabled, but the processor is not in the processor set of the pool to which the zone is bound, an error is returned.
`pset_setattr`(2)	If the caller is in a non-global zone and the pools facility is enabled, but the processor is not in the processor set of the pool to which the zone is bound, an error is returned.
`sysinfo`(2)	Changed `PRIV_SYS_CONFIG` to `PRIV_SYS_ADMIN`.
`umount`(2)	`ENOENT` is returned if file pointed to by `file` is not an absolute path.
`getloadavg`(3C)	If the caller is in a non-global zone and the pools facility is enabled, the behavior is equivalent to calling with a `psetid` of `PS_MYID`.
`getpriority`(3C)	Added zone IDs to target processes that can be specified. Added zone ID to `EINVAL` error description.
`priv_str_to_set`(3C)	Added “zone” string for the set of all privileges available within the caller's zone.
`pset_getloadavg`(3C)	If the caller is in a non-global zone and the pools facility is enabled, but the processor is not in the processor set of the pool to which the zone is bound, an error is returned.
`sysconf`(3C)	If the caller is in a non-global zone and the pools facility enabled, `sysconf(_SC_NPROCESSORS_CONF)` and `sysconf(_SC_NPROCESSORS_ONLN)` return the number of total and online processors in the processor set of the pool to which the zone is bound.
`ucred_get`(3C)	Added `ucred_getzoneid()` function, which returns the zone ID of the process or `-1` if the zone ID is not available.
`core`(4)	Added `n_type: NT_ZONENAME`. This entry contains a string that describes the name of the zone in which the process was running.
`pkginfo`(4)	Now provides optional parameters and an environment variable in support of zones.
`proc`(4)	Added capability to obtain information on processes running in zones.
`audit_syslog`(5)	Added `in<zone name>` field that is used if the `zonename` audit policy is set.
`privileges`(5)	Added `PRIV_PROC_ZONE`, which allows a process to trace or send signals to processes in other zones. See `zones`(5).
`if_tcp`(7P)	Added zone `ioctl()` calls.
`cmn_err`(9F)	Added zone parameter.
`ddi_cred`(9F)	Added `crgetzoneid()`, which returns the zone ID from the user credential pointed to by `cr`.