xref: /illumos-gate/usr/src/uts/common/io/usb/scsa2usb/scsa2usb.conf (revision 533affcbc7fc4d0c8132976ea454aaa715fe2307)
1#
2# CDDL HEADER START
3#
4# The contents of this file are subject to the terms of the
5# Common Development and Distribution License (the "License").
6# You may not use this file except in compliance with the License.
7#
8# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9# or http://www.opensolaris.org/os/licensing.
10# See the License for the specific language governing permissions
11# and limitations under the License.
12#
13# When distributing Covered Code, include this CDDL HEADER in each
14# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15# If applicable, add the following below this CDDL HEADER, with the
16# fields enclosed by brackets "[]" replaced with your own identifying
17# information: Portions Copyright [yyyy] [name of copyright owner]
18#
19# CDDL HEADER END
20#
21# Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
22# Use is subject to license terms.
23#
24
25
26#
27# scsa2usb.conf file
28#
29#       WARNING: This is an UNSTABLE configuration file. Its contents
30#               may change at any time.
31#
32# Records in this file may be used to override the vendor-supplied subclass
33# and protocol values for USB mass storage devices. Note: only non-class-
34# compliant values for subclass and protocol (e.g. 0xff) will be overridden.
35# If a device supplies legal, class-compliant values for these fields, those
36# values will not be overridden.
37#
38# Records in this file may also be used to override the default power
39# management behavior of USB mass storage devices.
40#
41# A record in this file has the following format:-
42# "vid=vId pid=pId rev=revision subclass=override protocol=override pm=pmvalue
43#	removable=remvalue modesense=modesensevalue"
44#
45# where:
46#	vId/pId/revision: are obtained from
47#	'prtconf -v' output for the device
48#
49#	vendorId is the hardware property 'usb-vendor-id'
50#	productId is the hardware property 'usb-product-id'
51#	revision is the hardware property 'usb-revision-id'
52#
53#	subclass override - could be either "ufi", "scsi", or "atapi"
54#		where	"ufi" -> Device follows UFI transport
55#			"atapi" -> Device follows ATAPI transport
56#			"scsi" -> Device follows SCSI transport
57#
58#	These values are part of USB Interface descriptor for that device.
59#		bInterfaceSubClass	type
60#		0x1			"scsi"
61#		0x2			"atapi"
62#		0x4			"ufi"
63#		0x5			"atapi"
64#		0x6			"scsi"
65#
66#	protocol override - could be either "cbi", "cb", or "bo"
67#		where	"cbi" -> Control/Bulk/Interrupt device
68#			"cb" -> Control/Bulk/Interrupt device with no
69#				interrupt pipe status
70#			"bo" -> Bulk Only device
71#
72#	These values are part of USB Interface descriptor for that device.
73#		bInterfaceProtocol	type
74#		0x0			"cbi"
75#		0x1			"cb"
76#		0x2			"bo" - zip protocol
77#		0x50			"bo"
78#
79#	pmvalue - "off" if device is not to be power managed.
80#		This is the only legal value for this parameter.
81#		This parameter is included because some devices
82#		are not capable of being power-managed, i.e. they
83#		will not respond after having their power lowered.
84#		If this is the case, the device should have power
85#		management disabled by setting this to "off".
86#
87#	remvalue - "true" if the device's removable media information
88#		in its hardware inquiry data is to be overridden. This
89#		is the only legal value for this parameter.
90#
91#	NOTE: In previous releases, the removable media information
92#		was always overridden and the only legal value was "false".
93#
94#		There is a removable media status bit in the USB storage
95#		device's inquiry data to indicate if the device has a media
96#		that can be removed. Usually only devices like floppy drives
97#		or CD/DVD drives that really have a removable media can
98#		have this bit set and be called removable media devices.
99#		Solaris treats removable media devices and non-removable
100#		media devices differently. Refer to "System	Administration
101#		Guide: Devices and File Systems" - "Using USB Devices
102#		(Tasks)" - "Using USB Mass Storage Devices" section for
103#		the differences in system behavior of treating removable
104#		media devices and non-removable	media devices.
105#
106#		By default, Solaris will treat USB storage devices as
107#		removable media devices depending on the removable media
108#		bit value. In some cases this may be undesirable and the
109#		behavior of the previous releases should be preserved. In
110#		this case the removable media bit value should be overridden.
111#		By setting "remvalue" to "true", the information provided
112#		by the device is ignored. Consequently a USB hard disk
113#		is treated as a removable media disk and will not show in
114#		format(8) disk list.
115#
116#	modesensevalue - "false" if the device cannot handle mode sense
117#		requests. This is the only legal value for this
118#		parameter. Some devices choke on mode sense requests
119#		and become unusable.
120#
121#	reduced-cmd-support	- "true" if the device cannot handle
122#		mode sense, or start/stop, or doorlock, or doesn not
123#		report correct residues on data transfers.
124#		This is the only legal value for this parameter. This
125#		setting is recommended for USB memory sticks and USB2.0
126#		enclosures which may not be USB Mass Storage spec
127#		compliant.
128#
129# NOTE: As a special case, "*" may be used as a wildcard which matches
130#	any field. This is useful in situations where more than one
131#	vendor produces a particular model of a product, one vendor
132#	produces more than one product with the same characteristics,
133#	or a product has more than one revision. The subclass and
134#	protocol override values may also contain "*" if one or the
135#	the other does not require an override value.
136#
137# For the properties to take effect, reboot the system.
138#
139# To create this list, first COPY the "attribute-override-list =" line
140# to the end of the file and uncomment it.
141#
142# Then COPY sample records and uncomment them or create new records.
143# The list consists of one or more records separated by commas and
144# terminated by a semicolon.
145#
146# IMPORTANT: CREATE THE LIST BY ENTERING NEW RECORDS AFTER THE LAST LINE
147# OF THE FILE. TO PREVENT CHANGES BEING LOST WHEN THIS FILE IS UPGRADED,
148# DO NOT UNCOMMENT LINES "IN PLACE."
149#
150#attribute-override-list =
151#
152# for Sony DSC-S85 USB Digital camera:
153# "vid=0x54c pid=0x10 rev=* subclass=ufi protocol=cb",
154#
155# for SanDisk SDDR-05a CF:
156# "vid=0x781 pid=1 rev=* subclass=ufi protocol=cb";
157#
158# to apply to all USB Mass Storage devices:
159# "vid=* reduced-cmd-support=true";
160#
161# (this is not recommended for CD and DVD reader/writers but may work
162# well with USB memory sticks)
163#
164# ANYTHING CHANGED BEFORE THIS POINT MAY BE OVERWRITTEN IN UPGRADE
165