1 /*- 2 * Copyright (c) 2012 The FreeBSD Foundation 3 * All rights reserved. 4 * 5 * This software was developed by Edward Tomasz Napierala under sponsorship 6 * from the FreeBSD Foundation. 7 * 8 * Redistribution and use in source and binary forms, with or without 9 * modification, are permitted provided that the following conditions 10 * are met: 11 * 1. Redistributions of source code must retain the above copyright 12 * notice, this list of conditions and the following disclaimer. 13 * 2. Redistributions in binary form must reproduce the above copyright 14 * notice, this list of conditions and the following disclaimer in the 15 * documentation and/or other materials provided with the distribution. 16 * 17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 18 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 19 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 20 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 21 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 23 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 25 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27 * SUCH DAMAGE. 28 * 29 * $FreeBSD$ 30 */ 31 32 #ifndef ICL_H 33 #define ICL_H 34 35 /* 36 * iSCSI Common Layer. It's used by both the initiator and target to send 37 * and receive iSCSI PDUs. 38 */ 39 40 #include <sys/types.h> 41 #include <sys/kobj.h> 42 #include <sys/condvar.h> 43 #include <sys/sysctl.h> 44 45 SYSCTL_DECL(_kern_icl); 46 47 extern int icl_debug; 48 49 #define ICL_DEBUG(X, ...) \ 50 do { \ 51 if (icl_debug > 1) \ 52 printf("%s: " X "\n", __func__, ## __VA_ARGS__);\ 53 } while (0) 54 55 #define ICL_WARN(X, ...) \ 56 do { \ 57 if (icl_debug > 0) { \ 58 printf("WARNING: %s: " X "\n", \ 59 __func__, ## __VA_ARGS__); \ 60 } \ 61 } while (0) 62 63 struct icl_conn; 64 struct ccb_scsiio; 65 union ctl_io; 66 67 struct icl_pdu { 68 STAILQ_ENTRY(icl_pdu) ip_next; 69 struct icl_conn *ip_conn; 70 struct iscsi_bhs *ip_bhs; 71 struct mbuf *ip_bhs_mbuf; 72 size_t ip_ahs_len; 73 struct mbuf *ip_ahs_mbuf; 74 size_t ip_data_len; 75 struct mbuf *ip_data_mbuf; 76 77 /* 78 * User (initiator or provider) private fields. 79 */ 80 uint32_t ip_prv0; 81 uint32_t ip_prv1; 82 uint32_t ip_prv2; 83 }; 84 85 #define ICL_CONN_STATE_INVALID 0 86 #define ICL_CONN_STATE_BHS 1 87 #define ICL_CONN_STATE_AHS 2 88 #define ICL_CONN_STATE_HEADER_DIGEST 3 89 #define ICL_CONN_STATE_DATA 4 90 #define ICL_CONN_STATE_DATA_DIGEST 5 91 92 #define ICL_MAX_DATA_SEGMENT_LENGTH (128 * 1024) 93 94 struct icl_conn { 95 KOBJ_FIELDS; 96 struct mtx *ic_lock; 97 struct socket *ic_socket; 98 #ifdef DIAGNOSTIC 99 volatile u_int ic_outstanding_pdus; 100 #endif 101 STAILQ_HEAD(, icl_pdu) ic_to_send; 102 bool ic_check_send_space; 103 size_t ic_receive_len; 104 int ic_receive_state; 105 struct icl_pdu *ic_receive_pdu; 106 struct cv ic_send_cv; 107 struct cv ic_receive_cv; 108 bool ic_header_crc32c; 109 bool ic_data_crc32c; 110 bool ic_send_running; 111 bool ic_receive_running; 112 size_t ic_max_data_segment_length; 113 bool ic_disconnecting; 114 bool ic_iser; 115 const char *ic_name; 116 const char *ic_offload; 117 118 void (*ic_receive)(struct icl_pdu *); 119 void (*ic_error)(struct icl_conn *); 120 121 /* 122 * User (initiator or provider) private fields. 123 */ 124 void *ic_prv0; 125 }; 126 127 struct icl_conn *icl_new_conn(const char *offload, const char *name, 128 struct mtx *lock); 129 int icl_limits(const char *offload, size_t *limitp); 130 131 int icl_register(const char *offload, int priority, 132 int (*limits)(size_t *), 133 struct icl_conn *(*new_conn)(const char *, struct mtx *)); 134 int icl_unregister(const char *offload); 135 136 #ifdef ICL_KERNEL_PROXY 137 138 struct sockaddr; 139 struct icl_listen; 140 141 struct icl_listen_sock { 142 TAILQ_ENTRY(icl_listen_sock) ils_next; 143 struct icl_listen *ils_listen; 144 struct socket *ils_socket; 145 bool ils_running; 146 bool ils_disconnecting; 147 int ils_id; 148 }; 149 150 struct icl_listen { 151 TAILQ_HEAD(, icl_listen_sock) il_sockets; 152 struct sx il_lock; 153 void (*il_accept)(struct socket *, 154 struct sockaddr *, int); 155 }; 156 157 /* 158 * Initiator part. 159 */ 160 int icl_conn_connect(struct icl_conn *ic, bool rdma, 161 int domain, int socktype, int protocol, 162 struct sockaddr *from_sa, struct sockaddr *to_sa); 163 /* 164 * Target part. 165 */ 166 struct icl_listen *icl_listen_new(void (*accept_cb)(struct socket *, 167 struct sockaddr *, int)); 168 void icl_listen_free(struct icl_listen *il); 169 int icl_listen_add(struct icl_listen *il, bool rdma, 170 int domain, int socktype, int protocol, 171 struct sockaddr *sa, int portal_id); 172 int icl_listen_remove(struct icl_listen *il, struct sockaddr *sa); 173 174 /* 175 * This one is not a public API; only to be used by icl_proxy.c. 176 */ 177 int icl_conn_handoff_sock(struct icl_conn *ic, struct socket *so); 178 179 #endif /* ICL_KERNEL_PROXY */ 180 181 #endif /* !ICL_H */ 182