1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 /* 3 * Copyright(c) 2009 Intel Corporation. All rights reserved. 4 * 5 * Maintained at www.Open-FCoE.org 6 */ 7 8 #ifndef _FC_LIBFC_H_ 9 #define _FC_LIBFC_H_ 10 11 #define FC_LIBFC_LOGGING 0x01 /* General logging, not categorized */ 12 #define FC_LPORT_LOGGING 0x02 /* lport layer logging */ 13 #define FC_DISC_LOGGING 0x04 /* discovery layer logging */ 14 #define FC_RPORT_LOGGING 0x08 /* rport layer logging */ 15 #define FC_FCP_LOGGING 0x10 /* I/O path logging */ 16 #define FC_EM_LOGGING 0x20 /* Exchange Manager logging */ 17 #define FC_EXCH_LOGGING 0x40 /* Exchange/Sequence logging */ 18 #define FC_SCSI_LOGGING 0x80 /* SCSI logging (mostly error handling) */ 19 20 extern unsigned int fc_debug_logging; 21 22 #define FC_CHECK_LOGGING(LEVEL, CMD) \ 23 do { \ 24 if (unlikely(fc_debug_logging & LEVEL)) \ 25 do { \ 26 CMD; \ 27 } while (0); \ 28 } while (0) 29 30 #define FC_LIBFC_DBG(fmt, args...) \ 31 FC_CHECK_LOGGING(FC_LIBFC_LOGGING, \ 32 pr_info("libfc: " fmt, ##args)) 33 34 #define FC_LPORT_DBG(lport, fmt, args...) \ 35 FC_CHECK_LOGGING(FC_LPORT_LOGGING, \ 36 pr_info("host%u: lport %6.6x: " fmt, \ 37 (lport)->host->host_no, \ 38 (lport)->port_id, ##args)) 39 40 #define FC_DISC_DBG(disc, fmt, args...) \ 41 FC_CHECK_LOGGING(FC_DISC_LOGGING, \ 42 pr_info("host%u: disc: " fmt, \ 43 fc_disc_lport(disc)->host->host_no, \ 44 ##args)) 45 46 #define FC_RPORT_ID_DBG(lport, port_id, fmt, args...) \ 47 FC_CHECK_LOGGING(FC_RPORT_LOGGING, \ 48 pr_info("host%u: rport %6.6x: " fmt, \ 49 (lport)->host->host_no, \ 50 (port_id), ##args)) 51 52 #define FC_RPORT_DBG(rdata, fmt, args...) \ 53 FC_RPORT_ID_DBG((rdata)->local_port, (rdata)->ids.port_id, fmt, ##args) 54 55 #define FC_FCP_DBG(pkt, fmt, args...) \ 56 FC_CHECK_LOGGING(FC_FCP_LOGGING, \ 57 { \ 58 if ((pkt)->seq_ptr) { \ 59 struct fc_exch *_ep = NULL; \ 60 _ep = fc_seq_exch((pkt)->seq_ptr); \ 61 pr_info("host%u: fcp: %6.6x: " \ 62 "xid %04x-%04x: " fmt, \ 63 (pkt)->lp->host->host_no, \ 64 (pkt)->rport->port_id, \ 65 (_ep)->oxid, (_ep)->rxid, ##args); \ 66 } else { \ 67 pr_info("host%u: fcp: %6.6x: " fmt, \ 68 (pkt)->lp->host->host_no, \ 69 (pkt)->rport->port_id, ##args); \ 70 } \ 71 }) 72 73 #define FC_EXCH_DBG(exch, fmt, args...) \ 74 FC_CHECK_LOGGING(FC_EXCH_LOGGING, \ 75 pr_info("host%u: xid %4x: " fmt, \ 76 (exch)->lp->host->host_no, \ 77 exch->xid, ##args)) 78 79 #define FC_SCSI_DBG(lport, fmt, args...) \ 80 FC_CHECK_LOGGING(FC_SCSI_LOGGING, \ 81 pr_info("host%u: scsi: " fmt, \ 82 (lport)->host->host_no, ##args)) 83 84 /* 85 * FC-4 Providers. 86 */ 87 extern struct fc4_prov *fc_active_prov[]; /* providers without recv */ 88 extern struct fc4_prov *fc_passive_prov[]; /* providers with recv */ 89 extern struct mutex fc_prov_mutex; /* lock over table changes */ 90 91 extern struct fc4_prov fc_rport_t0_prov; /* type 0 provider */ 92 extern struct fc4_prov fc_lport_els_prov; /* ELS provider */ 93 extern struct fc4_prov fc_rport_fcp_init; /* FCP initiator provider */ 94 95 /* 96 * Set up direct-data placement for this I/O request 97 */ 98 void fc_fcp_ddp_setup(struct fc_fcp_pkt *fsp, u16 xid); 99 void fc_fcp_ddp_done(struct fc_fcp_pkt *fsp); 100 101 /* 102 * Module setup functions 103 */ 104 int fc_setup_exch_mgr(void); 105 void fc_destroy_exch_mgr(void); 106 int fc_setup_rport(void); 107 void fc_destroy_rport(void); 108 int fc_setup_fcp(void); 109 void fc_destroy_fcp(void); 110 111 /* 112 * Internal libfc functions 113 */ 114 const char *fc_els_resp_type(struct fc_frame *); 115 extern void fc_fc4_add_lport(struct fc_lport *); 116 extern void fc_fc4_del_lport(struct fc_lport *); 117 extern void fc_fc4_conf_lport_params(struct fc_lport *, enum fc_fh_type); 118 119 /* 120 * Copies a buffer into an sg list 121 */ 122 u32 fc_copy_buffer_to_sglist(void *buf, size_t len, 123 struct scatterlist *sg, 124 u32 *nents, size_t *offset, 125 u32 *crc); 126 127 #endif /* _FC_LIBFC_H_ */ 128