GNU Linux-libre 4.19.263-gnu1
[releases.git] / drivers / target / tcm_fc / tcm_fc.h
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
20 #include <linux/types.h>
21 #include <target/target_core_base.h>
22
23 #define FT_VERSION "0.4"
24
25 #define FT_NAMELEN 32           /* length of ASCII WWPNs including pad */
26 #define FT_TPG_NAMELEN 32       /* max length of TPG name */
27 #define FT_LUN_NAMELEN 32       /* max length of LUN name */
28 #define TCM_FC_DEFAULT_TAGS 512 /* tags used for per-session preallocation */
29
30 struct ft_transport_id {
31         __u8    format;
32         __u8    __resvd1[7];
33         __u8    wwpn[8];
34         __u8    __resvd2[8];
35 } __attribute__((__packed__));
36
37 /*
38  * Session (remote port).
39  */
40 struct ft_sess {
41         u32 port_id;                    /* for hash lookup use only */
42         u32 params;
43         u16 max_frame;                  /* maximum frame size */
44         u64 port_name;                  /* port name for transport ID */
45         struct ft_tport *tport;
46         struct se_session *se_sess;
47         struct hlist_node hash;         /* linkage in ft_sess_hash table */
48         struct rcu_head rcu;
49         struct kref kref;               /* ref for hash and outstanding I/Os */
50 };
51
52 /*
53  * Hash table of sessions per local port.
54  * Hash lookup by remote port FC_ID.
55  */
56 #define FT_SESS_HASH_BITS       6
57 #define FT_SESS_HASH_SIZE       (1 << FT_SESS_HASH_BITS)
58
59 /*
60  * Per local port data.
61  * This is created only after a TPG exists that allows target function
62  * for the local port.  If the TPG exists, this is allocated when
63  * we're notified that the local port has been created, or when
64  * the first PRLI provider callback is received.
65  */
66 struct ft_tport {
67         struct fc_lport *lport;
68         struct ft_tpg *tpg;             /* NULL if TPG deleted before tport */
69         u32     sess_count;             /* number of sessions in hash */
70         struct rcu_head rcu;
71         struct hlist_head hash[FT_SESS_HASH_SIZE];      /* list of sessions */
72 };
73
74 /*
75  * Node ID and authentication.
76  */
77 struct ft_node_auth {
78         u64     port_name;
79         u64     node_name;
80 };
81
82 /*
83  * Node ACL for FC remote port session.
84  */
85 struct ft_node_acl {
86         struct se_node_acl se_node_acl;
87         struct ft_node_auth node_auth;
88 };
89
90 struct ft_lun {
91         u32 index;
92         char name[FT_LUN_NAMELEN];
93 };
94
95 /*
96  * Target portal group (local port).
97  */
98 struct ft_tpg {
99         u32 index;
100         struct ft_lport_wwn *lport_wwn;
101         struct ft_tport *tport;         /* active tport or NULL */
102         struct list_head lun_list;      /* head of LUNs */
103         struct se_portal_group se_tpg;
104         struct workqueue_struct *workqueue;
105 };
106
107 struct ft_lport_wwn {
108         u64 wwpn;
109         char name[FT_NAMELEN];
110         struct list_head ft_wwn_node;
111         struct ft_tpg *tpg;
112         struct se_wwn se_wwn;
113 };
114
115 /*
116  * Commands
117  */
118 struct ft_cmd {
119         struct ft_sess *sess;           /* session held for cmd */
120         struct fc_seq *seq;             /* sequence in exchange mgr */
121         struct se_cmd se_cmd;           /* Local TCM I/O descriptor */
122         struct fc_frame *req_frame;
123         u32 write_data_len;             /* data received on writes */
124         struct work_struct work;
125         /* Local sense buffer */
126         unsigned char ft_sense_buffer[TRANSPORT_SENSE_BUFFER];
127         u32 was_ddp_setup:1;            /* Set only if ddp is setup */
128         u32 aborted:1;                  /* Set if aborted by reset or timeout */
129         struct scatterlist *sg;         /* Set only if DDP is setup */
130         u32 sg_cnt;                     /* No. of item in scatterlist */
131 };
132
133 extern struct mutex ft_lport_lock;
134 extern struct fc4_prov ft_prov;
135 extern unsigned int ft_debug_logging;
136
137 /*
138  * Fabric methods.
139  */
140
141 /*
142  * Session ops.
143  */
144 void ft_sess_put(struct ft_sess *);
145 void ft_sess_close(struct se_session *);
146 u32 ft_sess_get_index(struct se_session *);
147 u32 ft_sess_get_port_name(struct se_session *, unsigned char *, u32);
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  */
156 int ft_check_stop_free(struct se_cmd *);
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 int ft_get_cmd_state(struct se_cmd *);
163 void ft_queue_tm_resp(struct se_cmd *);
164 void ft_aborted_task(struct se_cmd *);
165
166 /*
167  * other internal functions.
168  */
169 void ft_recv_req(struct ft_sess *, struct fc_frame *);
170 struct ft_tpg *ft_lport_find_tpg(struct fc_lport *);
171
172 void ft_recv_write_data(struct ft_cmd *, struct fc_frame *);
173 void ft_dump_cmd(struct ft_cmd *, const char *caller);
174
175 ssize_t ft_format_wwn(char *, size_t, u64);
176
177 /*
178  * Underlying HW specific helper function
179  */
180 void ft_invl_hw_context(struct ft_cmd *);
181
182 #endif /* __TCM_FC_H__ */