Options That Operate on Non-Global Zones
As discussed in Working with Non-Global Zones, only some package installations, removals, and updates performed in the global zone automatically affect non-global zones. The -r
option performs the same pkg
operation in non-global zones that you entered in the global zone, possibly affecting many more packages than would be affected if you did not use -r
. These options are available for the install
, uninstall
, update
, change-variant
, and change-facet
subcommands.
-
-r
-
Run this operation in the global zone and also in all installed
solaris
branded non-global zones. The effect on the non-global zone is similar to logging into each non-global zone and running the command directly.Without this option, when you run
pkg
commands in the global zone, non-global zones are modified only to the extent required to keep them compatible with the global zone as described in Working with Non-Global Zones. With this option, thepkg
operation is applied to all installed non-global zones except as limited by the-z
and-Z
options. Zones that are excluded by the-z
and-Z
options might still be modified if updates are required to keep them in sync with the global zone. -
-z zone
-
Run this operation only in the specified non-global zone. The
-z
option can be specified multiple times. The-z
option can only be used with the-r
option. The-z
option cannot be used with the-Z
option. -
-Z zone
-
Run this operation in all non-global zones except for the specified zone. The
-Z
option can be specified multiple times. The-Z
option can only be used with the-r
option. The-Z
option cannot be used with the-z
option.
The following option specifies the number of non-global zones to update concurrently with the global zone. This option is available for the install
, exact-install
, uninstall
, update
, change-variant
, and change-facet
subcommands.
-
-C n
-
Update at most n installed
solaris
branded non-global zones in parallel with the global zone. If n is 0 or a negative number, all non-global zones are updated concurrently with the global zone.The environment variable
PKG_CONCURRENCY
can also be set to the value n. The-C
option overrides thePKG_CONCURRENCY
setting. If the-C
option is specified,PKG_CONCURRENCY
is ignored.