1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3  * RDMA Transport Layer
4  *
5  * Copyright (c) 2014 - 2018 ProfitBricks GmbH. All rights reserved.
6  * Copyright (c) 2018 - 2019 1&1 IONOS Cloud GmbH. All rights reserved.
7  * Copyright (c) 2019 - 2020 1&1 IONOS SE. All rights reserved.
8  */
9 
10 #ifndef RTRS_CLT_H
11 #define RTRS_CLT_H
12 
13 #include <linux/device.h>
14 #include "rtrs-pri.h"
15 
16 /**
17  * enum rtrs_clt_state - Client states.
18  */
19 enum rtrs_clt_state {
20 	RTRS_CLT_CONNECTING,
21 	RTRS_CLT_CONNECTING_ERR,
22 	RTRS_CLT_RECONNECTING,
23 	RTRS_CLT_CONNECTED,
24 	RTRS_CLT_CLOSING,
25 	RTRS_CLT_CLOSED,
26 	RTRS_CLT_DEAD,
27 };
28 
29 enum rtrs_mp_policy {
30 	MP_POLICY_RR,
31 	MP_POLICY_MIN_INFLIGHT,
32 };
33 
34 /* see Documentation/ABI/testing/sysfs-class-rtrs-client for details */
35 struct rtrs_clt_stats_reconnects {
36 	int successful_cnt;
37 	int fail_cnt;
38 };
39 
40 /* see Documentation/ABI/testing/sysfs-class-rtrs-client for details */
41 struct rtrs_clt_stats_cpu_migr {
42 	atomic_t from;
43 	int to;
44 };
45 
46 /* stats for Read and write operation.
47  * see Documentation/ABI/testing/sysfs-class-rtrs-client for details
48  */
49 struct rtrs_clt_stats_rdma {
50 	struct {
51 		u64 cnt;
52 		u64 size_total;
53 	} dir[2];
54 
55 	u64 failover_cnt;
56 };
57 
58 struct rtrs_clt_stats_pcpu {
59 	struct rtrs_clt_stats_cpu_migr		cpu_migr;
60 	struct rtrs_clt_stats_rdma		rdma;
61 };
62 
63 struct rtrs_clt_stats {
64 	struct kobject				kobj_stats;
65 	struct rtrs_clt_stats_pcpu    __percpu	*pcpu_stats;
66 	struct rtrs_clt_stats_reconnects	reconnects;
67 	atomic_t				inflight;
68 };
69 
70 struct rtrs_clt_con {
71 	struct rtrs_con	c;
72 	struct rtrs_iu		*rsp_ius;
73 	u32			queue_size;
74 	unsigned int		cpu;
75 	struct mutex		con_mutex;
76 	atomic_t		io_cnt;
77 	int			cm_err;
78 };
79 
80 /**
81  * rtrs_permit - permits the memory allocation for future RDMA operation.
82  *		 Combine with irq pinning to keep IO on same CPU.
83  */
84 struct rtrs_permit {
85 	enum rtrs_clt_con_type con_type;
86 	unsigned int cpu_id;
87 	unsigned int mem_id;
88 	unsigned int mem_off;
89 };
90 
91 /**
92  * rtrs_clt_io_req - describes one inflight IO request
93  */
94 struct rtrs_clt_io_req {
95 	struct list_head        list;
96 	struct rtrs_iu		*iu;
97 	struct scatterlist	*sglist; /* list holding user data */
98 	unsigned int		sg_cnt;
99 	unsigned int		sg_size;
100 	unsigned int		data_len;
101 	unsigned int		usr_len;
102 	void			*priv;
103 	bool			in_use;
104 	struct rtrs_clt_con	*con;
105 	struct rtrs_sg_desc	*desc;
106 	struct ib_sge		*sge;
107 	struct rtrs_permit	*permit;
108 	enum dma_data_direction dir;
109 	void			(*conf)(void *priv, int errno);
110 	unsigned long		start_jiffies;
111 
112 	struct ib_mr		*mr;
113 	struct ib_cqe		inv_cqe;
114 	struct completion	inv_comp;
115 	int			inv_errno;
116 	bool			need_inv_comp;
117 	bool			need_inv;
118 };
119 
120 struct rtrs_rbuf {
121 	u64 addr;
122 	u32 rkey;
123 };
124 
125 struct rtrs_clt_sess {
126 	struct rtrs_sess	s;
127 	struct rtrs_clt	*clt;
128 	wait_queue_head_t	state_wq;
129 	enum rtrs_clt_state	state;
130 	atomic_t		connected_cnt;
131 	struct mutex		init_mutex;
132 	struct rtrs_clt_io_req	*reqs;
133 	struct delayed_work	reconnect_dwork;
134 	struct work_struct	close_work;
135 	unsigned int		reconnect_attempts;
136 	bool			established;
137 	struct rtrs_rbuf	*rbufs;
138 	size_t			max_io_size;
139 	u32			max_hdr_size;
140 	u32			chunk_size;
141 	size_t			queue_depth;
142 	u32			max_pages_per_mr;
143 	int			max_send_sge;
144 	u32			flags;
145 	struct kobject		kobj;
146 	u8			for_new_clt;
147 	struct rtrs_clt_stats	*stats;
148 	/* cache hca_port and hca_name to display in sysfs */
149 	u8			hca_port;
150 	char                    hca_name[IB_DEVICE_NAME_MAX];
151 	struct list_head __percpu
152 				*mp_skip_entry;
153 };
154 
155 struct rtrs_clt {
156 	struct list_head	paths_list; /* rcu protected list */
157 	size_t			paths_num;
158 	struct rtrs_clt_sess
159 	__rcu * __percpu	*pcpu_path;
160 	uuid_t			paths_uuid;
161 	int			paths_up;
162 	struct mutex		paths_mutex;
163 	struct mutex		paths_ev_mutex;
164 	char			sessname[NAME_MAX];
165 	u16			port;
166 	unsigned int		max_reconnect_attempts;
167 	unsigned int		reconnect_delay_sec;
168 	unsigned int		max_segments;
169 	size_t			max_segment_size;
170 	void			*permits;
171 	unsigned long		*permits_map;
172 	size_t			queue_depth;
173 	size_t			max_io_size;
174 	wait_queue_head_t	permits_wait;
175 	size_t			pdu_sz;
176 	void			*priv;
177 	void			(*link_ev)(void *priv,
178 					   enum rtrs_clt_link_ev ev);
179 	struct device		dev;
180 	struct kobject		*kobj_paths;
181 	enum rtrs_mp_policy	mp_policy;
182 };
183 
184 static inline struct rtrs_clt_con *to_clt_con(struct rtrs_con *c)
185 {
186 	return container_of(c, struct rtrs_clt_con, c);
187 }
188 
189 static inline struct rtrs_clt_sess *to_clt_sess(struct rtrs_sess *s)
190 {
191 	return container_of(s, struct rtrs_clt_sess, s);
192 }
193 
194 static inline int permit_size(struct rtrs_clt *clt)
195 {
196 	return sizeof(struct rtrs_permit) + clt->pdu_sz;
197 }
198 
199 static inline struct rtrs_permit *get_permit(struct rtrs_clt *clt, int idx)
200 {
201 	return (struct rtrs_permit *)(clt->permits + permit_size(clt) * idx);
202 }
203 
204 int rtrs_clt_reconnect_from_sysfs(struct rtrs_clt_sess *sess);
205 int rtrs_clt_disconnect_from_sysfs(struct rtrs_clt_sess *sess);
206 int rtrs_clt_create_path_from_sysfs(struct rtrs_clt *clt,
207 				     struct rtrs_addr *addr);
208 int rtrs_clt_remove_path_from_sysfs(struct rtrs_clt_sess *sess,
209 				     const struct attribute *sysfs_self);
210 
211 void rtrs_clt_set_max_reconnect_attempts(struct rtrs_clt *clt, int value);
212 int rtrs_clt_get_max_reconnect_attempts(const struct rtrs_clt *clt);
213 void free_sess(struct rtrs_clt_sess *sess);
214 
215 /* rtrs-clt-stats.c */
216 
217 int rtrs_clt_init_stats(struct rtrs_clt_stats *stats);
218 
219 void rtrs_clt_inc_failover_cnt(struct rtrs_clt_stats *s);
220 
221 void rtrs_clt_update_wc_stats(struct rtrs_clt_con *con);
222 void rtrs_clt_update_all_stats(struct rtrs_clt_io_req *req, int dir);
223 
224 int rtrs_clt_reset_rdma_lat_distr_stats(struct rtrs_clt_stats *stats,
225 					 bool enable);
226 ssize_t rtrs_clt_stats_rdma_lat_distr_to_str(struct rtrs_clt_stats *stats,
227 					      char *page, size_t len);
228 int rtrs_clt_reset_cpu_migr_stats(struct rtrs_clt_stats *stats, bool enable);
229 int rtrs_clt_stats_migration_cnt_to_str(struct rtrs_clt_stats *stats, char *buf,
230 					 size_t len);
231 int rtrs_clt_reset_reconnects_stat(struct rtrs_clt_stats *stats, bool enable);
232 int rtrs_clt_stats_reconnects_to_str(struct rtrs_clt_stats *stats, char *buf,
233 				      size_t len);
234 int rtrs_clt_reset_wc_comp_stats(struct rtrs_clt_stats *stats, bool enable);
235 int rtrs_clt_stats_wc_completion_to_str(struct rtrs_clt_stats *stats, char *buf,
236 					 size_t len);
237 int rtrs_clt_reset_rdma_stats(struct rtrs_clt_stats *stats, bool enable);
238 ssize_t rtrs_clt_stats_rdma_to_str(struct rtrs_clt_stats *stats,
239 				    char *page, size_t len);
240 int rtrs_clt_reset_all_stats(struct rtrs_clt_stats *stats, bool enable);
241 ssize_t rtrs_clt_reset_all_help(struct rtrs_clt_stats *stats,
242 				 char *page, size_t len);
243 
244 /* rtrs-clt-sysfs.c */
245 
246 int rtrs_clt_create_sysfs_root_files(struct rtrs_clt *clt);
247 void rtrs_clt_destroy_sysfs_root(struct rtrs_clt *clt);
248 
249 int rtrs_clt_create_sess_files(struct rtrs_clt_sess *sess);
250 void rtrs_clt_destroy_sess_files(struct rtrs_clt_sess *sess,
251 				  const struct attribute *sysfs_self);
252 
253 #endif /* RTRS_CLT_H */
254