![[first]](../icons/first.png){kind=icon}
![[previous]](../icons/n_left.png){kind=icon}
![[next]](../icons/n_right.png){kind=icon}
![[last]](../icons/n_last.png){kind=icon}
![[top]](../icons/n_top.png){kind=icon}
![[bottom]](../icons/bottom.png){kind=icon}
![[index]](../icons/index.png){kind=icon}
![[help]](../icons/help.png){kind=icon}
*/
1 /*
2 * scsi.h Copyright (C) 1992 Drew Eckhardt
3 * generic SCSI package header file by
4 * Drew Eckhardt
5 *
6 * <drew@colorado.edu>
7 *
8 * Modified by Eric Youngdale eric@tantalus.nrl.navy.mil to
9 * add scatter-gather, multiple outstanding request, and other
10 * enhancements.
11 */
12
13 #ifndef _SCSI_H
14 #define _SCSI_H
15
16 /*
17 $Header: /usr/src/linux/kernel/blk_drv/scsi/RCS/scsi.h,v 1.3 1993/09/24 12:20:33 drew Exp $
18
19 For documentation on the OPCODES, MESSAGES, and SENSE values,
20 please consult the SCSI standard.
21
22 */
23
24 /*
25 SCSI opcodes
26 */
27
28 #define TEST_UNIT_READY 0x00
29 #define REZERO_UNIT 0x01
30 #define REQUEST_SENSE 0x03
31 #define FORMAT_UNIT 0x04
32 #define READ_BLOCK_LIMITS 0x05
33 #define REASSIGN_BLOCKS 0x07
34 #define READ_6 0x08
35 #define WRITE_6 0x0a
36 #define SEEK_6 0x0b
37 #define READ_REVERSE 0x0f
38 #define WRITE_FILEMARKS 0x10
39 #define SPACE 0x11
40 #define INQUIRY 0x12
41 #define RECOVER_BUFFERED_DATA 0x14
42 #define MODE_SELECT 0x15
43 #define RESERVE 0x16
44 #define RELEASE 0x17
45 #define COPY 0x18
46 #define ERASE 0x19
47 #define MODE_SENSE 0x1a
48 #define START_STOP 0x1b
49 #define RECEIVE_DIAGNOSTIC 0x1c
50 #define SEND_DIAGNOSTIC 0x1d
51 #define ALLOW_MEDIUM_REMOVAL 0x1e
52
53 #define READ_CAPACITY 0x25
54 #define READ_10 0x28
55 #define WRITE_10 0x2a
56 #define SEEK_10 0x2b
57 #define WRITE_VERIFY 0x2e
58 #define VERIFY 0x2f
59 #define SEARCH_HIGH 0x30
60 #define SEARCH_EQUAL 0x31
61 #define SEARCH_LOW 0x32
62 #define SET_LIMITS 0x33
63 #define PRE_FETCH 0x34
64 #define READ_POSITION 0x34
65 #define SYNCHRONIZE_CACHE 0x35
66 #define LOCK_UNLOCK_CACHE 0x36
67 #define READ_DEFECT_DATA 0x37
68 #define COMPARE 0x39
69 #define COPY_VERIFY 0x3a
70 #define WRITE_BUFFER 0x3b
71 #define READ_BUFFER 0x3c
72 #define READ_LONG 0x3e
73 #define CHANGE_DEFINITION 0x40
74 #define LOG_SELECT 0x4c
75 #define LOG_SENSE 0x4d
76 #define MODE_SELECT_10 0x55
77 #define MODE_SENSE_10 0x5a
78
79 extern volatile int in_scan_scsis;
80 extern const unsigned char scsi_command_size[8];
81 #define COMMAND_SIZE(opcode) scsi_command_size[((opcode) >> 5) & 7]
82
83 /*
84 MESSAGE CODES
85 */
86
87 #define COMMAND_COMPLETE 0x00
88 #define EXTENDED_MESSAGE 0x01
89 #define EXTENDED_MODIFY_DATA_POINTER 0x00
90 #define EXTENDED_SDTR 0x01
91 #define EXTENDED_EXTENDED_IDENTIFY 0x02 /* SCSI-I only */
92 #define EXTENDED_WDTR 0x03
93 #define SAVE_POINTERS 0x02
94 #define RESTORE_POINTERS 0x03
95 #define DISCONNECT 0x04
96 #define INITIATOR_ERROR 0x05
97 #define ABORT 0x06
98 #define MESSAGE_REJECT 0x07
99 #define NOP 0x08
100 #define MSG_PARITY_ERROR 0x09
101 #define LINKED_CMD_COMPLETE 0x0a
102 #define LINKED_FLG_CMD_COMPLETE 0x0b
103 #define BUS_DEVICE_RESET 0x0c
104
105 #define INITIATE_RECOVERY 0x0f /* SCSI-II only */
106 #define RELEASE_RECOVERY 0x10 /* SCSI-II only */
107
108 #define SIMPLE_QUEUE_TAG 0x20
109 #define HEAD_OF_QUEUE_TAG 0x21
110 #define ORDERED_QUEUE_TAG 0x22
111
112 #define IDENTIFY_BASE 0x80
113 #define IDENTIFY(can_disconnect, lun) (IDENTIFY_BASE |\
114 ((can_disconnect) ? 0x40 : 0) |\
115 ((lun) & 0x07))
116
117
118 /*
119 Status codes
120 */
121
122 #define GOOD 0x00
123 #define CHECK_CONDITION 0x01
124 #define CONDITION_GOOD 0x02
125 #define BUSY 0x04
126 #define INTERMEDIATE_GOOD 0x08
127 #define INTERMEDIATE_C_GOOD 0x0a
128 #define RESERVATION_CONFLICT 0x0c
129
130 #define STATUS_MASK 0x1e
131
132 /*
133 the return of the status word will be in the following format :
134 The low byte is the status returned by the SCSI command,
135 with vendor specific bits masked.
136
137 The next byte is the message which followed the SCSI status.
138 This allows a stos to be used, since the Intel is a little
139 endian machine.
140
141 The final byte is a host return code, which is one of the following.
142
143 IE
144 lsb msb
145 status msg host code
146
147 Our errors returned by OUR driver, NOT SCSI message. Or'd with
148 SCSI message passed back to driver <IF any>.
149 */
150
151 /* NO error */
152 #define DID_OK 0x00
153 /* Couldn't connect before timeout period */
154 #define DID_NO_CONNECT 0x01
155 /* BUS stayed busy through time out period */
156 #define DID_BUS_BUSY 0x02
157 /* TIMED OUT for other reason */
158 #define DID_TIME_OUT 0x03
159 /* BAD target. */
160 #define DID_BAD_TARGET 0x04
161 /* Told to abort for some other reason */
162 #define DID_ABORT 0x05
163 /*
164 Parity error
165 */
166 #define DID_PARITY 0x06
167 /*
168 Internal error
169 */
170 #define DID_ERROR 0x07
171 /*
172 Reset by somebody.
173 */
174 #define DID_RESET 0x08
175 /*
176 Got an interrupt we weren't expecting.
177 */
178 #define DID_BAD_INTR 0x09
179
180 /*
181 Driver status
182 */
183 #define DRIVER_OK 0x00
184
185 /*
186 These indicate the error that occurred, and what is available.
187 */
188
189 #define DRIVER_BUSY 0x01
190 #define DRIVER_SOFT 0x02
191 #define DRIVER_MEDIA 0x03
192 #define DRIVER_ERROR 0x04
193
194 #define DRIVER_INVALID 0x05
195 #define DRIVER_TIMEOUT 0x06
196 #define DRIVER_HARD 0x07
197
198 #define SUGGEST_RETRY 0x10
199 #define SUGGEST_ABORT 0x20
200 #define SUGGEST_REMAP 0x30
201 #define SUGGEST_DIE 0x40
202 #define SUGGEST_SENSE 0x80
203 #define SUGGEST_IS_OK 0xff
204
205 #define DRIVER_SENSE 0x08
206
207 #define DRIVER_MASK 0x0f
208 #define SUGGEST_MASK 0xf0
209
210 /*
211
212 SENSE KEYS
213 */
214
215 #define NO_SENSE 0x00
216 #define RECOVERED_ERROR 0x01
217 #define NOT_READY 0x02
218 #define MEDIUM_ERROR 0x03
219 #define HARDWARE_ERROR 0x04
220 #define ILLEGAL_REQUEST 0x05
221 #define UNIT_ATTENTION 0x06
222 #define DATA_PROTECT 0x07
223 #define BLANK_CHECK 0x08
224 #define COPY_ABORTED 0x0a
225 #define ABORTED_COMMAND 0x0b
226 #define VOLUME_OVERFLOW 0x0d
227 #define MISCOMPARE 0x0e
228
229
230 /*
231 DEVICE TYPES
232
233 */
234
235 #define TYPE_DISK 0x00
236 #define TYPE_TAPE 0x01
237 #define TYPE_PROCESSOR 0x03 /* HP scanners use this */
238 #define TYPE_WORM 0x04 /* Treated as ROM by our system */
239 #define TYPE_ROM 0x05
240 #define TYPE_SCANNER 0x06
241 #define TYPE_MOD 0x07 /* Magneto-optical disk - treated as TYPE_DISK */
242 #define TYPE_NO_LUN 0x7f
243
244
245 #define MAX_COMMAND_SIZE 12
246 /*
247 SCSI command sets
248
249 */
250
251 #define SCSI_UNKNOWN 0
252 #define SCSI_1 1
253 #define SCSI_1_CCS 2
254 #define SCSI_2 3
255
256 /*
257 Every SCSI command starts with a one byte OP-code.
258 The next byte's high three bits are the LUN of the
259 device. Any multi-byte quantities are stored high byte
260 first, and may have a 5 bit MSB in the same byte
261 as the LUN.
262 */
263
264 /*
265 Manufacturers list
266 */
267
268 #define SCSI_MAN_UNKNOWN 0
269 #define SCSI_MAN_NEC 1
270 #define SCSI_MAN_TOSHIBA 2
271
272 /*
273 The scsi_device struct contains what we know about each given scsi
274 device.
275 */
276
277 typedef struct scsi_device {
278 struct scsi_device * next; /* Used for linked list */
279 unsigned char id, lun;
280 unsigned int manufacturer; /* Manufacturer of device, for using vendor-specific cmd's */
281 int attached; /* # of high level drivers attached to this */
282 int access_count; /* Count of open channels/mounts */
283 struct wait_queue * device_wait; /* Used to wait if device is busy */
284 struct Scsi_Host * host;
285 void (*scsi_request_fn)(void); /* Used to jumpstart things after an ioctl */
286 void *hostdata; /* available to low-level driver */
287 char type;
288 char scsi_level;
289 unsigned writeable:1;
290 unsigned removable:1;
291 unsigned random:1;
292 unsigned changed:1; /* Data invalid due to media change */
293 unsigned busy:1; /* Used to prevent races */
294 unsigned lockable:1; /* Able to prevent media removal */
295 unsigned borken:1; /* Tell the Seagate driver to be
296 painfully slow on this device */
297 unsigned tagged_supported:1; /* Supports SCSI-II tagged queuing */
298 unsigned tagged_queue:1; /*SCSI-II tagged queuing enabled */
299 unsigned disconnect:1; /* can disconnect */
300 unsigned soft_reset:1; /* Uses soft reset option */
301 unsigned char current_tag; /* current tag */
302 unsigned sync:1; /* Negotiate for sync transfers */
303 unsigned char sync_min_period; /* Not less than this period */
304 unsigned char sync_max_offset; /* Not greater than this offset */
305 } Scsi_Device;
306 /*
307 Use these to separate status msg and our bytes
308 */
309
310 #define status_byte(result) (((result) >> 1) & 0xf)
311 #define msg_byte(result) (((result) >> 8) & 0xff)
312 #define host_byte(result) (((result) >> 16) & 0xff)
313 #define driver_byte(result) (((result) >> 24) & 0xff)
314 #define suggestion(result) (driver_byte(result) & SUGGEST_MASK)
315
316 #define sense_class(sense) (((sense) >> 4) & 0x7)
317 #define sense_error(sense) ((sense) & 0xf)
318 #define sense_valid(sense) ((sense) & 0x80);
319
320 /*
321 These are the SCSI devices available on the system.
322 */
323
324 extern Scsi_Device * scsi_devices;
325 /*
326 Initializes all SCSI devices. This scans all scsi busses.
327 */
328
329 extern unsigned long scsi_dev_init (unsigned long, unsigned long);
330
331 struct scatterlist {
332 char * address; /* Location data is to be transferred to */
333 char * alt_address; /* Location of actual if address is a
334 dma indirect buffer. NULL otherwise */
335 unsigned int length;
336 };
337
338 #define ISA_DMA_THRESHOLD (0x00ffffff)
339 #define CONTIGUOUS_BUFFERS(X,Y) ((X->b_data+X->b_size) == Y->b_data)
340
341
342 /*
343 * These are the return codes for the abort and reset functions. The mid-level
344 * code uses these to decide what to do next. Each of the low level abort
345 * and reset functions must correctly indicate what it has done.
346 */
347
348 /* We did not do anything. Wait
349 some more for this command to complete, and if this does not work, try
350 something more serious. */
351 #define SCSI_ABORT_SNOOZE 0
352
353 /* This means that we were able to abort the command. We have already
354 called the mid-level done function, and do not expect an interrupt that will
355 lead to another call to the mid-level done function for this command */
356 #define SCSI_ABORT_SUCCESS 1
357
358 /* We called for an abort of this command, and we should get an interrupt
359 when this succeeds. Thus we should not restore the timer for this
360 command in the mid-level abort function. */
361 #define SCSI_ABORT_PENDING 2
362
363 /* Unable to abort - command is currently on the bus. Grin and bear it. */
364 #define SCSI_ABORT_BUSY 3
365
366 /* The command is not active in the low level code. Command probably
367 finished. */
368 #define SCSI_ABORT_NOT_RUNNING 4
369
370 /* Something went wrong. The low level driver will indicate the correct
371 error condition when it calls scsi_done, so the mid-level abort function
372 can simply wait until this comes through */
373 #define SCSI_ABORT_ERROR 5
374
375 /* We do not know how to reset the bus, or we do not want to. Bummer.
376 Anyway, just wait a little more for the command in question, and hope that
377 it eventually finishes. If it never finishes, the SCSI device could
378 hang, so use this with caution. */
379 #define SCSI_RESET_SNOOZE 0
380
381 /* We do not know how to reset the bus, or we do not want to. Bummer.
382 We have given up on this ever completing. The mid-level code will
383 request sense information to decide how to proceed from here. */
384 #define SCSI_RESET_PUNT 1
385
386 /* This means that we were able to reset the bus. We have restarted all of
387 the commands that should be restarted, and we should be able to continue
388 on normally from here. We do not expect any interrupts that will return
389 DID_RESET to any of the other commands in the host_queue, and the mid-level
390 code does not need to do anything special to keep the commands alive. */
391 #define SCSI_RESET_SUCCESS 2
392
393 /* We called for an reset of this bus, and we should get an interrupt
394 when this succeeds. Each command should get it's own status
395 passed up to scsi_done, but this has not happened yet. */
396 #define SCSI_RESET_PENDING 3
397
398 /* We did a reset, but do not expect an interrupt to signal DID_RESET.
399 This tells the upper level code to request the sense info, and this
400 should keep the command alive. */
401 #define SCSI_RESET_WAKEUP 4
402
403 /* Something went wrong, and we do not know how to fix it. */
404 #define SCSI_RESET_ERROR 5
405
406 void * scsi_malloc(unsigned int);
407 int scsi_free(void *, unsigned int);
408 extern unsigned int dma_free_sectors; /* How much room do we have left */
409 extern unsigned int need_isa_buffer; /* True if some devices need indirection
410 buffers */
411
412 /*
413 The Scsi_Cmnd structure is used by scsi.c internally, and for communication with
414 low level drivers that support multiple outstanding commands.
415 */
416 typedef struct scsi_pointer {
417 char * ptr; /* data pointer */
418 int this_residual; /* left in this buffer */
419 struct scatterlist *buffer; /* which buffer */
420 int buffers_residual; /* how many buffers left */
421
422 volatile int Status;
423 volatile int Message;
424 volatile int have_data_in;
425 volatile int sent_command;
426 volatile int phase;
427 } Scsi_Pointer;
428
429 typedef struct scsi_cmnd {
430 struct Scsi_Host * host;
431 Scsi_Device * device;
432 unsigned char target, lun;
433 unsigned char cmd_len;
434 unsigned char old_cmd_len;
435 struct scsi_cmnd *next, *prev;
436
437 /* These elements define the operation we are about to perform */
438 unsigned char cmnd[12];
439 unsigned request_bufflen; /* Actual request size */
440
441 void * request_buffer; /* Actual requested buffer */
442
443 /* These elements define the operation we ultimately want to perform */
444 unsigned char data_cmnd[12];
445 unsigned short old_use_sg; /* We save use_sg here when requesting
446 sense info */
447 unsigned short use_sg; /* Number of pieces of scatter-gather */
448 unsigned short sglist_len; /* size of malloc'd scatter-gather list */
449 unsigned short abort_reason; /* If the mid-level code requests an
450 abort, this is the reason. */
451 unsigned bufflen; /* Size of data buffer */
452 void *buffer; /* Data buffer */
453
454 unsigned underflow; /* Return error if less than this amount is
455 transfered */
456
457 unsigned transfersize; /* How much we are guaranteed to transfer with
458 each SCSI transfer (ie, between disconnect /
459 reconnects. Probably == sector size */
460
461
462
463 struct request request; /* A copy of the command we are working on*/
464
465 unsigned char sense_buffer[16]; /* Sense for this command, if needed*/
466
467
468 int retries;
469 int allowed;
470 int timeout_per_command, timeout_total, timeout;
471 /*
472 * We handle the timeout differently if it happens when a reset,
473 * abort, etc are in process.
474 */
475
476 unsigned volatile char internal_timeout;
477
478 unsigned flags;
479
480 /* These variables are for the cdrom only. Once we have variable size buffers
481 in the buffer cache, they will go away. */
482 int this_count;
483 /* End of special cdrom variables */
484
485 /* Low-level done function - can be used by low-level driver to point
486 to completion function. Not used by mid/upper level code. */
487 void (*scsi_done)(struct scsi_cmnd *);
488 void (*done)(struct scsi_cmnd *); /* Mid-level done function */
489
490 /* The following fields can be written to by the host specific code.
491 Everything else should be left alone. */
492
493 Scsi_Pointer SCp; /* Scratchpad used by some host adapters */
494
495 unsigned char * host_scribble; /* The host adapter is allowed to
496 call scsi_malloc and get some memory
497 and hang it here. The host adapter
498 is also expected to call scsi_free
499 to release this memory. (The memory
500 obtained by scsi_malloc is guaranteed
501 to be at an address < 16Mb). */
502
503 int result; /* Status code from lower level driver */
504
505 unsigned char tag; /* SCSI-II queued command tag */
506 unsigned long pid; /* Process ID, starts at 0 */
507 } Scsi_Cmnd;
508
509 /*
510 scsi_abort aborts the current command that is executing on host host.
511 The error code, if non zero is returned in the host byte, otherwise
512 DID_ABORT is returned in the hostbyte.
513 */
514
515 extern int scsi_abort (Scsi_Cmnd *, int code, int pid);
516
517 extern void scsi_do_cmd (Scsi_Cmnd *, const void *cmnd ,
518 void *buffer, unsigned bufflen, void (*done)(struct scsi_cmnd *),
519 int timeout, int retries);
520
521
522 extern Scsi_Cmnd * allocate_device(struct request **, Scsi_Device *, int);
523
524 extern Scsi_Cmnd * request_queueable(struct request *, Scsi_Device *);
525 extern int scsi_reset (Scsi_Cmnd *);
526
527 extern int max_scsi_hosts;
528
529 #if defined(MAJOR_NR) && (MAJOR_NR != SCSI_TAPE_MAJOR)
530 static Scsi_Cmnd * end_scsi_request(Scsi_Cmnd * SCpnt, int uptodate, int sectors)
/* ![[first]](../icons/n_first.png)
![[top]](../icons/top.png)
*/
531 {
532 struct request * req;
533 struct buffer_head * bh;
534
535 req = &SCpnt->request;
536 req->errors = 0;
537 if (!uptodate) {
538 printk(DEVICE_NAME " I/O error: dev %04x, sector %lu\n",
539 req->dev,req->sector);
540 }
541
542 do {
543 if ((bh = req->bh) != NULL) {
544 req->bh = bh->b_reqnext;
545 req->nr_sectors -= bh->b_size >> 9;
546 req->sector += bh->b_size >> 9;
547 bh->b_reqnext = NULL;
548 bh->b_uptodate = uptodate;
549 unlock_buffer(bh);
550 sectors -= bh->b_size >> 9;
551 if ((bh = req->bh) != NULL) {
552 req->current_nr_sectors = bh->b_size >> 9;
553 if (req->nr_sectors < req->current_nr_sectors) {
554 req->nr_sectors = req->current_nr_sectors;
555 printk("end_scsi_request: buffer-list destroyed\n");
556 }
557 }
558 }
559 } while(sectors && bh);
560 if (req->bh){
561 req->buffer = bh->b_data;
562 return SCpnt;
563 };
564 DEVICE_OFF(req->dev);
565 if (req->sem != NULL) {
566 up(req->sem);
567 }
568 req->dev = -1;
569 wake_up(&wait_for_request);
570 wake_up(&SCpnt->device->device_wait);
571 return NULL;
572 }
573
574
575 /* This is just like INIT_REQUEST, but we need to be aware of the fact
576 that an interrupt may start another request, so we run this with interrupts
577 turned off */
578
579 #define INIT_SCSI_REQUEST \
580 if (!CURRENT) {\
581 CLEAR_INTR; \
582 restore_flags(flags); \
583 return; \
584 } \
585 if (MAJOR(CURRENT->dev) != MAJOR_NR) \
586 panic(DEVICE_NAME ": request list destroyed"); \
587 if (CURRENT->bh) { \
588 if (!CURRENT->bh->b_lock) \
589 panic(DEVICE_NAME ": block not locked"); \
590 }
591 #endif
592
593 #define SCSI_SLEEP(QUEUE, CONDITION) { \
594 if (CONDITION) { \
595 struct wait_queue wait = { current, NULL}; \
596 add_wait_queue(QUEUE, &wait); \
597 sleep_repeat: \
598 current->state = TASK_UNINTERRUPTIBLE; \
599 if (CONDITION) { \
600 schedule(); \
601 goto sleep_repeat; \
602 } \
603 remove_wait_queue(QUEUE, &wait); \
604 current->state = TASK_RUNNING; \
605 }; }
606
607 #endif
![[last]](../icons/last.png){kind=icon}
![[bottom]](../icons/n_bottom.png){kind=icon}
*/