2017-12-19 15:49:01 +00:00
|
|
|
/* SPDX-License-Identifier: BSD-3-Clause
|
|
|
|
* Copyright(c) 2010-2015 Intel Corporation
|
2013-09-18 12:00:00 +02:00
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef _VIRTIO_ETHDEV_H_
|
|
|
|
#define _VIRTIO_ETHDEV_H_
|
|
|
|
|
|
|
|
#include <stdint.h>
|
|
|
|
|
|
|
|
#include "virtio_pci.h"
|
|
|
|
|
|
|
|
#ifndef PAGE_SIZE
|
|
|
|
#define PAGE_SIZE 4096
|
|
|
|
#endif
|
|
|
|
|
2016-10-13 16:16:01 +02:00
|
|
|
#define VIRTIO_MAX_RX_QUEUES 128U
|
|
|
|
#define VIRTIO_MAX_TX_QUEUES 128U
|
2015-02-09 09:14:03 +08:00
|
|
|
#define VIRTIO_MAX_MAC_ADDRS 64
|
2013-09-18 12:00:00 +02:00
|
|
|
#define VIRTIO_MIN_RX_BUFSIZE 64
|
2017-03-12 17:34:04 +01:00
|
|
|
#define VIRTIO_MAX_RX_PKTLEN 9728U
|
2013-09-18 12:00:00 +02:00
|
|
|
|
|
|
|
/* Features desired/implemented by this driver. */
|
2016-10-13 16:16:08 +02:00
|
|
|
#define VIRTIO_PMD_DEFAULT_GUEST_FEATURES \
|
2015-06-11 08:53:26 -07:00
|
|
|
(1u << VIRTIO_NET_F_MAC | \
|
|
|
|
1u << VIRTIO_NET_F_STATUS | \
|
|
|
|
1u << VIRTIO_NET_F_MQ | \
|
|
|
|
1u << VIRTIO_NET_F_CTRL_MAC_ADDR | \
|
|
|
|
1u << VIRTIO_NET_F_CTRL_VQ | \
|
|
|
|
1u << VIRTIO_NET_F_CTRL_RX | \
|
|
|
|
1u << VIRTIO_NET_F_CTRL_VLAN | \
|
virtio: support specification 1.0
Modern (v1.0) virtio pci device defines several pci capabilities.
Each cap has a configure structure corresponding to it, and the
cap.bar and cap.offset fields tell us where to find it.
Firstly, we map the pci resources by rte_eal_pci_map_device().
We then could easily locate a cfg structure by:
cfg_addr = dev->mem_resources[cap.bar].addr + cap.offset;
Therefore, the entrance of enabling modern (v1.0) pci device support
is to iterate the pci capability lists, and to locate some configs
we care; and they are:
- common cfg
For generic virtio and virtqueue configuration, such as setting/getting
features, enabling a specific queue, and so on.
- nofity cfg
Combining with `queue_notify_off' from common cfg, we could use it to
notify a specific virt queue.
- device cfg
Where virtio_net_config structure is located.
- isr cfg
Where to read isr (interrupt status).
If any of above cap is not found, we fallback to the legacy virtio
handling.
If succeed, hw->vtpci_ops is assigned to modern_ops, where all
operations are implemented by reading/writing a (or few) specific
configuration space from above 4 cfg structures. And that's basically
how this patch works.
Besides those changes, virtio 1.0 introduces a new status field:
FEATURES_OK, which is set after features negotiation is done.
Last, set the VIRTIO_F_VERSION_1 feature flag.
Signed-off-by: Yuanhan Liu <yuanhan.liu@linux.intel.com>
Tested-by: Qian Xu <qian.q.xu@intel.com>
Reviewed-by: Tetsuya Mukawa <mukawa@igel.co.jp>
Tested-by: Tetsuya Mukawa <mukawa@igel.co.jp>
Acked-by: Huawei Xie <huawei.xie@intel.com>
2016-02-02 21:48:19 +08:00
|
|
|
1u << VIRTIO_NET_F_MRG_RXBUF | \
|
2017-03-12 17:34:04 +01:00
|
|
|
1u << VIRTIO_NET_F_MTU | \
|
2018-01-18 10:20:38 +08:00
|
|
|
1ULL << VIRTIO_NET_F_GUEST_ANNOUNCE | \
|
2016-09-07 10:46:18 +08:00
|
|
|
1u << VIRTIO_RING_F_INDIRECT_DESC | \
|
2016-09-28 16:25:12 +08:00
|
|
|
1ULL << VIRTIO_F_VERSION_1 | \
|
2018-07-02 21:56:42 +08:00
|
|
|
1ULL << VIRTIO_F_IN_ORDER | \
|
2018-12-17 22:31:39 +01:00
|
|
|
1ULL << VIRTIO_F_RING_PACKED | \
|
2019-01-09 17:50:15 +03:00
|
|
|
1ULL << VIRTIO_F_IOMMU_PLATFORM | \
|
|
|
|
1ULL << VIRTIO_F_ORDER_PLATFORM)
|
2013-09-18 12:00:00 +02:00
|
|
|
|
2017-01-13 12:18:34 +00:00
|
|
|
#define VIRTIO_PMD_SUPPORTED_GUEST_FEATURES \
|
|
|
|
(VIRTIO_PMD_DEFAULT_GUEST_FEATURES | \
|
|
|
|
1u << VIRTIO_NET_F_GUEST_CSUM | \
|
|
|
|
1u << VIRTIO_NET_F_GUEST_TSO4 | \
|
2018-09-21 20:52:43 +08:00
|
|
|
1u << VIRTIO_NET_F_GUEST_TSO6 | \
|
|
|
|
1u << VIRTIO_NET_F_CSUM | \
|
|
|
|
1u << VIRTIO_NET_F_HOST_TSO4 | \
|
|
|
|
1u << VIRTIO_NET_F_HOST_TSO6)
|
2018-03-09 08:32:16 +08:00
|
|
|
|
2019-03-25 12:12:15 +08:00
|
|
|
extern const struct eth_dev_ops virtio_user_secondary_eth_dev_ops;
|
|
|
|
|
2014-05-29 15:18:20 +08:00
|
|
|
/*
|
|
|
|
* CQ function prototype
|
|
|
|
*/
|
|
|
|
void virtio_dev_cq_start(struct rte_eth_dev *dev);
|
|
|
|
|
2013-09-18 12:00:00 +02:00
|
|
|
/*
|
|
|
|
* RX/TX function prototypes
|
|
|
|
*/
|
2017-01-17 07:10:23 +00:00
|
|
|
|
|
|
|
int virtio_dev_rx_queue_done(void *rxq, uint16_t offset);
|
|
|
|
|
2013-09-18 12:00:00 +02:00
|
|
|
int virtio_dev_rx_queue_setup(struct rte_eth_dev *dev, uint16_t rx_queue_id,
|
|
|
|
uint16_t nb_rx_desc, unsigned int socket_id,
|
|
|
|
const struct rte_eth_rxconf *rx_conf,
|
|
|
|
struct rte_mempool *mb_pool);
|
|
|
|
|
2017-09-07 14:13:43 +02:00
|
|
|
int virtio_dev_rx_queue_setup_finish(struct rte_eth_dev *dev,
|
|
|
|
uint16_t rx_queue_id);
|
|
|
|
|
2013-09-18 12:00:00 +02:00
|
|
|
int virtio_dev_tx_queue_setup(struct rte_eth_dev *dev, uint16_t tx_queue_id,
|
|
|
|
uint16_t nb_tx_desc, unsigned int socket_id,
|
|
|
|
const struct rte_eth_txconf *tx_conf);
|
|
|
|
|
2017-09-07 14:13:43 +02:00
|
|
|
int virtio_dev_tx_queue_setup_finish(struct rte_eth_dev *dev,
|
|
|
|
uint16_t tx_queue_id);
|
|
|
|
|
2013-09-18 12:00:00 +02:00
|
|
|
uint16_t virtio_recv_pkts(void *rx_queue, struct rte_mbuf **rx_pkts,
|
|
|
|
uint16_t nb_pkts);
|
2018-12-17 22:31:35 +01:00
|
|
|
uint16_t virtio_recv_pkts_packed(void *rx_queue, struct rte_mbuf **rx_pkts,
|
|
|
|
uint16_t nb_pkts);
|
2013-09-18 12:00:00 +02:00
|
|
|
|
2014-08-14 16:54:35 +08:00
|
|
|
uint16_t virtio_recv_mergeable_pkts(void *rx_queue, struct rte_mbuf **rx_pkts,
|
|
|
|
uint16_t nb_pkts);
|
|
|
|
|
2018-12-17 22:31:35 +01:00
|
|
|
uint16_t virtio_recv_mergeable_pkts_packed(void *rx_queue,
|
|
|
|
struct rte_mbuf **rx_pkts, uint16_t nb_pkts);
|
|
|
|
|
2018-12-20 18:27:17 +01:00
|
|
|
uint16_t virtio_recv_pkts_inorder(void *rx_queue,
|
2018-07-02 21:56:40 +08:00
|
|
|
struct rte_mbuf **rx_pkts, uint16_t nb_pkts);
|
|
|
|
|
2019-06-17 12:31:37 +01:00
|
|
|
uint16_t virtio_xmit_pkts_prepare(void *tx_queue, struct rte_mbuf **tx_pkts,
|
|
|
|
uint16_t nb_pkts);
|
|
|
|
|
2013-09-18 12:00:00 +02:00
|
|
|
uint16_t virtio_xmit_pkts(void *tx_queue, struct rte_mbuf **tx_pkts,
|
|
|
|
uint16_t nb_pkts);
|
2018-12-17 22:31:34 +01:00
|
|
|
uint16_t virtio_xmit_pkts_packed(void *tx_queue, struct rte_mbuf **tx_pkts,
|
|
|
|
uint16_t nb_pkts);
|
2013-09-18 12:00:00 +02:00
|
|
|
|
2018-07-02 21:56:40 +08:00
|
|
|
uint16_t virtio_xmit_pkts_inorder(void *tx_queue, struct rte_mbuf **tx_pkts,
|
|
|
|
uint16_t nb_pkts);
|
|
|
|
|
2015-10-29 22:53:26 +08:00
|
|
|
uint16_t virtio_recv_pkts_vec(void *rx_queue, struct rte_mbuf **rx_pkts,
|
|
|
|
uint16_t nb_pkts);
|
2013-09-18 12:00:00 +02:00
|
|
|
|
2015-10-29 22:53:27 +08:00
|
|
|
uint16_t virtio_xmit_pkts_simple(void *tx_queue, struct rte_mbuf **tx_pkts,
|
|
|
|
uint16_t nb_pkts);
|
|
|
|
|
net/virtio-user: add virtual device
Add a new virtual device named virtio-user, which can be used just like
eth_ring, eth_null, etc. To reuse the code of original virtio, we do
some adjustment in virtio_ethdev.c, such as remove key _static_ of
eth_virtio_dev_init() so that it can be reused in virtual device; and
we add some check to make sure it will not crash.
Configured parameters include:
- queues (optional, 1 by default), number of queue pairs, multi-queue
not supported for now.
- cq (optional, 0 by default), not supported for now.
- mac (optional), random value will be given if not specified.
- queue_size (optional, 256 by default), size of virtqueues.
- path (madatory), path of vhost user.
When enable CONFIG_RTE_VIRTIO_USER (enabled by default), the compiled
library can be used in both VM and container environment.
Examples:
path_vhost=<path_to_vhost_user> # use vhost-user as a backend
sudo ./examples/l2fwd/build/l2fwd -c 0x100000 -n 4 \
--socket-mem 0,1024 --no-pci --file-prefix=l2fwd \
--vdev=virtio-user0,mac=00:01:02:03:04:05,path=$path_vhost -- -p 0x1
Known issues:
- Control queue and multi-queue are not supported yet.
- Cannot work with --huge-unlink.
- Cannot work with no-huge.
- Cannot work when there are more than VHOST_MEMORY_MAX_NREGIONS(8)
hugepages.
- Root privilege is a must (mainly becase of sorting hugepages according
to physical address).
- Applications should not use file name like HUGEFILE_FMT ("%smap_%d").
- Cannot work with vhost-net backend.
Signed-off-by: Huawei Xie <huawei.xie@intel.com>
Signed-off-by: Jianfeng Tan <jianfeng.tan@intel.com>
Acked-by: Neil Horman <nhorman@tuxdriver.com>
Acked-by: Yuanhan Liu <yuanhan.liu@linux.intel.com>
2016-06-15 09:03:25 +00:00
|
|
|
int eth_virtio_dev_init(struct rte_eth_dev *eth_dev);
|
|
|
|
|
2017-04-06 20:42:22 +08:00
|
|
|
void virtio_interrupt_handler(void *param);
|
2017-03-31 19:44:58 +00:00
|
|
|
|
2018-01-10 09:23:53 +08:00
|
|
|
int virtio_dev_pause(struct rte_eth_dev *dev);
|
|
|
|
void virtio_dev_resume(struct rte_eth_dev *dev);
|
|
|
|
int virtio_inject_pkts(struct rte_eth_dev *dev, struct rte_mbuf **tx_pkts,
|
|
|
|
int nb_pkts);
|
|
|
|
|
2013-09-18 12:00:00 +02:00
|
|
|
#endif /* _VIRTIO_ETHDEV_H_ */
|