src/plugins/memif/memif.h

   1 /*
   2  *------------------------------------------------------------------
   3  * Copyright (c) 2017 Cisco and/or its affiliates.
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at:
   7  *
   8  *     http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  *------------------------------------------------------------------
  16  */
  17
  18 #ifndef _MEMIF_H_
  19 #define _MEMIF_H_
  20
  21 #ifndef MEMIF_CACHELINE_SIZE
  22 #define MEMIF_CACHELINE_SIZE 64
  23 #endif
  24
  25 #define MEMIF_COOKIE            0x3E31F20
  26 #define MEMIF_VERSION_MAJOR     2
  27 #define MEMIF_VERSION_MINOR     0
  28 #define MEMIF_VERSION           ((MEMIF_VERSION_MAJOR << 8) | MEMIF_VERSION_MINOR)
  29
  30 /*
  31  *  Type definitions
  32  */
  33
  34 typedef enum memif_msg_type
  35 {
  36   MEMIF_MSG_TYPE_NONE = 0,
  37   MEMIF_MSG_TYPE_ACK = 1,
  38   MEMIF_MSG_TYPE_HELLO = 2,
  39   MEMIF_MSG_TYPE_INIT = 3,
  40   MEMIF_MSG_TYPE_ADD_REGION = 4,
  41   MEMIF_MSG_TYPE_ADD_RING = 5,
  42   MEMIF_MSG_TYPE_CONNECT = 6,
  43   MEMIF_MSG_TYPE_CONNECTED = 7,
  44   MEMIF_MSG_TYPE_DISCONNECT = 8,
  45 } memif_msg_type_t;
  46
  47 typedef enum
  48 {
  49   MEMIF_RING_S2M = 0,
  50   MEMIF_RING_M2S = 1
  51 } memif_ring_type_t;
  52
  53 typedef enum
  54 {
  55   MEMIF_INTERFACE_MODE_ETHERNET = 0,
  56   MEMIF_INTERFACE_MODE_IP = 1,
  57   MEMIF_INTERFACE_MODE_PUNT_INJECT = 2,
  58 } memif_interface_mode_t;
  59
  60 typedef uint16_t memif_region_index_t;
  61 typedef uint32_t memif_region_offset_t;
  62 typedef uint64_t memif_region_size_t;
  63 typedef uint16_t memif_ring_index_t;
  64 typedef uint32_t memif_interface_id_t;
  65 typedef uint16_t memif_version_t;
  66 typedef uint8_t memif_log2_ring_size_t;
  67
  68 /*
  69  *  Socket messages
  70  */
  71
  72 typedef struct __attribute__ ((packed))
  73 {
  74   uint8_t name[32];
  75   memif_version_t min_version;
  76   memif_version_t max_version;
  77   memif_region_index_t max_region;
  78   memif_ring_index_t max_m2s_ring;
  79   memif_ring_index_t max_s2m_ring;
  80   memif_log2_ring_size_t max_log2_ring_size;
  81 } memif_msg_hello_t;
  82
  83 typedef struct __attribute__ ((packed))
  84 {
  85   memif_version_t version;
  86   memif_interface_id_t id;
  87   memif_interface_mode_t mode:8;
  88   uint8_t secret[24];
  89   uint8_t name[32];
  90 } memif_msg_init_t;
  91
  92 typedef struct __attribute__ ((packed))
  93 {
  94   memif_region_index_t index;
  95   memif_region_size_t size;
  96 } memif_msg_add_region_t;
  97
  98 typedef struct __attribute__ ((packed))
  99 {
 100   uint16_t flags;
 101 #define MEMIF_MSG_ADD_RING_FLAG_S2M     (1 << 0)
 102   memif_ring_index_t index;
 103   memif_region_index_t region;
 104   memif_region_offset_t offset;
 105   memif_log2_ring_size_t log2_ring_size;
 106 } memif_msg_add_ring_t;
 107
 108 typedef struct __attribute__ ((packed))
 109 {
 110   uint8_t if_name[32];
 111 } memif_msg_connect_t;
 112
 113 typedef struct __attribute__ ((packed))
 114 {
 115   uint8_t if_name[32];
 116 } memif_msg_connected_t;
 117
 118 typedef struct __attribute__ ((packed))
 119 {
 120   uint32_t code;
 121   uint8_t string[96];
 122 } memif_msg_disconnect_t;
 123
 124 typedef struct __attribute__ ((packed, aligned (128)))
 125 {
 126   memif_msg_type_t type:16;
 127   union
 128   {
 129     memif_msg_hello_t hello;
 130     memif_msg_init_t init;
 131     memif_msg_add_region_t add_region;
 132     memif_msg_add_ring_t add_ring;
 133     memif_msg_connect_t connect;
 134     memif_msg_connected_t connected;
 135     memif_msg_disconnect_t disconnect;
 136   };
 137 } memif_msg_t;
 138
 139 _Static_assert (sizeof (memif_msg_t) == 128,
 140                 "Size of memif_msg_t must be 128");
 141
 142 /*
 143  *  Ring and Descriptor Layout
 144  */
 145
 146 typedef struct __attribute__ ((packed))
 147 {
 148   uint16_t flags;
 149 #define MEMIF_DESC_FLAG_NEXT (1 << 0)
 150   memif_region_index_t region;
 151   uint32_t length;
 152   memif_region_offset_t offset;
 153   uint32_t metadata;
 154 } memif_desc_t;
 155
 156 _Static_assert (sizeof (memif_desc_t) == 16,
 157                 "Size of memif_dsct_t must be 16 bytes");
 158
 159 #define MEMIF_CACHELINE_ALIGN_MARK(mark) \
 160   uint8_t mark[0] __attribute__((aligned(MEMIF_CACHELINE_SIZE)))
 161
 162 typedef struct
 163 {
 164   MEMIF_CACHELINE_ALIGN_MARK (cacheline0);
 165   uint32_t cookie;
 166   uint16_t flags;
 167 #define MEMIF_RING_FLAG_MASK_INT 1
 168   volatile uint16_t head;
 169     MEMIF_CACHELINE_ALIGN_MARK (cacheline1);
 170   volatile uint16_t tail;
 171     MEMIF_CACHELINE_ALIGN_MARK (cacheline2);
 172   memif_desc_t desc[0];
 173 } memif_ring_t;
 174
 175 #endif /* _MEMIF_H_ */
 176
 177 /*
 178  * fd.io coding-style-patch-verification: ON
 179  *
 180  * Local Variables:
 181  * eval: (c-set-style "gnu")
 182  * End:
 183  */