rdma_user_cm.h 7.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381
  1. /* SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR Linux-OpenIB) */
  2. /*
  3. * Copyright (c) 2005-2006 Intel Corporation. All rights reserved.
  4. *
  5. * This software is available to you under a choice of one of two
  6. * licenses. You may choose to be licensed under the terms of the GNU
  7. * General Public License (GPL) Version 2, available from the file
  8. * COPYING in the main directory of this source tree, or the
  9. * OpenIB.org BSD license below:
  10. *
  11. * Redistribution and use in source and binary forms, with or
  12. * without modification, are permitted provided that the following
  13. * conditions are met:
  14. *
  15. * - Redistributions of source code must retain the above
  16. * copyright notice, this list of conditions and the following
  17. * disclaimer.
  18. *
  19. * - Redistributions in binary form must reproduce the above
  20. * copyright notice, this list of conditions and the following
  21. * disclaimer in the documentation and/or other materials
  22. * provided with the distribution.
  23. *
  24. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  25. * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  26. * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  27. * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
  28. * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
  29. * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  30. * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  31. * SOFTWARE.
  32. */
  33. #ifndef RDMA_USER_CM_H
  34. #define RDMA_USER_CM_H
  35. #include <linux/types.h>
  36. #include <linux/socket.h>
  37. #include <linux/in6.h>
  38. #include <rdma/ib_user_verbs.h>
  39. #include <rdma/ib_user_sa.h>
  40. #define RDMA_USER_CM_ABI_VERSION 4
  41. #define RDMA_MAX_PRIVATE_DATA 256
  42. enum {
  43. RDMA_USER_CM_CMD_CREATE_ID,
  44. RDMA_USER_CM_CMD_DESTROY_ID,
  45. RDMA_USER_CM_CMD_BIND_IP,
  46. RDMA_USER_CM_CMD_RESOLVE_IP,
  47. RDMA_USER_CM_CMD_RESOLVE_ROUTE,
  48. RDMA_USER_CM_CMD_QUERY_ROUTE,
  49. RDMA_USER_CM_CMD_CONNECT,
  50. RDMA_USER_CM_CMD_LISTEN,
  51. RDMA_USER_CM_CMD_ACCEPT,
  52. RDMA_USER_CM_CMD_REJECT,
  53. RDMA_USER_CM_CMD_DISCONNECT,
  54. RDMA_USER_CM_CMD_INIT_QP_ATTR,
  55. RDMA_USER_CM_CMD_GET_EVENT,
  56. RDMA_USER_CM_CMD_GET_OPTION,
  57. RDMA_USER_CM_CMD_SET_OPTION,
  58. RDMA_USER_CM_CMD_NOTIFY,
  59. RDMA_USER_CM_CMD_JOIN_IP_MCAST,
  60. RDMA_USER_CM_CMD_LEAVE_MCAST,
  61. RDMA_USER_CM_CMD_MIGRATE_ID,
  62. RDMA_USER_CM_CMD_QUERY,
  63. RDMA_USER_CM_CMD_BIND,
  64. RDMA_USER_CM_CMD_RESOLVE_ADDR,
  65. RDMA_USER_CM_CMD_JOIN_MCAST,
  66. RDMA_USER_CM_CMD_RESOLVE_IB_SERVICE,
  67. RDMA_USER_CM_CMD_WRITE_CM_EVENT,
  68. };
  69. /* See IBTA Annex A11, servies ID bytes 4 & 5 */
  70. enum rdma_ucm_port_space {
  71. RDMA_PS_IPOIB = 0x0002,
  72. RDMA_PS_IB = 0x013F,
  73. RDMA_PS_TCP = 0x0106,
  74. RDMA_PS_UDP = 0x0111,
  75. };
  76. /*
  77. * command ABI structures.
  78. */
  79. struct rdma_ucm_cmd_hdr {
  80. __u32 cmd;
  81. __u16 in;
  82. __u16 out;
  83. };
  84. struct rdma_ucm_create_id {
  85. __aligned_u64 uid;
  86. __aligned_u64 response;
  87. __u16 ps; /* use enum rdma_ucm_port_space */
  88. __u8 qp_type;
  89. __u8 reserved[5];
  90. };
  91. struct rdma_ucm_create_id_resp {
  92. __u32 id;
  93. };
  94. struct rdma_ucm_destroy_id {
  95. __aligned_u64 response;
  96. __u32 id;
  97. __u32 reserved;
  98. };
  99. struct rdma_ucm_destroy_id_resp {
  100. __u32 events_reported;
  101. };
  102. struct rdma_ucm_bind_ip {
  103. __aligned_u64 response;
  104. struct sockaddr_in6 addr;
  105. __u32 id;
  106. };
  107. struct rdma_ucm_bind {
  108. __u32 id;
  109. __u16 addr_size;
  110. __u16 reserved;
  111. struct __kernel_sockaddr_storage addr;
  112. };
  113. struct rdma_ucm_resolve_ip {
  114. struct sockaddr_in6 src_addr;
  115. struct sockaddr_in6 dst_addr;
  116. __u32 id;
  117. __u32 timeout_ms;
  118. };
  119. struct rdma_ucm_resolve_addr {
  120. __u32 id;
  121. __u32 timeout_ms;
  122. __u16 src_size;
  123. __u16 dst_size;
  124. __u32 reserved;
  125. struct __kernel_sockaddr_storage src_addr;
  126. struct __kernel_sockaddr_storage dst_addr;
  127. };
  128. struct rdma_ucm_resolve_route {
  129. __u32 id;
  130. __u32 timeout_ms;
  131. };
  132. enum {
  133. RDMA_USER_CM_QUERY_ADDR,
  134. RDMA_USER_CM_QUERY_PATH,
  135. RDMA_USER_CM_QUERY_GID,
  136. RDMA_USER_CM_QUERY_IB_SERVICE
  137. };
  138. struct rdma_ucm_query {
  139. __aligned_u64 response;
  140. __u32 id;
  141. __u32 option;
  142. };
  143. struct rdma_ucm_query_route_resp {
  144. __aligned_u64 node_guid;
  145. struct ib_user_path_rec ib_route[2];
  146. struct sockaddr_in6 src_addr;
  147. struct sockaddr_in6 dst_addr;
  148. __u32 num_paths;
  149. __u8 port_num;
  150. __u8 reserved[3];
  151. __u32 ibdev_index;
  152. __u32 reserved1;
  153. };
  154. struct rdma_ucm_query_addr_resp {
  155. __aligned_u64 node_guid;
  156. __u8 port_num;
  157. __u8 reserved;
  158. __u16 pkey;
  159. __u16 src_size;
  160. __u16 dst_size;
  161. struct __kernel_sockaddr_storage src_addr;
  162. struct __kernel_sockaddr_storage dst_addr;
  163. __u32 ibdev_index;
  164. __u32 reserved1;
  165. };
  166. struct rdma_ucm_query_path_resp {
  167. __u32 num_paths;
  168. __u32 reserved;
  169. struct ib_path_rec_data path_data[];
  170. };
  171. struct rdma_ucm_query_ib_service_resp {
  172. __u32 num_service_recs;
  173. __u32 reserved;
  174. struct ib_user_service_rec recs[];
  175. };
  176. struct rdma_ucm_conn_param {
  177. __u32 qp_num;
  178. __u32 qkey;
  179. __u8 private_data[RDMA_MAX_PRIVATE_DATA];
  180. __u8 private_data_len;
  181. __u8 srq;
  182. __u8 responder_resources;
  183. __u8 initiator_depth;
  184. __u8 flow_control;
  185. __u8 retry_count;
  186. __u8 rnr_retry_count;
  187. __u8 valid;
  188. };
  189. struct rdma_ucm_ud_param {
  190. __u32 qp_num;
  191. __u32 qkey;
  192. struct ib_uverbs_ah_attr ah_attr;
  193. __u8 private_data[RDMA_MAX_PRIVATE_DATA];
  194. __u8 private_data_len;
  195. __u8 reserved[7];
  196. };
  197. struct rdma_ucm_ece {
  198. __u32 vendor_id;
  199. __u32 attr_mod;
  200. };
  201. struct rdma_ucm_connect {
  202. struct rdma_ucm_conn_param conn_param;
  203. __u32 id;
  204. __u32 reserved;
  205. struct rdma_ucm_ece ece;
  206. };
  207. struct rdma_ucm_listen {
  208. __u32 id;
  209. __u32 backlog;
  210. };
  211. struct rdma_ucm_accept {
  212. __aligned_u64 uid;
  213. struct rdma_ucm_conn_param conn_param;
  214. __u32 id;
  215. __u32 reserved;
  216. struct rdma_ucm_ece ece;
  217. };
  218. struct rdma_ucm_reject {
  219. __u32 id;
  220. __u8 private_data_len;
  221. __u8 reason;
  222. __u8 reserved[2];
  223. __u8 private_data[RDMA_MAX_PRIVATE_DATA];
  224. };
  225. struct rdma_ucm_disconnect {
  226. __u32 id;
  227. };
  228. struct rdma_ucm_init_qp_attr {
  229. __aligned_u64 response;
  230. __u32 id;
  231. __u32 qp_state;
  232. };
  233. struct rdma_ucm_notify {
  234. __u32 id;
  235. __u32 event;
  236. };
  237. struct rdma_ucm_join_ip_mcast {
  238. __aligned_u64 response; /* rdma_ucm_create_id_resp */
  239. __aligned_u64 uid;
  240. struct sockaddr_in6 addr;
  241. __u32 id;
  242. };
  243. /* Multicast join flags */
  244. enum {
  245. RDMA_MC_JOIN_FLAG_FULLMEMBER,
  246. RDMA_MC_JOIN_FLAG_SENDONLY_FULLMEMBER,
  247. RDMA_MC_JOIN_FLAG_RESERVED,
  248. };
  249. struct rdma_ucm_join_mcast {
  250. __aligned_u64 response; /* rdma_ucma_create_id_resp */
  251. __aligned_u64 uid;
  252. __u32 id;
  253. __u16 addr_size;
  254. __u16 join_flags;
  255. struct __kernel_sockaddr_storage addr;
  256. };
  257. struct rdma_ucm_get_event {
  258. __aligned_u64 response;
  259. };
  260. struct rdma_ucm_event_resp {
  261. __aligned_u64 uid;
  262. __u32 id;
  263. __u32 event;
  264. __u32 status;
  265. /*
  266. * NOTE: This union is not aligned to 8 bytes so none of the union
  267. * members may contain a u64 or anything with higher alignment than 4.
  268. */
  269. union {
  270. struct rdma_ucm_conn_param conn;
  271. struct rdma_ucm_ud_param ud;
  272. __u32 arg32[2];
  273. } param;
  274. __u32 reserved;
  275. struct rdma_ucm_ece ece;
  276. };
  277. /* Option levels */
  278. enum {
  279. RDMA_OPTION_ID = 0,
  280. RDMA_OPTION_IB = 1
  281. };
  282. /* Option details */
  283. enum {
  284. RDMA_OPTION_ID_TOS = 0,
  285. RDMA_OPTION_ID_REUSEADDR = 1,
  286. RDMA_OPTION_ID_AFONLY = 2,
  287. RDMA_OPTION_ID_ACK_TIMEOUT = 3
  288. };
  289. enum {
  290. RDMA_OPTION_IB_PATH = 1
  291. };
  292. struct rdma_ucm_set_option {
  293. __aligned_u64 optval;
  294. __u32 id;
  295. __u32 level;
  296. __u32 optname;
  297. __u32 optlen;
  298. };
  299. struct rdma_ucm_migrate_id {
  300. __aligned_u64 response;
  301. __u32 id;
  302. __u32 fd;
  303. };
  304. struct rdma_ucm_migrate_resp {
  305. __u32 events_reported;
  306. };
  307. enum {
  308. RDMA_USER_CM_IB_SERVICE_FLAG_ID = 1 << 0,
  309. RDMA_USER_CM_IB_SERVICE_FLAG_NAME = 1 << 1,
  310. };
  311. #define RDMA_USER_CM_IB_SERVICE_NAME_SIZE 64
  312. struct rdma_ucm_ib_service {
  313. __aligned_u64 service_id;
  314. __u8 service_name[RDMA_USER_CM_IB_SERVICE_NAME_SIZE];
  315. __u32 flags;
  316. __u32 reserved;
  317. };
  318. struct rdma_ucm_resolve_ib_service {
  319. __u32 id;
  320. __u32 reserved;
  321. struct rdma_ucm_ib_service ibs;
  322. };
  323. struct rdma_ucm_write_cm_event {
  324. __u32 id;
  325. __u32 reserved;
  326. __u32 event;
  327. __u32 status;
  328. union {
  329. struct rdma_ucm_conn_param conn;
  330. struct rdma_ucm_ud_param ud;
  331. __u64 arg;
  332. } param;
  333. };
  334. #endif /* RDMA_USER_CM_H */