Background

• OS module objects are created by State.pm::initialize() when a new state object is created.
• OS module objects are available within state and provisioning modules
• OS module objects are not available within other types of modules for safety.   For example, a monitoring or other utility module should not be able to call the OS module's shutdown subroutine.

OS Module Subroutines

It is highly recommended that all OS modules implement the following subroutines.  There may be many additional subroutines implemented within an OS module.  These will not be called by any of the core VCL modules nor any of the provisioning engine modules.

• #pre_capture
• #post_load
• #sanitize
• #reboot
• #shutdown
• #get_current_image

...