1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3 * Shared Memory Communications over RDMA (SMC-R) and RoCE
4 *
5 * Definitions for the SMC module (socket related)
6 *
7 * Copyright IBM Corp. 2016
8 *
9 * Author(s): Ursula Braun <ubraun@linux.vnet.ibm.com>
10 */
11 #ifndef __SMC_H
12 #define __SMC_H
13
14 #include <linux/socket.h>
15 #include <linux/types.h>
16 #include <linux/compiler.h> /* __aligned */
17 #include <net/genetlink.h>
18 #include <net/sock.h>
19
20 #include "smc_ib.h"
21
22 #define SMC_V1 1 /* SMC version V1 */
23 #define SMC_V2 2 /* SMC version V2 */
24
25 #define SMC_RELEASE_0 0
26 #define SMC_RELEASE_1 1
27 #define SMC_RELEASE SMC_RELEASE_1 /* the latest release version */
28
29 #define SMCPROTO_SMC 0 /* SMC protocol, IPv4 */
30 #define SMCPROTO_SMC6 1 /* SMC protocol, IPv6 */
31
32 #define SMC_AUTOCORKING_DEFAULT_SIZE 0x10000 /* 64K by default */
33
34 extern struct proto smc_proto;
35 extern struct proto smc_proto6;
36
37 extern struct smc_hashinfo smc_v4_hashinfo;
38 extern struct smc_hashinfo smc_v6_hashinfo;
39
40 int smc_hash_sk(struct sock *sk);
41 void smc_unhash_sk(struct sock *sk);
42 void smc_release_cb(struct sock *sk);
43
44 int smc_release(struct socket *sock);
45 int smc_bind(struct socket *sock, struct sockaddr *uaddr,
46 int addr_len);
47 int smc_connect(struct socket *sock, struct sockaddr *addr,
48 int alen, int flags);
49 int smc_accept(struct socket *sock, struct socket *new_sock,
50 struct proto_accept_arg *arg);
51 int smc_getname(struct socket *sock, struct sockaddr *addr,
52 int peer);
53 __poll_t smc_poll(struct file *file, struct socket *sock,
54 poll_table *wait);
55 int smc_ioctl(struct socket *sock, unsigned int cmd,
56 unsigned long arg);
57 int smc_listen(struct socket *sock, int backlog);
58 int smc_shutdown(struct socket *sock, int how);
59 int smc_setsockopt(struct socket *sock, int level, int optname,
60 sockptr_t optval, unsigned int optlen);
61 int smc_getsockopt(struct socket *sock, int level, int optname,
62 char __user *optval, int __user *optlen);
63 int smc_sendmsg(struct socket *sock, struct msghdr *msg, size_t len);
64 int smc_recvmsg(struct socket *sock, struct msghdr *msg, size_t len,
65 int flags);
66 ssize_t smc_splice_read(struct socket *sock, loff_t *ppos,
67 struct pipe_inode_info *pipe, size_t len,
68 unsigned int flags);
69
70 /* smc sock initialization */
71 void smc_sk_init(struct net *net, struct sock *sk, int protocol);
72 /* clcsock initialization */
73 int smc_create_clcsk(struct net *net, struct sock *sk, int family);
74
75 #ifdef ATOMIC64_INIT
76 #define KERNEL_HAS_ATOMIC64
77 #endif
78
79 enum smc_state { /* possible states of an SMC socket */
80 SMC_ACTIVE = 1,
81 SMC_INIT = 2,
82 SMC_CLOSED = 7,
83 SMC_LISTEN = 10,
84 /* normal close */
85 SMC_PEERCLOSEWAIT1 = 20,
86 SMC_PEERCLOSEWAIT2 = 21,
87 SMC_APPFINCLOSEWAIT = 24,
88 SMC_APPCLOSEWAIT1 = 22,
89 SMC_APPCLOSEWAIT2 = 23,
90 SMC_PEERFINCLOSEWAIT = 25,
91 /* abnormal close */
92 SMC_PEERABORTWAIT = 26,
93 SMC_PROCESSABORT = 27,
94 };
95
96 enum smc_supplemental_features {
97 SMC_SPF_EMULATED_ISM_DEV = 0,
98 };
99
100 #define SMC_FEATURE_MASK \
101 (BIT(SMC_SPF_EMULATED_ISM_DEV))
102
103 struct smc_link_group;
104
105 struct smc_wr_rx_hdr { /* common prefix part of LLC and CDC to demultiplex */
106 union {
107 u8 type;
108 #if defined(__BIG_ENDIAN_BITFIELD)
109 struct {
110 u8 llc_version:4,
111 llc_type:4;
112 };
113 #elif defined(__LITTLE_ENDIAN_BITFIELD)
114 struct {
115 u8 llc_type:4,
116 llc_version:4;
117 };
118 #endif
119 };
120 } __aligned(1);
121
122 struct smc_cdc_conn_state_flags {
123 #if defined(__BIG_ENDIAN_BITFIELD)
124 u8 peer_done_writing : 1; /* Sending done indicator */
125 u8 peer_conn_closed : 1; /* Peer connection closed indicator */
126 u8 peer_conn_abort : 1; /* Abnormal close indicator */
127 u8 reserved : 5;
128 #elif defined(__LITTLE_ENDIAN_BITFIELD)
129 u8 reserved : 5;
130 u8 peer_conn_abort : 1;
131 u8 peer_conn_closed : 1;
132 u8 peer_done_writing : 1;
133 #endif
134 };
135
136 struct smc_cdc_producer_flags {
137 #if defined(__BIG_ENDIAN_BITFIELD)
138 u8 write_blocked : 1; /* Writing Blocked, no rx buf space */
139 u8 urg_data_pending : 1; /* Urgent Data Pending */
140 u8 urg_data_present : 1; /* Urgent Data Present */
141 u8 cons_curs_upd_req : 1; /* cursor update requested */
142 u8 failover_validation : 1;/* message replay due to failover */
143 u8 reserved : 3;
144 #elif defined(__LITTLE_ENDIAN_BITFIELD)
145 u8 reserved : 3;
146 u8 failover_validation : 1;
147 u8 cons_curs_upd_req : 1;
148 u8 urg_data_present : 1;
149 u8 urg_data_pending : 1;
150 u8 write_blocked : 1;
151 #endif
152 };
153
154 /* in host byte order */
155 union smc_host_cursor { /* SMC cursor - an offset in an RMBE */
156 struct {
157 u16 reserved;
158 u16 wrap; /* window wrap sequence number */
159 u32 count; /* cursor (= offset) part */
160 };
161 #ifdef KERNEL_HAS_ATOMIC64
162 atomic64_t acurs; /* for atomic processing */
163 #else
164 u64 acurs; /* for atomic processing */
165 #endif
166 } __aligned(8);
167
168 /* in host byte order, except for flag bitfields in network byte order */
169 struct smc_host_cdc_msg { /* Connection Data Control message */
170 struct smc_wr_rx_hdr common; /* .type = 0xFE */
171 u8 len; /* length = 44 */
172 u16 seqno; /* connection seq # */
173 u32 token; /* alert_token */
174 union smc_host_cursor prod; /* producer cursor */
175 union smc_host_cursor cons; /* consumer cursor,
176 * piggy backed "ack"
177 */
178 struct smc_cdc_producer_flags prod_flags; /* conn. tx/rx status */
179 struct smc_cdc_conn_state_flags conn_state_flags; /* peer conn. status*/
180 u8 reserved[18];
181 } __aligned(8);
182
183 enum smc_urg_state {
184 SMC_URG_VALID = 1, /* data present */
185 SMC_URG_NOTYET = 2, /* data pending */
186 SMC_URG_READ = 3, /* data was already read */
187 };
188
189 struct smc_mark_woken {
190 bool woken;
191 void *key;
192 wait_queue_entry_t wait_entry;
193 };
194
195 struct smc_connection {
196 struct rb_node alert_node;
197 struct smc_link_group *lgr; /* link group of connection */
198 struct smc_link *lnk; /* assigned SMC-R link */
199 u32 alert_token_local; /* unique conn. id */
200 u8 peer_rmbe_idx; /* from tcp handshake */
201 int peer_rmbe_size; /* size of peer rx buffer */
202 atomic_t peer_rmbe_space;/* remaining free bytes in peer
203 * rmbe
204 */
205 int rtoken_idx; /* idx to peer RMB rkey/addr */
206
207 struct smc_buf_desc *sndbuf_desc; /* send buffer descriptor */
208 struct smc_buf_desc *rmb_desc; /* RMBE descriptor */
209 int rmbe_size_comp; /* compressed notation */
210 int rmbe_update_limit;
211 /* lower limit for consumer
212 * cursor update
213 */
214
215 struct smc_host_cdc_msg local_tx_ctrl; /* host byte order staging
216 * buffer for CDC msg send
217 * .prod cf. TCP snd_nxt
218 * .cons cf. TCP sends ack
219 */
220 union smc_host_cursor local_tx_ctrl_fin;
221 /* prod crsr - confirmed by peer
222 */
223 union smc_host_cursor tx_curs_prep; /* tx - prepared data
224 * snd_max..wmem_alloc
225 */
226 union smc_host_cursor tx_curs_sent; /* tx - sent data
227 * snd_nxt ?
228 */
229 union smc_host_cursor tx_curs_fin; /* tx - confirmed by peer
230 * snd-wnd-begin ?
231 */
232 atomic_t sndbuf_space; /* remaining space in sndbuf */
233 u16 tx_cdc_seq; /* sequence # for CDC send */
234 u16 tx_cdc_seq_fin; /* sequence # - tx completed */
235 spinlock_t send_lock; /* protect wr_sends */
236 atomic_t cdc_pend_tx_wr; /* number of pending tx CDC wqe
237 * - inc when post wqe,
238 * - dec on polled tx cqe
239 */
240 wait_queue_head_t cdc_pend_tx_wq; /* wakeup on no cdc_pend_tx_wr*/
241 struct delayed_work tx_work; /* retry of smc_cdc_msg_send */
242 u32 tx_off; /* base offset in peer rmb */
243
244 struct smc_host_cdc_msg local_rx_ctrl; /* filled during event_handl.
245 * .prod cf. TCP rcv_nxt
246 * .cons cf. TCP snd_una
247 */
248 union smc_host_cursor rx_curs_confirmed; /* confirmed to peer
249 * source of snd_una ?
250 */
251 union smc_host_cursor urg_curs; /* points at urgent byte */
252 enum smc_urg_state urg_state;
253 bool urg_tx_pend; /* urgent data staged */
254 bool urg_rx_skip_pend;
255 /* indicate urgent oob data
256 * read, but previous regular
257 * data still pending
258 */
259 char urg_rx_byte; /* urgent byte */
260 bool tx_in_release_sock;
261 /* flush pending tx data in
262 * sock release_cb()
263 */
264 atomic_t bytes_to_rcv; /* arrived data,
265 * not yet received
266 */
267 atomic_t splice_pending; /* number of spliced bytes
268 * pending processing
269 */
270 #ifndef KERNEL_HAS_ATOMIC64
271 spinlock_t acurs_lock; /* protect cursors */
272 #endif
273 struct work_struct close_work; /* peer sent some closing */
274 struct work_struct abort_work; /* abort the connection */
275 struct tasklet_struct rx_tsklet; /* Receiver tasklet for SMC-D */
276 u8 rx_off; /* receive offset:
277 * 0 for SMC-R, 32 for SMC-D
278 */
279 u64 peer_token; /* SMC-D token of peer */
280 u8 killed : 1; /* abnormal termination */
281 u8 freed : 1; /* normal termiation */
282 u8 out_of_sync : 1; /* out of sync with peer */
283 };
284
285 struct smc_sock { /* smc sock container */
286 struct sock sk;
287 #if IS_ENABLED(CONFIG_IPV6)
288 struct ipv6_pinfo *pinet6;
289 #endif
290 struct socket *clcsock; /* internal tcp socket */
291 void (*clcsk_state_change)(struct sock *sk);
292 /* original stat_change fct. */
293 void (*clcsk_data_ready)(struct sock *sk);
294 /* original data_ready fct. */
295 void (*clcsk_write_space)(struct sock *sk);
296 /* original write_space fct. */
297 void (*clcsk_error_report)(struct sock *sk);
298 /* original error_report fct. */
299 struct smc_connection conn; /* smc connection */
300 struct smc_sock *listen_smc; /* listen parent */
301 struct work_struct connect_work; /* handle non-blocking connect*/
302 struct work_struct tcp_listen_work;/* handle tcp socket accepts */
303 struct work_struct smc_listen_work;/* prepare new accept socket */
304 struct list_head accept_q; /* sockets to be accepted */
305 spinlock_t accept_q_lock; /* protects accept_q */
306 bool limit_smc_hs; /* put constraint on handshake */
307 bool use_fallback; /* fallback to tcp */
308 int fallback_rsn; /* reason for fallback */
309 u32 peer_diagnosis; /* decline reason from peer */
310 atomic_t queued_smc_hs; /* queued smc handshakes */
311 struct inet_connection_sock_af_ops af_ops;
312 const struct inet_connection_sock_af_ops *ori_af_ops;
313 /* original af ops */
314 int sockopt_defer_accept;
315 /* sockopt TCP_DEFER_ACCEPT
316 * value
317 */
318 u8 wait_close_tx_prepared : 1;
319 /* shutdown wr or close
320 * started, waiting for unsent
321 * data to be sent
322 */
323 u8 connect_nonblock : 1;
324 /* non-blocking connect in
325 * flight
326 */
327 struct mutex clcsock_release_lock;
328 /* protects clcsock of a listen
329 * socket
330 * */
331 };
332
333 #define smc_sk(ptr) container_of_const(ptr, struct smc_sock, sk)
334
335 static inline void smc_init_saved_callbacks(struct smc_sock *smc)
336 {
337 smc->clcsk_state_change = NULL;
338 smc->clcsk_data_ready = NULL;
339 smc->clcsk_write_space = NULL;
340 smc->clcsk_error_report = NULL;
341 }
342
343 static inline struct smc_sock *smc_clcsock_user_data(const struct sock *clcsk)
344 {
345 return (struct smc_sock *)
346 ((uintptr_t)clcsk->sk_user_data & ~SK_USER_DATA_NOCOPY);
347 }
348
349 /* save target_cb in saved_cb, and replace target_cb with new_cb */
350 static inline void smc_clcsock_replace_cb(void (**target_cb)(struct sock *),
351 void (*new_cb)(struct sock *),
352 void (**saved_cb)(struct sock *))
353 {
354 /* only save once */
355 if (!*saved_cb)
356 *saved_cb = *target_cb;
357 *target_cb = new_cb;
358 }
359
360 /* restore target_cb to saved_cb, and reset saved_cb to NULL */
361 static inline void smc_clcsock_restore_cb(void (**target_cb)(struct sock *),
362 void (**saved_cb)(struct sock *))
363 {
364 if (!*saved_cb)
365 return;
366 *target_cb = *saved_cb;
367 *saved_cb = NULL;
368 }
369
370 extern struct workqueue_struct *smc_hs_wq; /* wq for handshake work */
371 extern struct workqueue_struct *smc_close_wq; /* wq for close work */
372
373 #define SMC_SYSTEMID_LEN 8
374
375 extern u8 local_systemid[SMC_SYSTEMID_LEN]; /* unique system identifier */
376
377 #define ntohll(x) be64_to_cpu(x)
378 #define htonll(x) cpu_to_be64(x)
379
380 /* convert an u32 value into network byte order, store it into a 3 byte field */
381 static inline void hton24(u8 *net, u32 host)
382 {
383 __be32 t;
384
385 t = cpu_to_be32(host);
386 memcpy(net, ((u8 *)&t) + 1, 3);
387 }
388
389 /* convert a received 3 byte field into host byte order*/
390 static inline u32 ntoh24(u8 *net)
391 {
392 __be32 t = 0;
393
394 memcpy(((u8 *)&t) + 1, net, 3);
395 return be32_to_cpu(t);
396 }
397
398 #ifdef CONFIG_XFRM
399 static inline bool using_ipsec(struct smc_sock *smc)
400 {
401 return (smc->clcsock->sk->sk_policy[0] ||
402 smc->clcsock->sk->sk_policy[1]) ? true : false;
403 }
404 #else
405 static inline bool using_ipsec(struct smc_sock *smc)
406 {
407 return false;
408 }
409 #endif
410
411 struct smc_gidlist;
412
413 struct sock *smc_accept_dequeue(struct sock *parent, struct socket *new_sock);
414 void smc_close_non_accepted(struct sock *sk);
415 void smc_fill_gid_list(struct smc_link_group *lgr,
416 struct smc_gidlist *gidlist,
417 struct smc_ib_device *known_dev, u8 *known_gid);
418
419 /* smc handshake limitation interface for netlink */
420 int smc_nl_dump_hs_limitation(struct sk_buff *skb, struct netlink_callback *cb);
421 int smc_nl_enable_hs_limitation(struct sk_buff *skb, struct genl_info *info);
422 int smc_nl_disable_hs_limitation(struct sk_buff *skb, struct genl_info *info);
423
424 static inline void smc_sock_set_flag(struct sock *sk, enum sock_flags flag)
425 {
426 set_bit(flag, &sk->sk_flags);
427 }
428
429 #endif /* __SMC_H */
430
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.