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