9a016c63ca347047a236dff12f0da83aac8981d1stevel# CDDL HEADER START
9a016c63ca347047a236dff12f0da83aac8981d1stevel# The contents of this file are subject to the terms of the
9a016c63ca347047a236dff12f0da83aac8981d1stevel# Common Development and Distribution License (the "License").
9a016c63ca347047a236dff12f0da83aac8981d1stevel# You may not use this file except in compliance with the License.
9a016c63ca347047a236dff12f0da83aac8981d1stevel# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9a016c63ca347047a236dff12f0da83aac8981d1stevel# See the License for the specific language governing permissions
9a016c63ca347047a236dff12f0da83aac8981d1stevel# and limitations under the License.
9a016c63ca347047a236dff12f0da83aac8981d1stevel# When distributing Covered Code, include this CDDL HEADER in each
9a016c63ca347047a236dff12f0da83aac8981d1stevel# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
9a016c63ca347047a236dff12f0da83aac8981d1stevel# If applicable, add the following below this CDDL HEADER, with the
9a016c63ca347047a236dff12f0da83aac8981d1stevel# fields enclosed by brackets "[]" replaced with your own identifying
9a016c63ca347047a236dff12f0da83aac8981d1stevel# information: Portions Copyright [yyyy] [name of copyright owner]
9a016c63ca347047a236dff12f0da83aac8981d1stevel# CDDL HEADER END
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# Copyright 2009 Sun Microsystems, Inc. All rights reserved.
9a016c63ca347047a236dff12f0da83aac8981d1stevel# Use is subject to license terms.
9a016c63ca347047a236dff12f0da83aac8981d1stevel# Portions Copyright (c) Siemens 1999
9a016c63ca347047a236dff12f0da83aac8981d1stevel# All rights reserved.
9a016c63ca347047a236dff12f0da83aac8981d1stevel# WARNING: enabling this driver may impact the security and data integrity of
9a016c63ca347047a236dff12f0da83aac8981d1stevel# devices on your system. Please refer to sgen(7d) for details.
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# There are two ways of configuring sgen: by establishing an association
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# between a compatible alias for a device and the sgen driver via
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# "add_drv -i", or by using this file (sgen.conf).
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh#--------------------------add_drv binding method-----------------------------
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# SCSI target devices are now self-identifying in Solaris. Add_drv is the
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# preferred method to control driver binding, it avoids issues associated
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# with multiple driver.conf files associating more than one driver with a
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# device. The compatible property forms for SCSI target devices used in the
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# add_drv command are described in scsi(4).
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# USAGE EXAMPLE (add_drv)
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# In this example, sgen is configured to bind to all scanner and ocrw devices
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# in the system, as well as the UltraToast 4000 disk from ACME using the
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# add_drv configuration method.
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# add_drv -i \
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# '"scsiclass,06" "scsiclass,0f" "scsiclass,00.vACME,pUltraToast_4000"' sgen
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh#-------------------------sgen.conf binding method----------------------------
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# NOTE: Support for sgen.conf configuration may be removed in a future release
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# of Solaris.
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# The the remainder of this file is concerned with the .conf file
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# configuration method. Sgen may be configured to bind to SCSI devices
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# exporting a particular device type, using the device-type-config-list, which
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# is a ',' delimited list of strings.
9a016c63ca347047a236dff12f0da83aac8981d1stevel#device-type-config-list=
9a016c63ca347047a236dff12f0da83aac8981d1stevel# "direct" (type 0x00)
9a016c63ca347047a236dff12f0da83aac8981d1stevel# "sequential" (type 0x01)
9a016c63ca347047a236dff12f0da83aac8981d1stevel# "printer" (type 0x02)
9a016c63ca347047a236dff12f0da83aac8981d1stevel# "processor" (type 0x03)
9a016c63ca347047a236dff12f0da83aac8981d1stevel# "worm" (type 0x04)
9a016c63ca347047a236dff12f0da83aac8981d1stevel# "rodirect" (type 0x05)
9a016c63ca347047a236dff12f0da83aac8981d1stevel# "scanner" (type 0x06)
9a016c63ca347047a236dff12f0da83aac8981d1stevel# "optical" (type 0x07)
9a016c63ca347047a236dff12f0da83aac8981d1stevel# "changer" (type 0x08)
9a016c63ca347047a236dff12f0da83aac8981d1stevel# "comm" (type 0x09)
9a016c63ca347047a236dff12f0da83aac8981d1stevel# "prepress1" (type 0x0A)
9a016c63ca347047a236dff12f0da83aac8981d1stevel# "prepress2" (type 0x0B)
9a016c63ca347047a236dff12f0da83aac8981d1stevel# "array_ctrl" (type 0x0C)
9a016c63ca347047a236dff12f0da83aac8981d1stevel# "ses" (type 0x0D)
9a016c63ca347047a236dff12f0da83aac8981d1stevel# "rbc" (type 0x0E)
9a016c63ca347047a236dff12f0da83aac8981d1stevel# "ocrw" (type 0x0F)
9a016c63ca347047a236dff12f0da83aac8981d1stevel# "bridge" (type 0x10)
9a016c63ca347047a236dff12f0da83aac8981d1stevel# "type_0x<typenum>" (types 0x11-0x1e are undefined by SCSI-3)
9a016c63ca347047a236dff12f0da83aac8981d1stevel# "type_unknown" (type 0x1f)
9a016c63ca347047a236dff12f0da83aac8981d1stevel# In addition to binding to device types, sgen can be configured to bind to one
9a016c63ca347047a236dff12f0da83aac8981d1stevel# or more particular devices. The latter is accomplished by specifying the
9a016c63ca347047a236dff12f0da83aac8981d1stevel# Vendor and Product IDs returned by the device in response to the SCSI INQUIRY
9a016c63ca347047a236dff12f0da83aac8981d1stevel# command. This is accomplished by specifying pairs of Vendor ID and Product ID
9a016c63ca347047a236dff12f0da83aac8981d1stevel# strings in the inquiry-config-list property, below. "*" may be substituted
9a016c63ca347047a236dff12f0da83aac8981d1stevel# for the vendor ID as a wildcard. See sgen(7D) for details and extended usage
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# USAGE EXAMPLE (sgen.conf)
9a016c63ca347047a236dff12f0da83aac8981d1stevel# In this example, sgen is configured to bind to all scanner and ocrw devices in
9a016c63ca347047a236dff12f0da83aac8981d1stevel# the system, as well as the UltraToast 4000 from ACME, and the PowerToast
9a016c63ca347047a236dff12f0da83aac8981d1stevel# series of devices, regardless of vendor.
9a016c63ca347047a236dff12f0da83aac8981d1stevel#device-type-config-list="scanner", "ocrw";
9a016c63ca347047a236dff12f0da83aac8981d1stevel#inquiry-config-list= "ACME", "UltraToast 4000",
9a016c63ca347047a236dff12f0da83aac8981d1stevel# "*", "PowerToast";
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# When using the sgen.conf method, after configuring the
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# device-type-config-list and/or the inquiry-config-list, the administrator
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# must uncomment those target/lun pairs at which there are devices for sgen to
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# control. If it is expected that devices controlled by sgen will be hotplugged
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# or added into the system later, it is recommended that all of the following
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# lines be uncommented.
9a016c63ca347047a236dff12f0da83aac8981d1stevel#name="sgen" class="scsi" target=0 lun=0;
9a016c63ca347047a236dff12f0da83aac8981d1stevel#name="sgen" class="scsi" target=1 lun=0;
9a016c63ca347047a236dff12f0da83aac8981d1stevel#name="sgen" class="scsi" target=2 lun=0;
9a016c63ca347047a236dff12f0da83aac8981d1stevel#name="sgen" class="scsi" target=3 lun=0;
9a016c63ca347047a236dff12f0da83aac8981d1stevel#name="sgen" class="scsi" target=4 lun=0;
9a016c63ca347047a236dff12f0da83aac8981d1stevel#name="sgen" class="scsi" target=5 lun=0;
9a016c63ca347047a236dff12f0da83aac8981d1stevel#name="sgen" class="scsi" target=6 lun=0;
9a016c63ca347047a236dff12f0da83aac8981d1stevel#name="sgen" class="scsi" target=7 lun=0;
9a016c63ca347047a236dff12f0da83aac8981d1stevel#name="sgen" class="scsi" target=8 lun=0;
9a016c63ca347047a236dff12f0da83aac8981d1stevel#name="sgen" class="scsi" target=9 lun=0;
9a016c63ca347047a236dff12f0da83aac8981d1stevel#name="sgen" class="scsi" target=10 lun=0;
9a016c63ca347047a236dff12f0da83aac8981d1stevel#name="sgen" class="scsi" target=11 lun=0;
9a016c63ca347047a236dff12f0da83aac8981d1stevel#name="sgen" class="scsi" target=12 lun=0;
9a016c63ca347047a236dff12f0da83aac8981d1stevel#name="sgen" class="scsi" target=13 lun=0;
9a016c63ca347047a236dff12f0da83aac8981d1stevel#name="sgen" class="scsi" target=14 lun=0;
9a016c63ca347047a236dff12f0da83aac8981d1stevel#name="sgen" class="scsi" target=15 lun=0;