Some package action modifications cannot be performed on a live system image, or should not be performed on a live image. The reboot-needed actuator specifies whether modification of the tagged action should be performed in a new BE if the package system is operating on a live image. Ultimately, creation of a new BE is controlled by the be-policy image property. See the “Image Properties” section in the pkg(1) man page for more information about the be-policy property.
If the package system is not operating on a live image, the reboot-needed actuator is ignored: The package operation can be done without creating a new BE or a backup BE.
The reboot-needed actuator takes one of the following values. The term “modifying” can mean installing, changing, or removing the action through any of several pkg operations such as install, update, uninstall, change-facet, change-variant, set-mediator, or fix.
A backup BE will be created before modifying this action when operating on a live image unless the administrator specifies the --no-backup-be option on the pkg command or a be-policy property value that does not allow a backup BE to be created.
Any pkg operation on this action will be performed in a new BE when operating on a live image. Specifying the --deny-new-be option on the pkg command or a be-policy property value that does not allow a new BE to be created will cause the pkg operation to fail.
For file actions only; ignored for all other types of actions. If the content of the file specified by the file action changes, updating this action will be performed in a new BE when operating on a live image. Removing this file will always be performed in a new BE when operating on a live image.
This is the default value for any action if reboot-needed is not specified. You never need to specify reboot-needed=false.
Modification of this action will be performed in a new BE when operating on a live image. Specifying the --deny-new-be option on the pkg command or a be-policy property value that does not allow a new BE to be created will cause the pkg operation to fail.
The following is an example of specifying the reboot-needed actuator in a package manifest:
file path=kernel/drv/amd64/qlc owner=root group=sys mode=0755 reboot-needed=true \
variant.arch=i386 variant.opensolaris.zone=global