1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
|
/*
* 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
* or http://www.opensolaris.org/os/licensing.
* 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)
*/
#define SCSI_DEBUG_TGT 0x1 /* debug statements in target drivers */
#define SCSI_DEBUG_LIB 0x2 /* debug statements in library */
#define SCSI_DEBUG_HA 0x4 /* debug statements in host adapters */
/*
* Following are applicable to all interconnects
*/
#define SCSI_OPTIONS_LINK 0x10 /* Global linked commands */
#define SCSI_OPTIONS_TAG 0x80 /* Global tagged command support */
/*
* Following are for parallel SCSI only
*/
#define SCSI_OPTIONS_DR 0x8 /* Global disconnect/reconnect */
#define SCSI_OPTIONS_SYNC 0x20 /* Global synchronous xfer capability */
#define SCSI_OPTIONS_PARITY 0x40 /* Global parity support */
#define SCSI_OPTIONS_FAST 0x100 /* Global FAST scsi support */
#define SCSI_OPTIONS_WIDE 0x200 /* Global WIDE scsi support */
#define SCSI_OPTIONS_FAST20 0x400 /* Global FAST20 scsi support */
#define SCSI_OPTIONS_FAST40 0x800 /* Global FAST40 scsi support */
#define SCSI_OPTIONS_FAST80 0x1000 /* Global FAST80 scsi support */
#define SCSI_OPTIONS_FAST160 0x2000 /* Global FAST160 scsi support */
#define SCSI_OPTIONS_FAST320 0x4000 /* Global FAST320 scsi support */
/*
* 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)
#define SCSI_OPTIONS_QAS 0x100000 /* Global Quick Arbitration Select */
/*
* 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_NONCCS 1 /* device exists, no inquiry data */
#define SCSIPROBE_NORESP 2 /* device didn't respond */
#define SCSIPROBE_NOMEM 3 /* no space available for structures */
#define SCSIPROBE_FAILURE 4 /* polled cmnd failure- unspecified */
#define SCSIPROBE_BUSY 5 /* device was busy */
#define SCSIPROBE_NOMEM_CB 6 /* no space, callback queued */
#define SCSIPROBE_ASCII \
{"EXISTS", "NONCCS", "NORESP", "NOMEM", \
"FAILURE", "BUSY", "NOMEM_CB", NULL}
/*
* 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
* "scsi-enumeration" property. In addition to enabling/disabling enumeration
* (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;
* 7 dynamic enumeration with target/lun 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 */
|
