sys/cam/cam.h

   1 /*-
   2  * Data structures and definitions for the CAM system.
   3  *
   4  * Copyright (c) 1997 Justin T. Gibbs.
   5  * All rights reserved.
   6  *
   7  * Redistribution and use in source and binary forms, with or without
   8  * modification, are permitted provided that the following conditions
   9  * are met:
  10  * 1. Redistributions of source code must retain the above copyright
  11  *    notice, this list of conditions, and the following disclaimer,
  12  *    without modification, immediately at the beginning of the file.
  13  * 2. The name of the author may not be used to endorse or promote products
  14  *    derived from this software without specific prior written permission.
  15  *
  16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  19  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
  20  * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  26  * SUCH DAMAGE.
  27  *
  28  * $FreeBSD$
  29  */
  30
  31 #ifndef _CAM_CAM_H
  32 #define _CAM_CAM_H 1
  33
  34 #ifdef _KERNEL
  35 #include <opt_cam.h>
  36 #endif
  37
  38 #include <sys/cdefs.h>
  39
  40 typedef u_int path_id_t;
  41 typedef u_int target_id_t;
  42 typedef u_int lun_id_t;
  43
  44 #define CAM_XPT_PATH_ID ((path_id_t)~0)
  45 #define CAM_BUS_WILDCARD ((path_id_t)~0)
  46 #define CAM_TARGET_WILDCARD ((target_id_t)~0)
  47 #define CAM_LUN_WILDCARD ((lun_id_t)~0)
  48
  49 /*
  50  * Maximum length for a CAM CDB.
  51  */
  52 #define CAM_MAX_CDBLEN 16
  53
  54 /*
  55  * Definition of a CAM peripheral driver entry.  Peripheral drivers instantiate
  56  * one of these for each device they wish to communicate with and pass it into
  57  * the xpt layer when they wish to schedule work on that device via the
  58  * xpt_schedule API.
  59  */
  60 struct cam_periph;
  61
  62 /*
  63  * Priority information for a CAM structure.
  64  */
  65 typedef enum {
  66     CAM_RL_HOST,
  67     CAM_RL_BUS,
  68     CAM_RL_XPT,
  69     CAM_RL_DEV,
  70     CAM_RL_NORMAL,
  71     CAM_RL_VALUES
  72 } cam_rl;
  73 /*
  74  * The generation number is incremented everytime a new entry is entered into
  75  * the queue giving round robin per priority level scheduling.
  76  */
  77 typedef struct {
  78         u_int32_t priority;
  79 #define CAM_PRIORITY_HOST       ((CAM_RL_HOST << 8) + 0x80)
  80 #define CAM_PRIORITY_BUS        ((CAM_RL_BUS << 8) + 0x80)
  81 #define CAM_PRIORITY_XPT        ((CAM_RL_XPT << 8) + 0x80)
  82 #define CAM_PRIORITY_DEV        ((CAM_RL_DEV << 8) + 0x80)
  83 #define CAM_PRIORITY_NORMAL     ((CAM_RL_NORMAL << 8) + 0x80)
  84 #define CAM_PRIORITY_NONE       (u_int32_t)-1
  85 #define CAM_PRIORITY_TO_RL(x)   ((x) >> 8)
  86 #define CAM_RL_TO_PRIORITY(x)   ((x) << 8)
  87         u_int32_t generation;
  88         int       index;
  89 #define CAM_UNQUEUED_INDEX      -1
  90 #define CAM_ACTIVE_INDEX        -2
  91 #define CAM_DONEQ_INDEX         -3
  92 } cam_pinfo;
  93
  94 /*
  95  * Macro to compare two generation numbers.  It is used like this:
  96  *
  97  *      if (GENERATIONCMP(a, >=, b))
  98  *              ...;
  99  *
 100  * GERERATIONCMP uses modular arithmetic to guard against wraps
 101  * wraps in the generation number.
 102  */
 103 #define GENERATIONCMP(x, op, y) ((int32_t)((x) - (y)) op 0)
 104
 105 /* CAM flags XXX Move to cam_periph.h ??? */
 106 typedef enum {
 107         CAM_FLAG_NONE           = 0x00,
 108         CAM_EXPECT_INQ_CHANGE   = 0x01,
 109         CAM_RETRY_SELTO         = 0x02 /* Retry Selection Timeouts */
 110 } cam_flags;
 111
 112 /* CAM  Status field values */
 113 typedef enum {
 114         CAM_REQ_INPROG,         /* CCB request is in progress */
 115         CAM_REQ_CMP,            /* CCB request completed without error */
 116         CAM_REQ_ABORTED,        /* CCB request aborted by the host */
 117         CAM_UA_ABORT,           /* Unable to abort CCB request */
 118         CAM_REQ_CMP_ERR,        /* CCB request completed with an error */
 119         CAM_BUSY,               /* CAM subsystem is busy */
 120         CAM_REQ_INVALID,        /* CCB request was invalid */
 121         CAM_PATH_INVALID,       /* Supplied Path ID is invalid */
 122         CAM_DEV_NOT_THERE,      /* SCSI Device Not Installed/there */
 123         CAM_UA_TERMIO,          /* Unable to terminate I/O CCB request */
 124         CAM_SEL_TIMEOUT,        /* Target Selection Timeout */
 125         CAM_CMD_TIMEOUT,        /* Command timeout */
 126         CAM_SCSI_STATUS_ERROR,  /* SCSI error, look at error code in CCB */
 127         CAM_MSG_REJECT_REC,     /* Message Reject Received */
 128         CAM_SCSI_BUS_RESET,     /* SCSI Bus Reset Sent/Received */
 129         CAM_UNCOR_PARITY,       /* Uncorrectable parity error occurred */
 130         CAM_AUTOSENSE_FAIL = 0x10,/* Autosense: request sense cmd fail */
 131         CAM_NO_HBA,             /* No HBA Detected error */
 132         CAM_DATA_RUN_ERR,       /* Data Overrun error */
 133         CAM_UNEXP_BUSFREE,      /* Unexpected Bus Free */
 134         CAM_SEQUENCE_FAIL,      /* Target Bus Phase Sequence Failure */
 135         CAM_CCB_LEN_ERR,        /* CCB length supplied is inadequate */
 136         CAM_PROVIDE_FAIL,       /* Unable to provide requested capability */
 137         CAM_BDR_SENT,           /* A SCSI BDR msg was sent to target */
 138         CAM_REQ_TERMIO,         /* CCB request terminated by the host */
 139         CAM_UNREC_HBA_ERROR,    /* Unrecoverable Host Bus Adapter Error */
 140         CAM_REQ_TOO_BIG,        /* The request was too large for this host */
 141         CAM_REQUEUE_REQ,        /*
 142                                  * This request should be requeued to preserve
 143                                  * transaction ordering.  This typically occurs
 144                                  * when the SIM recognizes an error that should
 145                                  * freeze the queue and must place additional
 146                                  * requests for the target at the sim level
 147                                  * back into the XPT queue.
 148                                  */
 149         CAM_ATA_STATUS_ERROR,   /* ATA error, look at error code in CCB */
 150         CAM_SCSI_IT_NEXUS_LOST, /* Initiator/Target Nexus lost. */
 151         CAM_IDE = 0x33,         /* Initiator Detected Error */
 152         CAM_RESRC_UNAVAIL,      /* Resource Unavailable */
 153         CAM_UNACKED_EVENT,      /* Unacknowledged Event by Host */
 154         CAM_MESSAGE_RECV,       /* Message Received in Host Target Mode */
 155         CAM_INVALID_CDB,        /* Invalid CDB received in Host Target Mode */
 156         CAM_LUN_INVALID,        /* Lun supplied is invalid */
 157         CAM_TID_INVALID,        /* Target ID supplied is invalid */
 158         CAM_FUNC_NOTAVAIL,      /* The requested function is not available */
 159         CAM_NO_NEXUS,           /* Nexus is not established */
 160         CAM_IID_INVALID,        /* The initiator ID is invalid */
 161         CAM_CDB_RECVD,          /* The SCSI CDB has been received */
 162         CAM_LUN_ALRDY_ENA,      /* The LUN is already enabled for target mode */
 163         CAM_SCSI_BUSY,          /* SCSI Bus Busy */
 164
 165         CAM_DEV_QFRZN = 0x40,   /* The DEV queue is frozen w/this err */
 166
 167                                 /* Autosense data valid for target */
 168         CAM_AUTOSNS_VALID = 0x80,
 169         CAM_RELEASE_SIMQ = 0x100,/* SIM ready to take more commands */
 170         CAM_SIM_QUEUED   = 0x200,/* SIM has this command in it's queue */
 171
 172         CAM_STATUS_MASK = 0x3F, /* Mask bits for just the status # */
 173
 174                                 /* Target Specific Adjunct Status */
 175         CAM_SENT_SENSE = 0x40000000     /* sent sense with status */
 176 } cam_status;
 177
 178 typedef enum {
 179         CAM_ESF_NONE            = 0x00,
 180         CAM_ESF_COMMAND         = 0x01,
 181         CAM_ESF_CAM_STATUS      = 0x02,
 182         CAM_ESF_PROTO_STATUS    = 0x04,
 183         CAM_ESF_ALL             = 0xff
 184 } cam_error_string_flags;
 185
 186 typedef enum {
 187         CAM_EPF_NONE            = 0x00,
 188         CAM_EPF_MINIMAL         = 0x01,
 189         CAM_EPF_NORMAL          = 0x02,
 190         CAM_EPF_ALL             = 0x03,
 191         CAM_EPF_LEVEL_MASK      = 0x0f
 192         /* All bits above bit 3 are protocol-specific */
 193 } cam_error_proto_flags;
 194
 195 typedef enum {
 196         CAM_ESF_PRINT_NONE      = 0x00,
 197         CAM_ESF_PRINT_STATUS    = 0x10,
 198         CAM_ESF_PRINT_SENSE     = 0x20
 199 } cam_error_scsi_flags;
 200
 201 typedef enum {
 202         CAM_EAF_PRINT_NONE      = 0x00,
 203         CAM_EAF_PRINT_STATUS    = 0x10,
 204         CAM_EAF_PRINT_RESULT    = 0x20
 205 } cam_error_ata_flags;
 206
 207 struct cam_status_entry
 208 {
 209         cam_status  status_code;
 210         const char *status_text;
 211 };
 212
 213 extern const struct cam_status_entry cam_status_table[];
 214 extern const int num_cam_status_entries;
 215 #ifdef _KERNEL
 216 extern int cam_sort_io_queues;
 217 #endif
 218 union ccb;
 219
 220 #ifdef SYSCTL_DECL      /* from sysctl.h */
 221 SYSCTL_DECL(_kern_cam);
 222 #endif
 223
 224 __BEGIN_DECLS
 225 typedef int (cam_quirkmatch_t)(caddr_t, caddr_t);
 226
 227 caddr_t cam_quirkmatch(caddr_t target, caddr_t quirk_table, int num_entries,
 228                        int entry_size, cam_quirkmatch_t *comp_func);
 229
 230 void    cam_strvis(u_int8_t *dst, const u_int8_t *src, int srclen, int dstlen);
 231
 232 int     cam_strmatch(const u_int8_t *str, const u_int8_t *pattern, int str_len);
 233 const struct cam_status_entry*
 234         cam_fetch_status_entry(cam_status status);
 235 #ifdef _KERNEL
 236 char *  cam_error_string(union ccb *ccb, char *str, int str_len,
 237                          cam_error_string_flags flags,
 238                          cam_error_proto_flags proto_flags);
 239 void    cam_error_print(union ccb *ccb, cam_error_string_flags flags,
 240                         cam_error_proto_flags proto_flags);
 241 #else /* _KERNEL */
 242 struct cam_device;
 243
 244 char *  cam_error_string(struct cam_device *device, union ccb *ccb, char *str,
 245                          int str_len, cam_error_string_flags flags,
 246                          cam_error_proto_flags proto_flags);
 247 void    cam_error_print(struct cam_device *device, union ccb *ccb,
 248                         cam_error_string_flags flags,
 249                         cam_error_proto_flags proto_flags, FILE *ofile);
 250 #endif /* _KERNEL */
 251 __END_DECLS
 252
 253 #ifdef _KERNEL
 254 static __inline void cam_init_pinfo(cam_pinfo *pinfo);
 255
 256 static __inline void cam_init_pinfo(cam_pinfo *pinfo)
 257 {
 258         pinfo->priority = CAM_PRIORITY_NONE;
 259         pinfo->index = CAM_UNQUEUED_INDEX;
 260 }
 261 #endif
 262
 263 #endif /* _CAM_CAM_H */