FD.io VPP  v21.10.1-2-g0a485f517
Vector Packet Processing
virtio_std.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2015 Cisco and/or its affiliates.
3  * Licensed under the Apache License, Version 2.0 (the "License");
4  * you may not use this file except in compliance with the License.
5  * You may obtain a copy of the License at:
6  *
7  * http://www.apache.org/licenses/LICENSE-2.0
8  *
9  * Unless required by applicable law or agreed to in writing, software
10  * distributed under the License is distributed on an "AS IS" BASIS,
11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12  * See the License for the specific language governing permissions and
13  * limitations under the License.
14  */
15 #ifndef __VIRTIO_STD_H__
16 #define __VIRTIO_STD_H__
17 
18 #define foreach_virtio_net_features \
19  _ (VIRTIO_NET_F_CSUM, 0) /* Host handles pkts w/ partial csum */ \
20  _ (VIRTIO_NET_F_GUEST_CSUM, 1) /* Guest handles pkts w/ partial csum */ \
21  _ (VIRTIO_NET_F_CTRL_GUEST_OFFLOADS, 2) /* Dynamic offload configuration. */ \
22  _ (VIRTIO_NET_F_MTU, 3) /* Initial MTU advice. */ \
23  _ (VIRTIO_NET_F_MAC, 5) /* Host has given MAC address. */ \
24  _ (VIRTIO_NET_F_GSO, 6) /* Host handles pkts w/ any GSO. */ \
25  _ (VIRTIO_NET_F_GUEST_TSO4, 7) /* Guest can handle TSOv4 in. */ \
26  _ (VIRTIO_NET_F_GUEST_TSO6, 8) /* Guest can handle TSOv6 in. */ \
27  _ (VIRTIO_NET_F_GUEST_ECN, 9) /* Guest can handle TSO[6] w/ ECN in. */ \
28  _ (VIRTIO_NET_F_GUEST_UFO, 10) /* Guest can handle UFO in. */ \
29  _ (VIRTIO_NET_F_HOST_TSO4, 11) /* Host can handle TSOv4 in. */ \
30  _ (VIRTIO_NET_F_HOST_TSO6, 12) /* Host can handle TSOv6 in. */ \
31  _ (VIRTIO_NET_F_HOST_ECN, 13) /* Host can handle TSO[6] w/ ECN in. */ \
32  _ (VIRTIO_NET_F_HOST_UFO, 14) /* Host can handle UFO in. */ \
33  _ (VIRTIO_NET_F_MRG_RXBUF, 15) /* Host can merge receive buffers. */ \
34  _ (VIRTIO_NET_F_STATUS, 16) /* virtio_net_config.status available */ \
35  _ (VIRTIO_NET_F_CTRL_VQ, 17) /* Control channel available */ \
36  _ (VIRTIO_NET_F_CTRL_RX, 18) /* Control channel RX mode support */ \
37  _ (VIRTIO_NET_F_CTRL_VLAN, 19) /* Control channel VLAN filtering */ \
38  _ (VIRTIO_NET_F_CTRL_RX_EXTRA, 20) /* Extra RX mode control support */ \
39  _ (VIRTIO_NET_F_GUEST_ANNOUNCE, 21) /* Guest can announce device on the network */ \
40  _ (VIRTIO_NET_F_MQ, 22) /* Device supports Receive Flow Steering */ \
41  _ (VIRTIO_NET_F_CTRL_MAC_ADDR, 23) /* Set MAC address */ \
42  _ (VIRTIO_F_NOTIFY_ON_EMPTY, 24) \
43  _ (VHOST_F_LOG_ALL, 26) /* Log all write descriptors */ \
44  _ (VIRTIO_F_ANY_LAYOUT, 27) /* Can the device handle any descriptor layout */ \
45  _ (VIRTIO_RING_F_INDIRECT_DESC, 28) /* Support indirect buffer descriptors */ \
46  _ (VIRTIO_RING_F_EVENT_IDX, 29) /* The Guest publishes the used index for which it expects an interrupt \
47  * at the end of the avail ring. Host should ignore the avail->flags field. */ \
48 /* The Host publishes the avail index for which it expects a kick \
49  * at the end of the used ring. Guest should ignore the used->flags field. */ \
50  _ (VHOST_USER_F_PROTOCOL_FEATURES, 30) \
51  _ (VIRTIO_F_VERSION_1, 32) /* v1.0 compliant. */ \
52  _ (VIRTIO_F_IOMMU_PLATFORM, 33) \
53  _ (VIRTIO_F_RING_PACKED, 34) \
54  _ (VIRTIO_F_IN_ORDER, 35) /* all buffers are used by the device in the */ \
55  /* same order in which they have been made available */ \
56  _ (VIRTIO_F_ORDER_PLATFORM, 36) /* memory accesses by the driver and the */ \
57  /* device are ordered in a way described by the platfor */ \
58  _ (VIRTIO_F_NOTIFICATION_DATA, 38) /* the driver passes extra data (besides */ \
59  /* identifying the virtqueue) in its device notifications. */ \
60  _ (VIRTIO_NET_F_SPEED_DUPLEX, 63) /* Device set linkspeed and duplex */
61 
62 typedef enum
63 {
64 #define _(f,n) f = n,
66 #undef _
68 
69 #define VIRTIO_FEATURE(X) (1ULL << X)
70 
71 #define VRING_MAX_SIZE 32768
72 
73 #define VRING_DESC_F_NEXT 1
74 #define VRING_DESC_F_WRITE 2
75 #define VRING_DESC_F_INDIRECT 4
76 
77 #define VRING_DESC_F_AVAIL (1 << 7)
78 #define VRING_DESC_F_USED (1 << 15)
79 
80 #define foreach_virtio_event_idx_flags \
81  _ (VRING_EVENT_F_ENABLE, 0) \
82  _ (VRING_EVENT_F_DISABLE, 1) \
83  _ (VRING_EVENT_F_DESC, 2)
84 
85 typedef enum
86 {
87 #define _(f,n) f = n,
89 #undef _
91 
92 #define VRING_USED_F_NO_NOTIFY 1
93 #define VRING_AVAIL_F_NO_INTERRUPT 1
94 
95 typedef struct
96 {
99  u16 flags;
100  u16 next;
102 
103 typedef struct
104 {
106  u16 idx;
107  u16 ring[0];
108  /* u16 used_event; */
110 
111 typedef struct
112 {
113  u32 id;
114  u32 len;
116 
117 typedef struct
118 {
120  u16 idx;
121  vring_used_elem_t ring[0];
122  /* u16 avail_event; */
123 } vring_used_t;
124 
125 /* *INDENT-OFF* */
126 typedef CLIB_PACKED (struct
127 {
128  u64 addr; // packet data buffer address
129  u32 len; // packet data buffer size
130  u16 id; // buffer id
131  u16 flags; // flags
132 }) vring_packed_desc_t;
133 
134 STATIC_ASSERT_SIZEOF (vring_packed_desc_t, 16);
135 
136 typedef CLIB_PACKED (struct
137 {
138  u16 off_wrap;
139  u16 flags;
140 }) vring_desc_event_t;
141 
142 #define VIRTIO_NET_HDR_F_NEEDS_CSUM 1 /* Use csum_start, csum_offset */
143 #define VIRTIO_NET_HDR_F_DATA_VALID 2 /* Csum is valid */
144 
145 #define VIRTIO_NET_HDR_GSO_NONE 0 /* Not a GSO frame */
146 #define VIRTIO_NET_HDR_GSO_TCPV4 1 /* GSO frame, IPv4 TCP (TSO) */
147 #define VIRTIO_NET_HDR_GSO_UDP 3 /* GSO frame, IPv4 UDP (UFO) */
148 #define VIRTIO_NET_HDR_GSO_TCPV6 4 /* GSO frame, IPv6 TCP */
149 #define VIRTIO_NET_HDR_GSO_ECN 0x80 /* TCP has ECN set */
150 
151 typedef CLIB_PACKED (struct
152 {
153  u8 flags;
154  u8 gso_type;
155  u16 hdr_len; /* Ethernet + IP + tcp/udp hdrs */
156  u16 gso_size; /* Bytes to append to hdr_len per frame */
157  u16 csum_start; /* Position to start checksumming from */
158  u16 csum_offset; /* Offset after that to place checksum */
159  u16 num_buffers; /* Number of merged rx buffers */
160 }) virtio_net_hdr_v1_t;
161 
162 typedef CLIB_PACKED (struct
163 {
164  u8 flags;
165  u8 gso_type;
166  u16 hdr_len;
167  u16 gso_size;
168  u16 csum_start;
169  u16 csum_offset;
170 }) virtio_net_hdr_t;
171 
172 typedef CLIB_PACKED (struct
173 {
174  virtio_net_hdr_t hdr;
175  u16 num_buffers;
176 }) virtio_net_hdr_mrg_rxbuf_t;
177 
178 /* *INDENT-ON* */
179 
180 typedef struct
181 {
182  u16 num;
184  vring_avail_t *avail;
185  vring_used_t *used;
186 } vring_t;
187 
189 vring_init (vring_t * vr, u32 num, void *p, u32 align)
190 {
191  vr->num = num;
192  vr->desc = p;
193  vr->avail = (vring_avail_t *) ((char *) p + num * sizeof (vring_desc_t));
194  vr->used =
195  (vring_used_t *) ((char *) p +
196  ((sizeof (vring_desc_t) * num +
197  sizeof (u16) * (3 + num) + align - 1) & ~(align -
198  1)));
199 }
200 
202 vring_size (u32 num, u32 align)
203 {
204  return ((sizeof (vring_desc_t) * num + sizeof (u16) * (3 + num)
205  + align - 1) & ~(align - 1))
206  + sizeof (u16) * 3 + sizeof (vring_used_elem_t) * num;
207 }
208 #endif
209 
210 /*
211  * fd.io coding-style-patch-verification: ON
212  *
213  * Local Variables:
214  * eval: (c-set-style "gnu")
215  * End:
216  */
vring_used_elem_t
Definition: virtio_std.h:109
next
u16 * next
Definition: nat44_ei_out2in.c:718
vring_t::num
u16 num
Definition: virtio_std.h:180
u16
unsigned short u16
Definition: types.h:57
vring_t::avail
vring_avail_t * avail
Definition: virtio_std.h:182
addr
vhost_vring_addr_t addr
Definition: vhost_user.h:130
vring_t::desc
vring_desc_t * desc
Definition: virtio_std.h:181
CLIB_PACKED
typedef CLIB_PACKED(struct { u64 addr;u32 len;u16 id;u16 flags;}) vring_packed_desc_t
vring_size
static_always_inline u16 vring_size(u32 num, u32 align)
Definition: virtio_std.h:200
len
u8 len
Definition: ip_types.api:103
vring_desc_t
Definition: virtio_std.h:93
static_always_inline
#define static_always_inline
Definition: clib.h:112
STATIC_ASSERT_SIZEOF
STATIC_ASSERT_SIZEOF(vring_packed_desc_t, 16)
vring_t
Definition: virtio_std.h:178
virtio_event_idx_flags_t
virtio_event_idx_flags_t
Definition: virtio_std.h:83
id
u8 id[64]
Definition: dhcp.api:160
foreach_virtio_event_idx_flags
#define foreach_virtio_event_idx_flags
Definition: virtio_std.h:78
vring_avail_t
Definition: virtio_std.h:101
vring_t::used
vring_used_t * used
Definition: virtio_std.h:183
u64
unsigned long u64
Definition: types.h:89
u32
unsigned int u32
Definition: types.h:88
foreach_virtio_net_features
#define foreach_virtio_net_features
Definition: virtio_std.h:18
u8
unsigned char u8
Definition: types.h:56
vring_init
static_always_inline void vring_init(vring_t *vr, u32 num, void *p, u32 align)
Definition: virtio_std.h:187
virtio_net_feature_t
virtio_net_feature_t
Definition: virtio_std.h:60
vring_used_t
Definition: virtio_std.h:115
flags
vl_api_wireguard_peer_flags_t flags
Definition: wireguard.api:105