include/scsi/scsi_eh.h

   1 #ifndef _SCSI_SCSI_EH_H
   2 #define _SCSI_SCSI_EH_H
   3
   4 #include <linux/scatterlist.h>
   5
   6 #include <scsi/scsi_cmnd.h>
   7 struct scsi_device;
   8 struct Scsi_Host;
   9
  10 /*
  11  * This is a slightly modified SCSI sense "descriptor" format header.
  12  * The addition is to allow the 0x70 and 0x71 response codes. The idea
  13  * is to place the salient data from either "fixed" or "descriptor" sense
  14  * format into one structure to ease application processing.
  15  *
  16  * The original sense buffer should be kept around for those cases
  17  * in which more information is required (e.g. the LBA of a MEDIUM ERROR).
  18  */
  19 struct scsi_sense_hdr {         /* See SPC-3 section 4.5 */
  20         u8 response_code;       /* permit: 0x0, 0x70, 0x71, 0x72, 0x73 */
  21         u8 sense_key;
  22         u8 asc;
  23         u8 ascq;
  24         u8 byte4;
  25         u8 byte5;
  26         u8 byte6;
  27         u8 additional_length;   /* always 0 for fixed sense format */
  28 };
  29
  30 static inline int scsi_sense_valid(struct scsi_sense_hdr *sshdr)
  31 {
  32         if (!sshdr)
  33                 return 0;
  34
  35         return (sshdr->response_code & 0x70) == 0x70;
  36 }
  37
  38
  39 extern void scsi_eh_finish_cmd(struct scsi_cmnd *scmd,
  40                                struct list_head *done_q);
  41 extern void scsi_eh_flush_done_q(struct list_head *done_q);
  42 extern void scsi_report_bus_reset(struct Scsi_Host *, int);
  43 extern void scsi_report_device_reset(struct Scsi_Host *, int, int);
  44 extern int scsi_block_when_processing_errors(struct scsi_device *);
  45 extern int scsi_normalize_sense(const u8 *sense_buffer, int sb_len,
  46                 struct scsi_sense_hdr *sshdr);
  47 extern int scsi_command_normalize_sense(struct scsi_cmnd *cmd,
  48                 struct scsi_sense_hdr *sshdr);
  49
  50 static inline int scsi_sense_is_deferred(const struct scsi_sense_hdr *sshdr)
  51 {
  52         return ((sshdr->response_code >= 0x70) && (sshdr->response_code & 1));
  53 }
  54
  55 extern const u8 * scsi_sense_desc_find(const u8 * sense_buffer, int sb_len,
  56                                        int desc_type);
  57
  58 extern int scsi_get_sense_info_fld(const u8 * sense_buffer, int sb_len,
  59                                    u64 * info_out);
  60
  61 extern void scsi_build_sense_buffer(int desc, u8 *buf, u8 key, u8 asc, u8 ascq);
  62
  63 /*
  64  * Reset request from external source
  65  * Note: if SCSI_TRY_RESET_DEVICE fails then it will escalate to
  66  * SCSI_TRY_RESET_TARGET which if it fails will escalate to
  67  * SCSI_TRY_RESET_BUS which if it fails will escalate to SCSI_TRY_RESET_HOST.
  68  * To prevent escalation OR with SCSI_TRY_RESET_NO_ESCALATE.
  69  */
  70 #define SCSI_TRY_RESET_DEVICE   1
  71 #define SCSI_TRY_RESET_BUS      2
  72 #define SCSI_TRY_RESET_HOST     3
  73 #define SCSI_TRY_RESET_TARGET   4
  74 #define SCSI_TRY_RESET_NO_ESCALATE      0x100   /* OR-ed to prior defines */
  75
  76 extern int scsi_reset_provider(struct scsi_device *, int);
  77
  78 struct scsi_eh_save {
  79         /* saved state */
  80         int result;
  81         enum dma_data_direction data_direction;
  82         unsigned underflow;
  83         unsigned char cmd_len;
  84         unsigned char prot_op;
  85         unsigned char *cmnd;
  86         struct scsi_data_buffer sdb;
  87         struct request *next_rq;
  88         /* new command support */
  89         unsigned char eh_cmnd[BLK_MAX_CDB];
  90         struct scatterlist sense_sgl;
  91 };
  92
  93 extern void scsi_eh_prep_cmnd(struct scsi_cmnd *scmd,
  94                 struct scsi_eh_save *ses, unsigned char *cmnd,
  95                 int cmnd_size, unsigned sense_bytes);
  96
  97 extern void scsi_eh_restore_cmnd(struct scsi_cmnd* scmd,
  98                 struct scsi_eh_save *ses);
  99
 100 #endif /* _SCSI_SCSI_EH_H */