[Previous] [Contents] [Index] [Next]

Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

devb-ncr8

Driver for the NCR 53c810, 815, 820, 825, 860, 875, 885, 895, and 896 PCI SCSI host adapter (QNX Neutrino)


Note: You must be root to start this driver.

Syntax:

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

Options:


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

cam options

lun=mask
Enable Logical Unit Number (LUN) scan for the devices specified in mask. The mask is a hex bitmask specifying which IDs to scan for; the default is 0x00.
quiet
Be quiet: don't display any information on startup.
verbose
Be verbose: display full information about SCSI units (devices) on startup.

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.

optical options

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

ncr8 options

The ncr8 options control the driver's interface to the NCR 8 series controllers.

did=did
The device ID of the controller.
nosync=mask
Disable synchronous transfers.
nowide=mask
Disable wide transfers.
pci=index
The PCI index of the controller in the machine, where pci_index is a value between 0 and the number of adapters.

blk options

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

Description:

The devb-ncr8 driver is for the NCR53c810, NCR53c815, NCR53c820, NCR53c825, NCR53c860, NCR53c875, NCR53c885, NCR53c895, and NCR53c896 PCI SCSI adapters. The driver automatically scans the machine for controllers. Controllers are numbered from 0 to n, in the order they're found.

The driver performs a scan, looking for installed units. All targets are scanned (0 to 7) and for each target, each LUN (Logical Unit Number) is scanned (0 to 7). Devices are numbered starting from 0, and each type of device is numbered separately.

The devb-ncr8 driver autodetects all PCI NCR53c810 adapters by default, therefore you must specify the ncr8 pci option to the driver if you only require a specific SCSI adapter to be used.


Note: This driver currently doesn't support synchronous or wide data transfers.

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

Examples:

Assume an NCR 53c810 controller, and list all connected devices:

devb-ncr8 &

Assume an NCR 53c810 controller with a PCI index of 1, and list all connected devices:

devb-ncr8 ncr8 pci=1 &

Files:

The devb-ncr8 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-ncr8 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-ncr8 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.

See also:

io-blk.so

"Block-oriented drivers (devb-*)," "Common access method (cam-*)," and "Filesystem drivers (fs-*)" in the Utilities Summary


[Previous] [Contents] [Index] [Next]