xref: /dpdk/drivers/net/mlx5/mlx5_ethdev.c (revision f926cce3fa94298cdbed88c6bb37adfd0ca87a54)
1 /* SPDX-License-Identifier: BSD-3-Clause
2  * Copyright 2015 6WIND S.A.
3  * Copyright 2015 Mellanox Technologies, Ltd
4  */
5 
6 #include <stddef.h>
7 #include <unistd.h>
8 #include <string.h>
9 #include <stdint.h>
10 #include <stdlib.h>
11 #include <errno.h>
12 
13 #include <ethdev_driver.h>
14 #include <rte_bus_pci.h>
15 #include <rte_mbuf.h>
16 #include <rte_common.h>
17 #include <rte_interrupts.h>
18 #include <rte_malloc.h>
19 #include <rte_string_fns.h>
20 #include <rte_rwlock.h>
21 #include <rte_cycles.h>
22 
23 #include <mlx5_malloc.h>
24 
25 #include "mlx5_rxtx.h"
26 #include "mlx5_autoconf.h"
27 
28 /**
29  * Get the interface index from device name.
30  *
31  * @param[in] dev
32  *   Pointer to Ethernet device.
33  *
34  * @return
35  *   Nonzero interface index on success, zero otherwise and rte_errno is set.
36  */
37 unsigned int
38 mlx5_ifindex(const struct rte_eth_dev *dev)
39 {
40 	struct mlx5_priv *priv = dev->data->dev_private;
41 	unsigned int ifindex;
42 
43 	MLX5_ASSERT(priv);
44 	MLX5_ASSERT(priv->if_index);
45 	ifindex = priv->bond_ifindex > 0 ? priv->bond_ifindex : priv->if_index;
46 	if (!ifindex)
47 		rte_errno = ENXIO;
48 	return ifindex;
49 }
50 
51 /**
52  * DPDK callback for Ethernet device configuration.
53  *
54  * @param dev
55  *   Pointer to Ethernet device structure.
56  *
57  * @return
58  *   0 on success, a negative errno value otherwise and rte_errno is set.
59  */
60 int
61 mlx5_dev_configure(struct rte_eth_dev *dev)
62 {
63 	struct mlx5_priv *priv = dev->data->dev_private;
64 	unsigned int rxqs_n = dev->data->nb_rx_queues;
65 	unsigned int txqs_n = dev->data->nb_tx_queues;
66 	const uint8_t use_app_rss_key =
67 		!!dev->data->dev_conf.rx_adv_conf.rss_conf.rss_key;
68 	int ret = 0;
69 
70 	if (use_app_rss_key &&
71 	    (dev->data->dev_conf.rx_adv_conf.rss_conf.rss_key_len !=
72 	     MLX5_RSS_HASH_KEY_LEN)) {
73 		DRV_LOG(ERR, "port %u RSS key len must be %s Bytes long",
74 			dev->data->port_id, RTE_STR(MLX5_RSS_HASH_KEY_LEN));
75 		rte_errno = EINVAL;
76 		return -rte_errno;
77 	}
78 	priv->rss_conf.rss_key =
79 		mlx5_realloc(priv->rss_conf.rss_key, MLX5_MEM_RTE,
80 			    MLX5_RSS_HASH_KEY_LEN, 0, SOCKET_ID_ANY);
81 	if (!priv->rss_conf.rss_key) {
82 		DRV_LOG(ERR, "port %u cannot allocate RSS hash key memory (%u)",
83 			dev->data->port_id, rxqs_n);
84 		rte_errno = ENOMEM;
85 		return -rte_errno;
86 	}
87 
88 	if ((dev->data->dev_conf.txmode.offloads &
89 			DEV_TX_OFFLOAD_SEND_ON_TIMESTAMP) &&
90 			rte_mbuf_dyn_tx_timestamp_register(NULL, NULL) != 0) {
91 		DRV_LOG(ERR, "port %u cannot register Tx timestamp field/flag",
92 			dev->data->port_id);
93 		return -rte_errno;
94 	}
95 	memcpy(priv->rss_conf.rss_key,
96 	       use_app_rss_key ?
97 	       dev->data->dev_conf.rx_adv_conf.rss_conf.rss_key :
98 	       rss_hash_default_key,
99 	       MLX5_RSS_HASH_KEY_LEN);
100 	priv->rss_conf.rss_key_len = MLX5_RSS_HASH_KEY_LEN;
101 	priv->rss_conf.rss_hf = dev->data->dev_conf.rx_adv_conf.rss_conf.rss_hf;
102 	priv->rxqs = (void *)dev->data->rx_queues;
103 	priv->txqs = (void *)dev->data->tx_queues;
104 	if (txqs_n != priv->txqs_n) {
105 		DRV_LOG(INFO, "port %u Tx queues number update: %u -> %u",
106 			dev->data->port_id, priv->txqs_n, txqs_n);
107 		priv->txqs_n = txqs_n;
108 	}
109 	if (rxqs_n > priv->config.ind_table_max_size) {
110 		DRV_LOG(ERR, "port %u cannot handle this many Rx queues (%u)",
111 			dev->data->port_id, rxqs_n);
112 		rte_errno = EINVAL;
113 		return -rte_errno;
114 	}
115 	if (rxqs_n != priv->rxqs_n) {
116 		DRV_LOG(INFO, "port %u Rx queues number update: %u -> %u",
117 			dev->data->port_id, priv->rxqs_n, rxqs_n);
118 		priv->rxqs_n = rxqs_n;
119 	}
120 	priv->skip_default_rss_reta = 0;
121 	ret = mlx5_proc_priv_init(dev);
122 	if (ret)
123 		return ret;
124 	return 0;
125 }
126 
127 /**
128  * Configure default RSS reta.
129  *
130  * @param dev
131  *   Pointer to Ethernet device structure.
132  *
133  * @return
134  *   0 on success, a negative errno value otherwise and rte_errno is set.
135  */
136 int
137 mlx5_dev_configure_rss_reta(struct rte_eth_dev *dev)
138 {
139 	struct mlx5_priv *priv = dev->data->dev_private;
140 	unsigned int rxqs_n = dev->data->nb_rx_queues;
141 	unsigned int i;
142 	unsigned int j;
143 	unsigned int reta_idx_n;
144 	int ret = 0;
145 	unsigned int *rss_queue_arr = NULL;
146 	unsigned int rss_queue_n = 0;
147 
148 	if (priv->skip_default_rss_reta)
149 		return ret;
150 	rss_queue_arr = mlx5_malloc(0, rxqs_n * sizeof(unsigned int), 0,
151 				    SOCKET_ID_ANY);
152 	if (!rss_queue_arr) {
153 		DRV_LOG(ERR, "port %u cannot allocate RSS queue list (%u)",
154 			dev->data->port_id, rxqs_n);
155 		rte_errno = ENOMEM;
156 		return -rte_errno;
157 	}
158 	for (i = 0, j = 0; i < rxqs_n; i++) {
159 		struct mlx5_rxq_data *rxq_data;
160 		struct mlx5_rxq_ctrl *rxq_ctrl;
161 
162 		rxq_data = (*priv->rxqs)[i];
163 		rxq_ctrl = container_of(rxq_data, struct mlx5_rxq_ctrl, rxq);
164 		if (rxq_ctrl && rxq_ctrl->type == MLX5_RXQ_TYPE_STANDARD)
165 			rss_queue_arr[j++] = i;
166 	}
167 	rss_queue_n = j;
168 	if (rss_queue_n > priv->config.ind_table_max_size) {
169 		DRV_LOG(ERR, "port %u cannot handle this many Rx queues (%u)",
170 			dev->data->port_id, rss_queue_n);
171 		rte_errno = EINVAL;
172 		mlx5_free(rss_queue_arr);
173 		return -rte_errno;
174 	}
175 	DRV_LOG(INFO, "port %u Rx queues number update: %u -> %u",
176 		dev->data->port_id, priv->rxqs_n, rxqs_n);
177 	priv->rxqs_n = rxqs_n;
178 	/*
179 	 * If the requested number of RX queues is not a power of two,
180 	 * use the maximum indirection table size for better balancing.
181 	 * The result is always rounded to the next power of two.
182 	 */
183 	reta_idx_n = (1 << log2above((rss_queue_n & (rss_queue_n - 1)) ?
184 				priv->config.ind_table_max_size :
185 				rss_queue_n));
186 	ret = mlx5_rss_reta_index_resize(dev, reta_idx_n);
187 	if (ret) {
188 		mlx5_free(rss_queue_arr);
189 		return ret;
190 	}
191 	/*
192 	 * When the number of RX queues is not a power of two,
193 	 * the remaining table entries are padded with reused WQs
194 	 * and hashes are not spread uniformly.
195 	 */
196 	for (i = 0, j = 0; (i != reta_idx_n); ++i) {
197 		(*priv->reta_idx)[i] = rss_queue_arr[j];
198 		if (++j == rss_queue_n)
199 			j = 0;
200 	}
201 	mlx5_free(rss_queue_arr);
202 	return ret;
203 }
204 
205 /**
206  * Sets default tuning parameters.
207  *
208  * @param dev
209  *   Pointer to Ethernet device.
210  * @param[out] info
211  *   Info structure output buffer.
212  */
213 static void
214 mlx5_set_default_params(struct rte_eth_dev *dev, struct rte_eth_dev_info *info)
215 {
216 	struct mlx5_priv *priv = dev->data->dev_private;
217 
218 	/* Minimum CPU utilization. */
219 	info->default_rxportconf.ring_size = 256;
220 	info->default_txportconf.ring_size = 256;
221 	info->default_rxportconf.burst_size = MLX5_RX_DEFAULT_BURST;
222 	info->default_txportconf.burst_size = MLX5_TX_DEFAULT_BURST;
223 	if ((priv->link_speed_capa & ETH_LINK_SPEED_200G) |
224 		(priv->link_speed_capa & ETH_LINK_SPEED_100G)) {
225 		info->default_rxportconf.nb_queues = 16;
226 		info->default_txportconf.nb_queues = 16;
227 		if (dev->data->nb_rx_queues > 2 ||
228 		    dev->data->nb_tx_queues > 2) {
229 			/* Max Throughput. */
230 			info->default_rxportconf.ring_size = 2048;
231 			info->default_txportconf.ring_size = 2048;
232 		}
233 	} else {
234 		info->default_rxportconf.nb_queues = 8;
235 		info->default_txportconf.nb_queues = 8;
236 		if (dev->data->nb_rx_queues > 2 ||
237 		    dev->data->nb_tx_queues > 2) {
238 			/* Max Throughput. */
239 			info->default_rxportconf.ring_size = 4096;
240 			info->default_txportconf.ring_size = 4096;
241 		}
242 	}
243 }
244 
245 /**
246  * Sets tx mbuf limiting parameters.
247  *
248  * @param dev
249  *   Pointer to Ethernet device.
250  * @param[out] info
251  *   Info structure output buffer.
252  */
253 static void
254 mlx5_set_txlimit_params(struct rte_eth_dev *dev, struct rte_eth_dev_info *info)
255 {
256 	struct mlx5_priv *priv = dev->data->dev_private;
257 	struct mlx5_dev_config *config = &priv->config;
258 	unsigned int inlen;
259 	uint16_t nb_max;
260 
261 	inlen = (config->txq_inline_max == MLX5_ARG_UNSET) ?
262 		MLX5_SEND_DEF_INLINE_LEN :
263 		(unsigned int)config->txq_inline_max;
264 	MLX5_ASSERT(config->txq_inline_min >= 0);
265 	inlen = RTE_MAX(inlen, (unsigned int)config->txq_inline_min);
266 	inlen = RTE_MIN(inlen, MLX5_WQE_SIZE_MAX +
267 			       MLX5_ESEG_MIN_INLINE_SIZE -
268 			       MLX5_WQE_CSEG_SIZE -
269 			       MLX5_WQE_ESEG_SIZE -
270 			       MLX5_WQE_DSEG_SIZE * 2);
271 	nb_max = (MLX5_WQE_SIZE_MAX +
272 		  MLX5_ESEG_MIN_INLINE_SIZE -
273 		  MLX5_WQE_CSEG_SIZE -
274 		  MLX5_WQE_ESEG_SIZE -
275 		  MLX5_WQE_DSEG_SIZE -
276 		  inlen) / MLX5_WSEG_SIZE;
277 	info->tx_desc_lim.nb_seg_max = nb_max;
278 	info->tx_desc_lim.nb_mtu_seg_max = nb_max;
279 }
280 
281 /**
282  * DPDK callback to get information about the device.
283  *
284  * @param dev
285  *   Pointer to Ethernet device structure.
286  * @param[out] info
287  *   Info structure output buffer.
288  */
289 int
290 mlx5_dev_infos_get(struct rte_eth_dev *dev, struct rte_eth_dev_info *info)
291 {
292 	struct mlx5_priv *priv = dev->data->dev_private;
293 	struct mlx5_dev_config *config = &priv->config;
294 	unsigned int max;
295 
296 	/* FIXME: we should ask the device for these values. */
297 	info->min_rx_bufsize = 32;
298 	info->max_rx_pktlen = 65536;
299 	info->max_lro_pkt_size = MLX5_MAX_LRO_SIZE;
300 	/*
301 	 * Since we need one CQ per QP, the limit is the minimum number
302 	 * between the two values.
303 	 */
304 	max = RTE_MIN(priv->sh->device_attr.max_cq,
305 		      priv->sh->device_attr.max_qp);
306 	/* max_rx_queues is uint16_t. */
307 	max = RTE_MIN(max, (unsigned int)UINT16_MAX);
308 	info->max_rx_queues = max;
309 	info->max_tx_queues = max;
310 	info->max_mac_addrs = MLX5_MAX_UC_MAC_ADDRESSES;
311 	info->rx_queue_offload_capa = mlx5_get_rx_queue_offloads(dev);
312 	info->rx_seg_capa.max_nseg = MLX5_MAX_RXQ_NSEG;
313 	info->rx_seg_capa.multi_pools = !config->mprq.enabled;
314 	info->rx_seg_capa.offset_allowed = !config->mprq.enabled;
315 	info->rx_seg_capa.offset_align_log2 = 0;
316 	info->rx_offload_capa = (mlx5_get_rx_port_offloads() |
317 				 info->rx_queue_offload_capa);
318 	info->tx_offload_capa = mlx5_get_tx_port_offloads(dev);
319 	info->if_index = mlx5_ifindex(dev);
320 	info->reta_size = priv->reta_idx_n ?
321 		priv->reta_idx_n : config->ind_table_max_size;
322 	info->hash_key_size = MLX5_RSS_HASH_KEY_LEN;
323 	info->speed_capa = priv->link_speed_capa;
324 	info->flow_type_rss_offloads = ~MLX5_RSS_HF_MASK;
325 	mlx5_set_default_params(dev, info);
326 	mlx5_set_txlimit_params(dev, info);
327 	info->switch_info.name = dev->data->name;
328 	info->switch_info.domain_id = priv->domain_id;
329 	info->switch_info.port_id = priv->representor_id;
330 	if (priv->representor) {
331 		uint16_t port_id;
332 
333 		MLX5_ETH_FOREACH_DEV(port_id, priv->pci_dev) {
334 			struct mlx5_priv *opriv =
335 				rte_eth_devices[port_id].data->dev_private;
336 
337 			if (!opriv ||
338 			    opriv->representor ||
339 			    opriv->sh != priv->sh ||
340 			    opriv->domain_id != priv->domain_id)
341 				continue;
342 			/*
343 			 * Override switch name with that of the master
344 			 * device.
345 			 */
346 			info->switch_info.name = opriv->dev_data->name;
347 			break;
348 		}
349 	}
350 	return 0;
351 }
352 
353 /**
354  * Calculate representor ID from port switch info.
355  *
356  * Uint16 representor ID bits definition:
357  *   pf: 2
358  *   type: 2
359  *   vf/sf: 12
360  *
361  * @param info
362  *   Port switch info.
363  *
364  * @return
365  *   Encoded representor ID.
366  */
367 uint16_t
368 mlx5_representor_id_encode(const struct mlx5_switch_info *info)
369 {
370 	enum rte_eth_representor_type type = RTE_ETH_REPRESENTOR_VF;
371 	uint16_t repr = info->port_name;
372 
373 	if (info->representor == 0)
374 		return UINT16_MAX;
375 	if (info->name_type == MLX5_PHYS_PORT_NAME_TYPE_PFSF)
376 		type = RTE_ETH_REPRESENTOR_SF;
377 	if (info->name_type == MLX5_PHYS_PORT_NAME_TYPE_PFHPF)
378 		repr = UINT16_MAX;
379 	return MLX5_REPRESENTOR_ID(info->pf_num, type, repr);
380 }
381 
382 /**
383  * DPDK callback to get information about representor.
384  *
385  * Representor ID bits definition:
386  *   vf/sf: 12
387  *   type: 2
388  *   pf: 2
389  *
390  * @param dev
391  *   Pointer to Ethernet device structure.
392  * @param[out] info
393  *   Nullable info structure output buffer.
394  *
395  * @return
396  *   negative on error, or the number of representor ranges.
397  */
398 int
399 mlx5_representor_info_get(struct rte_eth_dev *dev,
400 			  struct rte_eth_representor_info *info)
401 {
402 	struct mlx5_priv *priv = dev->data->dev_private;
403 	int n_type = 3; /* Number of representor types, VF, HPF and SF. */
404 	int n_pf = 2; /* Number of PFs. */
405 	int i = 0, pf;
406 
407 	if (info == NULL)
408 		goto out;
409 	info->controller = 0;
410 	info->pf = priv->pf_bond >= 0 ? priv->pf_bond : 0;
411 	for (pf = 0; pf < n_pf; ++pf) {
412 		/* VF range. */
413 		info->ranges[i].type = RTE_ETH_REPRESENTOR_VF;
414 		info->ranges[i].controller = 0;
415 		info->ranges[i].pf = pf;
416 		info->ranges[i].vf = 0;
417 		info->ranges[i].id_base =
418 			MLX5_REPRESENTOR_ID(pf, info->ranges[i].type, 0);
419 		info->ranges[i].id_end =
420 			MLX5_REPRESENTOR_ID(pf, info->ranges[i].type, -1);
421 		snprintf(info->ranges[i].name,
422 			 sizeof(info->ranges[i].name), "pf%dvf", pf);
423 		i++;
424 		/* HPF range. */
425 		info->ranges[i].type = RTE_ETH_REPRESENTOR_VF;
426 		info->ranges[i].controller = 0;
427 		info->ranges[i].pf = pf;
428 		info->ranges[i].vf = UINT16_MAX;
429 		info->ranges[i].id_base =
430 			MLX5_REPRESENTOR_ID(pf, info->ranges[i].type, -1);
431 		info->ranges[i].id_end =
432 			MLX5_REPRESENTOR_ID(pf, info->ranges[i].type, -1);
433 		snprintf(info->ranges[i].name,
434 			 sizeof(info->ranges[i].name), "pf%dvf", pf);
435 		i++;
436 		/* SF range. */
437 		info->ranges[i].type = RTE_ETH_REPRESENTOR_SF;
438 		info->ranges[i].controller = 0;
439 		info->ranges[i].pf = pf;
440 		info->ranges[i].vf = 0;
441 		info->ranges[i].id_base =
442 			MLX5_REPRESENTOR_ID(pf, info->ranges[i].type, 0);
443 		info->ranges[i].id_end =
444 			MLX5_REPRESENTOR_ID(pf, info->ranges[i].type, -1);
445 		snprintf(info->ranges[i].name,
446 			 sizeof(info->ranges[i].name), "pf%dsf", pf);
447 		i++;
448 	}
449 out:
450 	return n_type * n_pf;
451 }
452 
453 /**
454  * Get firmware version of a device.
455  *
456  * @param dev
457  *   Ethernet device port.
458  * @param fw_ver
459  *   String output allocated by caller.
460  * @param fw_size
461  *   Size of the output string, including terminating null byte.
462  *
463  * @return
464  *   0 on success, or the size of the non truncated string if too big.
465  */
466 int
467 mlx5_fw_version_get(struct rte_eth_dev *dev, char *fw_ver, size_t fw_size)
468 {
469 	struct mlx5_priv *priv = dev->data->dev_private;
470 	struct mlx5_dev_attr *attr = &priv->sh->device_attr;
471 	size_t size = strnlen(attr->fw_ver, sizeof(attr->fw_ver)) + 1;
472 
473 	if (fw_size < size)
474 		return size;
475 	if (fw_ver != NULL)
476 		strlcpy(fw_ver, attr->fw_ver, fw_size);
477 	return 0;
478 }
479 
480 /**
481  * Get supported packet types.
482  *
483  * @param dev
484  *   Pointer to Ethernet device structure.
485  *
486  * @return
487  *   A pointer to the supported Packet types array.
488  */
489 const uint32_t *
490 mlx5_dev_supported_ptypes_get(struct rte_eth_dev *dev)
491 {
492 	static const uint32_t ptypes[] = {
493 		/* refers to rxq_cq_to_pkt_type() */
494 		RTE_PTYPE_L2_ETHER,
495 		RTE_PTYPE_L3_IPV4_EXT_UNKNOWN,
496 		RTE_PTYPE_L3_IPV6_EXT_UNKNOWN,
497 		RTE_PTYPE_L4_NONFRAG,
498 		RTE_PTYPE_L4_FRAG,
499 		RTE_PTYPE_L4_TCP,
500 		RTE_PTYPE_L4_UDP,
501 		RTE_PTYPE_INNER_L3_IPV4_EXT_UNKNOWN,
502 		RTE_PTYPE_INNER_L3_IPV6_EXT_UNKNOWN,
503 		RTE_PTYPE_INNER_L4_NONFRAG,
504 		RTE_PTYPE_INNER_L4_FRAG,
505 		RTE_PTYPE_INNER_L4_TCP,
506 		RTE_PTYPE_INNER_L4_UDP,
507 		RTE_PTYPE_UNKNOWN
508 	};
509 
510 	if (dev->rx_pkt_burst == mlx5_rx_burst ||
511 	    dev->rx_pkt_burst == mlx5_rx_burst_mprq ||
512 	    dev->rx_pkt_burst == mlx5_rx_burst_vec ||
513 	    dev->rx_pkt_burst == mlx5_rx_burst_mprq_vec)
514 		return ptypes;
515 	return NULL;
516 }
517 
518 /**
519  * DPDK callback to change the MTU.
520  *
521  * @param dev
522  *   Pointer to Ethernet device structure.
523  * @param in_mtu
524  *   New MTU.
525  *
526  * @return
527  *   0 on success, a negative errno value otherwise and rte_errno is set.
528  */
529 int
530 mlx5_dev_set_mtu(struct rte_eth_dev *dev, uint16_t mtu)
531 {
532 	struct mlx5_priv *priv = dev->data->dev_private;
533 	uint16_t kern_mtu = 0;
534 	int ret;
535 
536 	ret = mlx5_get_mtu(dev, &kern_mtu);
537 	if (ret)
538 		return ret;
539 	/* Set kernel interface MTU first. */
540 	ret = mlx5_set_mtu(dev, mtu);
541 	if (ret)
542 		return ret;
543 	ret = mlx5_get_mtu(dev, &kern_mtu);
544 	if (ret)
545 		return ret;
546 	if (kern_mtu == mtu) {
547 		priv->mtu = mtu;
548 		DRV_LOG(DEBUG, "port %u adapter MTU set to %u",
549 			dev->data->port_id, mtu);
550 		return 0;
551 	}
552 	rte_errno = EAGAIN;
553 	return -rte_errno;
554 }
555 
556 /**
557  * Configure the RX function to use.
558  *
559  * @param dev
560  *   Pointer to private data structure.
561  *
562  * @return
563  *   Pointer to selected Rx burst function.
564  */
565 eth_rx_burst_t
566 mlx5_select_rx_function(struct rte_eth_dev *dev)
567 {
568 	eth_rx_burst_t rx_pkt_burst = mlx5_rx_burst;
569 
570 	MLX5_ASSERT(dev != NULL);
571 	if (mlx5_check_vec_rx_support(dev) > 0) {
572 		if (mlx5_mprq_enabled(dev)) {
573 			rx_pkt_burst = mlx5_rx_burst_mprq_vec;
574 			DRV_LOG(DEBUG, "port %u selected vectorized"
575 				" MPRQ Rx function", dev->data->port_id);
576 		} else {
577 			rx_pkt_burst = mlx5_rx_burst_vec;
578 			DRV_LOG(DEBUG, "port %u selected vectorized"
579 				" SPRQ Rx function", dev->data->port_id);
580 		}
581 	} else if (mlx5_mprq_enabled(dev)) {
582 		rx_pkt_burst = mlx5_rx_burst_mprq;
583 		DRV_LOG(DEBUG, "port %u selected MPRQ Rx function",
584 			dev->data->port_id);
585 	} else {
586 		DRV_LOG(DEBUG, "port %u selected SPRQ Rx function",
587 			dev->data->port_id);
588 	}
589 	return rx_pkt_burst;
590 }
591 
592 /**
593  * Get the E-Switch parameters by port id.
594  *
595  * @param[in] port
596  *   Device port id.
597  * @param[in] valid
598  *   Device port id is valid, skip check. This flag is useful
599  *   when trials are performed from probing and device is not
600  *   flagged as valid yet (in attaching process).
601  * @param[out] es_domain_id
602  *   E-Switch domain id.
603  * @param[out] es_port_id
604  *   The port id of the port in the E-Switch.
605  *
606  * @return
607  *   pointer to device private data structure containing data needed
608  *   on success, NULL otherwise and rte_errno is set.
609  */
610 struct mlx5_priv *
611 mlx5_port_to_eswitch_info(uint16_t port, bool valid)
612 {
613 	struct rte_eth_dev *dev;
614 	struct mlx5_priv *priv;
615 
616 	if (port >= RTE_MAX_ETHPORTS) {
617 		rte_errno = EINVAL;
618 		return NULL;
619 	}
620 	if (!valid && !rte_eth_dev_is_valid_port(port)) {
621 		rte_errno = ENODEV;
622 		return NULL;
623 	}
624 	dev = &rte_eth_devices[port];
625 	priv = dev->data->dev_private;
626 	if (!(priv->representor || priv->master)) {
627 		rte_errno = EINVAL;
628 		return NULL;
629 	}
630 	return priv;
631 }
632 
633 /**
634  * Get the E-Switch parameters by device instance.
635  *
636  * @param[in] port
637  *   Device port id.
638  * @param[out] es_domain_id
639  *   E-Switch domain id.
640  * @param[out] es_port_id
641  *   The port id of the port in the E-Switch.
642  *
643  * @return
644  *   pointer to device private data structure containing data needed
645  *   on success, NULL otherwise and rte_errno is set.
646  */
647 struct mlx5_priv *
648 mlx5_dev_to_eswitch_info(struct rte_eth_dev *dev)
649 {
650 	struct mlx5_priv *priv;
651 
652 	priv = dev->data->dev_private;
653 	if (!(priv->representor || priv->master)) {
654 		rte_errno = EINVAL;
655 		return NULL;
656 	}
657 	return priv;
658 }
659 
660 /**
661  * DPDK callback to retrieve hairpin capabilities.
662  *
663  * @param dev
664  *   Pointer to Ethernet device structure.
665  * @param[out] cap
666  *   Storage for hairpin capability data.
667  *
668  * @return
669  *   0 on success, a negative errno value otherwise and rte_errno is set.
670  */
671 int
672 mlx5_hairpin_cap_get(struct rte_eth_dev *dev, struct rte_eth_hairpin_cap *cap)
673 {
674 	struct mlx5_priv *priv = dev->data->dev_private;
675 	struct mlx5_dev_config *config = &priv->config;
676 
677 	if (!priv->sh->devx || !config->dest_tir || !config->dv_flow_en) {
678 		rte_errno = ENOTSUP;
679 		return -rte_errno;
680 	}
681 	cap->max_nb_queues = UINT16_MAX;
682 	cap->max_rx_2_tx = 1;
683 	cap->max_tx_2_rx = 1;
684 	cap->max_nb_desc = 8192;
685 	return 0;
686 }
687