Device control object

Applications can perform actions on a CD by writing commands to the cdpub device control object. The cdpub process creates this PPS server object. By default, the object's path is /pps/qnx/device/cd0_ctrl but you can change this path through cdpub command options. When cdpub receives updates (i.e., data from the object), it executes the specified commands.

Commands must be written in the following format:

name::parameter

For details on publishing data to PPS objects, refer to the Persistent Publish/Subscribe Developer's Guide. Applications can publish the following commands:

Command	Description	Parameter type and purpose
eject	Eject the device	Integer indicating the slot number^a
enable	Request that the drive enable or disable media access operations	Integer set to one of the following values: `0` (to stop the disc), `1` (to start the disc and read the TOC), `2` (to stop the disc and eject it if possible), or `3` (to load the disc)
load	Load the device	Integer indicating the slot number^a
power_condition	Request that the drive be put into a specific power state	Integer between the values of `0` and `5`. The power states supported are vendor-specific.
prevent_media_removal	Adjust setting for preventing disc from being ejected	Integer set to one of the following values: `0` to allow disc removal or `1` to prevent it
reload	Reload the device	Integer indicating the slot number^a
temperature_simulation	Enable or disable simulation of temperature value and state	Integer set to one of the following values: `0` to enable simulation or `1` to disable it
temperature_state	Set temperature state (in simulation)	Integer set to one of the following values: `0` for `unknown`, `1` for `normal`, `2` for `overtemp`, `3` for `unsupported`, or `4` for `undertemp`
temperature_value	Set temperature value (in simulation)	Integer whose range is device-specific
unload	Unload the device	Integer indicating the slot number^a