Caution: This version of this document is no longer maintained. For the latest documentation, see


Boot the system


diskboot [options]...

Runs on:



-b type
Force the boot to a particular type; where type can be 1,2, or 3 depending on the type of boot required:
  1. Boot from a hard disk.
  2. Boot from a CDROM.
  3. Install QNX Neutrino to a new disk partition.
-D UseDma
If UseDma is 0, disable DMA for the EIDE driver. If UseDma is 1, enable DMA for the EIDE driver. By default, DMA is disabled.
-d dir
The directory to search for *.qfs files on partition filesystems. The default depends on the filesystem type:
Search ext2 partitions.
-o cmd,options
Provide options to use if the given command is started. For example:

You can use additional -o arguments to pass additional options. Specifying an -o option doesn't cause the specified command to be started.

Start drivers and filesystems but don't run the sysinit file.
-u options
Specify the options to pass to io-usb. The default is -duhci -dohci -dehci.
Verbose output. More v characters cause more verbosity.
-x drvr
Exclude the specified driver. The drvr argument must be the full name (e.g. -x devb-eide).


The diskboot utility is built into the boot image for systems that boot from a block device. Its purpose is to boot a QNX Neutrino system.

If the -b option isn't set, diskboot starts by searching for all hard disks and CDROMs on all controllers. A 10-second timeout prevents defective drivers or hardware from locking the system. The utility then starts all filesystems on all partitions on hard drives, magneto drives, and CDROMs. If you press the space bar while diskboot is running, it lets you select additional options.

The diskboot process then runs the /etc/system/sysinit script, which:

For a more detailed description, see the Controlling How Neutrino Starts chapter of the Neutrino User's Guide.


Run diskboot:



A file that indicates how to mount the partitions; see the description of .diskroot in the Controlling How Neutrino Starts chapter of the Neutrino User's Guide.
A script that sets up system services.

See also:

enum-devices, io-usb, tinit

Controlling How Neutrino Starts in the Neutrino User's Guide