`devb-eide`

Driver for ATA/IDE disk interface and ATAPI CD-ROM interface (QNX Neutrino)

You must be root to start this driver.

Syntax:

devb-eide [blk option[,option]...]
          [cam option[,option]...]
          [cdrom option[,option]...]
          [disk option[,option]...]
          [eide option[,option]...] &

Options:

Use commas (,) to separate the options. You can put the blk, cam, cdrom, disk, and eide groups of options in any order.

`blk` options

The blk options control io-blk.so. If specified, they must follow the blk keyword.

`cam` options

quiet: Be quiet: don't display any information on startup.
verbose: Be verbose.

`cdrom` options

The cdrom options control the driver's interface to cam-cdrom.so. If specified, they must follow the cdrom keyword.

`disk` options

The disk options control the driver's interface to cam-disk.so. If specified, they must follow the disk keyword.

The eide options control the driver's interface to the EIDE controller. If you've installed multiple controllers, you can repeat these options for each controller. Remember, however, to specify the eide keyword before each controller's set of options.

Interface-specific options:

chnl=chnl: The channel number of the controller (0 or 1).
decode=xor: Set the layout between I/O registers. The default is 0.
did=did: The device ID of the controller.
ioport=pri[:sec]: The I/O port of the interface. By default, it's detected automatically.
irq=req: The interrupt used by the controller.
master=device: Specify master device options. For device-specific options, see below.
nobios: Do not use BIOS transfer mode settings. The default is to use them.
nobmstr: Do not use busmastering. Specify this option if you want to disable DMA.
noconcurrent: Don't allow concurrent access to both channels.
nolegacy: Don't scan legacy addresses (0x1f0, 0x170).
nomaster: Don't scan for master devices.
noreset: Don't reset devices at initialization.
noslave: Don't scan for slave devices.
pci=index: The PCI index of the controller in the machine, where index is a value between 0 and the number of adapters.
priority=prio: Set the priority of the processing thread. The default is 21.
slave=device.: Specify slave device options. For device-specific options, see below.
stride=space: Set the spacing offset between I/O ports (IDE command registers). E.g. if the ports are located on 4-byte boundaries, set space to 4. The default is 1.
timeout=timeout: Set the I/O request timeout in seconds. The default is 10.
vid=vid: The vendor ID of the controller.

Device-specific options:

ata: Set the device type to ATA.
atapi: Set the device type to ATAPI.
chs: Use Cylinder-Head-Sector mode instead of Logical Block Addressing. LBA is used by default.
geometry=heads:cyl:sect: Specify drive geometry.
lba48: Enable LBA 48-bit addressing (off by default).
mdma=mode: Set multi-word DMA mode. Values for mode can be 0-2 (or off to disable).
multiblk=blks: Set the number of blocks per interrupt for multiblk mode.
nonremovable: Report the device as nonremovable.
pio=mode: Set PIO mode. Values for mode can be 0-4 (or off to disable PIO).
smart: Enable SMART monitoring.
udma=mode: Set ultra DMA mode. Values for mode can be 0-6 (or off to disable).
wcache: Enable the device write cache.
xfer=width: Set the I/O access width (8, 16, or 32 bits).

Description:

The devb-eide driver is for IDE (Integrated Drive Electronics), EIDE (Enhanced IDE) and ATA (AT Attachment) hard disk interface, as well as the ATAPI (ATA Packet Interface) CD-ROM interface. This driver autodetects all interfaces.

If you're installing multiple operating systems on the drive, make sure they all use a compatible mode. For example, if your drive is ≥ 528M and DOS will also be installed on the drive, the driver should be configured to use LBA.

The devb-eide driver uses DMA by default. If you want to disable DMA, specify the nobmstr command-line option.

By default, the driver uses LBA (Logical Block Addressing) modes if the drive supports them. If you want the device programmed to CHS (Cylinder-Head-Sector) mode, specify the chs option.

The devb-eide driver closes its standard input, standard output, and standard error immediately after completing its initializations. Any error messages produced during the initialization phase are written to standard error.

Examples:

Detect all IDE controllers, and list all connected devices:

devb-eide &

Detect an IDE controller at a specific I/O port address and IRQ number, and list all connected devices:

devb-eide eide ioport=0x1f0,irq=14

Detect a PCMCIA disk that is configured in contiguous I/O mapped addressing at a specific I/O port address and IRQ number:

devb-eide eide ioport=0x320:0x32c,irq=7,noslave

For PCMCIA devices configured in contiguous I/O mapped addressing, you should always specify the control block address of the interface by adding an offset (usually 12) to the base address of the port. This is not required for legacy addressing (0x1f0 or 0x170), where the driver adds the standard control block offset (0x200) automatically.

Detect an IDE controller with a specific vendor and device identity, and list all connected devices:

devb-eide eide vid=0x8086,did=0x2411,pci=0,chnl=0

Detect an IDE controller with a specific vendor ID, device ID, and channel number, and disable ultra DMA on the master:

devb-eide eide vid=0x8086,did=0x2411,pci=0,chnl=1,master=udma=off

Pass cache and delwri options to io-blk.so, uid and gid options to fs-cd.so, and vollabel option to fs-dos.so:

devb-eide blk cache=2m,delwri=2s cd uid=234,gid=120 dos \
vollabel=ignore &

The cd and dos options apply to any filesystems of those types that are mounted (either by the automatic mounter or a later explicit mount).

You can also pass generic mount options (as described in io-blk.so) as follows:

devb-eide blk noatime dos hidden=show,noexec qnx4 ro &

This sets the ST_NOATIME mount bit for all filesystems, the ST_RDONLY bit for any QNX 4 filesystem, and the ST_NOEXEC bit for any DOS filesystem. The mount message also has these bits, which apply only to that mountpoint.

Files:

The devb-eide driver causes io-blk.so to adopt various block special devices under /dev. These devices are normally named hdn (or cdn for CD-ROMs), where n is the physical unit number of the device.

This driver could also require the following shared objects:

Binary	Required
`cam-cdrom.so`	For CD-ROM access
`cam-disk.so`	For hard-disk access
`libcam.so`	Always

Exit status:

The devb-eide driver terminates only if an error occurs during startup, or if it has successfully forked itself upon startup because it hadn't been initially started in the background.

0: The devb-eide driver wasn't started in the background and therefore forked itself. The original process terminated with a zero exit status, the forked process continued.
>0: An error occurred during startup.

Caveats:

Unless overridden with the blk automount= option (see io-blk.so), devices are mounted as:

Device	Mountpoint	Filesystem type
`/dev/hd0t77`	`/hd`	`qnx4`
`/dev/cd0`	`/cd`	`cd`
`/dev/hd0t6`	`/dos`	`dos`
`/dev/hd0t11`	`/dos`	`dos`

While there's no limit to the size of a disk or partition, I/O (i.e. the lseek(), read(), and write() functions) is currently limited to 2 gigabytes per partition (or disk). This I/O limit has no effect on the partition size for mounted filesystems.

Known supported functions include:

chmod(), chown(), close(), closedir(), creat(), devctl(), dup(), dup2(), fcntl(), fpathconf(), fstat(), lseek(), mkdir(), mkfifo(), mknod(), open(), opendir(), pathconf(), read(), readdir(), readlink(), rewinddir(), rmdir(), stat(), symlink(), unlink() (not supported for directories), utime(), write()

Note that certain calls (such as pipe(), as well as read() and write() on FIFOs) may require the pipe manager.