1 /* 2 * From FreeBSD 2.2.7: Fundamental constants relating to ethernet. 3 * 4 * Portions of this code are copyright (c) 2022 Cypress Semiconductor Corporation 5 * 6 * Copyright (C) 1999-2017, Broadcom Corporation 7 * 8 * Unless you and Broadcom execute a separate written software license 9 * agreement governing use of this software, this software is licensed to you 10 * under the terms of the GNU General Public License version 2 (the "GPL"), 11 * available at http://www.broadcom.com/licenses/GPLv2.php, with the 12 * following added to such license: 13 * 14 * As a special exception, the copyright holders of this software give you 15 * permission to link this software with independent modules, and to copy and 16 * distribute the resulting executable under terms of your choice, provided that 17 * you also meet, for each linked independent module, the terms and conditions of 18 * the license of that module. An independent module is a module which is not 19 * derived from this software. The special exception does not apply to any 20 * modifications of the software. 21 * 22 * Notwithstanding the above, under no circumstances may you combine this 23 * software in any way with any other Broadcom software provided under a license 24 * other than the GPL, without Broadcom's express prior written consent. 25 * 26 * 27 * <<Broadcom-WL-IPTag/Open:>> 28 * 29 * $Id$ 30 */ 31 32 #ifndef _NET_ETHERNET_H_ /* use native BSD ethernet.h when available */ 33 #define _NET_ETHERNET_H_ 34 35 #ifndef _TYPEDEFS_H_ 36 #include "typedefs.h" 37 #endif // endif 38 39 /* This marks the start of a packed structure section. */ 40 #include <packed_section_start.h> 41 42 /* 43 * The number of bytes in an ethernet (MAC) address. 44 */ 45 #define ETHER_ADDR_LEN 6 46 47 /* 48 * The number of bytes in the type field. 49 */ 50 #define ETHER_TYPE_LEN 2 51 52 /* 53 * The number of bytes in the trailing CRC field. 54 */ 55 #define ETHER_CRC_LEN 4 56 57 /* 58 * The length of the combined header. 59 */ 60 #define ETHER_HDR_LEN (ETHER_ADDR_LEN * 2 + ETHER_TYPE_LEN) 61 62 /* 63 * The minimum packet length. 64 */ 65 #define ETHER_MIN_LEN 64 66 67 /* 68 * The minimum packet user data length. 69 */ 70 #define ETHER_MIN_DATA 46 71 72 /* 73 * The maximum packet length. 74 */ 75 #define ETHER_MAX_LEN 1518 76 77 /* 78 * The maximum packet user data length. 79 */ 80 #define ETHER_MAX_DATA 1500 81 82 /* ether types */ 83 #define ETHER_TYPE_MIN 0x0600 /* Anything less than MIN is a length */ 84 #define ETHER_TYPE_IP 0x0800 /* IP */ 85 #define ETHER_TYPE_ARP 0x0806 /* ARP */ 86 #define ETHER_TYPE_8021Q 0x8100 /* 802.1Q */ 87 #define ETHER_TYPE_IPV6 0x86dd /* IPv6 */ 88 #define ETHER_TYPE_BRCM 0x886c /* Broadcom Corp. */ 89 #define ETHER_TYPE_802_1X 0x888e /* 802.1x */ 90 #define ETHER_TYPE_802_1X_PREAUTH 0x88c7 /* 802.1x preauthentication */ 91 #define ETHER_TYPE_WAI 0x88b4 /* WAI */ 92 #define ETHER_TYPE_89_0D 0x890d /* 89-0d frame for TDLS */ 93 #define ETHER_TYPE_RRB ETHER_TYPE_89_0D /* RRB 802.11r 2008 */ 94 95 #define ETHER_TYPE_PPP_SES 0x8864 /* PPPoE Session */ 96 97 #define ETHER_TYPE_IAPP_L2_UPDATE 0x6 /* IAPP L2 update frame */ 98 99 /* Broadcom subtype follows ethertype; First 2 bytes are reserved; Next 2 are subtype; */ 100 #define ETHER_BRCM_SUBTYPE_LEN 4 /* Broadcom 4 byte subtype */ 101 102 /* ether header */ 103 #define ETHER_DEST_OFFSET (0 * ETHER_ADDR_LEN) /* dest address offset */ 104 #define ETHER_SRC_OFFSET (1 * ETHER_ADDR_LEN) /* src address offset */ 105 #define ETHER_TYPE_OFFSET (2 * ETHER_ADDR_LEN) /* ether type offset */ 106 107 /* 108 * A macro to validate a length with 109 */ 110 #define ETHER_IS_VALID_LEN(foo) \ 111 ((foo) >= ETHER_MIN_LEN && (foo) <= ETHER_MAX_LEN) 112 113 #define ETHER_FILL_MCAST_ADDR_FROM_IP(ea, mgrp_ip) { \ 114 ((uint8 *)ea)[0] = 0x01; \ 115 ((uint8 *)ea)[1] = 0x00; \ 116 ((uint8 *)ea)[2] = 0x5e; \ 117 ((uint8 *)ea)[3] = ((mgrp_ip) >> 16) & 0x7f; \ 118 ((uint8 *)ea)[4] = ((mgrp_ip) >> 8) & 0xff; \ 119 ((uint8 *)ea)[5] = ((mgrp_ip) >> 0) & 0xff; \ 120 } 121 122 #ifndef __INCif_etherh /* Quick and ugly hack for VxWorks */ 123 /* 124 * Structure of a 10Mb/s Ethernet header. 125 */ 126 BWL_PRE_PACKED_STRUCT struct ether_header { 127 uint8 ether_dhost[ETHER_ADDR_LEN]; 128 uint8 ether_shost[ETHER_ADDR_LEN]; 129 uint16 ether_type; 130 } BWL_POST_PACKED_STRUCT; 131 132 /* 133 * Structure of a 48-bit Ethernet address. 134 */ 135 BWL_PRE_PACKED_STRUCT struct ether_addr { 136 uint8 octet[ETHER_ADDR_LEN]; 137 } BWL_POST_PACKED_STRUCT; 138 #endif /* !__INCif_etherh Quick and ugly hack for VxWorks */ 139 140 /* 141 * Takes a pointer, set, test, clear, toggle locally admininistered 142 * address bit in the 48-bit Ethernet address. 143 */ 144 #define ETHER_SET_LOCALADDR(ea) (((uint8 *)(ea))[0] = (((uint8 *)(ea))[0] | 2)) 145 #define ETHER_IS_LOCALADDR(ea) (((uint8 *)(ea))[0] & 2) 146 #define ETHER_CLR_LOCALADDR(ea) (((uint8 *)(ea))[0] = (((uint8 *)(ea))[0] & 0xfd)) 147 #define ETHER_TOGGLE_LOCALADDR(ea) (((uint8 *)(ea))[0] = (((uint8 *)(ea))[0] ^ 2)) 148 149 /* Takes a pointer, marks unicast address bit in the MAC address */ 150 #define ETHER_SET_UNICAST(ea) (((uint8 *)(ea))[0] = (((uint8 *)(ea))[0] & ~1)) 151 152 /* 153 * Takes a pointer, returns true if a 48-bit multicast address 154 * (including broadcast, since it is all ones) 155 */ 156 #define ETHER_ISMULTI(ea) (((const uint8 *)(ea))[0] & 1) 157 158 /* compare two ethernet addresses - assumes the pointers can be referenced as shorts */ 159 #define eacmp(a, b) ((((const uint16 *)(a))[0] ^ ((const uint16 *)(b))[0]) | \ 160 (((const uint16 *)(a))[1] ^ ((const uint16 *)(b))[1]) | \ 161 (((const uint16 *)(a))[2] ^ ((const uint16 *)(b))[2])) 162 163 #define ether_cmp(a, b) eacmp(a, b) 164 165 /* copy an ethernet address - assumes the pointers can be referenced as shorts */ 166 #define eacopy(s, d) \ 167 do { \ 168 ((uint16 *)(d))[0] = ((const uint16 *)(s))[0]; \ 169 ((uint16 *)(d))[1] = ((const uint16 *)(s))[1]; \ 170 ((uint16 *)(d))[2] = ((const uint16 *)(s))[2]; \ 171 } while (0) 172 173 #define ether_copy(s, d) eacopy(s, d) 174 175 /* Copy an ethernet address in reverse order */ 176 #define ether_rcopy(s, d) \ 177 do { \ 178 ((uint16 *)(d))[2] = ((uint16 *)(s))[2]; \ 179 ((uint16 *)(d))[1] = ((uint16 *)(s))[1]; \ 180 ((uint16 *)(d))[0] = ((uint16 *)(s))[0]; \ 181 } while (0) 182 183 /* Copy 14B ethernet header: 32bit aligned source and destination. */ 184 #define ehcopy32(s, d) \ 185 do { \ 186 ((uint32 *)(d))[0] = ((const uint32 *)(s))[0]; \ 187 ((uint32 *)(d))[1] = ((const uint32 *)(s))[1]; \ 188 ((uint32 *)(d))[2] = ((const uint32 *)(s))[2]; \ 189 ((uint16 *)(d))[6] = ((const uint16 *)(s))[6]; \ 190 } while (0) 191 192 static const struct ether_addr ether_bcast = {{255, 255, 255, 255, 255, 255}}; 193 static const struct ether_addr ether_null = {{0, 0, 0, 0, 0, 0}}; 194 static const struct ether_addr ether_ipv6_mcast = {{0x33, 0x33, 0x00, 0x00, 0x00, 0x01}}; 195 196 #define ETHER_ISBCAST(ea) ((((const uint8 *)(ea))[0] & \ 197 ((const uint8 *)(ea))[1] & \ 198 ((const uint8 *)(ea))[2] & \ 199 ((const uint8 *)(ea))[3] & \ 200 ((const uint8 *)(ea))[4] & \ 201 ((const uint8 *)(ea))[5]) == 0xff) 202 #define ETHER_ISNULLADDR(ea) ((((const uint8 *)(ea))[0] | \ 203 ((const uint8 *)(ea))[1] | \ 204 ((const uint8 *)(ea))[2] | \ 205 ((const uint8 *)(ea))[3] | \ 206 ((const uint8 *)(ea))[4] | \ 207 ((const uint8 *)(ea))[5]) == 0) 208 209 #define ETHER_ISNULLDEST(da) ((((const uint16 *)(da))[0] | \ 210 ((const uint16 *)(da))[1] | \ 211 ((const uint16 *)(da))[2]) == 0) 212 #define ETHER_ISNULLSRC(sa) ETHER_ISNULLDEST(sa) 213 214 #define ETHER_MOVE_HDR(d, s) \ 215 do { \ 216 struct ether_header t; \ 217 t = *(struct ether_header *)(s); \ 218 *(struct ether_header *)(d) = t; \ 219 } while (0) 220 221 #define ETHER_ISUCAST(ea) ((((uint8 *)(ea))[0] & 0x01) == 0) 222 223 /* This marks the end of a packed structure section. */ 224 #include <packed_section_end.h> 225 226 #endif /* _NET_ETHERNET_H_ */ 227