2 * iSCSI User/Kernel Shares (Defines, Constants, Protocol definitions, etc)
4 * Copyright (C) 2005 Dmitry Yusupov
5 * Copyright (C) 2005 Alex Aizman
6 * maintained by open-iscsi@googlegroups.com
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published
10 * by the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful, but
14 * WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * General Public License for more details.
18 * See the file COPYING included with this distribution for more details.
24 #include <scsi/iscsi_proto.h>
26 #define UEVENT_BASE 10
27 #define KEVENT_BASE 100
28 #define ISCSI_ERR_BASE 1000
31 ISCSI_UEVENT_UNKNOWN
= 0,
34 ISCSI_UEVENT_CREATE_SESSION
= UEVENT_BASE
+ 1,
35 ISCSI_UEVENT_DESTROY_SESSION
= UEVENT_BASE
+ 2,
36 ISCSI_UEVENT_CREATE_CONN
= UEVENT_BASE
+ 3,
37 ISCSI_UEVENT_DESTROY_CONN
= UEVENT_BASE
+ 4,
38 ISCSI_UEVENT_BIND_CONN
= UEVENT_BASE
+ 5,
39 ISCSI_UEVENT_SET_PARAM
= UEVENT_BASE
+ 6,
40 ISCSI_UEVENT_START_CONN
= UEVENT_BASE
+ 7,
41 ISCSI_UEVENT_STOP_CONN
= UEVENT_BASE
+ 8,
42 ISCSI_UEVENT_SEND_PDU
= UEVENT_BASE
+ 9,
43 ISCSI_UEVENT_GET_STATS
= UEVENT_BASE
+ 10,
44 ISCSI_UEVENT_GET_PARAM
= UEVENT_BASE
+ 11,
46 ISCSI_UEVENT_TRANSPORT_EP_CONNECT
= UEVENT_BASE
+ 12,
47 ISCSI_UEVENT_TRANSPORT_EP_POLL
= UEVENT_BASE
+ 13,
48 ISCSI_UEVENT_TRANSPORT_EP_DISCONNECT
= UEVENT_BASE
+ 14,
50 ISCSI_UEVENT_TGT_DSCVR
= UEVENT_BASE
+ 15,
51 ISCSI_UEVENT_SET_HOST_PARAM
= UEVENT_BASE
+ 16,
52 ISCSI_UEVENT_UNBIND_SESSION
= UEVENT_BASE
+ 17,
53 ISCSI_UEVENT_CREATE_BOUND_SESSION
= UEVENT_BASE
+ 18,
54 ISCSI_UEVENT_TRANSPORT_EP_CONNECT_THROUGH_HOST
= UEVENT_BASE
+ 19,
57 ISCSI_KEVENT_RECV_PDU
= KEVENT_BASE
+ 1,
58 ISCSI_KEVENT_CONN_ERROR
= KEVENT_BASE
+ 2,
59 ISCSI_KEVENT_IF_ERROR
= KEVENT_BASE
+ 3,
60 ISCSI_KEVENT_DESTROY_SESSION
= KEVENT_BASE
+ 4,
61 ISCSI_KEVENT_UNBIND_SESSION
= KEVENT_BASE
+ 5,
62 ISCSI_KEVENT_CREATE_SESSION
= KEVENT_BASE
+ 6,
65 enum iscsi_tgt_dscvr
{
66 ISCSI_TGT_DSCVR_SEND_TARGETS
= 1,
67 ISCSI_TGT_DSCVR_ISNS
= 2,
68 ISCSI_TGT_DSCVR_SLP
= 3,
72 uint32_t type
; /* k/u events type */
73 uint32_t iferror
; /* carries interface or resource errors */
74 uint64_t transport_handle
;
78 struct msg_create_session
{
79 uint32_t initial_cmdsn
;
83 struct msg_create_bound_session
{
85 uint32_t initial_cmdsn
;
89 struct msg_destroy_session
{
92 struct msg_create_conn
{
96 struct msg_bind_conn
{
99 uint64_t transport_eph
;
102 struct msg_destroy_conn
{
106 struct msg_send_pdu
{
112 struct msg_set_param
{
115 uint32_t param
; /* enum iscsi_param */
118 struct msg_start_conn
{
122 struct msg_stop_conn
{
125 uint64_t conn_handle
;
128 struct msg_get_stats
{
132 struct msg_transport_connect
{
133 uint32_t non_blocking
;
135 struct msg_transport_connect_through_host
{
137 uint32_t non_blocking
;
138 } ep_connect_through_host
;
139 struct msg_transport_poll
{
143 struct msg_transport_disconnect
{
146 struct msg_tgt_dscvr
{
147 enum iscsi_tgt_dscvr type
;
150 * enable = 1 to establish a new connection
151 * with the server. enable = 0 to disconnect
152 * from the server. Used primarily to switch
153 * from one iSNS server to another.
157 struct msg_set_host_param
{
159 uint32_t param
; /* enum iscsi_host_param */
164 /* messages k -> u */
166 struct msg_create_session_ret
{
170 struct msg_create_conn_ret
{
174 struct msg_unbind_session
{
178 struct msg_recv_req
{
181 uint64_t recv_handle
;
183 struct msg_conn_error
{
186 uint32_t error
; /* enum iscsi_err */
188 struct msg_session_destroyed
{
192 struct msg_transport_connect_ret
{
196 } __attribute__ ((aligned (sizeof(uint64_t))));
204 ISCSI_ERR_DATASN
= ISCSI_ERR_BASE
+ 1,
205 ISCSI_ERR_DATA_OFFSET
= ISCSI_ERR_BASE
+ 2,
206 ISCSI_ERR_MAX_CMDSN
= ISCSI_ERR_BASE
+ 3,
207 ISCSI_ERR_EXP_CMDSN
= ISCSI_ERR_BASE
+ 4,
208 ISCSI_ERR_BAD_OPCODE
= ISCSI_ERR_BASE
+ 5,
209 ISCSI_ERR_DATALEN
= ISCSI_ERR_BASE
+ 6,
210 ISCSI_ERR_AHSLEN
= ISCSI_ERR_BASE
+ 7,
211 ISCSI_ERR_PROTO
= ISCSI_ERR_BASE
+ 8,
212 ISCSI_ERR_LUN
= ISCSI_ERR_BASE
+ 9,
213 ISCSI_ERR_BAD_ITT
= ISCSI_ERR_BASE
+ 10,
214 ISCSI_ERR_CONN_FAILED
= ISCSI_ERR_BASE
+ 11,
215 ISCSI_ERR_R2TSN
= ISCSI_ERR_BASE
+ 12,
216 ISCSI_ERR_SESSION_FAILED
= ISCSI_ERR_BASE
+ 13,
217 ISCSI_ERR_HDR_DGST
= ISCSI_ERR_BASE
+ 14,
218 ISCSI_ERR_DATA_DGST
= ISCSI_ERR_BASE
+ 15,
219 ISCSI_ERR_PARAM_NOT_FOUND
= ISCSI_ERR_BASE
+ 16,
220 ISCSI_ERR_NO_SCSI_CMD
= ISCSI_ERR_BASE
+ 17,
221 ISCSI_ERR_INVALID_HOST
= ISCSI_ERR_BASE
+ 18,
222 ISCSI_ERR_XMIT_FAILED
= ISCSI_ERR_BASE
+ 19,
226 * iSCSI Parameters (RFC3720)
229 /* passed in using netlink set param */
230 ISCSI_PARAM_MAX_RECV_DLENGTH
,
231 ISCSI_PARAM_MAX_XMIT_DLENGTH
,
232 ISCSI_PARAM_HDRDGST_EN
,
233 ISCSI_PARAM_DATADGST_EN
,
234 ISCSI_PARAM_INITIAL_R2T_EN
,
236 ISCSI_PARAM_IMM_DATA_EN
,
237 ISCSI_PARAM_FIRST_BURST
,
238 ISCSI_PARAM_MAX_BURST
,
239 ISCSI_PARAM_PDU_INORDER_EN
,
240 ISCSI_PARAM_DATASEQ_INORDER_EN
,
242 ISCSI_PARAM_IFMARKER_EN
,
243 ISCSI_PARAM_OFMARKER_EN
,
244 ISCSI_PARAM_EXP_STATSN
,
245 ISCSI_PARAM_TARGET_NAME
,
247 ISCSI_PARAM_PERSISTENT_ADDRESS
,
248 ISCSI_PARAM_PERSISTENT_PORT
,
249 ISCSI_PARAM_SESS_RECOVERY_TMO
,
251 /* pased in through bind conn using transport_fd */
252 ISCSI_PARAM_CONN_PORT
,
253 ISCSI_PARAM_CONN_ADDRESS
,
255 ISCSI_PARAM_USERNAME
,
256 ISCSI_PARAM_USERNAME_IN
,
257 ISCSI_PARAM_PASSWORD
,
258 ISCSI_PARAM_PASSWORD_IN
,
260 ISCSI_PARAM_FAST_ABORT
,
261 ISCSI_PARAM_ABORT_TMO
,
262 ISCSI_PARAM_LU_RESET_TMO
,
263 ISCSI_PARAM_HOST_RESET_TMO
,
265 ISCSI_PARAM_PING_TMO
,
266 ISCSI_PARAM_RECV_TMO
,
268 ISCSI_PARAM_IFACE_NAME
,
270 ISCSI_PARAM_INITIATOR_NAME
,
271 /* must always be last */
275 #define ISCSI_MAX_RECV_DLENGTH (1ULL << ISCSI_PARAM_MAX_RECV_DLENGTH)
276 #define ISCSI_MAX_XMIT_DLENGTH (1ULL << ISCSI_PARAM_MAX_XMIT_DLENGTH)
277 #define ISCSI_HDRDGST_EN (1ULL << ISCSI_PARAM_HDRDGST_EN)
278 #define ISCSI_DATADGST_EN (1ULL << ISCSI_PARAM_DATADGST_EN)
279 #define ISCSI_INITIAL_R2T_EN (1ULL << ISCSI_PARAM_INITIAL_R2T_EN)
280 #define ISCSI_MAX_R2T (1ULL << ISCSI_PARAM_MAX_R2T)
281 #define ISCSI_IMM_DATA_EN (1ULL << ISCSI_PARAM_IMM_DATA_EN)
282 #define ISCSI_FIRST_BURST (1ULL << ISCSI_PARAM_FIRST_BURST)
283 #define ISCSI_MAX_BURST (1ULL << ISCSI_PARAM_MAX_BURST)
284 #define ISCSI_PDU_INORDER_EN (1ULL << ISCSI_PARAM_PDU_INORDER_EN)
285 #define ISCSI_DATASEQ_INORDER_EN (1ULL << ISCSI_PARAM_DATASEQ_INORDER_EN)
286 #define ISCSI_ERL (1ULL << ISCSI_PARAM_ERL)
287 #define ISCSI_IFMARKER_EN (1ULL << ISCSI_PARAM_IFMARKER_EN)
288 #define ISCSI_OFMARKER_EN (1ULL << ISCSI_PARAM_OFMARKER_EN)
289 #define ISCSI_EXP_STATSN (1ULL << ISCSI_PARAM_EXP_STATSN)
290 #define ISCSI_TARGET_NAME (1ULL << ISCSI_PARAM_TARGET_NAME)
291 #define ISCSI_TPGT (1ULL << ISCSI_PARAM_TPGT)
292 #define ISCSI_PERSISTENT_ADDRESS (1ULL << ISCSI_PARAM_PERSISTENT_ADDRESS)
293 #define ISCSI_PERSISTENT_PORT (1ULL << ISCSI_PARAM_PERSISTENT_PORT)
294 #define ISCSI_SESS_RECOVERY_TMO (1ULL << ISCSI_PARAM_SESS_RECOVERY_TMO)
295 #define ISCSI_CONN_PORT (1ULL << ISCSI_PARAM_CONN_PORT)
296 #define ISCSI_CONN_ADDRESS (1ULL << ISCSI_PARAM_CONN_ADDRESS)
297 #define ISCSI_USERNAME (1ULL << ISCSI_PARAM_USERNAME)
298 #define ISCSI_USERNAME_IN (1ULL << ISCSI_PARAM_USERNAME_IN)
299 #define ISCSI_PASSWORD (1ULL << ISCSI_PARAM_PASSWORD)
300 #define ISCSI_PASSWORD_IN (1ULL << ISCSI_PARAM_PASSWORD_IN)
301 #define ISCSI_FAST_ABORT (1ULL << ISCSI_PARAM_FAST_ABORT)
302 #define ISCSI_ABORT_TMO (1ULL << ISCSI_PARAM_ABORT_TMO)
303 #define ISCSI_LU_RESET_TMO (1ULL << ISCSI_PARAM_LU_RESET_TMO)
304 #define ISCSI_HOST_RESET_TMO (1ULL << ISCSI_PARAM_HOST_RESET_TMO)
305 #define ISCSI_PING_TMO (1ULL << ISCSI_PARAM_PING_TMO)
306 #define ISCSI_RECV_TMO (1ULL << ISCSI_PARAM_RECV_TMO)
307 #define ISCSI_IFACE_NAME (1ULL << ISCSI_PARAM_IFACE_NAME)
308 #define ISCSI_ISID (1ULL << ISCSI_PARAM_ISID)
309 #define ISCSI_INITIATOR_NAME (1ULL << ISCSI_PARAM_INITIATOR_NAME)
311 /* iSCSI HBA params */
312 enum iscsi_host_param
{
313 ISCSI_HOST_PARAM_HWADDRESS
,
314 ISCSI_HOST_PARAM_INITIATOR_NAME
,
315 ISCSI_HOST_PARAM_NETDEV_NAME
,
316 ISCSI_HOST_PARAM_IPADDRESS
,
317 ISCSI_HOST_PARAM_MAX
,
320 #define ISCSI_HOST_HWADDRESS (1ULL << ISCSI_HOST_PARAM_HWADDRESS)
321 #define ISCSI_HOST_INITIATOR_NAME (1ULL << ISCSI_HOST_PARAM_INITIATOR_NAME)
322 #define ISCSI_HOST_NETDEV_NAME (1ULL << ISCSI_HOST_PARAM_NETDEV_NAME)
323 #define ISCSI_HOST_IPADDRESS (1ULL << ISCSI_HOST_PARAM_IPADDRESS)
325 #define iscsi_ptr(_handle) ((void*)(unsigned long)_handle)
326 #define iscsi_handle(_ptr) ((uint64_t)(unsigned long)_ptr)
329 * These flags presents iSCSI Data-Path capabilities.
331 #define CAP_RECOVERY_L0 0x1
332 #define CAP_RECOVERY_L1 0x2
333 #define CAP_RECOVERY_L2 0x4
334 #define CAP_MULTI_R2T 0x8
335 #define CAP_HDRDGST 0x10
336 #define CAP_DATADGST 0x20
337 #define CAP_MULTI_CONN 0x40
338 #define CAP_TEXT_NEGO 0x80
339 #define CAP_MARKERS 0x100
340 #define CAP_FW_DB 0x200
341 #define CAP_SENDTARGETS_OFFLOAD 0x400 /* offload discovery process */
342 #define CAP_DATA_PATH_OFFLOAD 0x800 /* offload entire IO path */
343 #define CAP_DIGEST_OFFLOAD 0x1000 /* offload hdr and data digests */
344 #define CAP_PADDING_OFFLOAD 0x2000 /* offload padding insertion, removal,
348 * These flags describes reason of stop_conn() call
350 #define STOP_CONN_TERM 0x1
351 #define STOP_CONN_SUSPEND 0x2
352 #define STOP_CONN_RECOVER 0x3
354 #define ISCSI_STATS_CUSTOM_MAX 32
355 #define ISCSI_STATS_CUSTOM_DESC_MAX 64
356 struct iscsi_stats_custom
{
357 char desc
[ISCSI_STATS_CUSTOM_DESC_MAX
];
362 * struct iscsi_stats - iSCSI Statistics (iSCSI MIB)
364 * Note: this structure contains counters collected on per-connection basis.
368 uint64_t txdata_octets
;
369 uint64_t rxdata_octets
;
373 uint32_t scsicmd_pdus
;
374 uint32_t tmfcmd_pdus
;
377 uint32_t dataout_pdus
;
378 uint32_t logout_pdus
;
383 uint32_t scsirsp_pdus
;
384 uint32_t tmfrsp_pdus
;
385 uint32_t textrsp_pdus
;
386 uint32_t datain_pdus
;
387 uint32_t logoutrsp_pdus
;
394 uint32_t timeout_err
;
397 * iSCSI Custom Statistics support, i.e. Transport could
398 * extend existing MIB statistics with its own specific statistics
399 * up to ISCSI_STATS_CUSTOM_MAX
401 uint32_t custom_length
;
402 struct iscsi_stats_custom custom
[0]
403 __attribute__ ((aligned (sizeof(uint64_t))));