xref: /titanic_52/usr/src/uts/common/io/scsi/targets/sgen.conf (revision 4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6)
19a016c63Sstevel#
29a016c63Sstevel# CDDL HEADER START
39a016c63Sstevel#
49a016c63Sstevel# The contents of this file are subject to the terms of the
59a016c63Sstevel# Common Development and Distribution License (the "License").
69a016c63Sstevel# You may not use this file except in compliance with the License.
79a016c63Sstevel#
89a016c63Sstevel# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
99a016c63Sstevel# or http://www.opensolaris.org/os/licensing.
109a016c63Sstevel# See the License for the specific language governing permissions
119a016c63Sstevel# and limitations under the License.
129a016c63Sstevel#
139a016c63Sstevel# When distributing Covered Code, include this CDDL HEADER in each
149a016c63Sstevel# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
159a016c63Sstevel# If applicable, add the following below this CDDL HEADER, with the
169a016c63Sstevel# fields enclosed by brackets "[]" replaced with your own identifying
179a016c63Sstevel# information: Portions Copyright [yyyy] [name of copyright owner]
189a016c63Sstevel#
199a016c63Sstevel# CDDL HEADER END
209a016c63Sstevel#
21*4c06356bSdh142964# Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
229a016c63Sstevel# Use is subject to license terms.
239a016c63Sstevel#
249a016c63Sstevel
259a016c63Sstevel#
269a016c63Sstevel# Portions Copyright (c) Siemens 1999
279a016c63Sstevel# All rights reserved.
289a016c63Sstevel#
299a016c63Sstevel
309a016c63Sstevel# WARNING: enabling this driver may impact the security and data integrity of
319a016c63Sstevel# devices on your system.  Please refer to sgen(7d) for details.
329a016c63Sstevel#
33*4c06356bSdh142964# There are two ways of configuring sgen: by establishing an association
34*4c06356bSdh142964# between a compatible alias for a device and the sgen driver via
35*4c06356bSdh142964# "add_drv -i", or by using this file (sgen.conf).
36*4c06356bSdh142964
37*4c06356bSdh142964#--------------------------add_drv binding method-----------------------------
38*4c06356bSdh142964# SCSI target devices are now self-identifying in Solaris. Add_drv is the
39*4c06356bSdh142964# preferred method to control driver binding, it avoids issues associated
40*4c06356bSdh142964# with multiple driver.conf files associating more than one driver with a
41*4c06356bSdh142964# device. The compatible property forms for SCSI target devices used in the
42*4c06356bSdh142964# add_drv command are described in scsi(4).
43*4c06356bSdh142964#
44*4c06356bSdh142964# USAGE EXAMPLE (add_drv)
45*4c06356bSdh142964#
46*4c06356bSdh142964# In this example, sgen is configured to bind to all scanner and ocrw devices
47*4c06356bSdh142964# in the system, as well as the UltraToast 4000 disk from ACME using the
48*4c06356bSdh142964# add_drv configuration method.
49*4c06356bSdh142964#
50*4c06356bSdh142964# add_drv -i \
51*4c06356bSdh142964#    '"scsiclass,06" "scsiclass,0f" "scsiclass,00.vACME,pUltraToast_4000"' sgen
52*4c06356bSdh142964
53*4c06356bSdh142964#-------------------------sgen.conf binding method----------------------------
54*4c06356bSdh142964# NOTE: Support for sgen.conf configuration may be removed in a future release
55*4c06356bSdh142964# of Solaris.
56*4c06356bSdh142964#
57*4c06356bSdh142964# The the remainder of this file is concerned with the .conf file
58*4c06356bSdh142964# configuration method. Sgen may be configured to bind to SCSI devices
59*4c06356bSdh142964# exporting a particular device type, using the device-type-config-list, which
60*4c06356bSdh142964# is a ',' delimited list of strings.
619a016c63Sstevel#
629a016c63Sstevel#device-type-config-list=
639a016c63Sstevel#	"direct"		(type 0x00)
649a016c63Sstevel#	"sequential"		(type 0x01)
659a016c63Sstevel#	"printer"		(type 0x02)
669a016c63Sstevel#	"processor"		(type 0x03)
679a016c63Sstevel#	"worm"			(type 0x04)
689a016c63Sstevel#	"rodirect"		(type 0x05)
699a016c63Sstevel#	"scanner"		(type 0x06)
709a016c63Sstevel#	"optical"		(type 0x07)
719a016c63Sstevel#	"changer"		(type 0x08)
729a016c63Sstevel#	"comm"			(type 0x09)
739a016c63Sstevel#	"prepress1"		(type 0x0A)
749a016c63Sstevel#	"prepress2"		(type 0x0B)
759a016c63Sstevel#	"array_ctrl"		(type 0x0C)
769a016c63Sstevel#	"ses"			(type 0x0D)
779a016c63Sstevel#	"rbc"			(type 0x0E)
789a016c63Sstevel#	"ocrw"			(type 0x0F)
799a016c63Sstevel#	"bridge"		(type 0x10)
809a016c63Sstevel#	"type_0x<typenum>"	(types 0x11-0x1e are undefined by SCSI-3)
819a016c63Sstevel#	"type_unknown"		(type 0x1f)
829a016c63Sstevel#
839a016c63Sstevel# In addition to binding to device types, sgen can be configured to bind to one
849a016c63Sstevel# or more particular devices.  The latter is accomplished by specifying the
859a016c63Sstevel# Vendor and Product IDs returned by the device in response to the SCSI INQUIRY
869a016c63Sstevel# command.  This is accomplished by specifying pairs of Vendor ID and Product ID
879a016c63Sstevel# strings in the inquiry-config-list property, below.  "*" may be substituted
889a016c63Sstevel# for the vendor ID as a wildcard.  See sgen(7D) for details and extended usage
899a016c63Sstevel# examples.
909a016c63Sstevel#
91*4c06356bSdh142964# USAGE EXAMPLE (sgen.conf)
929a016c63Sstevel#
939a016c63Sstevel# In this example, sgen is configured to bind to all scanner and ocrw devices in
949a016c63Sstevel# the system, as well as the UltraToast 4000 from ACME, and the PowerToast
959a016c63Sstevel# series of devices, regardless of vendor.
969a016c63Sstevel#
979a016c63Sstevel#device-type-config-list="scanner", "ocrw";
989a016c63Sstevel#
999a016c63Sstevel#inquiry-config-list=	"ACME",		"UltraToast 4000",
1009a016c63Sstevel#			"*",		"PowerToast";
1019a016c63Sstevel#
102*4c06356bSdh142964# When using the sgen.conf method, after configuring the
103*4c06356bSdh142964# device-type-config-list and/or the inquiry-config-list, the administrator
104*4c06356bSdh142964# must uncomment those target/lun pairs at which there are devices for sgen to
105*4c06356bSdh142964# control.  If it is expected that devices controlled by sgen will be hotplugged
106*4c06356bSdh142964# or added into the system later, it is recommended that all of the following
107*4c06356bSdh142964# lines be uncommented.
108*4c06356bSdh142964#
1099a016c63Sstevel#name="sgen" class="scsi" target=0 lun=0;
1109a016c63Sstevel#name="sgen" class="scsi" target=1 lun=0;
1119a016c63Sstevel#name="sgen" class="scsi" target=2 lun=0;
1129a016c63Sstevel#name="sgen" class="scsi" target=3 lun=0;
1139a016c63Sstevel#name="sgen" class="scsi" target=4 lun=0;
1149a016c63Sstevel#name="sgen" class="scsi" target=5 lun=0;
1159a016c63Sstevel#name="sgen" class="scsi" target=6 lun=0;
1169a016c63Sstevel#name="sgen" class="scsi" target=7 lun=0;
1179a016c63Sstevel#name="sgen" class="scsi" target=8 lun=0;
1189a016c63Sstevel#name="sgen" class="scsi" target=9 lun=0;
1199a016c63Sstevel#name="sgen" class="scsi" target=10 lun=0;
1209a016c63Sstevel#name="sgen" class="scsi" target=11 lun=0;
1219a016c63Sstevel#name="sgen" class="scsi" target=12 lun=0;
1229a016c63Sstevel#name="sgen" class="scsi" target=13 lun=0;
1239a016c63Sstevel#name="sgen" class="scsi" target=14 lun=0;
1249a016c63Sstevel#name="sgen" class="scsi" target=15 lun=0;
125*4c06356bSdh142964
126