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