drivers/net/memif/rte_eth_memif.h

   1 /* SPDX-License-Identifier: BSD-3-Clause
   2  * Copyright 2018-2019 Cisco Systems, Inc.  All rights reserved.
   3  */
   4
   5 #ifndef _RTE_ETH_MEMIF_H_
   6 #define _RTE_ETH_MEMIF_H_
   7
   8 #ifndef _GNU_SOURCE
   9 #define _GNU_SOURCE
  10 #endif                          /* GNU_SOURCE */
  11
  12 #include <sys/queue.h>
  13
  14 #include <rte_ethdev_driver.h>
  15 #include <rte_ether.h>
  16 #include <rte_interrupts.h>
  17
  18 #include "memif.h"
  19
  20 #define ETH_MEMIF_DEFAULT_SOCKET_FILENAME       "/run/memif.sock"
  21 #define ETH_MEMIF_DEFAULT_RING_SIZE             10
  22 #define ETH_MEMIF_DEFAULT_PKT_BUFFER_SIZE       2048
  23
  24 #define ETH_MEMIF_MAX_NUM_Q_PAIRS               255
  25 #define ETH_MEMIF_MAX_LOG2_RING_SIZE            14
  26 #define ETH_MEMIF_MAX_REGION_NUM                256
  27
  28 #define ETH_MEMIF_SHM_NAME_SIZE                 32
  29 #define ETH_MEMIF_DISC_STRING_SIZE              96
  30 #define ETH_MEMIF_SECRET_SIZE                   24
  31
  32 extern int memif_logtype;
  33
  34 #define MIF_LOG(level, fmt, args...) \
  35         rte_log(RTE_LOG_ ## level, memif_logtype, \
  36                 "%s(): " fmt "\n", __func__, ##args)
  37
  38 enum memif_role_t {
  39         MEMIF_ROLE_MASTER,
  40         MEMIF_ROLE_SLAVE,
  41 };
  42
  43 struct memif_region {
  44         void *addr;                             /**< shared memory address */
  45         memif_region_size_t region_size;        /**< shared memory size */
  46         int fd;                                 /**< shared memory file descriptor */
  47         uint32_t pkt_buffer_offset;
  48         /**< offset from 'addr' to first packet buffer */
  49 };
  50
  51 struct memif_queue {
  52         struct rte_mempool *mempool;            /**< mempool for RX packets */
  53         struct pmd_internals *pmd;              /**< device internals */
  54
  55         memif_ring_type_t type;                 /**< ring type */
  56         memif_region_index_t region;            /**< shared memory region index */
  57
  58         uint16_t in_port;                       /**< port id */
  59
  60         memif_region_offset_t ring_offset;
  61         /**< ring offset from start of shm region (ring - memif_region.addr) */
  62
  63         uint16_t last_head;                     /**< last ring head */
  64         uint16_t last_tail;                     /**< last ring tail */
  65
  66         struct rte_mbuf **buffers;
  67         /**< Stored mbufs. Used in zero-copy tx. Slave stores transmitted
  68          * mbufs to free them once master has received them.
  69          */
  70
  71         /* rx/tx info */
  72         uint64_t n_pkts;                        /**< number of rx/tx packets */
  73         uint64_t n_bytes;                       /**< number of rx/tx bytes */
  74
  75         struct rte_intr_handle intr_handle;     /**< interrupt handle */
  76
  77         memif_log2_ring_size_t log2_ring_size;  /**< log2 of ring size */
  78 };
  79
  80 struct pmd_internals {
  81         memif_interface_id_t id;                /**< unique id */
  82         enum memif_role_t role;                 /**< device role */
  83         uint32_t flags;                         /**< device status flags */
  84 #define ETH_MEMIF_FLAG_CONNECTING       (1 << 0)
  85 /**< device is connecting */
  86 #define ETH_MEMIF_FLAG_CONNECTED        (1 << 1)
  87 /**< device is connected */
  88 #define ETH_MEMIF_FLAG_ZERO_COPY        (1 << 2)
  89 /**< device is zero-copy enabled */
  90 #define ETH_MEMIF_FLAG_DISABLED         (1 << 3)
  91 /**< device has not been configured and can not accept connection requests */
  92
  93         char *socket_filename;                  /**< pointer to socket filename */
  94         char secret[ETH_MEMIF_SECRET_SIZE]; /**< secret (optional security parameter) */
  95
  96         struct memif_control_channel *cc;       /**< control channel */
  97
  98         /* remote info */
  99         char remote_name[RTE_DEV_NAME_MAX_LEN];         /**< remote app name */
 100         char remote_if_name[RTE_DEV_NAME_MAX_LEN];      /**< remote peer name */
 101
 102         struct {
 103                 memif_log2_ring_size_t log2_ring_size; /**< log2 of ring size */
 104                 uint8_t num_s2m_rings;          /**< number of slave to master rings */
 105                 uint8_t num_m2s_rings;          /**< number of master to slave rings */
 106                 uint16_t pkt_buffer_size;       /**< buffer size */
 107         } cfg;                                  /**< Configured parameters (max values) */
 108
 109         struct {
 110                 memif_log2_ring_size_t log2_ring_size; /**< log2 of ring size */
 111                 uint8_t num_s2m_rings;          /**< number of slave to master rings */
 112                 uint8_t num_m2s_rings;          /**< number of master to slave rings */
 113                 uint16_t pkt_buffer_size;       /**< buffer size */
 114         } run;
 115         /**< Parameters used in active connection */
 116
 117         char local_disc_string[ETH_MEMIF_DISC_STRING_SIZE];
 118         /**< local disconnect reason */
 119         char remote_disc_string[ETH_MEMIF_DISC_STRING_SIZE];
 120         /**< remote disconnect reason */
 121 };
 122
 123 struct pmd_process_private {
 124         struct memif_region *regions[ETH_MEMIF_MAX_REGION_NUM];
 125         /**< shared memory regions */
 126         memif_region_index_t regions_num;       /**< number of regions */
 127 };
 128
 129 /**
 130  * Unmap shared memory and free regions from memory.
 131  *
 132  * @param proc_private
 133  *   device process private data
 134  */
 135 void memif_free_regions(struct rte_eth_dev *dev);
 136
 137 /**
 138  * Finalize connection establishment process. Map shared memory file
 139  * (master role), initialize ring queue, set link status up.
 140  *
 141  * @param dev
 142  *   memif device
 143  * @return
 144  *   - On success, zero.
 145  *   - On failure, a negative value.
 146  */
 147 int memif_connect(struct rte_eth_dev *dev);
 148
 149 /**
 150  * Create shared memory file and initialize ring queue.
 151  * Only called by slave when establishing connection
 152  *
 153  * @param dev
 154  *   memif device
 155  * @return
 156  *   - On success, zero.
 157  *   - On failure, a negative value.
 158  */
 159 int memif_init_regions_and_queues(struct rte_eth_dev *dev);
 160
 161 /**
 162  * Get memif version string.
 163  *
 164  * @return
 165  *   - memif version string
 166  */
 167 const char *memif_version(void);
 168
 169 #ifndef MFD_HUGETLB
 170 #ifndef __NR_memfd_create
 171
 172 #if defined __x86_64__
 173 #define __NR_memfd_create 319
 174 #elif defined __x86_32__
 175 #define __NR_memfd_create 1073742143
 176 #elif defined __arm__
 177 #define __NR_memfd_create 385
 178 #elif defined __aarch64__
 179 #define __NR_memfd_create 279
 180 #elif defined __powerpc__
 181 #define __NR_memfd_create 360
 182 #elif defined __i386__
 183 #define __NR_memfd_create 356
 184 #else
 185 #error "__NR_memfd_create unknown for this architecture"
 186 #endif
 187
 188 #endif                          /* __NR_memfd_create */
 189
 190 static inline int memfd_create(const char *name, unsigned int flags)
 191 {
 192         return syscall(__NR_memfd_create, name, flags);
 193 }
 194 #endif                          /* MFD_HUGETLB */
 195
 196 #ifndef F_LINUX_SPECIFIC_BASE
 197 #define F_LINUX_SPECIFIC_BASE 1024
 198 #endif
 199
 200 #ifndef MFD_ALLOW_SEALING
 201 #define MFD_ALLOW_SEALING       0x0002U
 202 #endif
 203
 204 #ifndef F_ADD_SEALS
 205 #define F_ADD_SEALS (F_LINUX_SPECIFIC_BASE + 9)
 206 #define F_GET_SEALS (F_LINUX_SPECIFIC_BASE + 10)
 207
 208 #define F_SEAL_SEAL     0x0001  /* prevent further seals from being set */
 209 #define F_SEAL_SHRINK   0x0002  /* prevent file from shrinking */
 210 #define F_SEAL_GROW     0x0004  /* prevent file from growing */
 211 #define F_SEAL_WRITE    0x0008  /* prevent writes */
 212 #endif
 213
 214 #endif                          /* RTE_ETH_MEMIF_H */