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:
8 * http://www.apache.org/licenses/LICENSE-2.0
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 *------------------------------------------------------------------
21 #ifndef MEMIF_CACHELINE_SIZE
22 #define MEMIF_CACHELINE_SIZE 64
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)
34 typedef enum memif_msg_type
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,
55 MEMIF_INTERFACE_MODE_ETHERNET = 0,
56 MEMIF_INTERFACE_MODE_IP = 1,
57 MEMIF_INTERFACE_MODE_PUNT_INJECT = 2,
58 } memif_interface_mode_t;
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;
72 typedef struct __attribute__ ((packed))
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;
83 typedef struct __attribute__ ((packed))
85 memif_version_t version;
86 memif_interface_id_t id;
87 memif_interface_mode_t mode:8;
92 typedef struct __attribute__ ((packed))
94 memif_region_index_t index;
95 memif_region_size_t size;
96 } memif_msg_add_region_t;
98 typedef struct __attribute__ ((packed))
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 uint16_t private_hdr_size; /* used for private metadata */
107 } memif_msg_add_ring_t;
109 typedef struct __attribute__ ((packed))
112 } memif_msg_connect_t;
114 typedef struct __attribute__ ((packed))
117 } memif_msg_connected_t;
119 typedef struct __attribute__ ((packed))
123 } memif_msg_disconnect_t;
125 typedef struct __attribute__ ((packed, aligned (128)))
127 memif_msg_type_t type:16;
130 memif_msg_hello_t hello;
131 memif_msg_init_t init;
132 memif_msg_add_region_t add_region;
133 memif_msg_add_ring_t add_ring;
134 memif_msg_connect_t connect;
135 memif_msg_connected_t connected;
136 memif_msg_disconnect_t disconnect;
140 _Static_assert (sizeof (memif_msg_t) == 128,
141 "Size of memif_msg_t must be 128");
144 * Ring and Descriptor Layout
147 typedef struct __attribute__ ((packed))
150 #define MEMIF_DESC_FLAG_NEXT (1 << 0)
151 memif_region_index_t region;
153 memif_region_offset_t offset;
157 _Static_assert (sizeof (memif_desc_t) == 16,
158 "Size of memif_dsct_t must be 16 bytes");
160 #define MEMIF_CACHELINE_ALIGN_MARK(mark) \
161 uint8_t mark[0] __attribute__((aligned(MEMIF_CACHELINE_SIZE)))
165 MEMIF_CACHELINE_ALIGN_MARK (cacheline0);
168 #define MEMIF_RING_FLAG_MASK_INT 1
169 volatile uint16_t head;
170 MEMIF_CACHELINE_ALIGN_MARK (cacheline1);
171 volatile uint16_t tail;
172 MEMIF_CACHELINE_ALIGN_MARK (cacheline2);
173 memif_desc_t desc[0];
176 #endif /* _MEMIF_H_ */
179 * fd.io coding-style-patch-verification: ON
182 * eval: (c-set-style "gnu")