DPDK  19.05.0
rte_ether.h
Go to the documentation of this file.
1 /* SPDX-License-Identifier: BSD-3-Clause
2  * Copyright(c) 2010-2014 Intel Corporation
3  */
4 
5 #ifndef _RTE_ETHER_H_
6 #define _RTE_ETHER_H_
7 
14 #ifdef __cplusplus
15 extern "C" {
16 #endif
17 
18 #include <stdint.h>
19 #include <stdio.h>
20 
21 #include <rte_memcpy.h>
22 #include <rte_random.h>
23 #include <rte_mbuf.h>
24 #include <rte_byteorder.h>
25 
26 #define ETHER_ADDR_LEN 6
27 #define ETHER_TYPE_LEN 2
28 #define ETHER_CRC_LEN 4
29 #define ETHER_HDR_LEN \
30  (ETHER_ADDR_LEN * 2 + ETHER_TYPE_LEN)
31 #define ETHER_MIN_LEN 64
32 #define ETHER_MAX_LEN 1518
33 #define ETHER_MTU \
34  (ETHER_MAX_LEN - ETHER_HDR_LEN - ETHER_CRC_LEN)
36 #define ETHER_MAX_VLAN_FRAME_LEN \
37  (ETHER_MAX_LEN + 4)
39 #define ETHER_MAX_JUMBO_FRAME_LEN \
40  0x3F00
42 #define ETHER_MAX_VLAN_ID 4095
44 #define ETHER_MIN_MTU 68
57 struct ether_addr {
58  uint8_t addr_bytes[ETHER_ADDR_LEN];
59 } __attribute__((__packed__));
60 
61 #define ETHER_LOCAL_ADMIN_ADDR 0x02
62 #define ETHER_GROUP_ADDR 0x01
78 static inline int is_same_ether_addr(const struct ether_addr *ea1,
79  const struct ether_addr *ea2)
80 {
81  int i;
82  for (i = 0; i < ETHER_ADDR_LEN; i++)
83  if (ea1->addr_bytes[i] != ea2->addr_bytes[i])
84  return 0;
85  return 1;
86 }
87 
98 static inline int is_zero_ether_addr(const struct ether_addr *ea)
99 {
100  int i;
101  for (i = 0; i < ETHER_ADDR_LEN; i++)
102  if (ea->addr_bytes[i] != 0x00)
103  return 0;
104  return 1;
105 }
106 
117 static inline int is_unicast_ether_addr(const struct ether_addr *ea)
118 {
119  return (ea->addr_bytes[0] & ETHER_GROUP_ADDR) == 0;
120 }
121 
132 static inline int is_multicast_ether_addr(const struct ether_addr *ea)
133 {
134  return ea->addr_bytes[0] & ETHER_GROUP_ADDR;
135 }
136 
147 static inline int is_broadcast_ether_addr(const struct ether_addr *ea)
148 {
149  const unaligned_uint16_t *ea_words = (const unaligned_uint16_t *)ea;
150 
151  return (ea_words[0] == 0xFFFF && ea_words[1] == 0xFFFF &&
152  ea_words[2] == 0xFFFF);
153 }
154 
165 static inline int is_universal_ether_addr(const struct ether_addr *ea)
166 {
167  return (ea->addr_bytes[0] & ETHER_LOCAL_ADMIN_ADDR) == 0;
168 }
169 
180 static inline int is_local_admin_ether_addr(const struct ether_addr *ea)
181 {
182  return (ea->addr_bytes[0] & ETHER_LOCAL_ADMIN_ADDR) != 0;
183 }
184 
196 static inline int is_valid_assigned_ether_addr(const struct ether_addr *ea)
197 {
198  return is_unicast_ether_addr(ea) && (!is_zero_ether_addr(ea));
199 }
200 
207 static inline void eth_random_addr(uint8_t *addr)
208 {
209  uint64_t rand = rte_rand();
210  uint8_t *p = (uint8_t *)&rand;
211 
212  rte_memcpy(addr, p, ETHER_ADDR_LEN);
213  addr[0] &= (uint8_t)~ETHER_GROUP_ADDR; /* clear multicast bit */
214  addr[0] |= ETHER_LOCAL_ADMIN_ADDR; /* set local assignment bit */
215 }
216 
225 static inline void ether_addr_copy(const struct ether_addr *ea_from,
226  struct ether_addr *ea_to)
227 {
228 #ifdef __INTEL_COMPILER
229  uint16_t *from_words = (uint16_t *)(ea_from->addr_bytes);
230  uint16_t *to_words = (uint16_t *)(ea_to->addr_bytes);
231 
232  to_words[0] = from_words[0];
233  to_words[1] = from_words[1];
234  to_words[2] = from_words[2];
235 #else
236  /*
237  * Use the common way, because of a strange gcc warning.
238  */
239  *ea_to = *ea_from;
240 #endif
241 }
242 
243 #define ETHER_ADDR_FMT_SIZE 18
244 
254 static inline void
255 ether_format_addr(char *buf, uint16_t size,
256  const struct ether_addr *eth_addr)
257 {
258  snprintf(buf, size, "%02X:%02X:%02X:%02X:%02X:%02X",
259  eth_addr->addr_bytes[0],
260  eth_addr->addr_bytes[1],
261  eth_addr->addr_bytes[2],
262  eth_addr->addr_bytes[3],
263  eth_addr->addr_bytes[4],
264  eth_addr->addr_bytes[5]);
265 }
266 
271 struct ether_hdr {
274  uint16_t ether_type;
275 } __attribute__((__packed__));
276 
282 struct vlan_hdr {
283  uint16_t vlan_tci;
284  uint16_t eth_proto;
285 } __attribute__((__packed__));
286 
292 struct vxlan_hdr {
293  uint32_t vx_flags;
294  uint32_t vx_vni;
295 } __attribute__((__packed__));
296 
297 /* Ethernet frame types */
298 #define ETHER_TYPE_IPv4 0x0800
299 #define ETHER_TYPE_IPv6 0x86DD
300 #define ETHER_TYPE_ARP 0x0806
301 #define ETHER_TYPE_RARP 0x8035
302 #define ETHER_TYPE_VLAN 0x8100
303 #define ETHER_TYPE_QINQ 0x88A8
304 #define ETHER_TYPE_PPPOE_DISCOVERY 0x8863
305 #define ETHER_TYPE_PPPOE_SESSION 0x8864
306 #define ETHER_TYPE_ETAG 0x893F
307 #define ETHER_TYPE_1588 0x88F7
308 #define ETHER_TYPE_SLOW 0x8809
309 #define ETHER_TYPE_TEB 0x6558
310 #define ETHER_TYPE_LLDP 0x88CC
311 #define ETHER_TYPE_MPLS 0x8847
312 #define ETHER_TYPE_MPLSM 0x8848
314 #define ETHER_VXLAN_HLEN (sizeof(struct udp_hdr) + sizeof(struct vxlan_hdr))
315 
323  uint8_t vx_flags;
324  uint8_t reserved[2];
325  uint8_t proto;
326  uint32_t vx_vni;
327 } __attribute__((__packed__));
328 
329 /* VXLAN-GPE next protocol types */
330 #define VXLAN_GPE_TYPE_IPV4 1
331 #define VXLAN_GPE_TYPE_IPV6 2
332 #define VXLAN_GPE_TYPE_ETH 3
333 #define VXLAN_GPE_TYPE_NSH 4
334 #define VXLAN_GPE_TYPE_MPLS 5
335 #define VXLAN_GPE_TYPE_GBP 6
336 #define VXLAN_GPE_TYPE_VBNG 7
338 #define ETHER_VXLAN_GPE_HLEN (sizeof(struct udp_hdr) + \
339  sizeof(struct vxlan_gpe_hdr))
340 
353 static inline int rte_vlan_strip(struct rte_mbuf *m)
354 {
355  struct ether_hdr *eh
356  = rte_pktmbuf_mtod(m, struct ether_hdr *);
357  struct vlan_hdr *vh;
358 
360  return -1;
361 
362  vh = (struct vlan_hdr *)(eh + 1);
365 
366  /* Copy ether header over rather than moving whole packet */
367  memmove(rte_pktmbuf_adj(m, sizeof(struct vlan_hdr)),
368  eh, 2 * ETHER_ADDR_LEN);
369 
370  return 0;
371 }
372 
385 static inline int rte_vlan_insert(struct rte_mbuf **m)
386 {
387  struct ether_hdr *oh, *nh;
388  struct vlan_hdr *vh;
389 
390  /* Can't insert header if mbuf is shared */
391  if (rte_mbuf_refcnt_read(*m) > 1) {
392  struct rte_mbuf *copy;
393 
394  copy = rte_pktmbuf_clone(*m, (*m)->pool);
395  if (unlikely(copy == NULL))
396  return -ENOMEM;
397  rte_pktmbuf_free(*m);
398  *m = copy;
399  }
400 
401  oh = rte_pktmbuf_mtod(*m, struct ether_hdr *);
402  nh = (struct ether_hdr *)
403  rte_pktmbuf_prepend(*m, sizeof(struct vlan_hdr));
404  if (nh == NULL)
405  return -ENOSPC;
406 
407  memmove(nh, oh, 2 * ETHER_ADDR_LEN);
409 
410  vh = (struct vlan_hdr *) (nh + 1);
411  vh->vlan_tci = rte_cpu_to_be_16((*m)->vlan_tci);
412 
413  (*m)->ol_flags &= ~(PKT_RX_VLAN_STRIPPED | PKT_TX_VLAN);
414 
415  return 0;
416 }
417 
418 #ifdef __cplusplus
419 }
420 #endif
421 
422 #endif /* _RTE_ETHER_H_ */