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, the pkg 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 the PKG_CONCURRENCY setting. If the -C option is specified, PKG_CONCURRENCY is ignored.