diskboot

Boot the system

Syntax:

diskboot [options]...

Runs on:

Neutrino

Options:

-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:

• QNX — /boot/fs
• DOS — /Program Files/qnx/boot/fs
• Linux — /qnx/boot/fs
• cd — /boot/fs

-e

Search ext2 partitions.

-o cmd,options

Provide options to use if the given command is started. For example:

• To pass an option to a specific driver:

  -o "devb-eide,blk cache=30m"

• To pass an option to all block drivers:

  -o "devb-*,blk cache=30m"

• To pass the -m option to the pci-bios utility:

  -o "pci-bios,-m"

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

-s

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.

-v[v...]

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).

Description:

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:

• runs enum-devices to determine what devices are present
• starts any system services that would be in any monolithic UNIX kernel
• executes /etc/rc.d/rc.sysinit, which does local initialization and finishes by running tinit, which allows logins to the system.

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

Examples:

Run diskboot:

diskboot

Files:

.diskroot

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.

/etc/system/sysinit

A script that sets up system services.

See also:

enum-devices, io-usb, tinit

Controlling How Neutrino Starts in the Neutrino User's Guide