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]...]
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 the
io-blk.so driver.
If specified, they must follow the blk keyword.
For more information, see io-blk.so.
- 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.
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 higher SuperSpeed USB (USB 3.0) and SuperSpeedPlus USB speeds (USB 3.1).
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 &