1 /* SPDX-License-Identifier: BSD-3-Clause
2 * Copyright 2018 6WIND S.A.
3 * Copyright 2018 Mellanox Technologies, Ltd
4 */
5
6 #ifndef RTE_PMD_MLX5_COMMON_MP_H_
7 #define RTE_PMD_MLX5_COMMON_MP_H_
8
9 #include <mlx5_glue.h>
10 #include <rte_eal.h>
11 #include <rte_string_fns.h>
12
13 /* Request types for IPC. */
14 enum mlx5_mp_req_type {
15 MLX5_MP_REQ_VERBS_CMD_FD = 1,
16 MLX5_MP_REQ_CREATE_MR,
17 MLX5_MP_REQ_MEMPOOL_REGISTER,
18 MLX5_MP_REQ_MEMPOOL_UNREGISTER,
19 MLX5_MP_REQ_START_RXTX,
20 MLX5_MP_REQ_STOP_RXTX,
21 MLX5_MP_REQ_QUEUE_STATE_MODIFY,
22 MLX5_MP_REQ_QUEUE_RX_STOP,
23 MLX5_MP_REQ_QUEUE_RX_START,
24 MLX5_MP_REQ_QUEUE_TX_STOP,
25 MLX5_MP_REQ_QUEUE_TX_START,
26 };
27
28 struct mlx5_mp_arg_queue_state_modify {
29 uint8_t is_wq; /* Set if WQ. */
30 uint16_t queue_id; /* DPDK queue ID. */
31 enum ibv_wq_state state; /* WQ requested state. */
32 };
33
34 struct mlx5_mp_arg_queue_id {
35 uint16_t queue_id; /* DPDK queue ID. */
36 };
37
38 struct mlx5_mp_arg_mr_manage {
39 struct mlx5_common_device *cdev;
40 RTE_STD_C11
41 union {
42 struct {
43 struct rte_mempool *mempool;
44 bool is_extmem;
45 }; /* MLX5_MP_REQ_MEMPOOL_(UN)REGISTER */
46 uintptr_t addr; /* MLX5_MP_REQ_CREATE_MR */
47 };
48 };
49
50 /* Parameters for IPC. */
51 struct mlx5_mp_param {
52 enum mlx5_mp_req_type type;
53 int port_id;
54 int result;
55 RTE_STD_C11
56 union {
57 struct mlx5_mp_arg_mr_manage mr_manage;
58 /* MLX5_MP_REQ_MEMPOOL_(UN)REGISTER, MLX5_MP_REQ_CREATE_MR */
59 struct mlx5_mp_arg_queue_state_modify state_modify;
60 /* MLX5_MP_REQ_QUEUE_STATE_MODIFY */
61 struct mlx5_mp_arg_queue_id queue_id;
62 /* MLX5_MP_REQ_QUEUE_RX/TX_START/STOP */
63 } args;
64 };
65
66 /* Identifier of a MP process */
67 struct mlx5_mp_id {
68 char name[RTE_MP_MAX_NAME_LEN];
69 uint16_t port_id;
70 };
71
72 /** Key string for IPC. */
73 #define MLX5_MP_NAME "common_mlx5_mp"
74
75 /** Initialize a multi-process ID. */
76 static inline void
mlx5_mp_id_init(struct mlx5_mp_id * mp_id,uint16_t port_id)77 mlx5_mp_id_init(struct mlx5_mp_id *mp_id, uint16_t port_id)
78 {
79 mp_id->port_id = port_id;
80 strlcpy(mp_id->name, MLX5_MP_NAME, RTE_MP_MAX_NAME_LEN);
81 }
82
83 /** Request timeout for IPC. */
84 #define MLX5_MP_REQ_TIMEOUT_SEC 5
85
86 /**
87 * Initialize IPC message.
88 *
89 * @param[in] port_id
90 * Port ID of the device.
91 * @param[out] msg
92 * Pointer to message to fill in.
93 * @param[in] type
94 * Message type.
95 */
96 static inline void
mp_init_msg(struct mlx5_mp_id * mp_id,struct rte_mp_msg * msg,enum mlx5_mp_req_type type)97 mp_init_msg(struct mlx5_mp_id *mp_id, struct rte_mp_msg *msg,
98 enum mlx5_mp_req_type type)
99 {
100 struct mlx5_mp_param *param = (struct mlx5_mp_param *)msg->param;
101
102 memset(msg, 0, sizeof(*msg));
103 strlcpy(msg->name, mp_id->name, sizeof(msg->name));
104 msg->len_param = sizeof(*param);
105 param->type = type;
106 param->port_id = mp_id->port_id;
107 }
108
109 /**
110 * Initialize IPC port-agnostic message.
111 *
112 * @param[out] msg
113 * Pointer to message to fill in.
114 * @param[in] type
115 * Message type.
116 */
117 static inline void
mp_init_port_agnostic_msg(struct rte_mp_msg * msg,enum mlx5_mp_req_type type)118 mp_init_port_agnostic_msg(struct rte_mp_msg *msg, enum mlx5_mp_req_type type)
119 {
120 struct mlx5_mp_param *param = (struct mlx5_mp_param *)msg->param;
121
122 memset(msg, 0, sizeof(*msg));
123 strlcpy(msg->name, MLX5_MP_NAME, sizeof(msg->name));
124 msg->len_param = sizeof(*param);
125 param->type = type;
126 }
127
128 __rte_internal
129 int mlx5_mp_init_primary(const char *name, const rte_mp_t primary_action);
130 __rte_internal
131 void mlx5_mp_uninit_primary(const char *name);
132 __rte_internal
133 int mlx5_mp_init_secondary(const char *name, const rte_mp_t secondary_action);
134 __rte_internal
135 void mlx5_mp_uninit_secondary(const char *name);
136 __rte_internal
137 int mlx5_mp_req_mr_create(struct mlx5_common_device *cdev, uintptr_t addr);
138 __rte_internal
139 int mlx5_mp_req_mempool_reg(struct mlx5_common_device *cdev,
140 struct rte_mempool *mempool, bool reg,
141 bool is_extmem);
142 __rte_internal
143 int mlx5_mp_req_queue_state_modify(struct mlx5_mp_id *mp_id,
144 struct mlx5_mp_arg_queue_state_modify *sm);
145 __rte_internal
146 int mlx5_mp_req_verbs_cmd_fd(struct mlx5_mp_id *mp_id);
147
148 #endif /* RTE_PMD_MLX5_COMMON_MP_H_ */
149