autoconf.h revision 4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License (the "License").
* You may not use this file except in compliance with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* Copyright 2009 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
#ifndef _SYS_SCSI_CONF_AUTOCONF_H
#define _SYS_SCSI_CONF_AUTOCONF_H
#ifdef __cplusplus
extern "C" {
#endif
/*
* SCSI subsystem scsi_options
*/
/*
* Following are for debugging purposes (few Sun drivers support this)
*/
/*
* Following are applicable to all interconnects
*/
/*
* Following are for parallel SCSI only
*/
/*
* The following 3 bits are for being able to limit the max. number of LUNs
* a nexus driver will allow -- "default" means that the adapter will
* continue its default behavior.
*/
#define SCSI_OPTIONS_NLUNS_MASK (0x70000)
#define SCSI_OPTIONS_NLUNS_DEFAULT 0x00000
#define SCSI_OPTIONS_NLUNS_1 0x10000
#define SCSI_OPTIONS_NLUNS_8 0x20000
#define SCSI_OPTIONS_NLUNS_16 0x30000
#define SCSI_OPTIONS_NLUNS_32 0x40000
#define SCSI_OPTIONS_NLUNS_64 0x50000
#define SCSI_OPTIONS_NLUNS_128 0x60000
#define SCSI_OPTIONS_NLUNS_256 0x70000
#define SCSI_OPTIONS_NLUNS(n) ((n) & SCSI_OPTIONS_NLUNS_MASK)
/*
* SCSI autoconfiguration definitions.
*
* The library routine scsi_slave() is provided as a service to target
* driver to check for existence and readiness of a SCSI device. It is
* defined as:
*
* int scsi_slave(struct scsi_device *devp, int (*callback)(void))
*
* where devp is the scsi_device structure passed to the target driver
* at probe time, and where callback declares whether scsi_slave() can
* sleep awaiting resources or must return an error if it cannot get
* resources (callback == SLEEP_FUNC implies that scsi_slave()
* can sleep - although this
* does not fully guarantee that resources will become available as
* some are allocated from the iopbmap which may just be completely
* full). The user call also supplies a callback function or NULL_FUNC.
* In the process of determining the existence of a SCSI device,
* scsi_slave will allocate space for the sd_inq field of the scsi_device
* pointed to by devp (if it is non-zero upon entry).
*
* scsi_slave() attempts to follow this sequence in order to determine
* the existence of a SCSI device:
*
* Attempt to send 2 TEST UNIT READY commands to the device.
*
* If that gets a check condition, run a non-extended
* REQUEST SENSE command. Ignore the results of it, as
* a the non-extended sense information contains only
* Vendor Unique error codes (the idea is that during
* probe time the nearly invariant first command to a
* device will get a Check Condition, and the real reason
* is that the device wants to tell you that a SCSI bus
* reset just occurred.
*
* Attempt to allocate an inquiry buffer and
* run an INQUIRY command (with response data format 0 set).
*
* If that gets a check condition, run another
* non-extended REQUEST SENSE command.
*
* The library routine scsi_probe() is provided as a service to target
* driver to check for bare-bones existence of a SCSI device. It is
* defined as:
*
* int scsi_probe(struct scsi_device *devp, int (*callback)(void))
*
* scsi_probe() only executes an inquiry.
*
* Both functions return one of the integer values as defined below:
*/
#define SCSIPROBE_EXISTS 0 /* device exists, inquiry data valid */
#define SCSIPROBE_ASCII \
{"EXISTS", "NONCCS", "NORESP", "NOMEM", \
/*
* default value for scsi_reset_delay
*/
#define SCSI_DEFAULT_RESET_DELAY 3000
/*
* default value for scsi_selection_timeout
*/
#define SCSI_DEFAULT_SELECTION_TIMEOUT 250
/*
* SCSI subsystem scsi_enumeration options.
*
* Knob for SPI (SCSI Parallel Intrconnect) enumeration. Unless an HBA defines
* it's own tran_bus_config, SPI enumeration is used. The "scsi_enumeration"
* knob determines how SPI enumeration is performed.
*
* The global variable "scsi_enumeration" is used as the default value of the
* (bit 0), target and lun threading can be specified. Having things
* multi-threaded does not guarantee reduce configuration time, however when
* the bus is marginal multi-threading can substaintaly reduce configuration
* time because targets negotiate to stable transfer speeds in parallel - so
* all targets have stabalized by the time the sequential attach(9E) operations
* begin. Running multi-threaded also helps verification of framework and HBA
* locking: a BUS_CONFIG_ALL is equivalent to every target and lun combination
* getting a BUS_CONFIG_ONE from a separate thread at the same time. A disable
* mechanism is provided to accomidate buggy HBAs (set scsi-enumeration=7
* driver.conf). Values are:
*
* 0 driver.conf enumeration
* 1 dynamic enumeration with target and lun multi-threading.
* 3 dynamic enumeration with lun multi-threading disabled.
* 5 dynamic enumeration with target multi-threading disabled;
*/
#define SCSI_ENUMERATION_ENABLE 0x1
#define SCSI_ENUMERATION_MT_LUN_DISABLE 0x2
#define SCSI_ENUMERATION_MT_TARGET_DISABLE 0x4
#ifdef _KERNEL
/*
* Global SCSI config variables / options
*/
extern int scsi_options;
extern int scsi_enumeration;
extern unsigned int scsi_reset_delay; /* specified in milli seconds */
extern int scsi_tag_age_limit;
extern int scsi_watchdog_tick;
extern int scsi_selection_timeout; /* specified in milli seconds */
extern int scsi_host_id;
extern int scsi_fm_capable;
#endif /* _KERNEL */
#ifdef __cplusplus
}
#endif
#endif /* _SYS_SCSI_CONF_AUTOCONF_H */