[deliverable/linux.git] / drivers / target / tcm_fc / tcm_fc.h

/*
 * Copyright (c) 2010 Cisco Systems, Inc.
 *
 * This program is free software; you can redistribute it and/or modify it
 * under the terms and conditions of the GNU General Public License,
 * version 2, as published by the Free Software Foundation.
 *
 * This program is distributed in the hope it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
 * more details.
 *
 * You should have received a copy of the GNU General Public License along with
 * this program; if not, write to the Free Software Foundation, Inc.,
 * 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
 */
#ifndef __TCM_FC_H__
#define __TCM_FC_H__

#define FT_VERSION "0.4"

#define FT_NAMELEN 32		/* length of ASCII WWPNs including pad */
#define FT_TPG_NAMELEN 32	/* max length of TPG name */
#define FT_LUN_NAMELEN 32	/* max length of LUN name */

struct ft_transport_id {
	__u8	format;
	__u8	__resvd1[7];
	__u8	wwpn[8];
	__u8	__resvd2[8];
} __attribute__((__packed__));

/*
 * Session (remote port).
 */
struct ft_sess {
	u32 port_id;			/* for hash lookup use only */
	u32 params;
	u16 max_frame;			/* maximum frame size */
	u64 port_name;			/* port name for transport ID */
	struct ft_tport *tport;
	struct se_session *se_sess;
	struct hlist_node hash;		/* linkage in ft_sess_hash table */
	struct rcu_head rcu;
	struct kref kref;		/* ref for hash and outstanding I/Os */
};

/*
 * Hash table of sessions per local port.
 * Hash lookup by remote port FC_ID.
 */
#define	FT_SESS_HASH_BITS	6
#define	FT_SESS_HASH_SIZE	(1 << FT_SESS_HASH_BITS)

/*
 * Per local port data.
 * This is created only after a TPG exists that allows target function
 * for the local port.  If the TPG exists, this is allocated when
 * we're notified that the local port has been created, or when
 * the first PRLI provider callback is received.
 */
struct ft_tport {
	struct fc_lport *lport;
	struct ft_tpg *tpg;		/* NULL if TPG deleted before tport */
	u32	sess_count;		/* number of sessions in hash */
	struct rcu_head rcu;
	struct hlist_head hash[FT_SESS_HASH_SIZE];	/* list of sessions */
};

/*
 * Node ID and authentication.
 */
struct ft_node_auth {
	u64	port_name;
	u64	node_name;
};

/*
 * Node ACL for FC remote port session.
 */
struct ft_node_acl {
	struct ft_node_auth node_auth;
	struct se_node_acl se_node_acl;
};

struct ft_lun {
	u32 index;
	char name[FT_LUN_NAMELEN];
};

/*
 * Target portal group (local port).
 */
struct ft_tpg {
	u32 index;
	struct ft_lport_acl *lport_acl;
	struct ft_tport *tport;		/* active tport or NULL */
	struct list_head list;		/* linkage in ft_lport_acl tpg_list */
	struct list_head lun_list;	/* head of LUNs */
	struct se_portal_group se_tpg;
	struct workqueue_struct *workqueue;
};

struct ft_lport_acl {
	u64 wwpn;
	char name[FT_NAMELEN];
	struct list_head list;
	struct list_head tpg_list;
	struct se_wwn fc_lport_wwn;
};

/*
 * Commands
 */
struct ft_cmd {
	struct ft_sess *sess;		/* session held for cmd */
	struct fc_seq *seq;		/* sequence in exchange mgr */
	struct se_cmd se_cmd;		/* Local TCM I/O descriptor */
	struct fc_frame *req_frame;
	u32 write_data_len;		/* data received on writes */
	struct work_struct work;
	/* Local sense buffer */
	unsigned char ft_sense_buffer[TRANSPORT_SENSE_BUFFER];
	u32 was_ddp_setup:1;		/* Set only if ddp is setup */
	u32 aborted:1;			/* Set if aborted by reset or timeout */
	struct scatterlist *sg;		/* Set only if DDP is setup */
	u32 sg_cnt;			/* No. of item in scatterlist */
};

extern struct list_head ft_lport_list;
extern struct mutex ft_lport_lock;
extern struct fc4_prov ft_prov;
extern struct target_fabric_configfs *ft_configfs;
extern unsigned int ft_debug_logging;

/*
 * Fabric methods.
 */

/*
 * Session ops.
 */
void ft_sess_put(struct ft_sess *);
int ft_sess_shutdown(struct se_session *);
void ft_sess_close(struct se_session *);
u32 ft_sess_get_index(struct se_session *);
u32 ft_sess_get_port_name(struct se_session *, unsigned char *, u32);

void ft_lport_add(struct fc_lport *, void *);
void ft_lport_del(struct fc_lport *, void *);
int ft_lport_notify(struct notifier_block *, unsigned long, void *);

/*
 * IO methods.
 */
int ft_check_stop_free(struct se_cmd *);
void ft_release_cmd(struct se_cmd *);
int ft_queue_status(struct se_cmd *);
int ft_queue_data_in(struct se_cmd *);
int ft_write_pending(struct se_cmd *);
int ft_write_pending_status(struct se_cmd *);
u32 ft_get_task_tag(struct se_cmd *);
int ft_get_cmd_state(struct se_cmd *);
int ft_queue_tm_resp(struct se_cmd *);

/*
 * other internal functions.
 */
void ft_recv_req(struct ft_sess *, struct fc_frame *);
struct ft_tpg *ft_lport_find_tpg(struct fc_lport *);
struct ft_node_acl *ft_acl_get(struct ft_tpg *, struct fc_rport_priv *);

void ft_recv_write_data(struct ft_cmd *, struct fc_frame *);
void ft_dump_cmd(struct ft_cmd *, const char *caller);

ssize_t ft_format_wwn(char *, size_t, u64);

/*
 * Underlying HW specific helper function
 */
void ft_invl_hw_context(struct ft_cmd *);

#endif /* __TCM_FC_H__ */
Commit	Line	Data
3699d92a KP	1	/*
	2	* Copyright (c) 2010 Cisco Systems, Inc.
	3	*
	4	* This program is free software; you can redistribute it and/or modify it
	5	* under the terms and conditions of the GNU General Public License,
	6	* version 2, as published by the Free Software Foundation.
	7	*
	8	* This program is distributed in the hope it will be useful, but WITHOUT
	9	* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
	10	* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
	11	* more details.
	12	*
	13	* You should have received a copy of the GNU General Public License along with
	14	* this program; if not, write to the Free Software Foundation, Inc.,
	15	* 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
	16	*/
	17	#ifndef __TCM_FC_H__
	18	#define __TCM_FC_H__
	19
9765b1f3	20	#define FT_VERSION "0.4"
3699d92a KP	21
	22	#define FT_NAMELEN 32 /* length of ASCII WWPNs including pad */
	23	#define FT_TPG_NAMELEN 32 /* max length of TPG name */
	24	#define FT_LUN_NAMELEN 32 /* max length of LUN name */
	25
3699d92a KP	26	struct ft_transport_id {
	27	__u8 format;
	28	__u8 __resvd1[7];
	29	__u8 wwpn[8];
	30	__u8 __resvd2[8];
	31	} __attribute__((__packed__));
	32
	33	/*
	34	* Session (remote port).
	35	*/
	36	struct ft_sess {
	37	u32 port_id; /* for hash lookup use only */
	38	u32 params;
	39	u16 max_frame; /* maximum frame size */
	40	u64 port_name; /* port name for transport ID */
	41	struct ft_tport *tport;
	42	struct se_session *se_sess;
	43	struct hlist_node hash; /* linkage in ft_sess_hash table */
	44	struct rcu_head rcu;
	45	struct kref kref; /* ref for hash and outstanding I/Os */
	46	};
	47
	48	/*
	49	* Hash table of sessions per local port.
	50	* Hash lookup by remote port FC_ID.
	51	*/
	52	#define FT_SESS_HASH_BITS 6
	53	#define FT_SESS_HASH_SIZE (1 << FT_SESS_HASH_BITS)
	54
	55	/*
	56	* Per local port data.
	57	* This is created only after a TPG exists that allows target function
	58	* for the local port. If the TPG exists, this is allocated when
	59	* we're notified that the local port has been created, or when
	60	* the first PRLI provider callback is received.
	61	*/
	62	struct ft_tport {
	63	struct fc_lport *lport;
	64	struct ft_tpg tpg; / NULL if TPG deleted before tport */
	65	u32 sess_count; /* number of sessions in hash */
	66	struct rcu_head rcu;
	67	struct hlist_head hash[FT_SESS_HASH_SIZE]; /* list of sessions */
	68	};
	69
	70	/*
	71	* Node ID and authentication.
	72	*/
	73	struct ft_node_auth {
	74	u64 port_name;
	75	u64 node_name;
	76	};
	77
	78	/*
	79	* Node ACL for FC remote port session.
	80	*/
	81	struct ft_node_acl {
	82	struct ft_node_auth node_auth;
	83	struct se_node_acl se_node_acl;
	84	};
	85
	86	struct ft_lun {
	87	u32 index;
	88	char name[FT_LUN_NAMELEN];
	89	};
90
91	/*
92	* Target portal group (local port).
93	*/
94	struct ft_tpg {
95	u32 index;
96	struct ft_lport_acl *lport_acl;
97	struct ft_tport tport; / active tport or NULL */
98	struct list_head list; /* linkage in ft_lport_acl tpg_list */
99	struct list_head lun_list; /* head of LUNs */
100	struct se_portal_group se_tpg;
58fc73d1	101	struct workqueue_struct *workqueue;
3699d92a KP	102	};
	103
	104	struct ft_lport_acl {
	105	u64 wwpn;
	106	char name[FT_NAMELEN];
	107	struct list_head list;
	108	struct list_head tpg_list;
	109	struct se_wwn fc_lport_wwn;
	110	};
	111
3699d92a KP	112	/*
	113	* Commands
	114	*/
	115	struct ft_cmd {
3699d92a KP	116	struct ft_sess sess; / session held for cmd */
	117	struct fc_seq seq; / sequence in exchange mgr */
	118	struct se_cmd se_cmd; /* Local TCM I/O descriptor */
	119	struct fc_frame *req_frame;
3699d92a	120	u32 write_data_len; /* data received on writes */
58fc73d1	121	struct work_struct work;
3699d92a KP	122	/* Local sense buffer */
	123	unsigned char ft_sense_buffer[TRANSPORT_SENSE_BUFFER];
	124	u32 was_ddp_setup:1; /* Set only if ddp is setup */
e1c40382	125	u32 aborted:1; /* Set if aborted by reset or timeout */
3699d92a KP	126	struct scatterlist sg; / Set only if DDP is setup */
	127	u32 sg_cnt; /* No. of item in scatterlist */
	128	};
	129
	130	extern struct list_head ft_lport_list;
	131	extern struct mutex ft_lport_lock;
	132	extern struct fc4_prov ft_prov;
	133	extern struct target_fabric_configfs *ft_configfs;
1fa8f450	134	extern unsigned int ft_debug_logging;
3699d92a KP	135
	136	/*
	137	* Fabric methods.
	138	*/
	139
	140	/*
	141	* Session ops.
	142	*/
	143	void ft_sess_put(struct ft_sess *);
	144	int ft_sess_shutdown(struct se_session *);
	145	void ft_sess_close(struct se_session *);
3699d92a KP	146	u32 ft_sess_get_index(struct se_session *);
3699d92a KP	147	u32 ft_sess_get_port_name(struct se_session , unsigned char , u32);
3699d92a KP	148
	149	void ft_lport_add(struct fc_lport , void );
	150	void ft_lport_del(struct fc_lport , void );
	151	int ft_lport_notify(struct notifier_block , unsigned long, void );
	152
	153	/*
	154	* IO methods.
	155	*/
88dd9e26	156	int ft_check_stop_free(struct se_cmd *);
3699d92a KP	157	void ft_release_cmd(struct se_cmd *);
	158	int ft_queue_status(struct se_cmd *);
	159	int ft_queue_data_in(struct se_cmd *);
	160	int ft_write_pending(struct se_cmd *);
	161	int ft_write_pending_status(struct se_cmd *);
	162	u32 ft_get_task_tag(struct se_cmd *);
	163	int ft_get_cmd_state(struct se_cmd *);
3699d92a	164	int ft_queue_tm_resp(struct se_cmd *);
3699d92a KP	165
	166	/*
	167	* other internal functions.
	168	*/
3699d92a KP	169	void ft_recv_req(struct ft_sess , struct fc_frame );
	170	struct ft_tpg ft_lport_find_tpg(struct fc_lport );
	171	struct ft_node_acl ft_acl_get(struct ft_tpg , struct fc_rport_priv *);
	172
	173	void ft_recv_write_data(struct ft_cmd , struct fc_frame );
	174	void ft_dump_cmd(struct ft_cmd , const char caller);
	175
	176	ssize_t ft_format_wwn(char *, size_t, u64);
	177
dcd998cc KP	178	/*
	179	* Underlying HW specific helper function
	180	*/
	181	void ft_invl_hw_context(struct ft_cmd *);
	182
3699d92a	183	#endif /* __TCM_FC_H__ */