root/drivers/scsi/scsi.h

/* [previous][next][first][last][top][bottom][index][help] */

INCLUDED FROM


DEFINITIONS

This source file includes following definitions.
  1. end_scsi_request

   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)
     /* [previous][next][first][last][top][bottom][index][help] */
 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

/* [previous][next][first][last][top][bottom][index][help] */