Linux Audio

Check our new training course

Loading...
v3.1
  1#ifndef ISCSI_TARGET_CORE_H
  2#define ISCSI_TARGET_CORE_H
  3
  4#include <linux/in.h>
  5#include <linux/configfs.h>
  6#include <net/sock.h>
  7#include <net/tcp.h>
  8#include <scsi/scsi_cmnd.h>
  9#include <scsi/iscsi_proto.h>
 10#include <target/target_core_base.h>
 11
 12#define ISCSIT_VERSION			"v4.1.0-rc1"
 13#define ISCSI_MAX_DATASN_MISSING_COUNT	16
 14#define ISCSI_TX_THREAD_TCP_TIMEOUT	2
 15#define ISCSI_RX_THREAD_TCP_TIMEOUT	2
 16#define SECONDS_FOR_ASYNC_LOGOUT	10
 17#define SECONDS_FOR_ASYNC_TEXT		10
 18#define SECONDS_FOR_LOGOUT_COMP		15
 19#define WHITE_SPACE			" \t\v\f\n\r"
 20
 21/* struct iscsi_node_attrib sanity values */
 22#define NA_DATAOUT_TIMEOUT		3
 23#define NA_DATAOUT_TIMEOUT_MAX		60
 24#define NA_DATAOUT_TIMEOUT_MIX		2
 25#define NA_DATAOUT_TIMEOUT_RETRIES	5
 26#define NA_DATAOUT_TIMEOUT_RETRIES_MAX	15
 27#define NA_DATAOUT_TIMEOUT_RETRIES_MIN	1
 28#define NA_NOPIN_TIMEOUT		5
 29#define NA_NOPIN_TIMEOUT_MAX		60
 30#define NA_NOPIN_TIMEOUT_MIN		3
 31#define NA_NOPIN_RESPONSE_TIMEOUT	5
 32#define NA_NOPIN_RESPONSE_TIMEOUT_MAX	60
 33#define NA_NOPIN_RESPONSE_TIMEOUT_MIN	3
 34#define NA_RANDOM_DATAIN_PDU_OFFSETS	0
 35#define NA_RANDOM_DATAIN_SEQ_OFFSETS	0
 36#define NA_RANDOM_R2T_OFFSETS		0
 37#define NA_DEFAULT_ERL			0
 38#define NA_DEFAULT_ERL_MAX		2
 39#define NA_DEFAULT_ERL_MIN		0
 40
 41/* struct iscsi_tpg_attrib sanity values */
 42#define TA_AUTHENTICATION		1
 43#define TA_LOGIN_TIMEOUT		15
 44#define TA_LOGIN_TIMEOUT_MAX		30
 45#define TA_LOGIN_TIMEOUT_MIN		5
 46#define TA_NETIF_TIMEOUT		2
 47#define TA_NETIF_TIMEOUT_MAX		15
 48#define TA_NETIF_TIMEOUT_MIN		2
 49#define TA_GENERATE_NODE_ACLS		0
 50#define TA_DEFAULT_CMDSN_DEPTH		16
 51#define TA_DEFAULT_CMDSN_DEPTH_MAX	512
 52#define TA_DEFAULT_CMDSN_DEPTH_MIN	1
 53#define TA_CACHE_DYNAMIC_ACLS		0
 54/* Enabled by default in demo mode (generic_node_acls=1) */
 55#define TA_DEMO_MODE_WRITE_PROTECT	1
 56/* Disabled by default in production mode w/ explict ACLs */
 57#define TA_PROD_MODE_WRITE_PROTECT	0
 58#define TA_CACHE_CORE_NPS		0
 59
 
 
 
 60enum tpg_np_network_transport_table {
 61	ISCSI_TCP				= 0,
 62	ISCSI_SCTP_TCP				= 1,
 63	ISCSI_SCTP_UDP				= 2,
 64	ISCSI_IWARP_TCP				= 3,
 65	ISCSI_IWARP_SCTP			= 4,
 66	ISCSI_INFINIBAND			= 5,
 67};
 68
 69/* RFC-3720 7.1.4  Standard Connection State Diagram for a Target */
 70enum target_conn_state_table {
 71	TARG_CONN_STATE_FREE			= 0x1,
 72	TARG_CONN_STATE_XPT_UP			= 0x3,
 73	TARG_CONN_STATE_IN_LOGIN		= 0x4,
 74	TARG_CONN_STATE_LOGGED_IN		= 0x5,
 75	TARG_CONN_STATE_IN_LOGOUT		= 0x6,
 76	TARG_CONN_STATE_LOGOUT_REQUESTED	= 0x7,
 77	TARG_CONN_STATE_CLEANUP_WAIT		= 0x8,
 78};
 79
 80/* RFC-3720 7.3.2  Session State Diagram for a Target */
 81enum target_sess_state_table {
 82	TARG_SESS_STATE_FREE			= 0x1,
 83	TARG_SESS_STATE_ACTIVE			= 0x2,
 84	TARG_SESS_STATE_LOGGED_IN		= 0x3,
 85	TARG_SESS_STATE_FAILED			= 0x4,
 86	TARG_SESS_STATE_IN_CONTINUE		= 0x5,
 87};
 88
 89/* struct iscsi_data_count->type */
 90enum data_count_type {
 91	ISCSI_RX_DATA	= 1,
 92	ISCSI_TX_DATA	= 2,
 93};
 94
 95/* struct iscsi_datain_req->dr_complete */
 96enum datain_req_comp_table {
 97	DATAIN_COMPLETE_NORMAL			= 1,
 98	DATAIN_COMPLETE_WITHIN_COMMAND_RECOVERY = 2,
 99	DATAIN_COMPLETE_CONNECTION_RECOVERY	= 3,
100};
101
102/* struct iscsi_datain_req->recovery */
103enum datain_req_rec_table {
104	DATAIN_WITHIN_COMMAND_RECOVERY		= 1,
105	DATAIN_CONNECTION_RECOVERY		= 2,
106};
107
108/* struct iscsi_portal_group->state */
109enum tpg_state_table {
110	TPG_STATE_FREE				= 0,
111	TPG_STATE_ACTIVE			= 1,
112	TPG_STATE_INACTIVE			= 2,
113	TPG_STATE_COLD_RESET			= 3,
114};
115
116/* struct iscsi_tiqn->tiqn_state */
117enum tiqn_state_table {
118	TIQN_STATE_ACTIVE			= 1,
119	TIQN_STATE_SHUTDOWN			= 2,
120};
121
122/* struct iscsi_cmd->cmd_flags */
123enum cmd_flags_table {
124	ICF_GOT_LAST_DATAOUT			= 0x00000001,
125	ICF_GOT_DATACK_SNACK			= 0x00000002,
126	ICF_NON_IMMEDIATE_UNSOLICITED_DATA	= 0x00000004,
127	ICF_SENT_LAST_R2T			= 0x00000008,
128	ICF_WITHIN_COMMAND_RECOVERY		= 0x00000010,
129	ICF_CONTIG_MEMORY			= 0x00000020,
130	ICF_ATTACHED_TO_RQUEUE			= 0x00000040,
131	ICF_OOO_CMDSN				= 0x00000080,
132	ICF_REJECT_FAIL_CONN			= 0x00000100,
133};
134
135/* struct iscsi_cmd->i_state */
136enum cmd_i_state_table {
137	ISTATE_NO_STATE			= 0,
138	ISTATE_NEW_CMD			= 1,
139	ISTATE_DEFERRED_CMD		= 2,
140	ISTATE_UNSOLICITED_DATA		= 3,
141	ISTATE_RECEIVE_DATAOUT		= 4,
142	ISTATE_RECEIVE_DATAOUT_RECOVERY	= 5,
143	ISTATE_RECEIVED_LAST_DATAOUT	= 6,
144	ISTATE_WITHIN_DATAOUT_RECOVERY	= 7,
145	ISTATE_IN_CONNECTION_RECOVERY	= 8,
146	ISTATE_RECEIVED_TASKMGT		= 9,
147	ISTATE_SEND_ASYNCMSG		= 10,
148	ISTATE_SENT_ASYNCMSG		= 11,
149	ISTATE_SEND_DATAIN		= 12,
150	ISTATE_SEND_LAST_DATAIN		= 13,
151	ISTATE_SENT_LAST_DATAIN		= 14,
152	ISTATE_SEND_LOGOUTRSP		= 15,
153	ISTATE_SENT_LOGOUTRSP		= 16,
154	ISTATE_SEND_NOPIN		= 17,
155	ISTATE_SENT_NOPIN		= 18,
156	ISTATE_SEND_REJECT		= 19,
157	ISTATE_SENT_REJECT		= 20,
158	ISTATE_SEND_R2T			= 21,
159	ISTATE_SENT_R2T			= 22,
160	ISTATE_SEND_R2T_RECOVERY	= 23,
161	ISTATE_SENT_R2T_RECOVERY	= 24,
162	ISTATE_SEND_LAST_R2T		= 25,
163	ISTATE_SENT_LAST_R2T		= 26,
164	ISTATE_SEND_LAST_R2T_RECOVERY	= 27,
165	ISTATE_SENT_LAST_R2T_RECOVERY	= 28,
166	ISTATE_SEND_STATUS		= 29,
167	ISTATE_SEND_STATUS_BROKEN_PC	= 30,
168	ISTATE_SENT_STATUS		= 31,
169	ISTATE_SEND_STATUS_RECOVERY	= 32,
170	ISTATE_SENT_STATUS_RECOVERY	= 33,
171	ISTATE_SEND_TASKMGTRSP		= 34,
172	ISTATE_SENT_TASKMGTRSP		= 35,
173	ISTATE_SEND_TEXTRSP		= 36,
174	ISTATE_SENT_TEXTRSP		= 37,
175	ISTATE_SEND_NOPIN_WANT_RESPONSE	= 38,
176	ISTATE_SENT_NOPIN_WANT_RESPONSE	= 39,
177	ISTATE_SEND_NOPIN_NO_RESPONSE	= 40,
178	ISTATE_REMOVE			= 41,
179	ISTATE_FREE			= 42,
180};
181
182/* Used for iscsi_recover_cmdsn() return values */
183enum recover_cmdsn_ret_table {
184	CMDSN_ERROR_CANNOT_RECOVER	= -1,
185	CMDSN_NORMAL_OPERATION		= 0,
186	CMDSN_LOWER_THAN_EXP		= 1,
187	CMDSN_HIGHER_THAN_EXP		= 2,
188};
189
190/* Used for iscsi_handle_immediate_data() return values */
191enum immedate_data_ret_table {
192	IMMEDIATE_DATA_CANNOT_RECOVER	= -1,
193	IMMEDIATE_DATA_NORMAL_OPERATION = 0,
194	IMMEDIATE_DATA_ERL1_CRC_FAILURE = 1,
195};
196
197/* Used for iscsi_decide_dataout_action() return values */
198enum dataout_action_ret_table {
199	DATAOUT_CANNOT_RECOVER		= -1,
200	DATAOUT_NORMAL			= 0,
201	DATAOUT_SEND_R2T		= 1,
202	DATAOUT_SEND_TO_TRANSPORT	= 2,
203	DATAOUT_WITHIN_COMMAND_RECOVERY = 3,
204};
205
206/* Used for struct iscsi_node_auth->naf_flags */
207enum naf_flags_table {
208	NAF_USERID_SET			= 0x01,
209	NAF_PASSWORD_SET		= 0x02,
210	NAF_USERID_IN_SET		= 0x04,
211	NAF_PASSWORD_IN_SET		= 0x08,
212};
213
214/* Used by various struct timer_list to manage iSCSI specific state */
215enum iscsi_timer_flags_table {
216	ISCSI_TF_RUNNING		= 0x01,
217	ISCSI_TF_STOP			= 0x02,
218	ISCSI_TF_EXPIRED		= 0x04,
219};
220
221/* Used for struct iscsi_np->np_flags */
222enum np_flags_table {
223	NPF_IP_NETWORK		= 0x00,
224	NPF_SCTP_STRUCT_FILE	= 0x01 /* Bugfix */
225};
226
227/* Used for struct iscsi_np->np_thread_state */
228enum np_thread_state_table {
229	ISCSI_NP_THREAD_ACTIVE		= 1,
230	ISCSI_NP_THREAD_INACTIVE	= 2,
231	ISCSI_NP_THREAD_RESET		= 3,
232	ISCSI_NP_THREAD_SHUTDOWN	= 4,
233	ISCSI_NP_THREAD_EXIT		= 5,
234};
235
236struct iscsi_conn_ops {
237	u8	HeaderDigest;			/* [0,1] == [None,CRC32C] */
238	u8	DataDigest;			/* [0,1] == [None,CRC32C] */
239	u32	MaxRecvDataSegmentLength;	/* [512..2**24-1] */
240	u8	OFMarker;			/* [0,1] == [No,Yes] */
241	u8	IFMarker;			/* [0,1] == [No,Yes] */
242	u32	OFMarkInt;			/* [1..65535] */
243	u32	IFMarkInt;			/* [1..65535] */
244};
245
246struct iscsi_sess_ops {
247	char	InitiatorName[224];
248	char	InitiatorAlias[256];
249	char	TargetName[224];
250	char	TargetAlias[256];
251	char	TargetAddress[256];
252	u16	TargetPortalGroupTag;		/* [0..65535] */
253	u16	MaxConnections;			/* [1..65535] */
254	u8	InitialR2T;			/* [0,1] == [No,Yes] */
255	u8	ImmediateData;			/* [0,1] == [No,Yes] */
256	u32	MaxBurstLength;			/* [512..2**24-1] */
257	u32	FirstBurstLength;		/* [512..2**24-1] */
258	u16	DefaultTime2Wait;		/* [0..3600] */
259	u16	DefaultTime2Retain;		/* [0..3600] */
260	u16	MaxOutstandingR2T;		/* [1..65535] */
261	u8	DataPDUInOrder;			/* [0,1] == [No,Yes] */
262	u8	DataSequenceInOrder;		/* [0,1] == [No,Yes] */
263	u8	ErrorRecoveryLevel;		/* [0..2] */
264	u8	SessionType;			/* [0,1] == [Normal,Discovery]*/
265};
266
267struct iscsi_queue_req {
268	int			state;
269	struct iscsi_cmd	*cmd;
270	struct list_head	qr_list;
271};
272
273struct iscsi_data_count {
274	int			data_length;
275	int			sync_and_steering;
276	enum data_count_type	type;
277	u32			iov_count;
278	u32			ss_iov_count;
279	u32			ss_marker_count;
280	struct kvec		*iov;
281};
282
283struct iscsi_param_list {
284	struct list_head	param_list;
285	struct list_head	extra_response_list;
286};
287
288struct iscsi_datain_req {
289	enum datain_req_comp_table dr_complete;
290	int			generate_recovery_values;
291	enum datain_req_rec_table recovery;
292	u32			begrun;
293	u32			runlength;
294	u32			data_length;
295	u32			data_offset;
296	u32			data_offset_end;
297	u32			data_sn;
298	u32			next_burst_len;
299	u32			read_data_done;
300	u32			seq_send_order;
301	struct list_head	dr_list;
302} ____cacheline_aligned;
303
304struct iscsi_ooo_cmdsn {
305	u16			cid;
306	u32			batch_count;
307	u32			cmdsn;
308	u32			exp_cmdsn;
309	struct iscsi_cmd	*cmd;
310	struct list_head	ooo_list;
311} ____cacheline_aligned;
312
313struct iscsi_datain {
314	u8			flags;
315	u32			data_sn;
316	u32			length;
317	u32			offset;
318} ____cacheline_aligned;
319
320struct iscsi_r2t {
321	int			seq_complete;
322	int			recovery_r2t;
323	int			sent_r2t;
324	u32			r2t_sn;
325	u32			offset;
326	u32			targ_xfer_tag;
327	u32			xfer_len;
328	struct list_head	r2t_list;
329} ____cacheline_aligned;
330
331struct iscsi_cmd {
332	enum iscsi_timer_flags_table dataout_timer_flags;
333	/* DataOUT timeout retries */
334	u8			dataout_timeout_retries;
335	/* Within command recovery count */
336	u8			error_recovery_count;
337	/* iSCSI dependent state for out or order CmdSNs */
338	enum cmd_i_state_table	deferred_i_state;
339	/* iSCSI dependent state */
340	enum cmd_i_state_table	i_state;
341	/* Command is an immediate command (ISCSI_OP_IMMEDIATE set) */
342	u8			immediate_cmd;
343	/* Immediate data present */
344	u8			immediate_data;
345	/* iSCSI Opcode */
346	u8			iscsi_opcode;
347	/* iSCSI Response Code */
348	u8			iscsi_response;
349	/* Logout reason when iscsi_opcode == ISCSI_INIT_LOGOUT_CMND */
350	u8			logout_reason;
351	/* Logout response code when iscsi_opcode == ISCSI_INIT_LOGOUT_CMND */
352	u8			logout_response;
353	/* MaxCmdSN has been incremented */
354	u8			maxcmdsn_inc;
355	/* Immediate Unsolicited Dataout */
356	u8			unsolicited_data;
357	/* CID contained in logout PDU when opcode == ISCSI_INIT_LOGOUT_CMND */
358	u16			logout_cid;
359	/* Command flags */
360	enum cmd_flags_table	cmd_flags;
361	/* Initiator Task Tag assigned from Initiator */
362	u32			init_task_tag;
363	/* Target Transfer Tag assigned from Target */
364	u32			targ_xfer_tag;
365	/* CmdSN assigned from Initiator */
366	u32			cmd_sn;
367	/* ExpStatSN assigned from Initiator */
368	u32			exp_stat_sn;
369	/* StatSN assigned to this ITT */
370	u32			stat_sn;
371	/* DataSN Counter */
372	u32			data_sn;
373	/* R2TSN Counter */
374	u32			r2t_sn;
375	/* Last DataSN acknowledged via DataAck SNACK */
376	u32			acked_data_sn;
377	/* Used for echoing NOPOUT ping data */
378	u32			buf_ptr_size;
379	/* Used to store DataDigest */
380	u32			data_crc;
381	/* Total size in bytes associated with command */
382	u32			data_length;
383	/* Counter for MaxOutstandingR2T */
384	u32			outstanding_r2ts;
385	/* Next R2T Offset when DataSequenceInOrder=Yes */
386	u32			r2t_offset;
387	/* Iovec current and orig count for iscsi_cmd->iov_data */
388	u32			iov_data_count;
389	u32			orig_iov_data_count;
390	/* Number of miscellaneous iovecs used for IP stack calls */
391	u32			iov_misc_count;
392	/* Number of struct iscsi_pdu in struct iscsi_cmd->pdu_list */
393	u32			pdu_count;
394	/* Next struct iscsi_pdu to send in struct iscsi_cmd->pdu_list */
395	u32			pdu_send_order;
396	/* Current struct iscsi_pdu in struct iscsi_cmd->pdu_list */
397	u32			pdu_start;
398	u32			residual_count;
399	/* Next struct iscsi_seq to send in struct iscsi_cmd->seq_list */
400	u32			seq_send_order;
401	/* Number of struct iscsi_seq in struct iscsi_cmd->seq_list */
402	u32			seq_count;
403	/* Current struct iscsi_seq in struct iscsi_cmd->seq_list */
404	u32			seq_no;
405	/* Lowest offset in current DataOUT sequence */
406	u32			seq_start_offset;
407	/* Highest offset in current DataOUT sequence */
408	u32			seq_end_offset;
409	/* Total size in bytes received so far of READ data */
410	u32			read_data_done;
411	/* Total size in bytes received so far of WRITE data */
412	u32			write_data_done;
413	/* Counter for FirstBurstLength key */
414	u32			first_burst_len;
415	/* Counter for MaxBurstLength key */
416	u32			next_burst_len;
417	/* Transfer size used for IP stack calls */
418	u32			tx_size;
419	/* Buffer used for various purposes */
420	void			*buf_ptr;
421	/* See include/linux/dma-mapping.h */
422	enum dma_data_direction	data_direction;
423	/* iSCSI PDU Header + CRC */
424	unsigned char		pdu[ISCSI_HDR_LEN + ISCSI_CRC_LEN];
425	/* Number of times struct iscsi_cmd is present in immediate queue */
426	atomic_t		immed_queue_count;
427	atomic_t		response_queue_count;
428	atomic_t		transport_sent;
429	spinlock_t		datain_lock;
430	spinlock_t		dataout_timeout_lock;
431	/* spinlock for protecting struct iscsi_cmd->i_state */
432	spinlock_t		istate_lock;
433	/* spinlock for adding within command recovery entries */
434	spinlock_t		error_lock;
435	/* spinlock for adding R2Ts */
436	spinlock_t		r2t_lock;
437	/* DataIN List */
438	struct list_head	datain_list;
439	/* R2T List */
440	struct list_head	cmd_r2t_list;
441	struct completion	reject_comp;
442	/* Timer for DataOUT */
443	struct timer_list	dataout_timer;
444	/* Iovecs for SCSI data payload RX/TX w/ kernel level sockets */
445	struct kvec		*iov_data;
446	/* Iovecs for miscellaneous purposes */
447#define ISCSI_MISC_IOVECS			5
448	struct kvec		iov_misc[ISCSI_MISC_IOVECS];
449	/* Array of struct iscsi_pdu used for DataPDUInOrder=No */
450	struct iscsi_pdu	*pdu_list;
451	/* Current struct iscsi_pdu used for DataPDUInOrder=No */
452	struct iscsi_pdu	*pdu_ptr;
453	/* Array of struct iscsi_seq used for DataSequenceInOrder=No */
454	struct iscsi_seq	*seq_list;
455	/* Current struct iscsi_seq used for DataSequenceInOrder=No */
456	struct iscsi_seq	*seq_ptr;
457	/* TMR Request when iscsi_opcode == ISCSI_OP_SCSI_TMFUNC */
458	struct iscsi_tmr_req	*tmr_req;
459	/* Connection this command is alligient to */
460	struct iscsi_conn	*conn;
461	/* Pointer to connection recovery entry */
462	struct iscsi_conn_recovery *cr;
463	/* Session the command is part of,  used for connection recovery */
464	struct iscsi_session	*sess;
465	/* list_head for connection list */
466	struct list_head	i_list;
467	/* The TCM I/O descriptor that is accessed via container_of() */
468	struct se_cmd		se_cmd;
469	/* Sense buffer that will be mapped into outgoing status */
470#define ISCSI_SENSE_BUFFER_LEN          (TRANSPORT_SENSE_BUFFER + 2)
471	unsigned char		sense_buffer[ISCSI_SENSE_BUFFER_LEN];
472
473	struct scatterlist	*t_mem_sg;
474	u32			t_mem_sg_nents;
475
476	u32			padding;
477	u8			pad_bytes[4];
478
479	struct scatterlist	*first_data_sg;
480	u32			first_data_sg_off;
481	u32			kmapped_nents;
482
483}  ____cacheline_aligned;
484
485struct iscsi_tmr_req {
486	bool			task_reassign:1;
487	u32			ref_cmd_sn;
488	u32			exp_data_sn;
489	struct iscsi_conn_recovery *conn_recovery;
490	struct se_tmr_req	*se_tmr_req;
491};
492
493struct iscsi_conn {
494	/* Authentication Successful for this connection */
495	u8			auth_complete;
496	/* State connection is currently in */
497	u8			conn_state;
498	u8			conn_logout_reason;
499	u8			network_transport;
500	enum iscsi_timer_flags_table nopin_timer_flags;
501	enum iscsi_timer_flags_table nopin_response_timer_flags;
502	u8			tx_immediate_queue;
503	u8			tx_response_queue;
504	/* Used to know what thread encountered a transport failure */
505	u8			which_thread;
506	/* connection id assigned by the Initiator */
507	u16			cid;
508	/* Remote TCP Port */
509	u16			login_port;
 
510	int			net_size;
511	u32			auth_id;
512#define CONNFLAG_SCTP_STRUCT_FILE			0x01
513	u32			conn_flags;
514	/* Used for iscsi_tx_login_rsp() */
515	u32			login_itt;
516	u32			exp_statsn;
517	/* Per connection status sequence number */
518	u32			stat_sn;
519	/* IFMarkInt's Current Value */
520	u32			if_marker;
521	/* OFMarkInt's Current Value */
522	u32			of_marker;
523	/* Used for calculating OFMarker offset to next PDU */
524	u32			of_marker_offset;
525	/* Complete Bad PDU for sending reject */
526	unsigned char		bad_hdr[ISCSI_HDR_LEN];
527#define IPV6_ADDRESS_SPACE				48
528	unsigned char		login_ip[IPV6_ADDRESS_SPACE];
 
529	int			conn_usage_count;
530	int			conn_waiting_on_uc;
531	atomic_t		check_immediate_queue;
532	atomic_t		conn_logout_remove;
533	atomic_t		connection_exit;
534	atomic_t		connection_recovery;
535	atomic_t		connection_reinstatement;
536	atomic_t		connection_wait;
537	atomic_t		connection_wait_rcfr;
538	atomic_t		sleep_on_conn_wait_comp;
539	atomic_t		transport_failed;
540	struct completion	conn_post_wait_comp;
541	struct completion	conn_wait_comp;
542	struct completion	conn_wait_rcfr_comp;
543	struct completion	conn_waiting_on_uc_comp;
544	struct completion	conn_logout_comp;
545	struct completion	tx_half_close_comp;
546	struct completion	rx_half_close_comp;
547	/* socket used by this connection */
548	struct socket		*sock;
549	struct timer_list	nopin_timer;
550	struct timer_list	nopin_response_timer;
551	struct timer_list	transport_timer;
552	/* Spinlock used for add/deleting cmd's from conn_cmd_list */
553	spinlock_t		cmd_lock;
554	spinlock_t		conn_usage_lock;
555	spinlock_t		immed_queue_lock;
556	spinlock_t		nopin_timer_lock;
557	spinlock_t		response_queue_lock;
558	spinlock_t		state_lock;
559	/* libcrypto RX and TX contexts for crc32c */
560	struct hash_desc	conn_rx_hash;
561	struct hash_desc	conn_tx_hash;
562	/* Used for scheduling TX and RX connection kthreads */
563	cpumask_var_t		conn_cpumask;
564	int			conn_rx_reset_cpumask:1;
565	int			conn_tx_reset_cpumask:1;
566	/* list_head of struct iscsi_cmd for this connection */
567	struct list_head	conn_cmd_list;
568	struct list_head	immed_queue_list;
569	struct list_head	response_queue_list;
570	struct iscsi_conn_ops	*conn_ops;
571	struct iscsi_param_list	*param_list;
572	/* Used for per connection auth state machine */
573	void			*auth_protocol;
574	struct iscsi_login_thread_s *login_thread;
575	struct iscsi_portal_group *tpg;
576	/* Pointer to parent session */
577	struct iscsi_session	*sess;
578	/* Pointer to thread_set in use for this conn's threads */
579	struct iscsi_thread_set	*thread_set;
580	/* list_head for session connection list */
581	struct list_head	conn_list;
582} ____cacheline_aligned;
583
584struct iscsi_conn_recovery {
585	u16			cid;
586	u32			cmd_count;
587	u32			maxrecvdatasegmentlength;
588	int			ready_for_reallegiance;
589	struct list_head	conn_recovery_cmd_list;
590	spinlock_t		conn_recovery_cmd_lock;
591	struct timer_list	time2retain_timer;
592	struct iscsi_session	*sess;
593	struct list_head	cr_list;
594}  ____cacheline_aligned;
595
596struct iscsi_session {
597	u8			initiator_vendor;
598	u8			isid[6];
599	enum iscsi_timer_flags_table time2retain_timer_flags;
600	u8			version_active;
601	u16			cid_called;
602	u16			conn_recovery_count;
603	u16			tsih;
604	/* state session is currently in */
605	u32			session_state;
606	/* session wide counter: initiator assigned task tag */
607	u32			init_task_tag;
608	/* session wide counter: target assigned task tag */
609	u32			targ_xfer_tag;
610	u32			cmdsn_window;
611
612	/* protects cmdsn values */
613	struct mutex		cmdsn_mutex;
614	/* session wide counter: expected command sequence number */
615	u32			exp_cmd_sn;
616	/* session wide counter: maximum allowed command sequence number */
617	u32			max_cmd_sn;
618	struct list_head	sess_ooo_cmdsn_list;
619
620	/* LIO specific session ID */
621	u32			sid;
622	char			auth_type[8];
623	/* unique within the target */
624	int			session_index;
625	/* Used for session reference counting */
626	int			session_usage_count;
627	int			session_waiting_on_uc;
628	u32			cmd_pdus;
629	u32			rsp_pdus;
630	u64			tx_data_octets;
631	u64			rx_data_octets;
632	u32			conn_digest_errors;
633	u32			conn_timeout_errors;
634	u64			creation_time;
635	spinlock_t		session_stats_lock;
636	/* Number of active connections */
637	atomic_t		nconn;
638	atomic_t		session_continuation;
639	atomic_t		session_fall_back_to_erl0;
640	atomic_t		session_logout;
641	atomic_t		session_reinstatement;
642	atomic_t		session_stop_active;
643	atomic_t		sleep_on_sess_wait_comp;
644	atomic_t		transport_wait_cmds;
645	/* connection list */
646	struct list_head	sess_conn_list;
647	struct list_head	cr_active_list;
648	struct list_head	cr_inactive_list;
649	spinlock_t		conn_lock;
650	spinlock_t		cr_a_lock;
651	spinlock_t		cr_i_lock;
652	spinlock_t		session_usage_lock;
653	spinlock_t		ttt_lock;
654	struct completion	async_msg_comp;
655	struct completion	reinstatement_comp;
656	struct completion	session_wait_comp;
657	struct completion	session_waiting_on_uc_comp;
658	struct timer_list	time2retain_timer;
659	struct iscsi_sess_ops	*sess_ops;
660	struct se_session	*se_sess;
661	struct iscsi_portal_group *tpg;
662} ____cacheline_aligned;
663
664struct iscsi_login {
665	u8 auth_complete;
666	u8 checked_for_existing;
667	u8 current_stage;
668	u8 leading_connection;
669	u8 first_request;
670	u8 version_min;
671	u8 version_max;
672	char isid[6];
673	u32 cmd_sn;
674	u32 init_task_tag;
675	u32 initial_exp_statsn;
676	u32 rsp_length;
677	u16 cid;
678	u16 tsih;
679	char *req;
680	char *rsp;
681	char *req_buf;
682	char *rsp_buf;
683} ____cacheline_aligned;
684
685struct iscsi_node_attrib {
686	u32			dataout_timeout;
687	u32			dataout_timeout_retries;
688	u32			default_erl;
689	u32			nopin_timeout;
690	u32			nopin_response_timeout;
691	u32			random_datain_pdu_offsets;
692	u32			random_datain_seq_offsets;
693	u32			random_r2t_offsets;
694	u32			tmr_cold_reset;
695	u32			tmr_warm_reset;
696	struct iscsi_node_acl *nacl;
697};
698
699struct se_dev_entry_s;
700
701struct iscsi_node_auth {
702	enum naf_flags_table	naf_flags;
703	int			authenticate_target;
704	/* Used for iscsit_global->discovery_auth,
705	 * set to zero (auth disabled) by default */
706	int			enforce_discovery_auth;
707#define MAX_USER_LEN				256
708#define MAX_PASS_LEN				256
709	char			userid[MAX_USER_LEN];
710	char			password[MAX_PASS_LEN];
711	char			userid_mutual[MAX_USER_LEN];
712	char			password_mutual[MAX_PASS_LEN];
713};
714
715#include "iscsi_target_stat.h"
716
717struct iscsi_node_stat_grps {
718	struct config_group	iscsi_sess_stats_group;
719	struct config_group	iscsi_conn_stats_group;
720};
721
722struct iscsi_node_acl {
723	struct iscsi_node_attrib node_attrib;
724	struct iscsi_node_auth	node_auth;
725	struct iscsi_node_stat_grps node_stat_grps;
726	struct se_node_acl	se_node_acl;
727};
728
729#define NODE_STAT_GRPS(nacl)	(&(nacl)->node_stat_grps)
730
731#define ISCSI_NODE_ATTRIB(t)	(&(t)->node_attrib)
732#define ISCSI_NODE_AUTH(t)	(&(t)->node_auth)
733
734struct iscsi_tpg_attrib {
735	u32			authentication;
736	u32			login_timeout;
737	u32			netif_timeout;
738	u32			generate_node_acls;
739	u32			cache_dynamic_acls;
740	u32			default_cmdsn_depth;
741	u32			demo_mode_write_protect;
742	u32			prod_mode_write_protect;
743	struct iscsi_portal_group *tpg;
744};
745
746struct iscsi_np {
747	int			np_network_transport;
748	int			np_ip_proto;
749	int			np_sock_type;
750	enum np_thread_state_table np_thread_state;
751	enum iscsi_timer_flags_table np_login_timer_flags;
752	u32			np_exports;
753	enum np_flags_table	np_flags;
754	unsigned char		np_ip[IPV6_ADDRESS_SPACE];
755	u16			np_port;
756	spinlock_t		np_thread_lock;
757	struct completion	np_restart_comp;
758	struct socket		*np_socket;
759	struct __kernel_sockaddr_storage np_sockaddr;
760	struct task_struct	*np_thread;
761	struct timer_list	np_login_timer;
762	struct iscsi_portal_group *np_login_tpg;
763	struct list_head	np_list;
764} ____cacheline_aligned;
765
766struct iscsi_tpg_np {
767	struct iscsi_np		*tpg_np;
768	struct iscsi_portal_group *tpg;
769	struct iscsi_tpg_np	*tpg_np_parent;
770	struct list_head	tpg_np_list;
771	struct list_head	tpg_np_child_list;
772	struct list_head	tpg_np_parent_list;
773	struct se_tpg_np	se_tpg_np;
774	spinlock_t		tpg_np_parent_lock;
775};
776
777struct iscsi_portal_group {
778	unsigned char		tpg_chap_id;
779	/* TPG State */
780	enum tpg_state_table	tpg_state;
781	/* Target Portal Group Tag */
782	u16			tpgt;
783	/* Id assigned to target sessions */
784	u16			ntsih;
785	/* Number of active sessions */
786	u32			nsessions;
787	/* Number of Network Portals available for this TPG */
788	u32			num_tpg_nps;
789	/* Per TPG LIO specific session ID. */
790	u32			sid;
791	/* Spinlock for adding/removing Network Portals */
792	spinlock_t		tpg_np_lock;
793	spinlock_t		tpg_state_lock;
794	struct se_portal_group tpg_se_tpg;
795	struct mutex		tpg_access_lock;
796	struct mutex		np_login_lock;
797	struct iscsi_tpg_attrib	tpg_attrib;
798	/* Pointer to default list of iSCSI parameters for TPG */
799	struct iscsi_param_list	*param_list;
800	struct iscsi_tiqn	*tpg_tiqn;
801	struct list_head	tpg_gnp_list;
802	struct list_head	tpg_list;
803} ____cacheline_aligned;
804
805#define ISCSI_TPG_C(c)		((struct iscsi_portal_group *)(c)->tpg)
806#define ISCSI_TPG_LUN(c, l)  ((iscsi_tpg_list_t *)(c)->tpg->tpg_lun_list_t[l])
807#define ISCSI_TPG_S(s)		((struct iscsi_portal_group *)(s)->tpg)
808#define ISCSI_TPG_ATTRIB(t)	(&(t)->tpg_attrib)
809#define SE_TPG(tpg)		(&(tpg)->tpg_se_tpg)
810
811struct iscsi_wwn_stat_grps {
812	struct config_group	iscsi_stat_group;
813	struct config_group	iscsi_instance_group;
814	struct config_group	iscsi_sess_err_group;
815	struct config_group	iscsi_tgt_attr_group;
816	struct config_group	iscsi_login_stats_group;
817	struct config_group	iscsi_logout_stats_group;
818};
819
820struct iscsi_tiqn {
821#define ISCSI_IQN_LEN				224
822	unsigned char		tiqn[ISCSI_IQN_LEN];
823	enum tiqn_state_table	tiqn_state;
824	int			tiqn_access_count;
825	u32			tiqn_active_tpgs;
826	u32			tiqn_ntpgs;
827	u32			tiqn_num_tpg_nps;
828	u32			tiqn_nsessions;
829	struct list_head	tiqn_list;
830	struct list_head	tiqn_tpg_list;
831	spinlock_t		tiqn_state_lock;
832	spinlock_t		tiqn_tpg_lock;
833	struct se_wwn		tiqn_wwn;
834	struct iscsi_wwn_stat_grps tiqn_stat_grps;
835	int			tiqn_index;
836	struct iscsi_sess_err_stats  sess_err_stats;
837	struct iscsi_login_stats     login_stats;
838	struct iscsi_logout_stats    logout_stats;
839} ____cacheline_aligned;
840
841#define WWN_STAT_GRPS(tiqn)	(&(tiqn)->tiqn_stat_grps)
842
843struct iscsit_global {
844	/* In core shutdown */
845	u32			in_shutdown;
846	u32			active_ts;
847	/* Unique identifier used for the authentication daemon */
848	u32			auth_id;
849	u32			inactive_ts;
850	/* Thread Set bitmap count */
851	int			ts_bitmap_count;
852	/* Thread Set bitmap pointer */
853	unsigned long		*ts_bitmap;
854	/* Used for iSCSI discovery session authentication */
855	struct iscsi_node_acl	discovery_acl;
856	struct iscsi_portal_group	*discovery_tpg;
857};
858
859#endif /* ISCSI_TARGET_CORE_H */
v3.5.6
  1#ifndef ISCSI_TARGET_CORE_H
  2#define ISCSI_TARGET_CORE_H
  3
  4#include <linux/in.h>
  5#include <linux/configfs.h>
  6#include <net/sock.h>
  7#include <net/tcp.h>
  8#include <scsi/scsi_cmnd.h>
  9#include <scsi/iscsi_proto.h>
 10#include <target/target_core_base.h>
 11
 12#define ISCSIT_VERSION			"v4.1.0-rc2"
 13#define ISCSI_MAX_DATASN_MISSING_COUNT	16
 14#define ISCSI_TX_THREAD_TCP_TIMEOUT	2
 15#define ISCSI_RX_THREAD_TCP_TIMEOUT	2
 16#define SECONDS_FOR_ASYNC_LOGOUT	10
 17#define SECONDS_FOR_ASYNC_TEXT		10
 18#define SECONDS_FOR_LOGOUT_COMP		15
 19#define WHITE_SPACE			" \t\v\f\n\r"
 20
 21/* struct iscsi_node_attrib sanity values */
 22#define NA_DATAOUT_TIMEOUT		3
 23#define NA_DATAOUT_TIMEOUT_MAX		60
 24#define NA_DATAOUT_TIMEOUT_MIX		2
 25#define NA_DATAOUT_TIMEOUT_RETRIES	5
 26#define NA_DATAOUT_TIMEOUT_RETRIES_MAX	15
 27#define NA_DATAOUT_TIMEOUT_RETRIES_MIN	1
 28#define NA_NOPIN_TIMEOUT		5
 29#define NA_NOPIN_TIMEOUT_MAX		60
 30#define NA_NOPIN_TIMEOUT_MIN		3
 31#define NA_NOPIN_RESPONSE_TIMEOUT	5
 32#define NA_NOPIN_RESPONSE_TIMEOUT_MAX	60
 33#define NA_NOPIN_RESPONSE_TIMEOUT_MIN	3
 34#define NA_RANDOM_DATAIN_PDU_OFFSETS	0
 35#define NA_RANDOM_DATAIN_SEQ_OFFSETS	0
 36#define NA_RANDOM_R2T_OFFSETS		0
 37#define NA_DEFAULT_ERL			0
 38#define NA_DEFAULT_ERL_MAX		2
 39#define NA_DEFAULT_ERL_MIN		0
 40
 41/* struct iscsi_tpg_attrib sanity values */
 42#define TA_AUTHENTICATION		1
 43#define TA_LOGIN_TIMEOUT		15
 44#define TA_LOGIN_TIMEOUT_MAX		30
 45#define TA_LOGIN_TIMEOUT_MIN		5
 46#define TA_NETIF_TIMEOUT		2
 47#define TA_NETIF_TIMEOUT_MAX		15
 48#define TA_NETIF_TIMEOUT_MIN		2
 49#define TA_GENERATE_NODE_ACLS		0
 50#define TA_DEFAULT_CMDSN_DEPTH		16
 51#define TA_DEFAULT_CMDSN_DEPTH_MAX	512
 52#define TA_DEFAULT_CMDSN_DEPTH_MIN	1
 53#define TA_CACHE_DYNAMIC_ACLS		0
 54/* Enabled by default in demo mode (generic_node_acls=1) */
 55#define TA_DEMO_MODE_WRITE_PROTECT	1
 56/* Disabled by default in production mode w/ explict ACLs */
 57#define TA_PROD_MODE_WRITE_PROTECT	0
 58#define TA_CACHE_CORE_NPS		0
 59
 60
 61#define ISCSI_IOV_DATA_BUFFER		5
 62
 63enum tpg_np_network_transport_table {
 64	ISCSI_TCP				= 0,
 65	ISCSI_SCTP_TCP				= 1,
 66	ISCSI_SCTP_UDP				= 2,
 67	ISCSI_IWARP_TCP				= 3,
 68	ISCSI_IWARP_SCTP			= 4,
 69	ISCSI_INFINIBAND			= 5,
 70};
 71
 72/* RFC-3720 7.1.4  Standard Connection State Diagram for a Target */
 73enum target_conn_state_table {
 74	TARG_CONN_STATE_FREE			= 0x1,
 75	TARG_CONN_STATE_XPT_UP			= 0x3,
 76	TARG_CONN_STATE_IN_LOGIN		= 0x4,
 77	TARG_CONN_STATE_LOGGED_IN		= 0x5,
 78	TARG_CONN_STATE_IN_LOGOUT		= 0x6,
 79	TARG_CONN_STATE_LOGOUT_REQUESTED	= 0x7,
 80	TARG_CONN_STATE_CLEANUP_WAIT		= 0x8,
 81};
 82
 83/* RFC-3720 7.3.2  Session State Diagram for a Target */
 84enum target_sess_state_table {
 85	TARG_SESS_STATE_FREE			= 0x1,
 86	TARG_SESS_STATE_ACTIVE			= 0x2,
 87	TARG_SESS_STATE_LOGGED_IN		= 0x3,
 88	TARG_SESS_STATE_FAILED			= 0x4,
 89	TARG_SESS_STATE_IN_CONTINUE		= 0x5,
 90};
 91
 92/* struct iscsi_data_count->type */
 93enum data_count_type {
 94	ISCSI_RX_DATA	= 1,
 95	ISCSI_TX_DATA	= 2,
 96};
 97
 98/* struct iscsi_datain_req->dr_complete */
 99enum datain_req_comp_table {
100	DATAIN_COMPLETE_NORMAL			= 1,
101	DATAIN_COMPLETE_WITHIN_COMMAND_RECOVERY = 2,
102	DATAIN_COMPLETE_CONNECTION_RECOVERY	= 3,
103};
104
105/* struct iscsi_datain_req->recovery */
106enum datain_req_rec_table {
107	DATAIN_WITHIN_COMMAND_RECOVERY		= 1,
108	DATAIN_CONNECTION_RECOVERY		= 2,
109};
110
111/* struct iscsi_portal_group->state */
112enum tpg_state_table {
113	TPG_STATE_FREE				= 0,
114	TPG_STATE_ACTIVE			= 1,
115	TPG_STATE_INACTIVE			= 2,
116	TPG_STATE_COLD_RESET			= 3,
117};
118
119/* struct iscsi_tiqn->tiqn_state */
120enum tiqn_state_table {
121	TIQN_STATE_ACTIVE			= 1,
122	TIQN_STATE_SHUTDOWN			= 2,
123};
124
125/* struct iscsi_cmd->cmd_flags */
126enum cmd_flags_table {
127	ICF_GOT_LAST_DATAOUT			= 0x00000001,
128	ICF_GOT_DATACK_SNACK			= 0x00000002,
129	ICF_NON_IMMEDIATE_UNSOLICITED_DATA	= 0x00000004,
130	ICF_SENT_LAST_R2T			= 0x00000008,
131	ICF_WITHIN_COMMAND_RECOVERY		= 0x00000010,
132	ICF_CONTIG_MEMORY			= 0x00000020,
133	ICF_ATTACHED_TO_RQUEUE			= 0x00000040,
134	ICF_OOO_CMDSN				= 0x00000080,
135	ICF_REJECT_FAIL_CONN			= 0x00000100,
136};
137
138/* struct iscsi_cmd->i_state */
139enum cmd_i_state_table {
140	ISTATE_NO_STATE			= 0,
141	ISTATE_NEW_CMD			= 1,
142	ISTATE_DEFERRED_CMD		= 2,
143	ISTATE_UNSOLICITED_DATA		= 3,
144	ISTATE_RECEIVE_DATAOUT		= 4,
145	ISTATE_RECEIVE_DATAOUT_RECOVERY	= 5,
146	ISTATE_RECEIVED_LAST_DATAOUT	= 6,
147	ISTATE_WITHIN_DATAOUT_RECOVERY	= 7,
148	ISTATE_IN_CONNECTION_RECOVERY	= 8,
149	ISTATE_RECEIVED_TASKMGT		= 9,
150	ISTATE_SEND_ASYNCMSG		= 10,
151	ISTATE_SENT_ASYNCMSG		= 11,
152	ISTATE_SEND_DATAIN		= 12,
153	ISTATE_SEND_LAST_DATAIN		= 13,
154	ISTATE_SENT_LAST_DATAIN		= 14,
155	ISTATE_SEND_LOGOUTRSP		= 15,
156	ISTATE_SENT_LOGOUTRSP		= 16,
157	ISTATE_SEND_NOPIN		= 17,
158	ISTATE_SENT_NOPIN		= 18,
159	ISTATE_SEND_REJECT		= 19,
160	ISTATE_SENT_REJECT		= 20,
161	ISTATE_SEND_R2T			= 21,
162	ISTATE_SENT_R2T			= 22,
163	ISTATE_SEND_R2T_RECOVERY	= 23,
164	ISTATE_SENT_R2T_RECOVERY	= 24,
165	ISTATE_SEND_LAST_R2T		= 25,
166	ISTATE_SENT_LAST_R2T		= 26,
167	ISTATE_SEND_LAST_R2T_RECOVERY	= 27,
168	ISTATE_SENT_LAST_R2T_RECOVERY	= 28,
169	ISTATE_SEND_STATUS		= 29,
170	ISTATE_SEND_STATUS_BROKEN_PC	= 30,
171	ISTATE_SENT_STATUS		= 31,
172	ISTATE_SEND_STATUS_RECOVERY	= 32,
173	ISTATE_SENT_STATUS_RECOVERY	= 33,
174	ISTATE_SEND_TASKMGTRSP		= 34,
175	ISTATE_SENT_TASKMGTRSP		= 35,
176	ISTATE_SEND_TEXTRSP		= 36,
177	ISTATE_SENT_TEXTRSP		= 37,
178	ISTATE_SEND_NOPIN_WANT_RESPONSE	= 38,
179	ISTATE_SENT_NOPIN_WANT_RESPONSE	= 39,
180	ISTATE_SEND_NOPIN_NO_RESPONSE	= 40,
181	ISTATE_REMOVE			= 41,
182	ISTATE_FREE			= 42,
183};
184
185/* Used for iscsi_recover_cmdsn() return values */
186enum recover_cmdsn_ret_table {
187	CMDSN_ERROR_CANNOT_RECOVER	= -1,
188	CMDSN_NORMAL_OPERATION		= 0,
189	CMDSN_LOWER_THAN_EXP		= 1,
190	CMDSN_HIGHER_THAN_EXP		= 2,
191};
192
193/* Used for iscsi_handle_immediate_data() return values */
194enum immedate_data_ret_table {
195	IMMEDIATE_DATA_CANNOT_RECOVER	= -1,
196	IMMEDIATE_DATA_NORMAL_OPERATION = 0,
197	IMMEDIATE_DATA_ERL1_CRC_FAILURE = 1,
198};
199
200/* Used for iscsi_decide_dataout_action() return values */
201enum dataout_action_ret_table {
202	DATAOUT_CANNOT_RECOVER		= -1,
203	DATAOUT_NORMAL			= 0,
204	DATAOUT_SEND_R2T		= 1,
205	DATAOUT_SEND_TO_TRANSPORT	= 2,
206	DATAOUT_WITHIN_COMMAND_RECOVERY = 3,
207};
208
209/* Used for struct iscsi_node_auth->naf_flags */
210enum naf_flags_table {
211	NAF_USERID_SET			= 0x01,
212	NAF_PASSWORD_SET		= 0x02,
213	NAF_USERID_IN_SET		= 0x04,
214	NAF_PASSWORD_IN_SET		= 0x08,
215};
216
217/* Used by various struct timer_list to manage iSCSI specific state */
218enum iscsi_timer_flags_table {
219	ISCSI_TF_RUNNING		= 0x01,
220	ISCSI_TF_STOP			= 0x02,
221	ISCSI_TF_EXPIRED		= 0x04,
222};
223
224/* Used for struct iscsi_np->np_flags */
225enum np_flags_table {
226	NPF_IP_NETWORK		= 0x00,
 
227};
228
229/* Used for struct iscsi_np->np_thread_state */
230enum np_thread_state_table {
231	ISCSI_NP_THREAD_ACTIVE		= 1,
232	ISCSI_NP_THREAD_INACTIVE	= 2,
233	ISCSI_NP_THREAD_RESET		= 3,
234	ISCSI_NP_THREAD_SHUTDOWN	= 4,
235	ISCSI_NP_THREAD_EXIT		= 5,
236};
237
238struct iscsi_conn_ops {
239	u8	HeaderDigest;			/* [0,1] == [None,CRC32C] */
240	u8	DataDigest;			/* [0,1] == [None,CRC32C] */
241	u32	MaxRecvDataSegmentLength;	/* [512..2**24-1] */
242	u8	OFMarker;			/* [0,1] == [No,Yes] */
243	u8	IFMarker;			/* [0,1] == [No,Yes] */
244	u32	OFMarkInt;			/* [1..65535] */
245	u32	IFMarkInt;			/* [1..65535] */
246};
247
248struct iscsi_sess_ops {
249	char	InitiatorName[224];
250	char	InitiatorAlias[256];
251	char	TargetName[224];
252	char	TargetAlias[256];
253	char	TargetAddress[256];
254	u16	TargetPortalGroupTag;		/* [0..65535] */
255	u16	MaxConnections;			/* [1..65535] */
256	u8	InitialR2T;			/* [0,1] == [No,Yes] */
257	u8	ImmediateData;			/* [0,1] == [No,Yes] */
258	u32	MaxBurstLength;			/* [512..2**24-1] */
259	u32	FirstBurstLength;		/* [512..2**24-1] */
260	u16	DefaultTime2Wait;		/* [0..3600] */
261	u16	DefaultTime2Retain;		/* [0..3600] */
262	u16	MaxOutstandingR2T;		/* [1..65535] */
263	u8	DataPDUInOrder;			/* [0,1] == [No,Yes] */
264	u8	DataSequenceInOrder;		/* [0,1] == [No,Yes] */
265	u8	ErrorRecoveryLevel;		/* [0..2] */
266	u8	SessionType;			/* [0,1] == [Normal,Discovery]*/
267};
268
269struct iscsi_queue_req {
270	int			state;
271	struct iscsi_cmd	*cmd;
272	struct list_head	qr_list;
273};
274
275struct iscsi_data_count {
276	int			data_length;
277	int			sync_and_steering;
278	enum data_count_type	type;
279	u32			iov_count;
280	u32			ss_iov_count;
281	u32			ss_marker_count;
282	struct kvec		*iov;
283};
284
285struct iscsi_param_list {
286	struct list_head	param_list;
287	struct list_head	extra_response_list;
288};
289
290struct iscsi_datain_req {
291	enum datain_req_comp_table dr_complete;
292	int			generate_recovery_values;
293	enum datain_req_rec_table recovery;
294	u32			begrun;
295	u32			runlength;
296	u32			data_length;
297	u32			data_offset;
 
298	u32			data_sn;
299	u32			next_burst_len;
300	u32			read_data_done;
301	u32			seq_send_order;
302	struct list_head	cmd_datain_node;
303} ____cacheline_aligned;
304
305struct iscsi_ooo_cmdsn {
306	u16			cid;
307	u32			batch_count;
308	u32			cmdsn;
309	u32			exp_cmdsn;
310	struct iscsi_cmd	*cmd;
311	struct list_head	ooo_list;
312} ____cacheline_aligned;
313
314struct iscsi_datain {
315	u8			flags;
316	u32			data_sn;
317	u32			length;
318	u32			offset;
319} ____cacheline_aligned;
320
321struct iscsi_r2t {
322	int			seq_complete;
323	int			recovery_r2t;
324	int			sent_r2t;
325	u32			r2t_sn;
326	u32			offset;
327	u32			targ_xfer_tag;
328	u32			xfer_len;
329	struct list_head	r2t_list;
330} ____cacheline_aligned;
331
332struct iscsi_cmd {
333	enum iscsi_timer_flags_table dataout_timer_flags;
334	/* DataOUT timeout retries */
335	u8			dataout_timeout_retries;
336	/* Within command recovery count */
337	u8			error_recovery_count;
338	/* iSCSI dependent state for out or order CmdSNs */
339	enum cmd_i_state_table	deferred_i_state;
340	/* iSCSI dependent state */
341	enum cmd_i_state_table	i_state;
342	/* Command is an immediate command (ISCSI_OP_IMMEDIATE set) */
343	u8			immediate_cmd;
344	/* Immediate data present */
345	u8			immediate_data;
346	/* iSCSI Opcode */
347	u8			iscsi_opcode;
348	/* iSCSI Response Code */
349	u8			iscsi_response;
350	/* Logout reason when iscsi_opcode == ISCSI_INIT_LOGOUT_CMND */
351	u8			logout_reason;
352	/* Logout response code when iscsi_opcode == ISCSI_INIT_LOGOUT_CMND */
353	u8			logout_response;
354	/* MaxCmdSN has been incremented */
355	u8			maxcmdsn_inc;
356	/* Immediate Unsolicited Dataout */
357	u8			unsolicited_data;
358	/* CID contained in logout PDU when opcode == ISCSI_INIT_LOGOUT_CMND */
359	u16			logout_cid;
360	/* Command flags */
361	enum cmd_flags_table	cmd_flags;
362	/* Initiator Task Tag assigned from Initiator */
363	u32			init_task_tag;
364	/* Target Transfer Tag assigned from Target */
365	u32			targ_xfer_tag;
366	/* CmdSN assigned from Initiator */
367	u32			cmd_sn;
368	/* ExpStatSN assigned from Initiator */
369	u32			exp_stat_sn;
370	/* StatSN assigned to this ITT */
371	u32			stat_sn;
372	/* DataSN Counter */
373	u32			data_sn;
374	/* R2TSN Counter */
375	u32			r2t_sn;
376	/* Last DataSN acknowledged via DataAck SNACK */
377	u32			acked_data_sn;
378	/* Used for echoing NOPOUT ping data */
379	u32			buf_ptr_size;
380	/* Used to store DataDigest */
381	u32			data_crc;
 
 
382	/* Counter for MaxOutstandingR2T */
383	u32			outstanding_r2ts;
384	/* Next R2T Offset when DataSequenceInOrder=Yes */
385	u32			r2t_offset;
386	/* Iovec current and orig count for iscsi_cmd->iov_data */
387	u32			iov_data_count;
388	u32			orig_iov_data_count;
389	/* Number of miscellaneous iovecs used for IP stack calls */
390	u32			iov_misc_count;
391	/* Number of struct iscsi_pdu in struct iscsi_cmd->pdu_list */
392	u32			pdu_count;
393	/* Next struct iscsi_pdu to send in struct iscsi_cmd->pdu_list */
394	u32			pdu_send_order;
395	/* Current struct iscsi_pdu in struct iscsi_cmd->pdu_list */
396	u32			pdu_start;
 
397	/* Next struct iscsi_seq to send in struct iscsi_cmd->seq_list */
398	u32			seq_send_order;
399	/* Number of struct iscsi_seq in struct iscsi_cmd->seq_list */
400	u32			seq_count;
401	/* Current struct iscsi_seq in struct iscsi_cmd->seq_list */
402	u32			seq_no;
403	/* Lowest offset in current DataOUT sequence */
404	u32			seq_start_offset;
405	/* Highest offset in current DataOUT sequence */
406	u32			seq_end_offset;
407	/* Total size in bytes received so far of READ data */
408	u32			read_data_done;
409	/* Total size in bytes received so far of WRITE data */
410	u32			write_data_done;
411	/* Counter for FirstBurstLength key */
412	u32			first_burst_len;
413	/* Counter for MaxBurstLength key */
414	u32			next_burst_len;
415	/* Transfer size used for IP stack calls */
416	u32			tx_size;
417	/* Buffer used for various purposes */
418	void			*buf_ptr;
419	/* See include/linux/dma-mapping.h */
420	enum dma_data_direction	data_direction;
421	/* iSCSI PDU Header + CRC */
422	unsigned char		pdu[ISCSI_HDR_LEN + ISCSI_CRC_LEN];
423	/* Number of times struct iscsi_cmd is present in immediate queue */
424	atomic_t		immed_queue_count;
425	atomic_t		response_queue_count;
 
426	spinlock_t		datain_lock;
427	spinlock_t		dataout_timeout_lock;
428	/* spinlock for protecting struct iscsi_cmd->i_state */
429	spinlock_t		istate_lock;
430	/* spinlock for adding within command recovery entries */
431	spinlock_t		error_lock;
432	/* spinlock for adding R2Ts */
433	spinlock_t		r2t_lock;
434	/* DataIN List */
435	struct list_head	datain_list;
436	/* R2T List */
437	struct list_head	cmd_r2t_list;
438	struct completion	reject_comp;
439	/* Timer for DataOUT */
440	struct timer_list	dataout_timer;
441	/* Iovecs for SCSI data payload RX/TX w/ kernel level sockets */
442	struct kvec		*iov_data;
443	/* Iovecs for miscellaneous purposes */
444#define ISCSI_MISC_IOVECS			5
445	struct kvec		iov_misc[ISCSI_MISC_IOVECS];
446	/* Array of struct iscsi_pdu used for DataPDUInOrder=No */
447	struct iscsi_pdu	*pdu_list;
448	/* Current struct iscsi_pdu used for DataPDUInOrder=No */
449	struct iscsi_pdu	*pdu_ptr;
450	/* Array of struct iscsi_seq used for DataSequenceInOrder=No */
451	struct iscsi_seq	*seq_list;
452	/* Current struct iscsi_seq used for DataSequenceInOrder=No */
453	struct iscsi_seq	*seq_ptr;
454	/* TMR Request when iscsi_opcode == ISCSI_OP_SCSI_TMFUNC */
455	struct iscsi_tmr_req	*tmr_req;
456	/* Connection this command is alligient to */
457	struct iscsi_conn	*conn;
458	/* Pointer to connection recovery entry */
459	struct iscsi_conn_recovery *cr;
460	/* Session the command is part of,  used for connection recovery */
461	struct iscsi_session	*sess;
462	/* list_head for connection list */
463	struct list_head	i_conn_node;
464	/* The TCM I/O descriptor that is accessed via container_of() */
465	struct se_cmd		se_cmd;
466	/* Sense buffer that will be mapped into outgoing status */
467#define ISCSI_SENSE_BUFFER_LEN          (TRANSPORT_SENSE_BUFFER + 2)
468	unsigned char		sense_buffer[ISCSI_SENSE_BUFFER_LEN];
469
 
 
 
470	u32			padding;
471	u8			pad_bytes[4];
472
473	struct scatterlist	*first_data_sg;
474	u32			first_data_sg_off;
475	u32			kmapped_nents;
476
477}  ____cacheline_aligned;
478
479struct iscsi_tmr_req {
480	bool			task_reassign:1;
481	u32			ref_cmd_sn;
482	u32			exp_data_sn;
483	struct iscsi_conn_recovery *conn_recovery;
484	struct se_tmr_req	*se_tmr_req;
485};
486
487struct iscsi_conn {
488	/* Authentication Successful for this connection */
489	u8			auth_complete;
490	/* State connection is currently in */
491	u8			conn_state;
492	u8			conn_logout_reason;
493	u8			network_transport;
494	enum iscsi_timer_flags_table nopin_timer_flags;
495	enum iscsi_timer_flags_table nopin_response_timer_flags;
 
 
496	/* Used to know what thread encountered a transport failure */
497	u8			which_thread;
498	/* connection id assigned by the Initiator */
499	u16			cid;
500	/* Remote TCP Port */
501	u16			login_port;
502	u16			local_port;
503	int			net_size;
504	u32			auth_id;
 
505	u32			conn_flags;
506	/* Used for iscsi_tx_login_rsp() */
507	u32			login_itt;
508	u32			exp_statsn;
509	/* Per connection status sequence number */
510	u32			stat_sn;
511	/* IFMarkInt's Current Value */
512	u32			if_marker;
513	/* OFMarkInt's Current Value */
514	u32			of_marker;
515	/* Used for calculating OFMarker offset to next PDU */
516	u32			of_marker_offset;
517	/* Complete Bad PDU for sending reject */
518	unsigned char		bad_hdr[ISCSI_HDR_LEN];
519#define IPV6_ADDRESS_SPACE				48
520	unsigned char		login_ip[IPV6_ADDRESS_SPACE];
521	unsigned char		local_ip[IPV6_ADDRESS_SPACE];
522	int			conn_usage_count;
523	int			conn_waiting_on_uc;
524	atomic_t		check_immediate_queue;
525	atomic_t		conn_logout_remove;
526	atomic_t		connection_exit;
527	atomic_t		connection_recovery;
528	atomic_t		connection_reinstatement;
 
529	atomic_t		connection_wait_rcfr;
530	atomic_t		sleep_on_conn_wait_comp;
531	atomic_t		transport_failed;
532	struct completion	conn_post_wait_comp;
533	struct completion	conn_wait_comp;
534	struct completion	conn_wait_rcfr_comp;
535	struct completion	conn_waiting_on_uc_comp;
536	struct completion	conn_logout_comp;
537	struct completion	tx_half_close_comp;
538	struct completion	rx_half_close_comp;
539	/* socket used by this connection */
540	struct socket		*sock;
541	struct timer_list	nopin_timer;
542	struct timer_list	nopin_response_timer;
543	struct timer_list	transport_timer;
544	/* Spinlock used for add/deleting cmd's from conn_cmd_list */
545	spinlock_t		cmd_lock;
546	spinlock_t		conn_usage_lock;
547	spinlock_t		immed_queue_lock;
548	spinlock_t		nopin_timer_lock;
549	spinlock_t		response_queue_lock;
550	spinlock_t		state_lock;
551	/* libcrypto RX and TX contexts for crc32c */
552	struct hash_desc	conn_rx_hash;
553	struct hash_desc	conn_tx_hash;
554	/* Used for scheduling TX and RX connection kthreads */
555	cpumask_var_t		conn_cpumask;
556	unsigned int		conn_rx_reset_cpumask:1;
557	unsigned int		conn_tx_reset_cpumask:1;
558	/* list_head of struct iscsi_cmd for this connection */
559	struct list_head	conn_cmd_list;
560	struct list_head	immed_queue_list;
561	struct list_head	response_queue_list;
562	struct iscsi_conn_ops	*conn_ops;
563	struct iscsi_param_list	*param_list;
564	/* Used for per connection auth state machine */
565	void			*auth_protocol;
566	struct iscsi_login_thread_s *login_thread;
567	struct iscsi_portal_group *tpg;
568	/* Pointer to parent session */
569	struct iscsi_session	*sess;
570	/* Pointer to thread_set in use for this conn's threads */
571	struct iscsi_thread_set	*thread_set;
572	/* list_head for session connection list */
573	struct list_head	conn_list;
574} ____cacheline_aligned;
575
576struct iscsi_conn_recovery {
577	u16			cid;
578	u32			cmd_count;
579	u32			maxrecvdatasegmentlength;
580	int			ready_for_reallegiance;
581	struct list_head	conn_recovery_cmd_list;
582	spinlock_t		conn_recovery_cmd_lock;
583	struct timer_list	time2retain_timer;
584	struct iscsi_session	*sess;
585	struct list_head	cr_list;
586}  ____cacheline_aligned;
587
588struct iscsi_session {
589	u8			initiator_vendor;
590	u8			isid[6];
591	enum iscsi_timer_flags_table time2retain_timer_flags;
592	u8			version_active;
593	u16			cid_called;
594	u16			conn_recovery_count;
595	u16			tsih;
596	/* state session is currently in */
597	u32			session_state;
598	/* session wide counter: initiator assigned task tag */
599	u32			init_task_tag;
600	/* session wide counter: target assigned task tag */
601	u32			targ_xfer_tag;
602	u32			cmdsn_window;
603
604	/* protects cmdsn values */
605	struct mutex		cmdsn_mutex;
606	/* session wide counter: expected command sequence number */
607	u32			exp_cmd_sn;
608	/* session wide counter: maximum allowed command sequence number */
609	u32			max_cmd_sn;
610	struct list_head	sess_ooo_cmdsn_list;
611
612	/* LIO specific session ID */
613	u32			sid;
614	char			auth_type[8];
615	/* unique within the target */
616	int			session_index;
617	/* Used for session reference counting */
618	int			session_usage_count;
619	int			session_waiting_on_uc;
620	u32			cmd_pdus;
621	u32			rsp_pdus;
622	u64			tx_data_octets;
623	u64			rx_data_octets;
624	u32			conn_digest_errors;
625	u32			conn_timeout_errors;
626	u64			creation_time;
627	spinlock_t		session_stats_lock;
628	/* Number of active connections */
629	atomic_t		nconn;
630	atomic_t		session_continuation;
631	atomic_t		session_fall_back_to_erl0;
632	atomic_t		session_logout;
633	atomic_t		session_reinstatement;
634	atomic_t		session_stop_active;
635	atomic_t		sleep_on_sess_wait_comp;
 
636	/* connection list */
637	struct list_head	sess_conn_list;
638	struct list_head	cr_active_list;
639	struct list_head	cr_inactive_list;
640	spinlock_t		conn_lock;
641	spinlock_t		cr_a_lock;
642	spinlock_t		cr_i_lock;
643	spinlock_t		session_usage_lock;
644	spinlock_t		ttt_lock;
645	struct completion	async_msg_comp;
646	struct completion	reinstatement_comp;
647	struct completion	session_wait_comp;
648	struct completion	session_waiting_on_uc_comp;
649	struct timer_list	time2retain_timer;
650	struct iscsi_sess_ops	*sess_ops;
651	struct se_session	*se_sess;
652	struct iscsi_portal_group *tpg;
653} ____cacheline_aligned;
654
655struct iscsi_login {
656	u8 auth_complete;
657	u8 checked_for_existing;
658	u8 current_stage;
659	u8 leading_connection;
660	u8 first_request;
661	u8 version_min;
662	u8 version_max;
663	char isid[6];
664	u32 cmd_sn;
665	u32 init_task_tag;
666	u32 initial_exp_statsn;
667	u32 rsp_length;
668	u16 cid;
669	u16 tsih;
670	char *req;
671	char *rsp;
672	char *req_buf;
673	char *rsp_buf;
674} ____cacheline_aligned;
675
676struct iscsi_node_attrib {
677	u32			dataout_timeout;
678	u32			dataout_timeout_retries;
679	u32			default_erl;
680	u32			nopin_timeout;
681	u32			nopin_response_timeout;
682	u32			random_datain_pdu_offsets;
683	u32			random_datain_seq_offsets;
684	u32			random_r2t_offsets;
685	u32			tmr_cold_reset;
686	u32			tmr_warm_reset;
687	struct iscsi_node_acl *nacl;
688};
689
690struct se_dev_entry_s;
691
692struct iscsi_node_auth {
693	enum naf_flags_table	naf_flags;
694	int			authenticate_target;
695	/* Used for iscsit_global->discovery_auth,
696	 * set to zero (auth disabled) by default */
697	int			enforce_discovery_auth;
698#define MAX_USER_LEN				256
699#define MAX_PASS_LEN				256
700	char			userid[MAX_USER_LEN];
701	char			password[MAX_PASS_LEN];
702	char			userid_mutual[MAX_USER_LEN];
703	char			password_mutual[MAX_PASS_LEN];
704};
705
706#include "iscsi_target_stat.h"
707
708struct iscsi_node_stat_grps {
709	struct config_group	iscsi_sess_stats_group;
710	struct config_group	iscsi_conn_stats_group;
711};
712
713struct iscsi_node_acl {
714	struct iscsi_node_attrib node_attrib;
715	struct iscsi_node_auth	node_auth;
716	struct iscsi_node_stat_grps node_stat_grps;
717	struct se_node_acl	se_node_acl;
718};
719
720#define NODE_STAT_GRPS(nacl)	(&(nacl)->node_stat_grps)
721
722#define ISCSI_NODE_ATTRIB(t)	(&(t)->node_attrib)
723#define ISCSI_NODE_AUTH(t)	(&(t)->node_auth)
724
725struct iscsi_tpg_attrib {
726	u32			authentication;
727	u32			login_timeout;
728	u32			netif_timeout;
729	u32			generate_node_acls;
730	u32			cache_dynamic_acls;
731	u32			default_cmdsn_depth;
732	u32			demo_mode_write_protect;
733	u32			prod_mode_write_protect;
734	struct iscsi_portal_group *tpg;
735};
736
737struct iscsi_np {
738	int			np_network_transport;
739	int			np_ip_proto;
740	int			np_sock_type;
741	enum np_thread_state_table np_thread_state;
742	enum iscsi_timer_flags_table np_login_timer_flags;
743	u32			np_exports;
744	enum np_flags_table	np_flags;
745	unsigned char		np_ip[IPV6_ADDRESS_SPACE];
746	u16			np_port;
747	spinlock_t		np_thread_lock;
748	struct completion	np_restart_comp;
749	struct socket		*np_socket;
750	struct __kernel_sockaddr_storage np_sockaddr;
751	struct task_struct	*np_thread;
752	struct timer_list	np_login_timer;
753	struct iscsi_portal_group *np_login_tpg;
754	struct list_head	np_list;
755} ____cacheline_aligned;
756
757struct iscsi_tpg_np {
758	struct iscsi_np		*tpg_np;
759	struct iscsi_portal_group *tpg;
760	struct iscsi_tpg_np	*tpg_np_parent;
761	struct list_head	tpg_np_list;
762	struct list_head	tpg_np_child_list;
763	struct list_head	tpg_np_parent_list;
764	struct se_tpg_np	se_tpg_np;
765	spinlock_t		tpg_np_parent_lock;
766};
767
768struct iscsi_portal_group {
769	unsigned char		tpg_chap_id;
770	/* TPG State */
771	enum tpg_state_table	tpg_state;
772	/* Target Portal Group Tag */
773	u16			tpgt;
774	/* Id assigned to target sessions */
775	u16			ntsih;
776	/* Number of active sessions */
777	u32			nsessions;
778	/* Number of Network Portals available for this TPG */
779	u32			num_tpg_nps;
780	/* Per TPG LIO specific session ID. */
781	u32			sid;
782	/* Spinlock for adding/removing Network Portals */
783	spinlock_t		tpg_np_lock;
784	spinlock_t		tpg_state_lock;
785	struct se_portal_group tpg_se_tpg;
786	struct mutex		tpg_access_lock;
787	struct mutex		np_login_lock;
788	struct iscsi_tpg_attrib	tpg_attrib;
789	/* Pointer to default list of iSCSI parameters for TPG */
790	struct iscsi_param_list	*param_list;
791	struct iscsi_tiqn	*tpg_tiqn;
792	struct list_head	tpg_gnp_list;
793	struct list_head	tpg_list;
794} ____cacheline_aligned;
795
796#define ISCSI_TPG_C(c)		((struct iscsi_portal_group *)(c)->tpg)
797#define ISCSI_TPG_LUN(c, l)  ((iscsi_tpg_list_t *)(c)->tpg->tpg_lun_list_t[l])
798#define ISCSI_TPG_S(s)		((struct iscsi_portal_group *)(s)->tpg)
799#define ISCSI_TPG_ATTRIB(t)	(&(t)->tpg_attrib)
800#define SE_TPG(tpg)		(&(tpg)->tpg_se_tpg)
801
802struct iscsi_wwn_stat_grps {
803	struct config_group	iscsi_stat_group;
804	struct config_group	iscsi_instance_group;
805	struct config_group	iscsi_sess_err_group;
806	struct config_group	iscsi_tgt_attr_group;
807	struct config_group	iscsi_login_stats_group;
808	struct config_group	iscsi_logout_stats_group;
809};
810
811struct iscsi_tiqn {
812#define ISCSI_IQN_LEN				224
813	unsigned char		tiqn[ISCSI_IQN_LEN];
814	enum tiqn_state_table	tiqn_state;
815	int			tiqn_access_count;
816	u32			tiqn_active_tpgs;
817	u32			tiqn_ntpgs;
818	u32			tiqn_num_tpg_nps;
819	u32			tiqn_nsessions;
820	struct list_head	tiqn_list;
821	struct list_head	tiqn_tpg_list;
822	spinlock_t		tiqn_state_lock;
823	spinlock_t		tiqn_tpg_lock;
824	struct se_wwn		tiqn_wwn;
825	struct iscsi_wwn_stat_grps tiqn_stat_grps;
826	int			tiqn_index;
827	struct iscsi_sess_err_stats  sess_err_stats;
828	struct iscsi_login_stats     login_stats;
829	struct iscsi_logout_stats    logout_stats;
830} ____cacheline_aligned;
831
832#define WWN_STAT_GRPS(tiqn)	(&(tiqn)->tiqn_stat_grps)
833
834struct iscsit_global {
835	/* In core shutdown */
836	u32			in_shutdown;
837	u32			active_ts;
838	/* Unique identifier used for the authentication daemon */
839	u32			auth_id;
840	u32			inactive_ts;
841	/* Thread Set bitmap count */
842	int			ts_bitmap_count;
843	/* Thread Set bitmap pointer */
844	unsigned long		*ts_bitmap;
845	/* Used for iSCSI discovery session authentication */
846	struct iscsi_node_acl	discovery_acl;
847	struct iscsi_portal_group	*discovery_tpg;
848};
849
850#endif /* ISCSI_TARGET_CORE_H */