drivers/s390/scsi/zfcp_dbf.h

   1 /*
   2  * zfcp device driver
   3  * debug feature declarations
   4  *
   5  * Copyright IBM Corp. 2008, 2010
   6  */
   7
   8 #ifndef ZFCP_DBF_H
   9 #define ZFCP_DBF_H
  10
  11 #include <scsi/fc/fc_fcp.h>
  12 #include "zfcp_ext.h"
  13 #include "zfcp_fsf.h"
  14 #include "zfcp_def.h"
  15
  16 #define ZFCP_DBF_TAG_LEN       7
  17
  18 #define ZFCP_DBF_INVALID_LUN    0xFFFFFFFFFFFFFFFFull
  19
  20 /**
  21  * struct zfcp_dbf_rec_trigger - trace record for triggered recovery action
  22  * @ready: number of ready recovery actions
  23  * @running: number of running recovery actions
  24  * @want: wanted recovery action
  25  * @need: needed recovery action
  26  */
  27 struct zfcp_dbf_rec_trigger {
  28         u32 ready;
  29         u32 running;
  30         u8 want;
  31         u8 need;
  32 } __packed;
  33
  34 /**
  35  * struct zfcp_dbf_rec_running - trace record for running recovery
  36  * @fsf_req_id: request id for fsf requests
  37  * @rec_status: status of the fsf request
  38  * @rec_step: current step of the recovery action
  39  * rec_count: recovery counter
  40  */
  41 struct zfcp_dbf_rec_running {
  42         u64 fsf_req_id;
  43         u32 rec_status;
  44         u16 rec_step;
  45         u8 rec_action;
  46         u8 rec_count;
  47 } __packed;
  48
  49 /**
  50  * enum zfcp_dbf_rec_id - recovery trace record id
  51  * @ZFCP_DBF_REC_TRIG: triggered recovery identifier
  52  * @ZFCP_DBF_REC_RUN: running recovery identifier
  53  */
  54 enum zfcp_dbf_rec_id {
  55         ZFCP_DBF_REC_TRIG       = 1,
  56         ZFCP_DBF_REC_RUN        = 2,
  57 };
  58
  59 /**
  60  * struct zfcp_dbf_rec - trace record for error recovery actions
  61  * @id: unique number of recovery record type
  62  * @tag: identifier string specifying the location of initiation
  63  * @lun: logical unit number
  64  * @wwpn: word wide port number
  65  * @d_id: destination ID
  66  * @adapter_status: current status of the adapter
  67  * @port_status: current status of the port
  68  * @lun_status: current status of the lun
  69  * @u.trig: structure zfcp_dbf_rec_trigger
  70  * @u.run: structure zfcp_dbf_rec_running
  71  */
  72 struct zfcp_dbf_rec {
  73         u8 id;
  74         char tag[ZFCP_DBF_TAG_LEN];
  75         u64 lun;
  76         u64 wwpn;
  77         u32 d_id;
  78         u32 adapter_status;
  79         u32 port_status;
  80         u32 lun_status;
  81         union {
  82                 struct zfcp_dbf_rec_trigger trig;
  83                 struct zfcp_dbf_rec_running run;
  84         } u;
  85 } __packed;
  86
  87 /**
  88  * enum zfcp_dbf_san_id - SAN trace record identifier
  89  * @ZFCP_DBF_SAN_REQ: request trace record id
  90  * @ZFCP_DBF_SAN_RES: response trace record id
  91  * @ZFCP_DBF_SAN_ELS: extended link service record id
  92  */
  93 enum zfcp_dbf_san_id {
  94         ZFCP_DBF_SAN_REQ        = 1,
  95         ZFCP_DBF_SAN_RES        = 2,
  96         ZFCP_DBF_SAN_ELS        = 3,
  97 };
  98
  99 /** struct zfcp_dbf_san - trace record for SAN requests and responses
 100  * @id: unique number of recovery record type
 101  * @tag: identifier string specifying the location of initiation
 102  * @fsf_req_id: request id for fsf requests
 103  * @payload: unformatted information related to request/response
 104  * @d_id: destination id
 105  */
 106 struct zfcp_dbf_san {
 107         u8 id;
 108         char tag[ZFCP_DBF_TAG_LEN];
 109         u64 fsf_req_id;
 110         u32 d_id;
 111 #define ZFCP_DBF_SAN_MAX_PAYLOAD (FC_CT_HDR_LEN + 32)
 112         char payload[ZFCP_DBF_SAN_MAX_PAYLOAD];
 113 } __packed;
 114
 115 /**
 116  * struct zfcp_dbf_hba_res - trace record for hba responses
 117  * @req_issued: timestamp when request was issued
 118  * @prot_status: protocol status
 119  * @prot_status_qual: protocol status qualifier
 120  * @fsf_status: fsf status
 121  * @fsf_status_qual: fsf status qualifier
 122  */
 123 struct zfcp_dbf_hba_res {
 124         u64 req_issued;
 125         u32 prot_status;
 126         u8  prot_status_qual[FSF_PROT_STATUS_QUAL_SIZE];
 127         u32 fsf_status;
 128         u8  fsf_status_qual[FSF_STATUS_QUALIFIER_SIZE];
 129 } __packed;
 130
 131 /**
 132  * struct zfcp_dbf_hba_uss - trace record for unsolicited status
 133  * @status_type: type of unsolicited status
 134  * @status_subtype: subtype of unsolicited status
 135  * @d_id: destination ID
 136  * @lun: logical unit number
 137  * @queue_designator: queue designator
 138  */
 139 struct zfcp_dbf_hba_uss {
 140         u32 status_type;
 141         u32 status_subtype;
 142         u32 d_id;
 143         u64 lun;
 144         u64 queue_designator;
 145 } __packed;
 146
 147 /**
 148  * enum zfcp_dbf_hba_id - HBA trace record identifier
 149  * @ZFCP_DBF_HBA_RES: response trace record
 150  * @ZFCP_DBF_HBA_USS: unsolicited status trace record
 151  * @ZFCP_DBF_HBA_BIT: bit error trace record
 152  */
 153 enum zfcp_dbf_hba_id {
 154         ZFCP_DBF_HBA_RES        = 1,
 155         ZFCP_DBF_HBA_USS        = 2,
 156         ZFCP_DBF_HBA_BIT        = 3,
 157 };
 158
 159 /**
 160  * struct zfcp_dbf_hba - common trace record for HBA records
 161  * @id: unique number of recovery record type
 162  * @tag: identifier string specifying the location of initiation
 163  * @fsf_req_id: request id for fsf requests
 164  * @fsf_req_status: status of fsf request
 165  * @fsf_cmd: fsf command
 166  * @fsf_seq_no: fsf sequence number
 167  * @pl_len: length of payload stored as zfcp_dbf_pay
 168  * @u: record type specific data
 169  */
 170 struct zfcp_dbf_hba {
 171         u8 id;
 172         char tag[ZFCP_DBF_TAG_LEN];
 173         u64 fsf_req_id;
 174         u32 fsf_req_status;
 175         u32 fsf_cmd;
 176         u32 fsf_seq_no;
 177         u16 pl_len;
 178         union {
 179                 struct zfcp_dbf_hba_res res;
 180                 struct zfcp_dbf_hba_uss uss;
 181                 struct fsf_bit_error_payload be;
 182         } u;
 183 } __packed;
 184
 185 /**
 186  * enum zfcp_dbf_scsi_id - scsi trace record identifier
 187  * @ZFCP_DBF_SCSI_CMND: scsi command trace record
 188  */
 189 enum zfcp_dbf_scsi_id {
 190         ZFCP_DBF_SCSI_CMND      = 1,
 191 };
 192
 193 /**
 194  * struct zfcp_dbf_scsi - common trace record for SCSI records
 195  * @id: unique number of recovery record type
 196  * @tag: identifier string specifying the location of initiation
 197  * @scsi_id: scsi device id
 198  * @scsi_lun: scsi device logical unit number
 199  * @scsi_result: scsi result
 200  * @scsi_retries: current retry number of scsi request
 201  * @scsi_allowed: allowed retries
 202  * @fcp_rsp_info: FCP response info
 203  * @scsi_opcode: scsi opcode
 204  * @fsf_req_id: request id of fsf request
 205  * @host_scribble: LLD specific data attached to SCSI request
 206  * @pl_len: length of paload stored as zfcp_dbf_pay
 207  * @fsf_rsp: response for fsf request
 208  */
 209 struct zfcp_dbf_scsi {
 210         u8 id;
 211         char tag[ZFCP_DBF_TAG_LEN];
 212         u32 scsi_id;
 213         u32 scsi_lun;
 214         u32 scsi_result;
 215         u8 scsi_retries;
 216         u8 scsi_allowed;
 217         u8 fcp_rsp_info;
 218 #define ZFCP_DBF_SCSI_OPCODE    16
 219         u8 scsi_opcode[ZFCP_DBF_SCSI_OPCODE];
 220         u64 fsf_req_id;
 221         u64 host_scribble;
 222         u16 pl_len;
 223         struct fcp_resp_with_ext fcp_rsp;
 224 } __packed;
 225
 226 /**
 227  * struct zfcp_dbf_pay - trace record for unformatted payload information
 228  * @area: area this record is originated from
 229  * @counter: ascending record number
 230  * @fsf_req_id: request id of fsf request
 231  * @data: unformatted data
 232  */
 233 struct zfcp_dbf_pay {
 234         u8 counter;
 235         char area[ZFCP_DBF_TAG_LEN];
 236         u64 fsf_req_id;
 237 #define ZFCP_DBF_PAY_MAX_REC 0x100
 238         char data[ZFCP_DBF_PAY_MAX_REC];
 239 } __packed;
 240
 241 /**
 242  * struct zfcp_dbf - main dbf trace structure
 243  * @pay: reference to payload trace area
 244  * @rec: reference to recovery trace area
 245  * @hba: reference to hba trace area
 246  * @san: reference to san trace area
 247  * @scsi: reference to scsi trace area
 248  * @pay_lock: lock protecting payload trace buffer
 249  * @rec_lock: lock protecting recovery trace buffer
 250  * @hba_lock: lock protecting hba trace buffer
 251  * @san_lock: lock protecting san trace buffer
 252  * @scsi_lock: lock protecting scsi trace buffer
 253  * @pay_buf: pre-allocated buffer for payload
 254  * @rec_buf: pre-allocated buffer for recovery
 255  * @hba_buf: pre-allocated buffer for hba
 256  * @san_buf: pre-allocated buffer for san
 257  * @scsi_buf: pre-allocated buffer for scsi
 258  */
 259 struct zfcp_dbf {
 260         debug_info_t                    *pay;
 261         debug_info_t                    *rec;
 262         debug_info_t                    *hba;
 263         debug_info_t                    *san;
 264         debug_info_t                    *scsi;
 265         spinlock_t                      pay_lock;
 266         spinlock_t                      rec_lock;
 267         spinlock_t                      hba_lock;
 268         spinlock_t                      san_lock;
 269         spinlock_t                      scsi_lock;
 270         struct zfcp_dbf_pay             pay_buf;
 271         struct zfcp_dbf_rec             rec_buf;
 272         struct zfcp_dbf_hba             hba_buf;
 273         struct zfcp_dbf_san             san_buf;
 274         struct zfcp_dbf_scsi            scsi_buf;
 275 };
 276
 277 static inline
 278 void zfcp_dbf_hba_fsf_resp(char *tag, int level, struct zfcp_fsf_req *req)
 279 {
 280         if (level <= req->adapter->dbf->hba->level)
 281                 zfcp_dbf_hba_fsf_res(tag, req);
 282 }
 283
 284 /**
 285  * zfcp_dbf_hba_fsf_response - trace event for request completion
 286  * @req: request that has been completed
 287  */
 288 static inline
 289 void zfcp_dbf_hba_fsf_response(struct zfcp_fsf_req *req)
 290 {
 291         struct fsf_qtcb *qtcb = req->qtcb;
 292
 293         if ((qtcb->prefix.prot_status != FSF_PROT_GOOD) &&
 294             (qtcb->prefix.prot_status != FSF_PROT_FSF_STATUS_PRESENTED)) {
 295                 zfcp_dbf_hba_fsf_resp("fs_perr", 1, req);
 296
 297         } else if (qtcb->header.fsf_status != FSF_GOOD) {
 298                 zfcp_dbf_hba_fsf_resp("fs_ferr", 1, req);
 299
 300         } else if ((req->fsf_command == FSF_QTCB_OPEN_PORT_WITH_DID) ||
 301                    (req->fsf_command == FSF_QTCB_OPEN_LUN)) {
 302                 zfcp_dbf_hba_fsf_resp("fs_open", 4, req);
 303
 304         } else if (qtcb->header.log_length) {
 305                 zfcp_dbf_hba_fsf_resp("fs_qtcb", 5, req);
 306
 307         } else {
 308                 zfcp_dbf_hba_fsf_resp("fs_norm", 6, req);
 309         }
 310 }
 311
 312 static inline
 313 void _zfcp_dbf_scsi(char *tag, int level, struct scsi_cmnd *scmd,
 314                    struct zfcp_fsf_req *req)
 315 {
 316         struct zfcp_adapter *adapter = (struct zfcp_adapter *)
 317                                         scmd->device->host->hostdata[0];
 318
 319         if (level <= adapter->dbf->scsi->level)
 320                 zfcp_dbf_scsi(tag, scmd, req);
 321 }
 322
 323 /**
 324  * zfcp_dbf_scsi_result - trace event for SCSI command completion
 325  * @scmd: SCSI command pointer
 326  * @req: FSF request used to issue SCSI command
 327  */
 328 static inline
 329 void zfcp_dbf_scsi_result(struct scsi_cmnd *scmd, struct zfcp_fsf_req *req)
 330 {
 331         if (scmd->result != 0)
 332                 _zfcp_dbf_scsi("rsl_err", 3, scmd, req);
 333         else if (scmd->retries > 0)
 334                 _zfcp_dbf_scsi("rsl_ret", 4, scmd, req);
 335         else
 336                 _zfcp_dbf_scsi("rsl_nor", 6, scmd, req);
 337 }
 338
 339 /**
 340  * zfcp_dbf_scsi_fail_send - trace event for failure to send SCSI command
 341  * @scmd: SCSI command pointer
 342  */
 343 static inline
 344 void zfcp_dbf_scsi_fail_send(struct scsi_cmnd *scmd)
 345 {
 346         _zfcp_dbf_scsi("rsl_fai", 4, scmd, NULL);
 347 }
 348
 349 /**
 350  * zfcp_dbf_scsi_abort - trace event for SCSI command abort
 351  * @tag: tag indicating success or failure of abort operation
 352  * @scmd: SCSI command to be aborted
 353  * @fsf_req: request containing abort (might be NULL)
 354  */
 355 static inline
 356 void zfcp_dbf_scsi_abort(char *tag, struct scsi_cmnd *scmd,
 357                          struct zfcp_fsf_req *fsf_req)
 358 {
 359         _zfcp_dbf_scsi(tag, 1, scmd, fsf_req);
 360 }
 361
 362 /**
 363  * zfcp_dbf_scsi_devreset - trace event for Logical Unit or Target Reset
 364  * @tag: tag indicating success or failure of reset operation
 365  * @scmnd: SCSI command which caused this error recovery
 366  * @flag: indicates type of reset (Target Reset, Logical Unit Reset)
 367  */
 368 static inline
 369 void zfcp_dbf_scsi_devreset(char *tag, struct scsi_cmnd *scmnd, u8 flag)
 370 {
 371         char tmp_tag[ZFCP_DBF_TAG_LEN];
 372
 373         if (flag == FCP_TMF_TGT_RESET)
 374                 memcpy(tmp_tag, "tr_", 3);
 375         else
 376                 memcpy(tmp_tag, "lr_", 3);
 377
 378         memcpy(&tmp_tag[3], tag, 4);
 379         _zfcp_dbf_scsi(tmp_tag, 1, scmnd, NULL);
 380 }
 381
 382 #endif /* ZFCP_DBF_H */