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

`devb-aha2`

Driver for Adaptec 6260/6360/6370-based SCSI host adapters (QNX Neutrino)

You must be root to start this driver.

Syntax:

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

Options:

Use commas (,) to separate the options. You can put the cam, cdrom, disk, optical, aha2, 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.

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

ioport= port: The I/O port of the interface. By default, it's detected automatically.
dma=channel: Use the specified DMA channel.
disconnect=mask: Specify the disconnect mask. The default is 0xff.
fast=mask: Specify the fast synchronous transfers mask. The default is 0xff.
irq=req: Assume that the controller is using this interrupt. Default is 11.
noreset: Don't reset the controller and SCSI bus at initialization time.
sync=mask: Specify the synchronous transfers enabled mask. The default is 0xff.
scsiid=id: Specify the SCSI ID used by the controller. Default is 7.

`blk` options

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

Description:

The devb-aha2 driver is for the Adaptec AIC-6260 and AIC-6360 based SCSI controllers (e.g. 1522). It detects EMX16, AHA 1520, and embedded 6260 and 6360 (motherboard) controllers. If the driver detects an embedded 6260 or 6360 and no command-line arguments exist, the factory defaults are used.

Controllers supported by this driver include, but aren't necessarily limited to:

Manufacturer	Controller
Adaptec	AIC-6260
Adaptec	AIC-6360
Adaptec	AHA-1510A
Adaptec	AHA-1520A
Adaptec	AHA-1522A, AHA-1522B
Adaptec	AHA-1530P
Adaptec	AHA-1570
Creative Labs	Sound Blaster 16 SCSI

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

Start the Adaptec 2 driver:

devb-aha2 &

Start the Adaptec 2 driver, specifying an I/O port of 0x140 and an interrupt of 11:

devb-aha2 aha2 ioport=0x140,irq=11 &

Files:

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