Branch data     Line data    Source code

       1                 :            : /* SPDX-License-Identifier: GPL-2.0 */
       2                 :            : /*
       3                 :            :  * Functions used by both the SCSI initiator code and the SCSI target code.
       4                 :            :  */
       5                 :            : 
       6                 :            : #ifndef _SCSI_COMMON_H_
       7                 :            : #define _SCSI_COMMON_H_
       8                 :            : 
       9                 :            : #include <linux/types.h>
      10                 :            : #include <scsi/scsi_proto.h>
      11                 :            : 
      12                 :            : static inline unsigned
      13                 :          0 : scsi_varlen_cdb_length(const void *hdr)
      14                 :            : {
      15         [ #  # ]:          0 :         return ((struct scsi_varlen_cdb_hdr *)hdr)->additional_cdb_length + 8;
      16                 :            : }
      17                 :            : 
      18                 :            : extern const unsigned char scsi_command_size_tbl[8];
      19                 :            : #define COMMAND_SIZE(opcode) scsi_command_size_tbl[((opcode) >> 5) & 7]
      20                 :            : 
      21                 :            : static inline unsigned
      22                 :          0 : scsi_command_size(const unsigned char *cmnd)
      23                 :            : {
      24                 :          0 :         return (cmnd[0] == VARIABLE_LENGTH_CMD) ?
      25         [ #  # ]:          0 :                 scsi_varlen_cdb_length(cmnd) : COMMAND_SIZE(cmnd[0]);
      26                 :            : }
      27                 :            : 
      28                 :            : /* Returns a human-readable name for the device */
      29                 :            : extern const char *scsi_device_type(unsigned type);
      30                 :            : 
      31                 :            : extern void int_to_scsilun(u64, struct scsi_lun *);
      32                 :            : extern u64 scsilun_to_int(struct scsi_lun *);
      33                 :            : 
      34                 :            : /*
      35                 :            :  * This is a slightly modified SCSI sense "descriptor" format header.
      36                 :            :  * The addition is to allow the 0x70 and 0x71 response codes. The idea
      37                 :            :  * is to place the salient data from either "fixed" or "descriptor" sense
      38                 :            :  * format into one structure to ease application processing.
      39                 :            :  *
      40                 :            :  * The original sense buffer should be kept around for those cases
      41                 :            :  * in which more information is required (e.g. the LBA of a MEDIUM ERROR).
      42                 :            :  */
      43                 :            : struct scsi_sense_hdr {         /* See SPC-3 section 4.5 */
      44                 :            :         u8 response_code;       /* permit: 0x0, 0x70, 0x71, 0x72, 0x73 */
      45                 :            :         u8 sense_key;
      46                 :            :         u8 asc;
      47                 :            :         u8 ascq;
      48                 :            :         u8 byte4;
      49                 :            :         u8 byte5;
      50                 :            :         u8 byte6;
      51                 :            :         u8 additional_length;   /* always 0 for fixed sense format */
      52                 :            : };
      53                 :            : 
      54                 :        924 : static inline bool scsi_sense_valid(const struct scsi_sense_hdr *sshdr)
      55                 :            : {
      56   [ +  -  +  -  :        924 :         if (!sshdr)
             -  -  -  - ]
      57                 :            :                 return false;
      58                 :            : 
      59   [ +  -  +  +  :        924 :         return (sshdr->response_code & 0x70) == 0x70;
          -  -  -  -  -  
          -  -  -  -  -  
          -  -  -  +  -  
                      - ]
      60                 :            : }
      61                 :            : 
      62                 :            : extern bool scsi_normalize_sense(const u8 *sense_buffer, int sb_len,
      63                 :            :                                  struct scsi_sense_hdr *sshdr);
      64                 :            : 
      65                 :            : extern void scsi_build_sense_buffer(int desc, u8 *buf, u8 key, u8 asc, u8 ascq);
      66                 :            : int scsi_set_sense_information(u8 *buf, int buf_len, u64 info);
      67                 :            : int scsi_set_sense_field_pointer(u8 *buf, int buf_len, u16 fp, u8 bp, bool cd);
      68                 :            : extern const u8 * scsi_sense_desc_find(const u8 * sense_buffer, int sb_len,
      69                 :            :                                        int desc_type);
      70                 :            : 
      71                 :            : #endif /* _SCSI_COMMON_H_ */