xref: /illumos-gate/usr/src/uts/common/io/usb/scsa2usb/scsa2usb.conf (revision bbf21555)

#
# CDDL HEADER START
#
# The contents of this file are subject to the terms of the
# Common Development and Distribution License (the "License").
# You may not use this file except in compliance with the License.
#
# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
# or http://www.opensolaris.org/os/licensing.
# See the License for the specific language governing permissions
# and limitations under the License.
#
# When distributing Covered Code, include this CDDL HEADER in each
# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
# If applicable, add the following below this CDDL HEADER, with the
# fields enclosed by brackets "[]" replaced with your own identifying
# information: Portions Copyright [yyyy] [name of copyright owner]
#
# CDDL HEADER END
#
# Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
# Use is subject to license terms.
#


#
# scsa2usb.conf file
#
#       WARNING: This is an UNSTABLE configuration file. Its contents
#               may change at any time.
#
# Records in this file may be used to override the vendor-supplied subclass
# and protocol values for USB mass storage devices. Note: only non-class-
# compliant values for subclass and protocol (e.g. 0xff) will be overridden.
# If a device supplies legal, class-compliant values for these fields, those
# values will not be overridden.
#
# Records in this file may also be used to override the default power
# management behavior of USB mass storage devices.
#
# A record in this file has the following format:-
# "vid=vId pid=pId rev=revision subclass=override protocol=override pm=pmvalue
#	removable=remvalue modesense=modesensevalue"
#
# where:
#	vId/pId/revision: are obtained from
#	'prtconf -v' output for the device
#
#	vendorId is the hardware property 'usb-vendor-id'
#	productId is the hardware property 'usb-product-id'
#	revision is the hardware property 'usb-revision-id'
#
#	subclass override - could be either "ufi", "scsi", or "atapi"
#		where	"ufi" -> Device follows UFI transport
#			"atapi" -> Device follows ATAPI transport
#			"scsi" -> Device follows SCSI transport
#
#	These values are part of USB Interface descriptor for that device.
#		bInterfaceSubClass	type
#		0x1			"scsi"
#		0x2			"atapi"
#		0x4			"ufi"
#		0x5			"atapi"
#		0x6			"scsi"
#
#	protocol override - could be either "cbi", "cb", or "bo"
#		where	"cbi" -> Control/Bulk/Interrupt device
#			"cb" -> Control/Bulk/Interrupt device with no
#				interrupt pipe status
#			"bo" -> Bulk Only device
#
#	These values are part of USB Interface descriptor for that device.
#		bInterfaceProtocol	type
#		0x0			"cbi"
#		0x1			"cb"
#		0x2			"bo" - zip protocol
#		0x50			"bo"
#
#	pmvalue - "off" if device is not to be power managed.
#		This is the only legal value for this parameter.
#		This parameter is included because some devices
#		are not capable of being power-managed, i.e. they
#		will not respond after having their power lowered.
#		If this is the case, the device should have power
#		management disabled by setting this to "off".
#
#	remvalue - "true" if the device's removable media information
#		in its hardware inquiry data is to be overridden. This
#		is the only legal value for this parameter.
#
#	NOTE: In previous releases, the removable media information
#		was always overridden and the only legal value was "false".
#
#		There is a removable media status bit in the USB storage
#		device's inquiry data to indicate if the device has a media
#		that can be removed. Usually only devices like floppy drives
#		or CD/DVD drives that really have a removable media can
#		have this bit set and be called removable media devices.
#		Solaris treats removable media devices and non-removable
#		media devices differently. Refer to "System	Administration
#		Guide: Devices and File Systems" - "Using USB Devices
#		(Tasks)" - "Using USB Mass Storage Devices" section for
#		the differences in system behavior of treating removable
#		media devices and non-removable	media devices.
#
#		By default, Solaris will treat USB storage devices as
#		removable media devices depending on the removable media
#		bit value. In some cases this may be undesirable and the
#		behavior of the previous releases should be preserved. In
#		this case the removable media bit value should be overridden.
#		By setting "remvalue" to "true", the information provided
#		by the device is ignored. Consequently a USB hard disk
#		is treated as a removable media disk and will not show in
#		format(8) disk list.
#
#	modesensevalue - "false" if the device cannot handle mode sense
#		requests. This is the only legal value for this
#		parameter. Some devices choke on mode sense requests
#		and become unusable.
#
#	reduced-cmd-support	- "true" if the device cannot handle
#		mode sense, or start/stop, or doorlock, or doesn not
#		report correct residues on data transfers.
#		This is the only legal value for this parameter. This
#		setting is recommended for USB memory sticks and USB2.0
#		enclosures which may not be USB Mass Storage spec
#		compliant.
#
# NOTE: As a special case, "*" may be used as a wildcard which matches
#	any field. This is useful in situations where more than one
#	vendor produces a particular model of a product, one vendor
#	produces more than one product with the same characteristics,
#	or a product has more than one revision. The subclass and
#	protocol override values may also contain "*" if one or the
#	the other does not require an override value.
#
# For the properties to take effect, reboot the system.
#
# To create this list, first COPY the "attribute-override-list =" line
# to the end of the file and uncomment it.
#
# Then COPY sample records and uncomment them or create new records.
# The list consists of one or more records separated by commas and
# terminated by a semicolon.
#
# IMPORTANT: CREATE THE LIST BY ENTERING NEW RECORDS AFTER THE LAST LINE
# OF THE FILE. TO PREVENT CHANGES BEING LOST WHEN THIS FILE IS UPGRADED,
# DO NOT UNCOMMENT LINES "IN PLACE."
#
#attribute-override-list =
#
# for Sony DSC-S85 USB Digital camera:
# "vid=0x54c pid=0x10 rev=* subclass=ufi protocol=cb",
#
# for SanDisk SDDR-05a CF:
# "vid=0x781 pid=1 rev=* subclass=ufi protocol=cb";
#
# to apply to all USB Mass Storage devices:
# "vid=* reduced-cmd-support=true";
#
# (this is not recommended for CD and DVD reader/writers but may work
# well with USB memory sticks)
#
# ANYTHING CHANGED BEFORE THIS POINT MAY BE OVERWRITTEN IN UPGRADE