devb-umass

Driver for USB Mass Storage interface

Note: In order to start this driver, you must be logged in as root or have the right abilities, and the USB stack (io-usb-otg) needs to be running.

Syntax:

devb-umass [blk option[,option]...]
           [cam option[,option]...]
           [disk option[,option]...]
           [umass options[,option]...]

Runs on:

QNX Neutrino

Options:

Note: Use commas (,) to separate the options. You can put the blk, cam, disk, and umass groups of options in any order.
blk options
The blk options control io-blk.so. If specified, they must follow the blk keyword. For more information, see io-blk.so.
cam options
The cam options control the common access methods:
async
Perform CPU cache invalidation after an I/O operation in a thread that's separate from the one that's notifying the upper layer. In some cases, and on some boards, this can provide a performance boost.
bounce=size
Specify the size of the driver's “bounce” buffer. The size argument can include a case-insensitve suffix that indicates the units: B (bytes; the default), K (kilobytes), M (megabytes), or P (pages). The bounce buffer is used if a specific piece of hardware can't directly access io-blk block cache buffers. The most common example is chips that don't support scatter-gather. The default is 32 KB.
cache[=on|off]
Map the bounce buffer as PROT_NOCACHE (cache=off) or not (cache or cache=on).
lun=mask
Enable Logical Unit Number (LUN) scanning for the devices specified in mask. The mask is a hex bitmask specifying which IDs to scan for; the default is 0xffff.
nopriv
Don't call ThreadCtl(_NTO_TCTL_IO_PRIV).
pnp
Enable CAM plug and play (i.e. don't exit at startup when no devices are found). The default is off.
quiet
Be quiet: don't display any information on startup.
retries
Specify the number of times to retry an operation before indicating to the filesystem that an I/O error occurred. The default is 10.
user=UID:GID
Operate as the specified user and group IDs. The driver retains the necessary process-manager abilities.
verbose
Be verbose: display full information about units (devices) on startup.
disk options
The disk options control the driver's interface to cam-disk.so. If specified, they must follow the disk keyword.
umass options
The umass options control the driver's interface to the USB device. If you've installed multiple devices, you can repeat these options for each device. Remember, however, to specify the umass keyword before each controller's set of options.
busno=bus
The bus number of the USB controller.
cmd_timeout=num
Specify the command timeout in ms. The default is 4 seconds.
config=cfg
The configuration number of the device.
csw_ignore
Ignore the Command Status Wrapper. Some devices return invalid data for the CSW.
devno=dev
The USB address of the device.
did=did
The device ID of the device.
iface=if
The particular interface number of the device.
maxbresets=num
Set the maximum number of bulk resets (default is 0). Once we reach this, the device will be disabled.
maxmerror=num
Set the maximum number of consecutive medium errors for devices that need to tweak the medium sense error. Beyond this limit, medium errors will return. The default is 10.
mpoll=num[:fpoll:fnum]
Set the polling thread interval, where num is the normal polling interval in ms, fpoll is the polling interval to use during startup (a faster rate), and fnum is how many times to poll using the second parameter. You can either specify the first parameter (without fpoll and fnum), or specify all three parameters. If you don't specify this option, there's no polling thread.
path=name
Connect to the specified USB stack. The default is /dev/usb/io-usb-otg.
priority=prio
Set the priority of the processing thread. The default is 21.
scsipath=name
Set the path name of the SCSI passthrough interface (default none).
vid=vid
The vendor ID of the device.
wait=num
Wait num of seconds for the USB stack. The default is 60 seconds.

Description:

The devb-umass driver is the driver for a USB mass storage interface.

Abilities:

The devb-umass driver may require the following abilities:

Use secpolmonitor to determine which abilities devb-umass is using on your specific system.

For more information on abilities, see procmgr_ability() in the C Library Reference.

Examples:

Assume a USB controller, and list all connected devices:

devb-umass &

Assume a USB controller, and list/wait for all connected devices:

devb-umass cam pnp &