devb-ustor

QNX SDP8.0Utilities ReferenceUtilities

Driver for USB-based storage device

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-ustor [blk option[,option]...]
           [cam option[,option]...]
           [disk option[,option]...]
           [ustor options[,option]...]
           [fs_type options]

Runs on:

QNX OS

Options:

Note:

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

blk options

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

cam options

The cam options control libcam.so. If specified, they must follow the cam keyword.

disk options

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

ustor options

The ustor 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 ustor 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 (CSW). 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. Once we reach this, the device will be disabled. The default is 0 (zero).
mpoll=num[:fpoll:fnum]: Set the polling thread interval, where num is the normal polling interval in milliseconds (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 pathname of the SCSI passthrough interface. The default is none.
vid=vid: The vendor ID of the device.
wait=num: Wait num seconds for the USB stack. The default is 60 seconds.

fs_type options

The fs_type options control any filesystem (fs-*.so) module being loaded. Here, fs_type is the filesystem type, such as qnx6 for the Power-Safe filesystem. For the list of supported filesystem options, see the reference for the corresponding shared object. For example, for qnx6, see fs-qnx6.so.

Description:

The devb-ustor driver is the driver for a USB mass storage interface. You can use this driver instead of devb-umass to support devices that support SuperSpeed USB (USB 3.0) and SuperSpeedPlus USB (USB 3.1) speeds.

Examples:

Assume a USB controller, and list all connected devices:

devb-ustor &

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

devb-ustor cam pnp &

Page updated: August 09, 2024