Home | History | Annotate | Download | only in rdma
      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 
     34 #ifndef RDMA_USER_CM_H
     35 #define RDMA_USER_CM_H
     36 
     37 #include <linux/types.h>
     38 #include <linux/socket.h>
     39 #include <linux/in6.h>
     40 #include <rdma/ib_user_verbs.h>
     41 #include <rdma/ib_user_sa.h>
     42 
     43 #define RDMA_USER_CM_ABI_VERSION	4
     44 
     45 #define RDMA_MAX_PRIVATE_DATA		256
     46 
     47 enum {
     48 	RDMA_USER_CM_CMD_CREATE_ID,
     49 	RDMA_USER_CM_CMD_DESTROY_ID,
     50 	RDMA_USER_CM_CMD_BIND_IP,
     51 	RDMA_USER_CM_CMD_RESOLVE_IP,
     52 	RDMA_USER_CM_CMD_RESOLVE_ROUTE,
     53 	RDMA_USER_CM_CMD_QUERY_ROUTE,
     54 	RDMA_USER_CM_CMD_CONNECT,
     55 	RDMA_USER_CM_CMD_LISTEN,
     56 	RDMA_USER_CM_CMD_ACCEPT,
     57 	RDMA_USER_CM_CMD_REJECT,
     58 	RDMA_USER_CM_CMD_DISCONNECT,
     59 	RDMA_USER_CM_CMD_INIT_QP_ATTR,
     60 	RDMA_USER_CM_CMD_GET_EVENT,
     61 	RDMA_USER_CM_CMD_GET_OPTION,
     62 	RDMA_USER_CM_CMD_SET_OPTION,
     63 	RDMA_USER_CM_CMD_NOTIFY,
     64 	RDMA_USER_CM_CMD_JOIN_IP_MCAST,
     65 	RDMA_USER_CM_CMD_LEAVE_MCAST,
     66 	RDMA_USER_CM_CMD_MIGRATE_ID,
     67 	RDMA_USER_CM_CMD_QUERY,
     68 	RDMA_USER_CM_CMD_BIND,
     69 	RDMA_USER_CM_CMD_RESOLVE_ADDR,
     70 	RDMA_USER_CM_CMD_JOIN_MCAST
     71 };
     72 
     73 /* See IBTA Annex A11, servies ID bytes 4 & 5 */
     74 enum rdma_ucm_port_space {
     75 	RDMA_PS_IPOIB = 0x0002,
     76 	RDMA_PS_IB    = 0x013F,
     77 	RDMA_PS_TCP   = 0x0106,
     78 	RDMA_PS_UDP   = 0x0111,
     79 };
     80 
     81 /*
     82  * command ABI structures.
     83  */
     84 struct rdma_ucm_cmd_hdr {
     85 	__u32 cmd;
     86 	__u16 in;
     87 	__u16 out;
     88 };
     89 
     90 struct rdma_ucm_create_id {
     91 	__aligned_u64 uid;
     92 	__aligned_u64 response;
     93 	__u16 ps;                  /* use enum rdma_ucm_port_space */
     94 	__u8  qp_type;
     95 	__u8  reserved[5];
     96 };
     97 
     98 struct rdma_ucm_create_id_resp {
     99 	__u32 id;
    100 };
    101 
    102 struct rdma_ucm_destroy_id {
    103 	__aligned_u64 response;
    104 	__u32 id;
    105 	__u32 reserved;
    106 };
    107 
    108 struct rdma_ucm_destroy_id_resp {
    109 	__u32 events_reported;
    110 };
    111 
    112 struct rdma_ucm_bind_ip {
    113 	__aligned_u64 response;
    114 	struct sockaddr_in6 addr;
    115 	__u32 id;
    116 };
    117 
    118 struct rdma_ucm_bind {
    119 	__u32 id;
    120 	__u16 addr_size;
    121 	__u16 reserved;
    122 	struct __kernel_sockaddr_storage addr;
    123 };
    124 
    125 struct rdma_ucm_resolve_ip {
    126 	struct sockaddr_in6 src_addr;
    127 	struct sockaddr_in6 dst_addr;
    128 	__u32 id;
    129 	__u32 timeout_ms;
    130 };
    131 
    132 struct rdma_ucm_resolve_addr {
    133 	__u32 id;
    134 	__u32 timeout_ms;
    135 	__u16 src_size;
    136 	__u16 dst_size;
    137 	__u32 reserved;
    138 	struct __kernel_sockaddr_storage src_addr;
    139 	struct __kernel_sockaddr_storage dst_addr;
    140 };
    141 
    142 struct rdma_ucm_resolve_route {
    143 	__u32 id;
    144 	__u32 timeout_ms;
    145 };
    146 
    147 enum {
    148 	RDMA_USER_CM_QUERY_ADDR,
    149 	RDMA_USER_CM_QUERY_PATH,
    150 	RDMA_USER_CM_QUERY_GID
    151 };
    152 
    153 struct rdma_ucm_query {
    154 	__aligned_u64 response;
    155 	__u32 id;
    156 	__u32 option;
    157 };
    158 
    159 struct rdma_ucm_query_route_resp {
    160 	__aligned_u64 node_guid;
    161 	struct ib_user_path_rec ib_route[2];
    162 	struct sockaddr_in6 src_addr;
    163 	struct sockaddr_in6 dst_addr;
    164 	__u32 num_paths;
    165 	__u8 port_num;
    166 	__u8 reserved[3];
    167 };
    168 
    169 struct rdma_ucm_query_addr_resp {
    170 	__aligned_u64 node_guid;
    171 	__u8  port_num;
    172 	__u8  reserved;
    173 	__u16 pkey;
    174 	__u16 src_size;
    175 	__u16 dst_size;
    176 	struct __kernel_sockaddr_storage src_addr;
    177 	struct __kernel_sockaddr_storage dst_addr;
    178 };
    179 
    180 struct rdma_ucm_query_path_resp {
    181 	__u32 num_paths;
    182 	__u32 reserved;
    183 	struct ib_path_rec_data path_data[0];
    184 };
    185 
    186 struct rdma_ucm_conn_param {
    187 	__u32 qp_num;
    188 	__u32 qkey;
    189 	__u8  private_data[RDMA_MAX_PRIVATE_DATA];
    190 	__u8  private_data_len;
    191 	__u8  srq;
    192 	__u8  responder_resources;
    193 	__u8  initiator_depth;
    194 	__u8  flow_control;
    195 	__u8  retry_count;
    196 	__u8  rnr_retry_count;
    197 	__u8  valid;
    198 };
    199 
    200 struct rdma_ucm_ud_param {
    201 	__u32 qp_num;
    202 	__u32 qkey;
    203 	struct ib_uverbs_ah_attr ah_attr;
    204 	__u8  private_data[RDMA_MAX_PRIVATE_DATA];
    205 	__u8  private_data_len;
    206 	__u8  reserved[7];
    207 };
    208 
    209 struct rdma_ucm_connect {
    210 	struct rdma_ucm_conn_param conn_param;
    211 	__u32 id;
    212 	__u32 reserved;
    213 };
    214 
    215 struct rdma_ucm_listen {
    216 	__u32 id;
    217 	__u32 backlog;
    218 };
    219 
    220 struct rdma_ucm_accept {
    221 	__aligned_u64 uid;
    222 	struct rdma_ucm_conn_param conn_param;
    223 	__u32 id;
    224 	__u32 reserved;
    225 };
    226 
    227 struct rdma_ucm_reject {
    228 	__u32 id;
    229 	__u8  private_data_len;
    230 	__u8  reserved[3];
    231 	__u8  private_data[RDMA_MAX_PRIVATE_DATA];
    232 };
    233 
    234 struct rdma_ucm_disconnect {
    235 	__u32 id;
    236 };
    237 
    238 struct rdma_ucm_init_qp_attr {
    239 	__aligned_u64 response;
    240 	__u32 id;
    241 	__u32 qp_state;
    242 };
    243 
    244 struct rdma_ucm_notify {
    245 	__u32 id;
    246 	__u32 event;
    247 };
    248 
    249 struct rdma_ucm_join_ip_mcast {
    250 	__aligned_u64 response;		/* rdma_ucm_create_id_resp */
    251 	__aligned_u64 uid;
    252 	struct sockaddr_in6 addr;
    253 	__u32 id;
    254 };
    255 
    256 /* Multicast join flags */
    257 enum {
    258 	RDMA_MC_JOIN_FLAG_FULLMEMBER,
    259 	RDMA_MC_JOIN_FLAG_SENDONLY_FULLMEMBER,
    260 	RDMA_MC_JOIN_FLAG_RESERVED,
    261 };
    262 
    263 struct rdma_ucm_join_mcast {
    264 	__aligned_u64 response;		/* rdma_ucma_create_id_resp */
    265 	__aligned_u64 uid;
    266 	__u32 id;
    267 	__u16 addr_size;
    268 	__u16 join_flags;
    269 	struct __kernel_sockaddr_storage addr;
    270 };
    271 
    272 struct rdma_ucm_get_event {
    273 	__aligned_u64 response;
    274 };
    275 
    276 struct rdma_ucm_event_resp {
    277 	__aligned_u64 uid;
    278 	__u32 id;
    279 	__u32 event;
    280 	__u32 status;
    281 	/*
    282 	 * NOTE: This union is not aligned to 8 bytes so none of the union
    283 	 * members may contain a u64 or anything with higher alignment than 4.
    284 	 */
    285 	union {
    286 		struct rdma_ucm_conn_param conn;
    287 		struct rdma_ucm_ud_param   ud;
    288 	} param;
    289 	__u32 reserved;
    290 };
    291 
    292 /* Option levels */
    293 enum {
    294 	RDMA_OPTION_ID		= 0,
    295 	RDMA_OPTION_IB		= 1
    296 };
    297 
    298 /* Option details */
    299 enum {
    300 	RDMA_OPTION_ID_TOS	 = 0,
    301 	RDMA_OPTION_ID_REUSEADDR = 1,
    302 	RDMA_OPTION_ID_AFONLY	 = 2,
    303 	RDMA_OPTION_IB_PATH	 = 1
    304 };
    305 
    306 struct rdma_ucm_set_option {
    307 	__aligned_u64 optval;
    308 	__u32 id;
    309 	__u32 level;
    310 	__u32 optname;
    311 	__u32 optlen;
    312 };
    313 
    314 struct rdma_ucm_migrate_id {
    315 	__aligned_u64 response;
    316 	__u32 id;
    317 	__u32 fd;
    318 };
    319 
    320 struct rdma_ucm_migrate_resp {
    321 	__u32 events_reported;
    322 };
    323 
    324 #endif /* RDMA_USER_CM_H */
    325