1 /* $FreeBSD$ */ 2 /*- 3 * Copyright (c) 1997-2009 by Matthew Jacob 4 * All rights reserved. 5 * 6 * Redistribution and use in source and binary forms, with or without 7 * modification, are permitted provided that the following conditions 8 * are met: 9 * 10 * 1. Redistributions of source code must retain the above copyright 11 * notice, this list of conditions and the following disclaimer. 12 * 2. Redistributions in binary form must reproduce the above copyright 13 * notice, this list of conditions and the following disclaimer in the 14 * documentation and/or other materials provided with the distribution. 15 * 16 * THIS SOFTWARE IS PROVIDED BY 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 AUTHOR OR CONTRIBUTORS BE LIABLE 20 * FOR 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 */ 29 #ifndef _ISP_LIBRARY_H 30 #define _ISP_LIBRARY_H 31 32 /* 33 * Common command shipping routine. 34 * 35 * This used to be platform specific, but basically once you get the segment 36 * stuff figured out, you can make all the code in one spot. 37 */ 38 typedef enum { ISP_TO_DEVICE, ISP_FROM_DEVICE, ISP_NOXFR} isp_ddir_t; 39 int isp_send_cmd(ispsoftc_t *, void *, void *, uint32_t, uint32_t, isp_ddir_t, ispds64_t *); 40 41 /* 42 * Handle management functions. 43 * 44 * These handles are associate with a command. 45 */ 46 uint32_t isp_allocate_handle(ispsoftc_t *, void *, int); 47 void *isp_find_xs(ispsoftc_t *, uint32_t); 48 uint32_t isp_find_handle(ispsoftc_t *, void *); 49 void isp_destroy_handle(ispsoftc_t *, uint32_t); 50 51 /* 52 * Request Queue allocation 53 */ 54 void *isp_getrqentry(ispsoftc_t *); 55 56 /* 57 * Queue Entry debug functions 58 */ 59 void isp_print_qentry (ispsoftc_t *, const char *, int, void *); 60 void isp_print_bytes(ispsoftc_t *, const char *, int, void *); 61 62 /* 63 * Fibre Channel specific routines and data. 64 */ 65 extern const char *isp_class3_roles[4]; 66 int isp_fc_runstate(ispsoftc_t *, int, int); 67 void isp_dump_portdb(ispsoftc_t *, int); 68 void isp_gen_role_str(char *, size_t, uint16_t); 69 70 const char *isp_fc_fw_statename(int); 71 const char *isp_fc_loop_statename(int); 72 const char *isp_fc_toponame(fcparam *); 73 74 /* 75 * Cleanup 76 */ 77 void isp_clear_commands(ispsoftc_t *); 78 79 /* 80 * Common chip shutdown function 81 */ 82 void isp_shutdown(ispsoftc_t *); 83 84 /* 85 * Put/Get routines to push from CPU view to device view 86 * or to pull from device view to CPU view for various 87 * data structures (IOCB) 88 */ 89 void isp_put_hdr(ispsoftc_t *, isphdr_t *, isphdr_t *); 90 void isp_get_hdr(ispsoftc_t *, isphdr_t *, isphdr_t *); 91 int isp_get_response_type(ispsoftc_t *, isphdr_t *); 92 void isp_put_request(ispsoftc_t *, ispreq_t *, ispreq_t *); 93 void isp_put_marker(ispsoftc_t *, isp_marker_t *, isp_marker_t *); 94 void isp_put_marker_24xx(ispsoftc_t *, isp_marker_24xx_t *, isp_marker_24xx_t *); 95 void isp_put_request_t2(ispsoftc_t *, ispreqt2_t *, ispreqt2_t *); 96 void isp_put_request_t2e(ispsoftc_t *, ispreqt2e_t *, ispreqt2e_t *); 97 void isp_put_request_t3(ispsoftc_t *, ispreqt3_t *, ispreqt3_t *); 98 void isp_put_request_t3e(ispsoftc_t *, ispreqt3e_t *, ispreqt3e_t *); 99 void isp_put_extended_request(ispsoftc_t *, ispextreq_t *, ispextreq_t *); 100 void isp_put_request_t7(ispsoftc_t *, ispreqt7_t *, ispreqt7_t *); 101 void isp_put_24xx_tmf(ispsoftc_t *, isp24xx_tmf_t *, isp24xx_tmf_t *); 102 void isp_put_24xx_abrt(ispsoftc_t *, isp24xx_abrt_t *, isp24xx_abrt_t *); 103 void isp_put_cont_req(ispsoftc_t *, ispcontreq_t *, ispcontreq_t *); 104 void isp_put_cont64_req(ispsoftc_t *, ispcontreq64_t *, ispcontreq64_t *); 105 void isp_get_response(ispsoftc_t *, ispstatusreq_t *, ispstatusreq_t *); 106 void isp_get_cont_response(ispsoftc_t *, ispstatus_cont_t *, ispstatus_cont_t *); 107 void isp_get_24xx_response(ispsoftc_t *, isp24xx_statusreq_t *, isp24xx_statusreq_t *); 108 void isp_get_24xx_abrt(ispsoftc_t *, isp24xx_abrt_t *, isp24xx_abrt_t *); 109 void isp_get_rio1(ispsoftc_t *, isp_rio1_t *, isp_rio1_t *); 110 void isp_get_rio2(ispsoftc_t *, isp_rio2_t *, isp_rio2_t *); 111 void isp_put_icb(ispsoftc_t *, isp_icb_t *, isp_icb_t *); 112 void isp_put_icb_2400(ispsoftc_t *, isp_icb_2400_t *, isp_icb_2400_t *); 113 void isp_put_icb_2400_vpinfo(ispsoftc_t *, isp_icb_2400_vpinfo_t *, isp_icb_2400_vpinfo_t *); 114 void isp_put_vp_port_info(ispsoftc_t *, vp_port_info_t *, vp_port_info_t *); 115 void isp_get_vp_port_info(ispsoftc_t *, vp_port_info_t *, vp_port_info_t *); 116 void isp_put_vp_ctrl_info(ispsoftc_t *, vp_ctrl_info_t *, vp_ctrl_info_t *); 117 void isp_get_vp_ctrl_info(ispsoftc_t *, vp_ctrl_info_t *, vp_ctrl_info_t *); 118 void isp_put_vp_modify(ispsoftc_t *, vp_modify_t *, vp_modify_t *); 119 void isp_get_vp_modify(ispsoftc_t *, vp_modify_t *, vp_modify_t *); 120 void isp_get_pdb_21xx(ispsoftc_t *, isp_pdb_21xx_t *, isp_pdb_21xx_t *); 121 void isp_get_pdb_24xx(ispsoftc_t *, isp_pdb_24xx_t *, isp_pdb_24xx_t *); 122 void isp_get_pnhle_21xx(ispsoftc_t *, isp_pnhle_21xx_t *, isp_pnhle_21xx_t *); 123 void isp_get_pnhle_23xx(ispsoftc_t *, isp_pnhle_23xx_t *, isp_pnhle_23xx_t *); 124 void isp_get_pnhle_24xx(ispsoftc_t *, isp_pnhle_24xx_t *, isp_pnhle_24xx_t *); 125 void isp_get_pnnle(ispsoftc_t *, isp_pnnle_t *, isp_pnnle_t *); 126 void isp_get_ridacq(ispsoftc_t *, isp_ridacq_t *, isp_ridacq_t *); 127 void isp_get_plogx(ispsoftc_t *, isp_plogx_t *, isp_plogx_t *); 128 void isp_put_plogx(ispsoftc_t *, isp_plogx_t *, isp_plogx_t *); 129 void isp_get_ct_pt(ispsoftc_t *isp, isp_ct_pt_t *, isp_ct_pt_t *); 130 void isp_get_ms(ispsoftc_t *isp, isp_ms_t *, isp_ms_t *); 131 void isp_put_ct_pt(ispsoftc_t *isp, isp_ct_pt_t *, isp_ct_pt_t *); 132 void isp_put_ms(ispsoftc_t *isp, isp_ms_t *, isp_ms_t *); 133 void isp_put_sns_request(ispsoftc_t *, sns_screq_t *, sns_screq_t *); 134 void isp_put_gid_ft_request(ispsoftc_t *, sns_gid_ft_req_t *, sns_gid_ft_req_t *); 135 void isp_put_gxn_id_request(ispsoftc_t *, sns_gxn_id_req_t *, sns_gxn_id_req_t *); 136 void isp_get_sns_response(ispsoftc_t *, sns_scrsp_t *, sns_scrsp_t *, int); 137 void isp_get_gid_ft_response(ispsoftc_t *, sns_gid_ft_rsp_t *, sns_gid_ft_rsp_t *, int); 138 void isp_get_gxn_id_response(ispsoftc_t *, sns_gxn_id_rsp_t *, sns_gxn_id_rsp_t *); 139 void isp_get_gff_id_response(ispsoftc_t *, sns_gff_id_rsp_t *, sns_gff_id_rsp_t *); 140 void isp_get_ga_nxt_response(ispsoftc_t *, sns_ga_nxt_rsp_t *, sns_ga_nxt_rsp_t *); 141 void isp_get_els(ispsoftc_t *, els_t *, els_t *); 142 void isp_put_els(ispsoftc_t *, els_t *, els_t *); 143 void isp_get_fc_hdr(ispsoftc_t *, fc_hdr_t *, fc_hdr_t *); 144 void isp_put_fc_hdr(ispsoftc_t *, fc_hdr_t *, fc_hdr_t *); 145 void isp_get_fcp_cmnd_iu(ispsoftc_t *, fcp_cmnd_iu_t *, fcp_cmnd_iu_t *); 146 void isp_put_rft_id(ispsoftc_t *, rft_id_t *, rft_id_t *); 147 void isp_put_rspn_id(ispsoftc_t *, rspn_id_t *, rspn_id_t *); 148 void isp_put_rff_id(ispsoftc_t *, rff_id_t *, rff_id_t *); 149 void isp_put_rsnn_nn(ispsoftc_t *, rsnn_nn_t *, rsnn_nn_t *); 150 void isp_get_ct_hdr(ispsoftc_t *isp, ct_hdr_t *, ct_hdr_t *); 151 void isp_put_ct_hdr(ispsoftc_t *isp, ct_hdr_t *, ct_hdr_t *); 152 void isp_put_fcp_rsp_iu(ispsoftc_t *isp, fcp_rsp_iu_t *, fcp_rsp_iu_t *); 153 154 #define ISP_HANDLE_MASK 0x7fff 155 156 #ifdef ISP_TARGET_MODE 157 #if defined(__NetBSD__) || defined(__OpenBSD__) 158 #include <dev/ic/isp_target.h> 159 #elif defined(__FreeBSD__) 160 #include <dev/isp/isp_target.h> 161 #else 162 #include "isp_target.h" 163 #endif 164 165 int isp_send_tgt_cmd(ispsoftc_t *, void *, void *, uint32_t, uint32_t, isp_ddir_t, void *, uint32_t); 166 #endif 167 int isp_find_pdb_empty(ispsoftc_t *, int, fcportdb_t **); 168 int isp_find_pdb_by_wwpn(ispsoftc_t *, int, uint64_t, fcportdb_t **); 169 int isp_find_pdb_by_handle(ispsoftc_t *, int, uint16_t, fcportdb_t **); 170 int isp_find_pdb_by_portid(ispsoftc_t *, int, uint32_t, fcportdb_t **); 171 #ifdef ISP_TARGET_MODE 172 void isp_find_chan_by_did(ispsoftc_t *, uint32_t, uint16_t *); 173 void isp_add_wwn_entry(ispsoftc_t *, int, uint64_t, uint64_t, uint16_t, uint32_t, uint16_t); 174 void isp_del_wwn_entry(ispsoftc_t *, int, uint64_t, uint16_t, uint32_t); 175 void isp_del_all_wwn_entries(ispsoftc_t *, int); 176 void isp_del_wwn_entries(ispsoftc_t *, isp_notify_t *); 177 178 void isp_put_atio2(ispsoftc_t *, at2_entry_t *, at2_entry_t *); 179 void isp_put_atio2e(ispsoftc_t *, at2e_entry_t *, at2e_entry_t *); 180 void isp_get_atio2(ispsoftc_t *, at2_entry_t *, at2_entry_t *); 181 void isp_get_atio2e(ispsoftc_t *, at2e_entry_t *, at2e_entry_t *); 182 void isp_get_atio7(ispsoftc_t *isp, at7_entry_t *, at7_entry_t *); 183 void isp_put_ctio2(ispsoftc_t *, ct2_entry_t *, ct2_entry_t *); 184 void isp_put_ctio2e(ispsoftc_t *, ct2e_entry_t *, ct2e_entry_t *); 185 void isp_put_ctio7(ispsoftc_t *, ct7_entry_t *, ct7_entry_t *); 186 void isp_get_ctio2(ispsoftc_t *, ct2_entry_t *, ct2_entry_t *); 187 void isp_get_ctio2e(ispsoftc_t *, ct2e_entry_t *, ct2e_entry_t *); 188 void isp_get_ctio7(ispsoftc_t *, ct7_entry_t *, ct7_entry_t *); 189 void isp_put_enable_lun(ispsoftc_t *, lun_entry_t *, lun_entry_t *); 190 void isp_get_enable_lun(ispsoftc_t *, lun_entry_t *, lun_entry_t *); 191 void isp_put_notify_fc(ispsoftc_t *, in_fcentry_t *, in_fcentry_t *); 192 void isp_put_notify_fc_e(ispsoftc_t *, in_fcentry_e_t *, in_fcentry_e_t *); 193 void isp_put_notify_24xx(ispsoftc_t *, in_fcentry_24xx_t *, in_fcentry_24xx_t *); 194 void isp_get_notify_fc(ispsoftc_t *, in_fcentry_t *, in_fcentry_t *); 195 void isp_get_notify_fc_e(ispsoftc_t *, in_fcentry_e_t *, in_fcentry_e_t *); 196 void isp_get_notify_24xx(ispsoftc_t *, in_fcentry_24xx_t *, in_fcentry_24xx_t *); 197 void isp_put_notify_24xx_ack(ispsoftc_t *, na_fcentry_24xx_t *, na_fcentry_24xx_t *); 198 void isp_put_notify_ack_fc(ispsoftc_t *, na_fcentry_t *, na_fcentry_t *); 199 void isp_put_notify_ack_fc_e(ispsoftc_t *, na_fcentry_e_t *, na_fcentry_e_t *); 200 void isp_put_notify_ack_24xx(ispsoftc_t *, na_fcentry_24xx_t *, na_fcentry_24xx_t *); 201 void isp_get_notify_ack_fc(ispsoftc_t *, na_fcentry_t *, na_fcentry_t *); 202 void isp_get_notify_ack_fc_e(ispsoftc_t *, na_fcentry_e_t *, na_fcentry_e_t *); 203 void isp_get_notify_ack_24xx(ispsoftc_t *, na_fcentry_24xx_t *, na_fcentry_24xx_t *); 204 void isp_get_abts(ispsoftc_t *, abts_t *, abts_t *); 205 void isp_put_abts_rsp(ispsoftc_t *, abts_rsp_t *, abts_rsp_t *); 206 void isp_get_abts_rsp(ispsoftc_t *, abts_rsp_t *, abts_rsp_t *); 207 #endif /* ISP_TARGET_MODE */ 208 #endif /* _ISP_LIBRARY_H */ 209