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 2005 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 - "false" if the device's removable media information 90# in its hardware inquiry data is not to be ignored. This 91# is the only legal value for this parameter. There is a 92# removable media status bit in the USB storage device's 93# inquiry data to indicate if the device has a media that 94# can be removed. Usually only devices like floppy drives 95# or CD/DVD drives that really have a removable media can 96# have this bit set and be called removable media devices. 97# Solaris treats removable media devices and non- 98# removable media devices differently. Refer to "System 99# Administration Guide: Devices and File Systems" - 100# "Using USB Devices (Tasks)" - "Using USB Mass Storage 101# Devices" section for the differences in system behavior 102# of treating removable media devices and non-removable 103# media devices. 104# 105# By default, Solaris will treat all USB storage devices 106# as removable media devices irrespective of the removable 107# media bit value. The advantage is a consistent user 108# experience. In some cases this may be undesirable and 109# the removable media bit value should not be ignored. By 110# setting "remvalue" to "false", the information provided 111# by the device is preserved. Consequently a USB hard disk 112# is treated as a real hard disk and will show in 113# format(1M) disk list and no longer in rmformat(1M) list. 114# 115# modesensevalue - "false" if the device cannot handle mode sense 116# requests. This is the only legal value for this 117# parameter. Some devices choke on mode sense requests 118# and become unusable. 119# 120# reduced-cmd-support - "true" if the device cannot handle 121# mode sense, or start/stop, or doorlock, or doesn not 122# report correct residues on data transfers. 123# This is the only legal value for this parameter. This 124# setting is recommended for USB memory sticks and USB2.0 125# enclosures which may not be USB Mass Storage spec 126# compliant. 127# 128# NOTE: As a special case, "*" may be used as a wildcard which matches 129# any field. This is useful in situations where more than one 130# vendor produces a particular model of a product, one vendor 131# produces more than one product with the same characteristics, 132# or a product has more than one revision. The subclass and 133# protocol override values may also contain "*" if one or the 134# the other does not require an override value. 135# 136# For the properties to take effect, reboot the system. 137# 138# To create this list, first COPY the "attribute-override-list =" line 139# to the end of the file and uncomment it. 140# 141# Then COPY sample records and uncomment them or create new records. 142# The list consists of one or more records separated by commas and 143# terminated by a semicolon. 144# 145# IMPORTANT: CREATE THE LIST BY ENTERING NEW RECORDS AFTER THE LAST LINE 146# OF THE FILE. TO PREVENT CHANGES BEING LOST WHEN THIS FILE IS UPGRADED, 147# DO NOT UNCOMMENT LINES "IN PLACE." 148# 149#attribute-override-list = 150# 151# for Sony DSC-S85 USB Digital camera: 152# "vid=0x54c pid=0x10 rev=* subclass=ufi protocol=cb", 153# 154# for SanDisk SDDR-05a CF: 155# "vid=0x781 pid=1 rev=* subclass=ufi protocol=cb"; 156# 157# to apply to all USB Mass Storage devices: 158# "vid=* reduced-cmd-support=true"; 159# 160# (this is not recommended for CD and DVD reader/writers but may work 161# well with USB memory sticks) 162# 163# ANYTHING CHANGED BEFORE THIS POINT MAY BE OVERWRITTEN IN UPGRADE 164