Linux Audio

Check our new training course

Loading...
v3.1
  1/*
  2 * iSCSI User/Kernel Shares (Defines, Constants, Protocol definitions, etc)
  3 *
  4 * Copyright (C) 2005 Dmitry Yusupov
  5 * Copyright (C) 2005 Alex Aizman
  6 * maintained by open-iscsi@googlegroups.com
  7 *
  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.
 12 *
 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.
 17 *
 18 * See the file COPYING included with this distribution for more details.
 19 */
 20
 21#ifndef ISCSI_IF_H
 22#define ISCSI_IF_H
 23
 24#include <scsi/iscsi_proto.h>
 25#include <linux/in.h>
 26#include <linux/in6.h>
 27
 28#define ISCSI_NL_GRP_ISCSID	1
 29#define ISCSI_NL_GRP_UIP	2
 30
 31#define UEVENT_BASE			10
 32#define KEVENT_BASE			100
 33#define ISCSI_ERR_BASE			1000
 34
 35enum iscsi_uevent_e {
 36	ISCSI_UEVENT_UNKNOWN		= 0,
 37
 38	/* down events */
 39	ISCSI_UEVENT_CREATE_SESSION	= UEVENT_BASE + 1,
 40	ISCSI_UEVENT_DESTROY_SESSION	= UEVENT_BASE + 2,
 41	ISCSI_UEVENT_CREATE_CONN	= UEVENT_BASE + 3,
 42	ISCSI_UEVENT_DESTROY_CONN	= UEVENT_BASE + 4,
 43	ISCSI_UEVENT_BIND_CONN		= UEVENT_BASE + 5,
 44	ISCSI_UEVENT_SET_PARAM		= UEVENT_BASE + 6,
 45	ISCSI_UEVENT_START_CONN		= UEVENT_BASE + 7,
 46	ISCSI_UEVENT_STOP_CONN		= UEVENT_BASE + 8,
 47	ISCSI_UEVENT_SEND_PDU		= UEVENT_BASE + 9,
 48	ISCSI_UEVENT_GET_STATS		= UEVENT_BASE + 10,
 49	ISCSI_UEVENT_GET_PARAM		= UEVENT_BASE + 11,
 50
 51	ISCSI_UEVENT_TRANSPORT_EP_CONNECT	= UEVENT_BASE + 12,
 52	ISCSI_UEVENT_TRANSPORT_EP_POLL		= UEVENT_BASE + 13,
 53	ISCSI_UEVENT_TRANSPORT_EP_DISCONNECT	= UEVENT_BASE + 14,
 54
 55	ISCSI_UEVENT_TGT_DSCVR		= UEVENT_BASE + 15,
 56	ISCSI_UEVENT_SET_HOST_PARAM	= UEVENT_BASE + 16,
 57	ISCSI_UEVENT_UNBIND_SESSION	= UEVENT_BASE + 17,
 58	ISCSI_UEVENT_CREATE_BOUND_SESSION		= UEVENT_BASE + 18,
 59	ISCSI_UEVENT_TRANSPORT_EP_CONNECT_THROUGH_HOST	= UEVENT_BASE + 19,
 60
 61	ISCSI_UEVENT_PATH_UPDATE	= UEVENT_BASE + 20,
 
 
 
 
 
 
 
 
 
 
 
 
 62
 63	/* up events */
 64	ISCSI_KEVENT_RECV_PDU		= KEVENT_BASE + 1,
 65	ISCSI_KEVENT_CONN_ERROR		= KEVENT_BASE + 2,
 66	ISCSI_KEVENT_IF_ERROR		= KEVENT_BASE + 3,
 67	ISCSI_KEVENT_DESTROY_SESSION	= KEVENT_BASE + 4,
 68	ISCSI_KEVENT_UNBIND_SESSION	= KEVENT_BASE + 5,
 69	ISCSI_KEVENT_CREATE_SESSION	= KEVENT_BASE + 6,
 70
 71	ISCSI_KEVENT_PATH_REQ		= KEVENT_BASE + 7,
 72	ISCSI_KEVENT_IF_DOWN		= KEVENT_BASE + 8,
 
 
 
 73};
 74
 75enum iscsi_tgt_dscvr {
 76	ISCSI_TGT_DSCVR_SEND_TARGETS	= 1,
 77	ISCSI_TGT_DSCVR_ISNS		= 2,
 78	ISCSI_TGT_DSCVR_SLP		= 3,
 79};
 80
 
 
 
 
 
 
 
 81struct iscsi_uevent {
 82	uint32_t type; /* k/u events type */
 83	uint32_t iferror; /* carries interface or resource errors */
 84	uint64_t transport_handle;
 85
 86	union {
 87		/* messages u -> k */
 88		struct msg_create_session {
 89			uint32_t	initial_cmdsn;
 90			uint16_t	cmds_max;
 91			uint16_t	queue_depth;
 92		} c_session;
 93		struct msg_create_bound_session {
 94			uint64_t	ep_handle;
 95			uint32_t	initial_cmdsn;
 96			uint16_t	cmds_max;
 97			uint16_t	queue_depth;
 98		} c_bound_session;
 99		struct msg_destroy_session {
100			uint32_t	sid;
101		} d_session;
102		struct msg_create_conn {
103			uint32_t	sid;
104			uint32_t	cid;
105		} c_conn;
106		struct msg_bind_conn {
107			uint32_t	sid;
108			uint32_t	cid;
109			uint64_t	transport_eph;
110			uint32_t	is_leading;
111		} b_conn;
112		struct msg_destroy_conn {
113			uint32_t	sid;
114			uint32_t	cid;
115		} d_conn;
116		struct msg_send_pdu {
117			uint32_t	sid;
118			uint32_t	cid;
119			uint32_t	hdr_size;
120			uint32_t	data_size;
121		} send_pdu;
122		struct msg_set_param {
123			uint32_t	sid;
124			uint32_t	cid;
125			uint32_t	param; /* enum iscsi_param */
126			uint32_t	len;
127		} set_param;
128		struct msg_start_conn {
129			uint32_t	sid;
130			uint32_t	cid;
131		} start_conn;
132		struct msg_stop_conn {
133			uint32_t	sid;
134			uint32_t	cid;
135			uint64_t	conn_handle;
136			uint32_t	flag;
137		} stop_conn;
138		struct msg_get_stats {
139			uint32_t	sid;
140			uint32_t	cid;
141		} get_stats;
142		struct msg_transport_connect {
143			uint32_t	non_blocking;
144		} ep_connect;
145		struct msg_transport_connect_through_host {
146			uint32_t	host_no;
147			uint32_t	non_blocking;
148		} ep_connect_through_host;
149		struct msg_transport_poll {
150			uint64_t	ep_handle;
151			uint32_t	timeout_ms;
152		} ep_poll;
153		struct msg_transport_disconnect {
154			uint64_t	ep_handle;
155		} ep_disconnect;
156		struct msg_tgt_dscvr {
157			enum iscsi_tgt_dscvr	type;
158			uint32_t	host_no;
159			/*
160 			 * enable = 1 to establish a new connection
161			 * with the server. enable = 0 to disconnect
162			 * from the server. Used primarily to switch
163			 * from one iSNS server to another.
164			 */
165			uint32_t	enable;
166		} tgt_dscvr;
167		struct msg_set_host_param {
168			uint32_t	host_no;
169			uint32_t	param; /* enum iscsi_host_param */
170			uint32_t	len;
171		} set_host_param;
172		struct msg_set_path {
173			uint32_t	host_no;
174		} set_path;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
175	} u;
176	union {
177		/* messages k -> u */
178		int			retcode;
179		struct msg_create_session_ret {
180			uint32_t	sid;
181			uint32_t	host_no;
182		} c_session_ret;
183		struct msg_create_conn_ret {
184			uint32_t	sid;
185			uint32_t	cid;
186		} c_conn_ret;
187		struct msg_unbind_session {
188			uint32_t	sid;
189			uint32_t	host_no;
190		} unbind_session;
191		struct msg_recv_req {
192			uint32_t	sid;
193			uint32_t	cid;
194			uint64_t	recv_handle;
195		} recv_req;
 
 
 
 
 
196		struct msg_conn_error {
197			uint32_t	sid;
198			uint32_t	cid;
199			uint32_t	error; /* enum iscsi_err */
200		} connerror;
201		struct msg_session_destroyed {
202			uint32_t	host_no;
203			uint32_t	sid;
204		} d_session;
205		struct msg_transport_connect_ret {
206			uint64_t	handle;
207		} ep_connect_ret;
208		struct msg_req_path {
209			uint32_t	host_no;
210		} req_path;
211		struct msg_notify_if_down {
212			uint32_t	host_no;
213		} notify_if_down;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
214	} r;
215} __attribute__ ((aligned (sizeof(uint64_t))));
216
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
217/*
218 * To keep the struct iscsi_uevent size the same for userspace code
219 * compatibility, the main structure for ISCSI_UEVENT_PATH_UPDATE and
220 * ISCSI_KEVENT_PATH_REQ is defined separately and comes after the
221 * struct iscsi_uevent in the NETLINK_ISCSI message.
222 */
223struct iscsi_path {
224	uint64_t	handle;
225	uint8_t		mac_addr[6];
226	uint8_t		mac_addr_old[6];
227	uint32_t	ip_addr_len;	/* 4 or 16 */
228	union {
229		struct in_addr	v4_addr;
230		struct in6_addr	v6_addr;
231	} src;
232	union {
233		struct in_addr	v4_addr;
234		struct in6_addr	v6_addr;
235	} dst;
236	uint16_t	vlan_id;
237	uint16_t	pmtu;
238} __attribute__ ((aligned (sizeof(uint64_t))));
239
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
240/*
241 * Common error codes
242 */
243enum iscsi_err {
244	ISCSI_OK			= 0,
245
246	ISCSI_ERR_DATASN		= ISCSI_ERR_BASE + 1,
247	ISCSI_ERR_DATA_OFFSET		= ISCSI_ERR_BASE + 2,
248	ISCSI_ERR_MAX_CMDSN		= ISCSI_ERR_BASE + 3,
249	ISCSI_ERR_EXP_CMDSN		= ISCSI_ERR_BASE + 4,
250	ISCSI_ERR_BAD_OPCODE		= ISCSI_ERR_BASE + 5,
251	ISCSI_ERR_DATALEN		= ISCSI_ERR_BASE + 6,
252	ISCSI_ERR_AHSLEN		= ISCSI_ERR_BASE + 7,
253	ISCSI_ERR_PROTO			= ISCSI_ERR_BASE + 8,
254	ISCSI_ERR_LUN			= ISCSI_ERR_BASE + 9,
255	ISCSI_ERR_BAD_ITT		= ISCSI_ERR_BASE + 10,
256	ISCSI_ERR_CONN_FAILED		= ISCSI_ERR_BASE + 11,
257	ISCSI_ERR_R2TSN			= ISCSI_ERR_BASE + 12,
258	ISCSI_ERR_SESSION_FAILED	= ISCSI_ERR_BASE + 13,
259	ISCSI_ERR_HDR_DGST		= ISCSI_ERR_BASE + 14,
260	ISCSI_ERR_DATA_DGST		= ISCSI_ERR_BASE + 15,
261	ISCSI_ERR_PARAM_NOT_FOUND	= ISCSI_ERR_BASE + 16,
262	ISCSI_ERR_NO_SCSI_CMD		= ISCSI_ERR_BASE + 17,
263	ISCSI_ERR_INVALID_HOST		= ISCSI_ERR_BASE + 18,
264	ISCSI_ERR_XMIT_FAILED		= ISCSI_ERR_BASE + 19,
265	ISCSI_ERR_TCP_CONN_CLOSE	= ISCSI_ERR_BASE + 20,
266	ISCSI_ERR_SCSI_EH_SESSION_RST	= ISCSI_ERR_BASE + 21,
267};
268
269/*
270 * iSCSI Parameters (RFC3720)
271 */
272enum iscsi_param {
273	/* passed in using netlink set param */
274	ISCSI_PARAM_MAX_RECV_DLENGTH,
275	ISCSI_PARAM_MAX_XMIT_DLENGTH,
276	ISCSI_PARAM_HDRDGST_EN,
277	ISCSI_PARAM_DATADGST_EN,
278	ISCSI_PARAM_INITIAL_R2T_EN,
279	ISCSI_PARAM_MAX_R2T,
280	ISCSI_PARAM_IMM_DATA_EN,
281	ISCSI_PARAM_FIRST_BURST,
282	ISCSI_PARAM_MAX_BURST,
283	ISCSI_PARAM_PDU_INORDER_EN,
284	ISCSI_PARAM_DATASEQ_INORDER_EN,
285	ISCSI_PARAM_ERL,
286	ISCSI_PARAM_IFMARKER_EN,
287	ISCSI_PARAM_OFMARKER_EN,
288	ISCSI_PARAM_EXP_STATSN,
289	ISCSI_PARAM_TARGET_NAME,
290	ISCSI_PARAM_TPGT,
291	ISCSI_PARAM_PERSISTENT_ADDRESS,
292	ISCSI_PARAM_PERSISTENT_PORT,
293	ISCSI_PARAM_SESS_RECOVERY_TMO,
294
295	/* passed in through bind conn using transport_fd */
296	ISCSI_PARAM_CONN_PORT,
297	ISCSI_PARAM_CONN_ADDRESS,
298
299	ISCSI_PARAM_USERNAME,
300	ISCSI_PARAM_USERNAME_IN,
301	ISCSI_PARAM_PASSWORD,
302	ISCSI_PARAM_PASSWORD_IN,
303
304	ISCSI_PARAM_FAST_ABORT,
305	ISCSI_PARAM_ABORT_TMO,
306	ISCSI_PARAM_LU_RESET_TMO,
307	ISCSI_PARAM_HOST_RESET_TMO,
308
309	ISCSI_PARAM_PING_TMO,
310	ISCSI_PARAM_RECV_TMO,
311
312	ISCSI_PARAM_IFACE_NAME,
313	ISCSI_PARAM_ISID,
314	ISCSI_PARAM_INITIATOR_NAME,
315
316	ISCSI_PARAM_TGT_RESET_TMO,
317	ISCSI_PARAM_TARGET_ALIAS,
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
318	/* must always be last */
319	ISCSI_PARAM_MAX,
320};
321
322#define ISCSI_MAX_RECV_DLENGTH		(1ULL << ISCSI_PARAM_MAX_RECV_DLENGTH)
323#define ISCSI_MAX_XMIT_DLENGTH		(1ULL << ISCSI_PARAM_MAX_XMIT_DLENGTH)
324#define ISCSI_HDRDGST_EN		(1ULL << ISCSI_PARAM_HDRDGST_EN)
325#define ISCSI_DATADGST_EN		(1ULL << ISCSI_PARAM_DATADGST_EN)
326#define ISCSI_INITIAL_R2T_EN		(1ULL << ISCSI_PARAM_INITIAL_R2T_EN)
327#define ISCSI_MAX_R2T			(1ULL << ISCSI_PARAM_MAX_R2T)
328#define ISCSI_IMM_DATA_EN		(1ULL << ISCSI_PARAM_IMM_DATA_EN)
329#define ISCSI_FIRST_BURST		(1ULL << ISCSI_PARAM_FIRST_BURST)
330#define ISCSI_MAX_BURST			(1ULL << ISCSI_PARAM_MAX_BURST)
331#define ISCSI_PDU_INORDER_EN		(1ULL << ISCSI_PARAM_PDU_INORDER_EN)
332#define ISCSI_DATASEQ_INORDER_EN	(1ULL << ISCSI_PARAM_DATASEQ_INORDER_EN)
333#define ISCSI_ERL			(1ULL << ISCSI_PARAM_ERL)
334#define ISCSI_IFMARKER_EN		(1ULL << ISCSI_PARAM_IFMARKER_EN)
335#define ISCSI_OFMARKER_EN		(1ULL << ISCSI_PARAM_OFMARKER_EN)
336#define ISCSI_EXP_STATSN		(1ULL << ISCSI_PARAM_EXP_STATSN)
337#define ISCSI_TARGET_NAME		(1ULL << ISCSI_PARAM_TARGET_NAME)
338#define ISCSI_TPGT			(1ULL << ISCSI_PARAM_TPGT)
339#define ISCSI_PERSISTENT_ADDRESS	(1ULL << ISCSI_PARAM_PERSISTENT_ADDRESS)
340#define ISCSI_PERSISTENT_PORT		(1ULL << ISCSI_PARAM_PERSISTENT_PORT)
341#define ISCSI_SESS_RECOVERY_TMO		(1ULL << ISCSI_PARAM_SESS_RECOVERY_TMO)
342#define ISCSI_CONN_PORT			(1ULL << ISCSI_PARAM_CONN_PORT)
343#define ISCSI_CONN_ADDRESS		(1ULL << ISCSI_PARAM_CONN_ADDRESS)
344#define ISCSI_USERNAME			(1ULL << ISCSI_PARAM_USERNAME)
345#define ISCSI_USERNAME_IN		(1ULL << ISCSI_PARAM_USERNAME_IN)
346#define ISCSI_PASSWORD			(1ULL << ISCSI_PARAM_PASSWORD)
347#define ISCSI_PASSWORD_IN		(1ULL << ISCSI_PARAM_PASSWORD_IN)
348#define ISCSI_FAST_ABORT		(1ULL << ISCSI_PARAM_FAST_ABORT)
349#define ISCSI_ABORT_TMO			(1ULL << ISCSI_PARAM_ABORT_TMO)
350#define ISCSI_LU_RESET_TMO		(1ULL << ISCSI_PARAM_LU_RESET_TMO)
351#define ISCSI_HOST_RESET_TMO		(1ULL << ISCSI_PARAM_HOST_RESET_TMO)
352#define ISCSI_PING_TMO			(1ULL << ISCSI_PARAM_PING_TMO)
353#define ISCSI_RECV_TMO			(1ULL << ISCSI_PARAM_RECV_TMO)
354#define ISCSI_IFACE_NAME		(1ULL << ISCSI_PARAM_IFACE_NAME)
355#define ISCSI_ISID			(1ULL << ISCSI_PARAM_ISID)
356#define ISCSI_INITIATOR_NAME		(1ULL << ISCSI_PARAM_INITIATOR_NAME)
357#define ISCSI_TGT_RESET_TMO		(1ULL << ISCSI_PARAM_TGT_RESET_TMO)
358#define ISCSI_TARGET_ALIAS		(1ULL << ISCSI_PARAM_TARGET_ALIAS)
359
360/* iSCSI HBA params */
361enum iscsi_host_param {
362	ISCSI_HOST_PARAM_HWADDRESS,
363	ISCSI_HOST_PARAM_INITIATOR_NAME,
364	ISCSI_HOST_PARAM_NETDEV_NAME,
365	ISCSI_HOST_PARAM_IPADDRESS,
 
 
366	ISCSI_HOST_PARAM_MAX,
367};
368
369#define ISCSI_HOST_HWADDRESS		(1ULL << ISCSI_HOST_PARAM_HWADDRESS)
370#define ISCSI_HOST_INITIATOR_NAME	(1ULL << ISCSI_HOST_PARAM_INITIATOR_NAME)
371#define ISCSI_HOST_NETDEV_NAME		(1ULL << ISCSI_HOST_PARAM_NETDEV_NAME)
372#define ISCSI_HOST_IPADDRESS		(1ULL << ISCSI_HOST_PARAM_IPADDRESS)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
373
374#define iscsi_ptr(_handle) ((void*)(unsigned long)_handle)
375#define iscsi_handle(_ptr) ((uint64_t)(unsigned long)_ptr)
376
377/*
378 * These flags presents iSCSI Data-Path capabilities.
379 */
380#define CAP_RECOVERY_L0		0x1
381#define CAP_RECOVERY_L1		0x2
382#define CAP_RECOVERY_L2		0x4
383#define CAP_MULTI_R2T		0x8
384#define CAP_HDRDGST		0x10
385#define CAP_DATADGST		0x20
386#define CAP_MULTI_CONN		0x40
387#define CAP_TEXT_NEGO		0x80
388#define CAP_MARKERS		0x100
389#define CAP_FW_DB		0x200
390#define CAP_SENDTARGETS_OFFLOAD	0x400	/* offload discovery process */
391#define CAP_DATA_PATH_OFFLOAD	0x800	/* offload entire IO path */
392#define CAP_DIGEST_OFFLOAD	0x1000	/* offload hdr and data digests */
393#define CAP_PADDING_OFFLOAD	0x2000	/* offload padding insertion, removal,
394					 and verification */
 
395
396/*
397 * These flags describes reason of stop_conn() call
398 */
399#define STOP_CONN_TERM		0x1
400#define STOP_CONN_SUSPEND	0x2
401#define STOP_CONN_RECOVER	0x3
402
403#define ISCSI_STATS_CUSTOM_MAX		32
404#define ISCSI_STATS_CUSTOM_DESC_MAX	64
405struct iscsi_stats_custom {
406	char desc[ISCSI_STATS_CUSTOM_DESC_MAX];
407	uint64_t value;
408};
409
410/*
411 * struct iscsi_stats - iSCSI Statistics (iSCSI MIB)
412 *
413 * Note: this structure contains counters collected on per-connection basis.
414 */
415struct iscsi_stats {
416	/* octets */
417	uint64_t txdata_octets;
418	uint64_t rxdata_octets;
419
420	/* xmit pdus */
421	uint32_t noptx_pdus;
422	uint32_t scsicmd_pdus;
423	uint32_t tmfcmd_pdus;
424	uint32_t login_pdus;
425	uint32_t text_pdus;
426	uint32_t dataout_pdus;
427	uint32_t logout_pdus;
428	uint32_t snack_pdus;
429
430	/* recv pdus */
431	uint32_t noprx_pdus;
432	uint32_t scsirsp_pdus;
433	uint32_t tmfrsp_pdus;
434	uint32_t textrsp_pdus;
435	uint32_t datain_pdus;
436	uint32_t logoutrsp_pdus;
437	uint32_t r2t_pdus;
438	uint32_t async_pdus;
439	uint32_t rjt_pdus;
440
441	/* errors */
442	uint32_t digest_err;
443	uint32_t timeout_err;
444
445	/*
446	 * iSCSI Custom Statistics support, i.e. Transport could
447	 * extend existing MIB statistics with its own specific statistics
448	 * up to ISCSI_STATS_CUSTOM_MAX
449	 */
450	uint32_t custom_length;
451	struct iscsi_stats_custom custom[0]
452		__attribute__ ((aligned (sizeof(uint64_t))));
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
453};
454
455#endif
v3.15
  1/*
  2 * iSCSI User/Kernel Shares (Defines, Constants, Protocol definitions, etc)
  3 *
  4 * Copyright (C) 2005 Dmitry Yusupov
  5 * Copyright (C) 2005 Alex Aizman
  6 * maintained by open-iscsi@googlegroups.com
  7 *
  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.
 12 *
 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.
 17 *
 18 * See the file COPYING included with this distribution for more details.
 19 */
 20
 21#ifndef ISCSI_IF_H
 22#define ISCSI_IF_H
 23
 24#include <scsi/iscsi_proto.h>
 25#include <linux/in.h>
 26#include <linux/in6.h>
 27
 28#define ISCSI_NL_GRP_ISCSID	1
 29#define ISCSI_NL_GRP_UIP	2
 30
 31#define UEVENT_BASE			10
 32#define KEVENT_BASE			100
 33#define ISCSI_ERR_BASE			1000
 34
 35enum iscsi_uevent_e {
 36	ISCSI_UEVENT_UNKNOWN		= 0,
 37
 38	/* down events */
 39	ISCSI_UEVENT_CREATE_SESSION	= UEVENT_BASE + 1,
 40	ISCSI_UEVENT_DESTROY_SESSION	= UEVENT_BASE + 2,
 41	ISCSI_UEVENT_CREATE_CONN	= UEVENT_BASE + 3,
 42	ISCSI_UEVENT_DESTROY_CONN	= UEVENT_BASE + 4,
 43	ISCSI_UEVENT_BIND_CONN		= UEVENT_BASE + 5,
 44	ISCSI_UEVENT_SET_PARAM		= UEVENT_BASE + 6,
 45	ISCSI_UEVENT_START_CONN		= UEVENT_BASE + 7,
 46	ISCSI_UEVENT_STOP_CONN		= UEVENT_BASE + 8,
 47	ISCSI_UEVENT_SEND_PDU		= UEVENT_BASE + 9,
 48	ISCSI_UEVENT_GET_STATS		= UEVENT_BASE + 10,
 49	ISCSI_UEVENT_GET_PARAM		= UEVENT_BASE + 11,
 50
 51	ISCSI_UEVENT_TRANSPORT_EP_CONNECT	= UEVENT_BASE + 12,
 52	ISCSI_UEVENT_TRANSPORT_EP_POLL		= UEVENT_BASE + 13,
 53	ISCSI_UEVENT_TRANSPORT_EP_DISCONNECT	= UEVENT_BASE + 14,
 54
 55	ISCSI_UEVENT_TGT_DSCVR		= UEVENT_BASE + 15,
 56	ISCSI_UEVENT_SET_HOST_PARAM	= UEVENT_BASE + 16,
 57	ISCSI_UEVENT_UNBIND_SESSION	= UEVENT_BASE + 17,
 58	ISCSI_UEVENT_CREATE_BOUND_SESSION		= UEVENT_BASE + 18,
 59	ISCSI_UEVENT_TRANSPORT_EP_CONNECT_THROUGH_HOST	= UEVENT_BASE + 19,
 60
 61	ISCSI_UEVENT_PATH_UPDATE	= UEVENT_BASE + 20,
 62	ISCSI_UEVENT_SET_IFACE_PARAMS	= UEVENT_BASE + 21,
 63	ISCSI_UEVENT_PING		= UEVENT_BASE + 22,
 64	ISCSI_UEVENT_GET_CHAP		= UEVENT_BASE + 23,
 65	ISCSI_UEVENT_DELETE_CHAP	= UEVENT_BASE + 24,
 66	ISCSI_UEVENT_SET_FLASHNODE_PARAMS	= UEVENT_BASE + 25,
 67	ISCSI_UEVENT_NEW_FLASHNODE	= UEVENT_BASE + 26,
 68	ISCSI_UEVENT_DEL_FLASHNODE	= UEVENT_BASE + 27,
 69	ISCSI_UEVENT_LOGIN_FLASHNODE	= UEVENT_BASE + 28,
 70	ISCSI_UEVENT_LOGOUT_FLASHNODE	= UEVENT_BASE + 29,
 71	ISCSI_UEVENT_LOGOUT_FLASHNODE_SID	= UEVENT_BASE + 30,
 72	ISCSI_UEVENT_SET_CHAP		= UEVENT_BASE + 31,
 73	ISCSI_UEVENT_GET_HOST_STATS	= UEVENT_BASE + 32,
 74
 75	/* up events */
 76	ISCSI_KEVENT_RECV_PDU		= KEVENT_BASE + 1,
 77	ISCSI_KEVENT_CONN_ERROR		= KEVENT_BASE + 2,
 78	ISCSI_KEVENT_IF_ERROR		= KEVENT_BASE + 3,
 79	ISCSI_KEVENT_DESTROY_SESSION	= KEVENT_BASE + 4,
 80	ISCSI_KEVENT_UNBIND_SESSION	= KEVENT_BASE + 5,
 81	ISCSI_KEVENT_CREATE_SESSION	= KEVENT_BASE + 6,
 82
 83	ISCSI_KEVENT_PATH_REQ		= KEVENT_BASE + 7,
 84	ISCSI_KEVENT_IF_DOWN		= KEVENT_BASE + 8,
 85	ISCSI_KEVENT_CONN_LOGIN_STATE   = KEVENT_BASE + 9,
 86	ISCSI_KEVENT_HOST_EVENT		= KEVENT_BASE + 10,
 87	ISCSI_KEVENT_PING_COMP		= KEVENT_BASE + 11,
 88};
 89
 90enum iscsi_tgt_dscvr {
 91	ISCSI_TGT_DSCVR_SEND_TARGETS	= 1,
 92	ISCSI_TGT_DSCVR_ISNS		= 2,
 93	ISCSI_TGT_DSCVR_SLP		= 3,
 94};
 95
 96enum iscsi_host_event_code {
 97	ISCSI_EVENT_LINKUP		= 1,
 98	ISCSI_EVENT_LINKDOWN,
 99	/* must always be last */
100	ISCSI_EVENT_MAX,
101};
102
103struct iscsi_uevent {
104	uint32_t type; /* k/u events type */
105	uint32_t iferror; /* carries interface or resource errors */
106	uint64_t transport_handle;
107
108	union {
109		/* messages u -> k */
110		struct msg_create_session {
111			uint32_t	initial_cmdsn;
112			uint16_t	cmds_max;
113			uint16_t	queue_depth;
114		} c_session;
115		struct msg_create_bound_session {
116			uint64_t	ep_handle;
117			uint32_t	initial_cmdsn;
118			uint16_t	cmds_max;
119			uint16_t	queue_depth;
120		} c_bound_session;
121		struct msg_destroy_session {
122			uint32_t	sid;
123		} d_session;
124		struct msg_create_conn {
125			uint32_t	sid;
126			uint32_t	cid;
127		} c_conn;
128		struct msg_bind_conn {
129			uint32_t	sid;
130			uint32_t	cid;
131			uint64_t	transport_eph;
132			uint32_t	is_leading;
133		} b_conn;
134		struct msg_destroy_conn {
135			uint32_t	sid;
136			uint32_t	cid;
137		} d_conn;
138		struct msg_send_pdu {
139			uint32_t	sid;
140			uint32_t	cid;
141			uint32_t	hdr_size;
142			uint32_t	data_size;
143		} send_pdu;
144		struct msg_set_param {
145			uint32_t	sid;
146			uint32_t	cid;
147			uint32_t	param; /* enum iscsi_param */
148			uint32_t	len;
149		} set_param;
150		struct msg_start_conn {
151			uint32_t	sid;
152			uint32_t	cid;
153		} start_conn;
154		struct msg_stop_conn {
155			uint32_t	sid;
156			uint32_t	cid;
157			uint64_t	conn_handle;
158			uint32_t	flag;
159		} stop_conn;
160		struct msg_get_stats {
161			uint32_t	sid;
162			uint32_t	cid;
163		} get_stats;
164		struct msg_transport_connect {
165			uint32_t	non_blocking;
166		} ep_connect;
167		struct msg_transport_connect_through_host {
168			uint32_t	host_no;
169			uint32_t	non_blocking;
170		} ep_connect_through_host;
171		struct msg_transport_poll {
172			uint64_t	ep_handle;
173			uint32_t	timeout_ms;
174		} ep_poll;
175		struct msg_transport_disconnect {
176			uint64_t	ep_handle;
177		} ep_disconnect;
178		struct msg_tgt_dscvr {
179			enum iscsi_tgt_dscvr	type;
180			uint32_t	host_no;
181			/*
182 			 * enable = 1 to establish a new connection
183			 * with the server. enable = 0 to disconnect
184			 * from the server. Used primarily to switch
185			 * from one iSNS server to another.
186			 */
187			uint32_t	enable;
188		} tgt_dscvr;
189		struct msg_set_host_param {
190			uint32_t	host_no;
191			uint32_t	param; /* enum iscsi_host_param */
192			uint32_t	len;
193		} set_host_param;
194		struct msg_set_path {
195			uint32_t	host_no;
196		} set_path;
197		struct msg_set_iface_params {
198			uint32_t	host_no;
199			uint32_t	count;
200		} set_iface_params;
201		struct msg_iscsi_ping {
202			uint32_t        host_no;
203			uint32_t        iface_num;
204			uint32_t        iface_type;
205			uint32_t        payload_size;
206			uint32_t	pid;	/* unique ping id associated
207						   with each ping request */
208		} iscsi_ping;
209		struct msg_get_chap {
210			uint32_t	host_no;
211			uint32_t	num_entries; /* number of CHAP entries
212						      * on request, number of
213						      * valid CHAP entries on
214						      * response */
215			uint16_t	chap_tbl_idx;
216		} get_chap;
217		struct msg_delete_chap {
218		       uint32_t        host_no;
219		       uint16_t        chap_tbl_idx;
220		} delete_chap;
221		struct msg_set_flashnode_param {
222			uint32_t	host_no;
223			uint32_t	flashnode_idx;
224			uint32_t	count;
225		} set_flashnode;
226		struct msg_new_flashnode {
227			uint32_t	host_no;
228			uint32_t	len;
229		} new_flashnode;
230		struct msg_del_flashnode {
231			uint32_t	host_no;
232			uint32_t	flashnode_idx;
233		} del_flashnode;
234		struct msg_login_flashnode {
235			uint32_t	host_no;
236			uint32_t	flashnode_idx;
237		} login_flashnode;
238		struct msg_logout_flashnode {
239			uint32_t	host_no;
240			uint32_t	flashnode_idx;
241		} logout_flashnode;
242		struct msg_logout_flashnode_sid {
243			uint32_t	host_no;
244			uint32_t	sid;
245		} logout_flashnode_sid;
246		struct msg_get_host_stats {
247			uint32_t host_no;
248		} get_host_stats;
249	} u;
250	union {
251		/* messages k -> u */
252		int			retcode;
253		struct msg_create_session_ret {
254			uint32_t	sid;
255			uint32_t	host_no;
256		} c_session_ret;
257		struct msg_create_conn_ret {
258			uint32_t	sid;
259			uint32_t	cid;
260		} c_conn_ret;
261		struct msg_unbind_session {
262			uint32_t	sid;
263			uint32_t	host_no;
264		} unbind_session;
265		struct msg_recv_req {
266			uint32_t	sid;
267			uint32_t	cid;
268			uint64_t	recv_handle;
269		} recv_req;
270		struct msg_conn_login {
271			uint32_t        sid;
272			uint32_t        cid;
273			uint32_t        state; /* enum iscsi_conn_state */
274		} conn_login;
275		struct msg_conn_error {
276			uint32_t	sid;
277			uint32_t	cid;
278			uint32_t	error; /* enum iscsi_err */
279		} connerror;
280		struct msg_session_destroyed {
281			uint32_t	host_no;
282			uint32_t	sid;
283		} d_session;
284		struct msg_transport_connect_ret {
285			uint64_t	handle;
286		} ep_connect_ret;
287		struct msg_req_path {
288			uint32_t	host_no;
289		} req_path;
290		struct msg_notify_if_down {
291			uint32_t	host_no;
292		} notify_if_down;
293		struct msg_host_event {
294			uint32_t	host_no;
295			uint32_t	data_size;
296			enum iscsi_host_event_code code;
297		} host_event;
298		struct msg_ping_comp {
299			uint32_t        host_no;
300			uint32_t        status; /* enum
301						 * iscsi_ping_status_code */
302			uint32_t	pid;	/* unique ping id associated
303						   with each ping request */
304			uint32_t        data_size;
305		} ping_comp;
306		struct msg_new_flashnode_ret {
307			uint32_t	flashnode_idx;
308		} new_flashnode_ret;
309	} r;
310} __attribute__ ((aligned (sizeof(uint64_t))));
311
312enum iscsi_param_type {
313	ISCSI_PARAM,		/* iscsi_param (session, conn, target, LU) */
314	ISCSI_HOST_PARAM,	/* iscsi_host_param */
315	ISCSI_NET_PARAM,	/* iscsi_net_param */
316	ISCSI_FLASHNODE_PARAM,	/* iscsi_flashnode_param */
317	ISCSI_CHAP_PARAM,	/* iscsi_chap_param */
318	ISCSI_IFACE_PARAM,	/* iscsi_iface_param */
319};
320
321/* structure for minimalist usecase */
322struct iscsi_param_info {
323	uint32_t len;		/* Actual length of the param value */
324	uint16_t param;		/* iscsi param */
325	uint8_t value[0];	/* length sized value follows */
326} __packed;
327
328struct iscsi_iface_param_info {
329	uint32_t iface_num;	/* iface number, 0 - n */
330	uint32_t len;		/* Actual length of the param */
331	uint16_t param;		/* iscsi param value */
332	uint8_t iface_type;	/* IPv4 or IPv6 */
333	uint8_t param_type;	/* iscsi_param_type */
334	uint8_t value[0];	/* length sized value follows */
335} __packed;
336
337/*
338 * To keep the struct iscsi_uevent size the same for userspace code
339 * compatibility, the main structure for ISCSI_UEVENT_PATH_UPDATE and
340 * ISCSI_KEVENT_PATH_REQ is defined separately and comes after the
341 * struct iscsi_uevent in the NETLINK_ISCSI message.
342 */
343struct iscsi_path {
344	uint64_t	handle;
345	uint8_t		mac_addr[6];
346	uint8_t		mac_addr_old[6];
347	uint32_t	ip_addr_len;	/* 4 or 16 */
348	union {
349		struct in_addr	v4_addr;
350		struct in6_addr	v6_addr;
351	} src;
352	union {
353		struct in_addr	v4_addr;
354		struct in6_addr	v6_addr;
355	} dst;
356	uint16_t	vlan_id;
357	uint16_t	pmtu;
358} __attribute__ ((aligned (sizeof(uint64_t))));
359
360/* iscsi iface enabled/disabled setting */
361#define ISCSI_IFACE_DISABLE	0x01
362#define ISCSI_IFACE_ENABLE	0x02
363
364/* ipv4 bootproto */
365#define ISCSI_BOOTPROTO_STATIC		0x01
366#define ISCSI_BOOTPROTO_DHCP		0x02
367
368/* ipv6 addr autoconfig type */
369#define ISCSI_IPV6_AUTOCFG_DISABLE		0x01
370#define ISCSI_IPV6_AUTOCFG_ND_ENABLE		0x02
371#define ISCSI_IPV6_AUTOCFG_DHCPV6_ENABLE	0x03
372
373/* ipv6 link local addr type */
374#define ISCSI_IPV6_LINKLOCAL_AUTOCFG_ENABLE	0x01
375#define ISCSI_IPV6_LINKLOCAL_AUTOCFG_DISABLE	0x02
376
377/* ipv6 router addr type */
378#define ISCSI_IPV6_ROUTER_AUTOCFG_ENABLE	0x01
379#define ISCSI_IPV6_ROUTER_AUTOCFG_DISABLE	0x02
380
381#define ISCSI_IFACE_TYPE_IPV4		0x01
382#define ISCSI_IFACE_TYPE_IPV6		0x02
383
384#define ISCSI_MAX_VLAN_ID		4095
385#define ISCSI_MAX_VLAN_PRIORITY		7
386
387/* iscsi vlan enable/disabled setting */
388#define ISCSI_VLAN_DISABLE	0x01
389#define ISCSI_VLAN_ENABLE	0x02
390
391/* iscsi generic enable/disabled setting for various features */
392#define ISCSI_NET_PARAM_DISABLE		0x01
393#define ISCSI_NET_PARAM_ENABLE		0x02
394
395/* iSCSI network params */
396enum iscsi_net_param {
397	ISCSI_NET_PARAM_IPV4_ADDR		= 1,
398	ISCSI_NET_PARAM_IPV4_SUBNET,
399	ISCSI_NET_PARAM_IPV4_GW,
400	ISCSI_NET_PARAM_IPV4_BOOTPROTO,
401	ISCSI_NET_PARAM_MAC,
402	ISCSI_NET_PARAM_IPV6_LINKLOCAL,
403	ISCSI_NET_PARAM_IPV6_ADDR,
404	ISCSI_NET_PARAM_IPV6_ROUTER,
405	ISCSI_NET_PARAM_IPV6_ADDR_AUTOCFG,
406	ISCSI_NET_PARAM_IPV6_LINKLOCAL_AUTOCFG,
407	ISCSI_NET_PARAM_IPV6_ROUTER_AUTOCFG,
408	ISCSI_NET_PARAM_IFACE_ENABLE,
409	ISCSI_NET_PARAM_VLAN_ID,
410	ISCSI_NET_PARAM_VLAN_PRIORITY,
411	ISCSI_NET_PARAM_VLAN_ENABLED,
412	ISCSI_NET_PARAM_VLAN_TAG,
413	ISCSI_NET_PARAM_IFACE_TYPE,
414	ISCSI_NET_PARAM_IFACE_NAME,
415	ISCSI_NET_PARAM_MTU,
416	ISCSI_NET_PARAM_PORT,
417	ISCSI_NET_PARAM_IPADDR_STATE,
418	ISCSI_NET_PARAM_IPV6_LINKLOCAL_STATE,
419	ISCSI_NET_PARAM_IPV6_ROUTER_STATE,
420	ISCSI_NET_PARAM_DELAYED_ACK_EN,
421	ISCSI_NET_PARAM_TCP_NAGLE_DISABLE,
422	ISCSI_NET_PARAM_TCP_WSF_DISABLE,
423	ISCSI_NET_PARAM_TCP_WSF,
424	ISCSI_NET_PARAM_TCP_TIMER_SCALE,
425	ISCSI_NET_PARAM_TCP_TIMESTAMP_EN,
426	ISCSI_NET_PARAM_CACHE_ID,
427	ISCSI_NET_PARAM_IPV4_DHCP_DNS_ADDR_EN,
428	ISCSI_NET_PARAM_IPV4_DHCP_SLP_DA_EN,
429	ISCSI_NET_PARAM_IPV4_TOS_EN,
430	ISCSI_NET_PARAM_IPV4_TOS,
431	ISCSI_NET_PARAM_IPV4_GRAT_ARP_EN,
432	ISCSI_NET_PARAM_IPV4_DHCP_ALT_CLIENT_ID_EN,
433	ISCSI_NET_PARAM_IPV4_DHCP_ALT_CLIENT_ID,
434	ISCSI_NET_PARAM_IPV4_DHCP_REQ_VENDOR_ID_EN,
435	ISCSI_NET_PARAM_IPV4_DHCP_USE_VENDOR_ID_EN,
436	ISCSI_NET_PARAM_IPV4_DHCP_VENDOR_ID,
437	ISCSI_NET_PARAM_IPV4_DHCP_LEARN_IQN_EN,
438	ISCSI_NET_PARAM_IPV4_FRAGMENT_DISABLE,
439	ISCSI_NET_PARAM_IPV4_IN_FORWARD_EN,
440	ISCSI_NET_PARAM_IPV4_TTL,
441	ISCSI_NET_PARAM_IPV6_GRAT_NEIGHBOR_ADV_EN,
442	ISCSI_NET_PARAM_IPV6_MLD_EN,
443	ISCSI_NET_PARAM_IPV6_FLOW_LABEL,
444	ISCSI_NET_PARAM_IPV6_TRAFFIC_CLASS,
445	ISCSI_NET_PARAM_IPV6_HOP_LIMIT,
446	ISCSI_NET_PARAM_IPV6_ND_REACHABLE_TMO,
447	ISCSI_NET_PARAM_IPV6_ND_REXMIT_TIME,
448	ISCSI_NET_PARAM_IPV6_ND_STALE_TMO,
449	ISCSI_NET_PARAM_IPV6_DUP_ADDR_DETECT_CNT,
450	ISCSI_NET_PARAM_IPV6_RTR_ADV_LINK_MTU,
451	ISCSI_NET_PARAM_REDIRECT_EN,
452};
453
454enum iscsi_ipaddress_state {
455	ISCSI_IPDDRESS_STATE_UNCONFIGURED,
456	ISCSI_IPDDRESS_STATE_ACQUIRING,
457	ISCSI_IPDDRESS_STATE_TENTATIVE,
458	ISCSI_IPDDRESS_STATE_VALID,
459	ISCSI_IPDDRESS_STATE_DISABLING,
460	ISCSI_IPDDRESS_STATE_INVALID,
461	ISCSI_IPDDRESS_STATE_DEPRECATED,
462};
463
464enum iscsi_router_state {
465	ISCSI_ROUTER_STATE_UNKNOWN,
466	ISCSI_ROUTER_STATE_ADVERTISED,
467	ISCSI_ROUTER_STATE_MANUAL,
468	ISCSI_ROUTER_STATE_STALE,
469};
470
471/* iSCSI specific settings params for iface */
472enum iscsi_iface_param {
473	ISCSI_IFACE_PARAM_DEF_TASKMGMT_TMO,
474	ISCSI_IFACE_PARAM_HDRDGST_EN,
475	ISCSI_IFACE_PARAM_DATADGST_EN,
476	ISCSI_IFACE_PARAM_IMM_DATA_EN,
477	ISCSI_IFACE_PARAM_INITIAL_R2T_EN,
478	ISCSI_IFACE_PARAM_DATASEQ_INORDER_EN,
479	ISCSI_IFACE_PARAM_PDU_INORDER_EN,
480	ISCSI_IFACE_PARAM_ERL,
481	ISCSI_IFACE_PARAM_MAX_RECV_DLENGTH,
482	ISCSI_IFACE_PARAM_FIRST_BURST,
483	ISCSI_IFACE_PARAM_MAX_R2T,
484	ISCSI_IFACE_PARAM_MAX_BURST,
485	ISCSI_IFACE_PARAM_CHAP_AUTH_EN,
486	ISCSI_IFACE_PARAM_BIDI_CHAP_EN,
487	ISCSI_IFACE_PARAM_DISCOVERY_AUTH_OPTIONAL,
488	ISCSI_IFACE_PARAM_DISCOVERY_LOGOUT_EN,
489	ISCSI_IFACE_PARAM_STRICT_LOGIN_COMP_EN,
490	ISCSI_IFACE_PARAM_INITIATOR_NAME,
491};
492
493enum iscsi_conn_state {
494	ISCSI_CONN_STATE_FREE,
495	ISCSI_CONN_STATE_XPT_WAIT,
496	ISCSI_CONN_STATE_IN_LOGIN,
497	ISCSI_CONN_STATE_LOGGED_IN,
498	ISCSI_CONN_STATE_IN_LOGOUT,
499	ISCSI_CONN_STATE_LOGOUT_REQUESTED,
500	ISCSI_CONN_STATE_CLEANUP_WAIT,
501};
502
503/*
504 * Common error codes
505 */
506enum iscsi_err {
507	ISCSI_OK			= 0,
508
509	ISCSI_ERR_DATASN		= ISCSI_ERR_BASE + 1,
510	ISCSI_ERR_DATA_OFFSET		= ISCSI_ERR_BASE + 2,
511	ISCSI_ERR_MAX_CMDSN		= ISCSI_ERR_BASE + 3,
512	ISCSI_ERR_EXP_CMDSN		= ISCSI_ERR_BASE + 4,
513	ISCSI_ERR_BAD_OPCODE		= ISCSI_ERR_BASE + 5,
514	ISCSI_ERR_DATALEN		= ISCSI_ERR_BASE + 6,
515	ISCSI_ERR_AHSLEN		= ISCSI_ERR_BASE + 7,
516	ISCSI_ERR_PROTO			= ISCSI_ERR_BASE + 8,
517	ISCSI_ERR_LUN			= ISCSI_ERR_BASE + 9,
518	ISCSI_ERR_BAD_ITT		= ISCSI_ERR_BASE + 10,
519	ISCSI_ERR_CONN_FAILED		= ISCSI_ERR_BASE + 11,
520	ISCSI_ERR_R2TSN			= ISCSI_ERR_BASE + 12,
521	ISCSI_ERR_SESSION_FAILED	= ISCSI_ERR_BASE + 13,
522	ISCSI_ERR_HDR_DGST		= ISCSI_ERR_BASE + 14,
523	ISCSI_ERR_DATA_DGST		= ISCSI_ERR_BASE + 15,
524	ISCSI_ERR_PARAM_NOT_FOUND	= ISCSI_ERR_BASE + 16,
525	ISCSI_ERR_NO_SCSI_CMD		= ISCSI_ERR_BASE + 17,
526	ISCSI_ERR_INVALID_HOST		= ISCSI_ERR_BASE + 18,
527	ISCSI_ERR_XMIT_FAILED		= ISCSI_ERR_BASE + 19,
528	ISCSI_ERR_TCP_CONN_CLOSE	= ISCSI_ERR_BASE + 20,
529	ISCSI_ERR_SCSI_EH_SESSION_RST	= ISCSI_ERR_BASE + 21,
530};
531
532/*
533 * iSCSI Parameters (RFC3720)
534 */
535enum iscsi_param {
536	/* passed in using netlink set param */
537	ISCSI_PARAM_MAX_RECV_DLENGTH,
538	ISCSI_PARAM_MAX_XMIT_DLENGTH,
539	ISCSI_PARAM_HDRDGST_EN,
540	ISCSI_PARAM_DATADGST_EN,
541	ISCSI_PARAM_INITIAL_R2T_EN,
542	ISCSI_PARAM_MAX_R2T,
543	ISCSI_PARAM_IMM_DATA_EN,
544	ISCSI_PARAM_FIRST_BURST,
545	ISCSI_PARAM_MAX_BURST,
546	ISCSI_PARAM_PDU_INORDER_EN,
547	ISCSI_PARAM_DATASEQ_INORDER_EN,
548	ISCSI_PARAM_ERL,
549	ISCSI_PARAM_IFMARKER_EN,
550	ISCSI_PARAM_OFMARKER_EN,
551	ISCSI_PARAM_EXP_STATSN,
552	ISCSI_PARAM_TARGET_NAME,
553	ISCSI_PARAM_TPGT,
554	ISCSI_PARAM_PERSISTENT_ADDRESS,
555	ISCSI_PARAM_PERSISTENT_PORT,
556	ISCSI_PARAM_SESS_RECOVERY_TMO,
557
558	/* passed in through bind conn using transport_fd */
559	ISCSI_PARAM_CONN_PORT,
560	ISCSI_PARAM_CONN_ADDRESS,
561
562	ISCSI_PARAM_USERNAME,
563	ISCSI_PARAM_USERNAME_IN,
564	ISCSI_PARAM_PASSWORD,
565	ISCSI_PARAM_PASSWORD_IN,
566
567	ISCSI_PARAM_FAST_ABORT,
568	ISCSI_PARAM_ABORT_TMO,
569	ISCSI_PARAM_LU_RESET_TMO,
570	ISCSI_PARAM_HOST_RESET_TMO,
571
572	ISCSI_PARAM_PING_TMO,
573	ISCSI_PARAM_RECV_TMO,
574
575	ISCSI_PARAM_IFACE_NAME,
576	ISCSI_PARAM_ISID,
577	ISCSI_PARAM_INITIATOR_NAME,
578
579	ISCSI_PARAM_TGT_RESET_TMO,
580	ISCSI_PARAM_TARGET_ALIAS,
581
582	ISCSI_PARAM_CHAP_IN_IDX,
583	ISCSI_PARAM_CHAP_OUT_IDX,
584
585	ISCSI_PARAM_BOOT_ROOT,
586	ISCSI_PARAM_BOOT_NIC,
587	ISCSI_PARAM_BOOT_TARGET,
588
589	ISCSI_PARAM_AUTO_SND_TGT_DISABLE,
590	ISCSI_PARAM_DISCOVERY_SESS,
591	ISCSI_PARAM_PORTAL_TYPE,
592	ISCSI_PARAM_CHAP_AUTH_EN,
593	ISCSI_PARAM_DISCOVERY_LOGOUT_EN,
594	ISCSI_PARAM_BIDI_CHAP_EN,
595	ISCSI_PARAM_DISCOVERY_AUTH_OPTIONAL,
596
597	ISCSI_PARAM_DEF_TIME2WAIT,
598	ISCSI_PARAM_DEF_TIME2RETAIN,
599	ISCSI_PARAM_MAX_SEGMENT_SIZE,
600	ISCSI_PARAM_STATSN,
601	ISCSI_PARAM_KEEPALIVE_TMO,
602	ISCSI_PARAM_LOCAL_PORT,
603	ISCSI_PARAM_TSID,
604	ISCSI_PARAM_DEF_TASKMGMT_TMO,
605
606	ISCSI_PARAM_TCP_TIMESTAMP_STAT,
607	ISCSI_PARAM_TCP_WSF_DISABLE,
608	ISCSI_PARAM_TCP_NAGLE_DISABLE,
609	ISCSI_PARAM_TCP_TIMER_SCALE,
610	ISCSI_PARAM_TCP_TIMESTAMP_EN,
611	ISCSI_PARAM_TCP_XMIT_WSF,
612	ISCSI_PARAM_TCP_RECV_WSF,
613	ISCSI_PARAM_IP_FRAGMENT_DISABLE,
614	ISCSI_PARAM_IPV4_TOS,
615	ISCSI_PARAM_IPV6_TC,
616	ISCSI_PARAM_IPV6_FLOW_LABEL,
617	ISCSI_PARAM_IS_FW_ASSIGNED_IPV6,
618
619	ISCSI_PARAM_DISCOVERY_PARENT_IDX,
620	ISCSI_PARAM_DISCOVERY_PARENT_TYPE,
621	ISCSI_PARAM_LOCAL_IPADDR,
622	/* must always be last */
623	ISCSI_PARAM_MAX,
624};
625
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
626/* iSCSI HBA params */
627enum iscsi_host_param {
628	ISCSI_HOST_PARAM_HWADDRESS,
629	ISCSI_HOST_PARAM_INITIATOR_NAME,
630	ISCSI_HOST_PARAM_NETDEV_NAME,
631	ISCSI_HOST_PARAM_IPADDRESS,
632	ISCSI_HOST_PARAM_PORT_STATE,
633	ISCSI_HOST_PARAM_PORT_SPEED,
634	ISCSI_HOST_PARAM_MAX,
635};
636
637/* portal type */
638#define PORTAL_TYPE_IPV4	"ipv4"
639#define PORTAL_TYPE_IPV6	"ipv6"
640
641/* iSCSI Flash Target params */
642enum iscsi_flashnode_param {
643	ISCSI_FLASHNODE_IS_FW_ASSIGNED_IPV6,
644	ISCSI_FLASHNODE_PORTAL_TYPE,
645	ISCSI_FLASHNODE_AUTO_SND_TGT_DISABLE,
646	ISCSI_FLASHNODE_DISCOVERY_SESS,
647	ISCSI_FLASHNODE_ENTRY_EN,
648	ISCSI_FLASHNODE_HDR_DGST_EN,
649	ISCSI_FLASHNODE_DATA_DGST_EN,
650	ISCSI_FLASHNODE_IMM_DATA_EN,
651	ISCSI_FLASHNODE_INITIAL_R2T_EN,
652	ISCSI_FLASHNODE_DATASEQ_INORDER,
653	ISCSI_FLASHNODE_PDU_INORDER,
654	ISCSI_FLASHNODE_CHAP_AUTH_EN,
655	ISCSI_FLASHNODE_SNACK_REQ_EN,
656	ISCSI_FLASHNODE_DISCOVERY_LOGOUT_EN,
657	ISCSI_FLASHNODE_BIDI_CHAP_EN,
658	/* make authentication for discovery sessions optional */
659	ISCSI_FLASHNODE_DISCOVERY_AUTH_OPTIONAL,
660	ISCSI_FLASHNODE_ERL,
661	ISCSI_FLASHNODE_TCP_TIMESTAMP_STAT,
662	ISCSI_FLASHNODE_TCP_NAGLE_DISABLE,
663	ISCSI_FLASHNODE_TCP_WSF_DISABLE,
664	ISCSI_FLASHNODE_TCP_TIMER_SCALE,
665	ISCSI_FLASHNODE_TCP_TIMESTAMP_EN,
666	ISCSI_FLASHNODE_IP_FRAG_DISABLE,
667	ISCSI_FLASHNODE_MAX_RECV_DLENGTH,
668	ISCSI_FLASHNODE_MAX_XMIT_DLENGTH,
669	ISCSI_FLASHNODE_FIRST_BURST,
670	ISCSI_FLASHNODE_DEF_TIME2WAIT,
671	ISCSI_FLASHNODE_DEF_TIME2RETAIN,
672	ISCSI_FLASHNODE_MAX_R2T,
673	ISCSI_FLASHNODE_KEEPALIVE_TMO,
674	ISCSI_FLASHNODE_ISID,
675	ISCSI_FLASHNODE_TSID,
676	ISCSI_FLASHNODE_PORT,
677	ISCSI_FLASHNODE_MAX_BURST,
678	ISCSI_FLASHNODE_DEF_TASKMGMT_TMO,
679	ISCSI_FLASHNODE_IPADDR,
680	ISCSI_FLASHNODE_ALIAS,
681	ISCSI_FLASHNODE_REDIRECT_IPADDR,
682	ISCSI_FLASHNODE_MAX_SEGMENT_SIZE,
683	ISCSI_FLASHNODE_LOCAL_PORT,
684	ISCSI_FLASHNODE_IPV4_TOS,
685	ISCSI_FLASHNODE_IPV6_TC,
686	ISCSI_FLASHNODE_IPV6_FLOW_LABEL,
687	ISCSI_FLASHNODE_NAME,
688	ISCSI_FLASHNODE_TPGT,
689	ISCSI_FLASHNODE_LINK_LOCAL_IPV6,
690	ISCSI_FLASHNODE_DISCOVERY_PARENT_IDX,
691	ISCSI_FLASHNODE_DISCOVERY_PARENT_TYPE,
692	ISCSI_FLASHNODE_TCP_XMIT_WSF,
693	ISCSI_FLASHNODE_TCP_RECV_WSF,
694	ISCSI_FLASHNODE_CHAP_IN_IDX,
695	ISCSI_FLASHNODE_CHAP_OUT_IDX,
696	ISCSI_FLASHNODE_USERNAME,
697	ISCSI_FLASHNODE_USERNAME_IN,
698	ISCSI_FLASHNODE_PASSWORD,
699	ISCSI_FLASHNODE_PASSWORD_IN,
700	ISCSI_FLASHNODE_STATSN,
701	ISCSI_FLASHNODE_EXP_STATSN,
702	ISCSI_FLASHNODE_IS_BOOT_TGT,
703
704	ISCSI_FLASHNODE_MAX,
705};
706
707struct iscsi_flashnode_param_info {
708	uint32_t len;		/* Actual length of the param */
709	uint16_t param;		/* iscsi param value */
710	uint8_t value[0];	/* length sized value follows */
711} __packed;
712
713enum iscsi_discovery_parent_type {
714	ISCSI_DISC_PARENT_UNKNOWN	= 0x1,
715	ISCSI_DISC_PARENT_SENDTGT	= 0x2,
716	ISCSI_DISC_PARENT_ISNS		= 0x3,
717};
718
719/* iSCSI port Speed */
720enum iscsi_port_speed {
721	ISCSI_PORT_SPEED_UNKNOWN	= 0x1,
722	ISCSI_PORT_SPEED_10MBPS		= 0x2,
723	ISCSI_PORT_SPEED_100MBPS	= 0x4,
724	ISCSI_PORT_SPEED_1GBPS		= 0x8,
725	ISCSI_PORT_SPEED_10GBPS		= 0x10,
726};
727
728/* iSCSI port state */
729enum iscsi_port_state {
730	ISCSI_PORT_STATE_DOWN		= 0x1,
731	ISCSI_PORT_STATE_UP		= 0x2,
732};
733
734/* iSCSI PING status/error code */
735enum iscsi_ping_status_code {
736	ISCSI_PING_SUCCESS			= 0,
737	ISCSI_PING_FW_DISABLED			= 0x1,
738	ISCSI_PING_IPADDR_INVALID		= 0x2,
739	ISCSI_PING_LINKLOCAL_IPV6_ADDR_INVALID	= 0x3,
740	ISCSI_PING_TIMEOUT			= 0x4,
741	ISCSI_PING_INVALID_DEST_ADDR		= 0x5,
742	ISCSI_PING_OVERSIZE_PACKET		= 0x6,
743	ISCSI_PING_ICMP_ERROR			= 0x7,
744	ISCSI_PING_MAX_REQ_EXCEEDED		= 0x8,
745	ISCSI_PING_NO_ARP_RECEIVED		= 0x9,
746};
747
748#define iscsi_ptr(_handle) ((void*)(unsigned long)_handle)
749#define iscsi_handle(_ptr) ((uint64_t)(unsigned long)_ptr)
750
751/*
752 * These flags presents iSCSI Data-Path capabilities.
753 */
754#define CAP_RECOVERY_L0		0x1
755#define CAP_RECOVERY_L1		0x2
756#define CAP_RECOVERY_L2		0x4
757#define CAP_MULTI_R2T		0x8
758#define CAP_HDRDGST		0x10
759#define CAP_DATADGST		0x20
760#define CAP_MULTI_CONN		0x40
761#define CAP_TEXT_NEGO		0x80
762#define CAP_MARKERS		0x100
763#define CAP_FW_DB		0x200
764#define CAP_SENDTARGETS_OFFLOAD	0x400	/* offload discovery process */
765#define CAP_DATA_PATH_OFFLOAD	0x800	/* offload entire IO path */
766#define CAP_DIGEST_OFFLOAD	0x1000	/* offload hdr and data digests */
767#define CAP_PADDING_OFFLOAD	0x2000	/* offload padding insertion, removal,
768					 and verification */
769#define CAP_LOGIN_OFFLOAD	0x4000  /* offload session login */
770
771/*
772 * These flags describes reason of stop_conn() call
773 */
774#define STOP_CONN_TERM		0x1
775#define STOP_CONN_SUSPEND	0x2
776#define STOP_CONN_RECOVER	0x3
777
778#define ISCSI_STATS_CUSTOM_MAX		32
779#define ISCSI_STATS_CUSTOM_DESC_MAX	64
780struct iscsi_stats_custom {
781	char desc[ISCSI_STATS_CUSTOM_DESC_MAX];
782	uint64_t value;
783};
784
785/*
786 * struct iscsi_stats - iSCSI Statistics (iSCSI MIB)
787 *
788 * Note: this structure contains counters collected on per-connection basis.
789 */
790struct iscsi_stats {
791	/* octets */
792	uint64_t txdata_octets;
793	uint64_t rxdata_octets;
794
795	/* xmit pdus */
796	uint32_t noptx_pdus;
797	uint32_t scsicmd_pdus;
798	uint32_t tmfcmd_pdus;
799	uint32_t login_pdus;
800	uint32_t text_pdus;
801	uint32_t dataout_pdus;
802	uint32_t logout_pdus;
803	uint32_t snack_pdus;
804
805	/* recv pdus */
806	uint32_t noprx_pdus;
807	uint32_t scsirsp_pdus;
808	uint32_t tmfrsp_pdus;
809	uint32_t textrsp_pdus;
810	uint32_t datain_pdus;
811	uint32_t logoutrsp_pdus;
812	uint32_t r2t_pdus;
813	uint32_t async_pdus;
814	uint32_t rjt_pdus;
815
816	/* errors */
817	uint32_t digest_err;
818	uint32_t timeout_err;
819
820	/*
821	 * iSCSI Custom Statistics support, i.e. Transport could
822	 * extend existing MIB statistics with its own specific statistics
823	 * up to ISCSI_STATS_CUSTOM_MAX
824	 */
825	uint32_t custom_length;
826	struct iscsi_stats_custom custom[0]
827		__attribute__ ((aligned (sizeof(uint64_t))));
828};
829
830enum chap_type_e {
831	CHAP_TYPE_OUT,
832	CHAP_TYPE_IN,
833};
834
835enum iscsi_chap_param {
836	ISCSI_CHAP_PARAM_INDEX,
837	ISCSI_CHAP_PARAM_CHAP_TYPE,
838	ISCSI_CHAP_PARAM_USERNAME,
839	ISCSI_CHAP_PARAM_PASSWORD,
840	ISCSI_CHAP_PARAM_PASSWORD_LEN
841};
842
843#define ISCSI_CHAP_AUTH_NAME_MAX_LEN	256
844#define ISCSI_CHAP_AUTH_SECRET_MAX_LEN	256
845struct iscsi_chap_rec {
846	uint16_t chap_tbl_idx;
847	enum chap_type_e chap_type;
848	char username[ISCSI_CHAP_AUTH_NAME_MAX_LEN];
849	uint8_t password[ISCSI_CHAP_AUTH_SECRET_MAX_LEN];
850	uint8_t password_length;
851};
852
853#define ISCSI_HOST_STATS_CUSTOM_MAX             32
854#define ISCSI_HOST_STATS_CUSTOM_DESC_MAX        64
855struct iscsi_host_stats_custom {
856	char desc[ISCSI_HOST_STATS_CUSTOM_DESC_MAX];
857	uint64_t value;
858};
859
860/* struct iscsi_offload_host_stats: Host statistics,
861 * Include statistics for MAC, IP, TCP & iSCSI.
862 */
863struct iscsi_offload_host_stats {
864	/* MAC */
865	uint64_t mactx_frames;
866	uint64_t mactx_bytes;
867	uint64_t mactx_multicast_frames;
868	uint64_t mactx_broadcast_frames;
869	uint64_t mactx_pause_frames;
870	uint64_t mactx_control_frames;
871	uint64_t mactx_deferral;
872	uint64_t mactx_excess_deferral;
873	uint64_t mactx_late_collision;
874	uint64_t mactx_abort;
875	uint64_t mactx_single_collision;
876	uint64_t mactx_multiple_collision;
877	uint64_t mactx_collision;
878	uint64_t mactx_frames_dropped;
879	uint64_t mactx_jumbo_frames;
880	uint64_t macrx_frames;
881	uint64_t macrx_bytes;
882	uint64_t macrx_unknown_control_frames;
883	uint64_t macrx_pause_frames;
884	uint64_t macrx_control_frames;
885	uint64_t macrx_dribble;
886	uint64_t macrx_frame_length_error;
887	uint64_t macrx_jabber;
888	uint64_t macrx_carrier_sense_error;
889	uint64_t macrx_frame_discarded;
890	uint64_t macrx_frames_dropped;
891	uint64_t mac_crc_error;
892	uint64_t mac_encoding_error;
893	uint64_t macrx_length_error_large;
894	uint64_t macrx_length_error_small;
895	uint64_t macrx_multicast_frames;
896	uint64_t macrx_broadcast_frames;
897	/* IP */
898	uint64_t iptx_packets;
899	uint64_t iptx_bytes;
900	uint64_t iptx_fragments;
901	uint64_t iprx_packets;
902	uint64_t iprx_bytes;
903	uint64_t iprx_fragments;
904	uint64_t ip_datagram_reassembly;
905	uint64_t ip_invalid_address_error;
906	uint64_t ip_error_packets;
907	uint64_t ip_fragrx_overlap;
908	uint64_t ip_fragrx_outoforder;
909	uint64_t ip_datagram_reassembly_timeout;
910	uint64_t ipv6tx_packets;
911	uint64_t ipv6tx_bytes;
912	uint64_t ipv6tx_fragments;
913	uint64_t ipv6rx_packets;
914	uint64_t ipv6rx_bytes;
915	uint64_t ipv6rx_fragments;
916	uint64_t ipv6_datagram_reassembly;
917	uint64_t ipv6_invalid_address_error;
918	uint64_t ipv6_error_packets;
919	uint64_t ipv6_fragrx_overlap;
920	uint64_t ipv6_fragrx_outoforder;
921	uint64_t ipv6_datagram_reassembly_timeout;
922	/* TCP */
923	uint64_t tcptx_segments;
924	uint64_t tcptx_bytes;
925	uint64_t tcprx_segments;
926	uint64_t tcprx_byte;
927	uint64_t tcp_duplicate_ack_retx;
928	uint64_t tcp_retx_timer_expired;
929	uint64_t tcprx_duplicate_ack;
930	uint64_t tcprx_pure_ackr;
931	uint64_t tcptx_delayed_ack;
932	uint64_t tcptx_pure_ack;
933	uint64_t tcprx_segment_error;
934	uint64_t tcprx_segment_outoforder;
935	uint64_t tcprx_window_probe;
936	uint64_t tcprx_window_update;
937	uint64_t tcptx_window_probe_persist;
938	/* ECC */
939	uint64_t ecc_error_correction;
940	/* iSCSI */
941	uint64_t iscsi_pdu_tx;
942	uint64_t iscsi_data_bytes_tx;
943	uint64_t iscsi_pdu_rx;
944	uint64_t iscsi_data_bytes_rx;
945	uint64_t iscsi_io_completed;
946	uint64_t iscsi_unexpected_io_rx;
947	uint64_t iscsi_format_error;
948	uint64_t iscsi_hdr_digest_error;
949	uint64_t iscsi_data_digest_error;
950	uint64_t iscsi_sequence_error;
951	/*
952	 * iSCSI Custom Host Statistics support, i.e. Transport could
953	 * extend existing host statistics with its own specific statistics
954	 * up to ISCSI_HOST_STATS_CUSTOM_MAX
955	 */
956	uint32_t custom_length;
957	struct iscsi_host_stats_custom custom[0]
958		__aligned(sizeof(uint64_t));
959};
960
961#endif