xref: /freebsd/sys/net/ethernet.h (revision 9d54812421274e490dc5f0fe4722ab8d35d9b258)
1 /*
2  * Fundamental constants relating to ethernet.
3  *
4  * $FreeBSD$
5  *
6  */
7 
8 #ifndef _NET_ETHERNET_H_
9 #define	_NET_ETHERNET_H_
10 
11 #include <sys/types.h>
12 
13 /*
14  * Some basic Ethernet constants.
15  */
16 #define	ETHER_ADDR_LEN		6	/* length of an Ethernet address */
17 #define	ETHER_TYPE_LEN		2	/* length of the Ethernet type field */
18 #define	ETHER_CRC_LEN		4	/* length of the Ethernet CRC */
19 #define	ETHER_HDR_LEN		(ETHER_ADDR_LEN*2+ETHER_TYPE_LEN)
20 #define	ETHER_MIN_LEN		64	/* minimum frame len, including CRC */
21 #define	ETHER_MAX_LEN		1518	/* maximum frame len, including CRC */
22 #define	ETHER_MAX_LEN_JUMBO	9018	/* max jumbo frame len, including CRC */
23 
24 #define	ETHER_VLAN_ENCAP_LEN	4	/* len of 802.1Q VLAN encapsulation */
25 /*
26  * Mbuf adjust factor to force 32-bit alignment of IP header.
27  * Drivers should do m_adj(m, ETHER_ALIGN) when setting up a
28  * receive so the upper layers get the IP header properly aligned
29  * past the 14-byte Ethernet header.
30  */
31 #define	ETHER_ALIGN		2	/* driver adjust for IP hdr alignment */
32 
33 /*
34  * Compute the maximum frame size based on ethertype (i.e. possible
35  * encapsulation) and whether or not an FCS is present.
36  */
37 #define	ETHER_MAX_FRAME(ifp, etype, hasfcs)				\
38 	((ifp)->if_mtu + ETHER_HDR_LEN +				\
39 	 ((hasfcs) ? ETHER_CRC_LEN : 0) +				\
40 	 (((etype) == ETHERTYPE_VLAN) ? ETHER_VLAN_ENCAP_LEN : 0))
41 
42 /*
43  * Ethernet-specific mbuf flags.
44  */
45 #define	M_HASFCS	M_PROTO5	/* FCS included at end of frame */
46 
47 /*
48  * Ethernet CRC32 polynomials (big- and little-endian versions).
49  */
50 #define	ETHER_CRC_POLY_LE	0xedb88320
51 #define	ETHER_CRC_POLY_BE	0x04c11db6
52 
53 /*
54  * A macro to validate a length with
55  */
56 #define	ETHER_IS_VALID_LEN(foo)	\
57 	((foo) >= ETHER_MIN_LEN && (foo) <= ETHER_MAX_LEN)
58 
59 /*
60  * Structure of a 10Mb/s Ethernet header.
61  */
62 struct ether_header {
63 	u_char	ether_dhost[ETHER_ADDR_LEN];
64 	u_char	ether_shost[ETHER_ADDR_LEN];
65 	u_short	ether_type;
66 } __packed;
67 
68 /*
69  * Structure of a 48-bit Ethernet address.
70  */
71 struct ether_addr {
72 	u_char octet[ETHER_ADDR_LEN];
73 } __packed;
74 
75 #define	ETHER_IS_MULTICAST(addr) (*(addr) & 0x01) /* is address mcast/bcast? */
76 #define	ETHER_IS_IPV6_MULTICAST(addr) \
77 	(((addr)[0] == 0x33) && ((addr)[1] == 0x33))
78 #define	ETHER_IS_BROADCAST(addr) \
79 	(((addr)[0] & (addr)[1] & (addr)[2] & \
80 	  (addr)[3] & (addr)[4] & (addr)[5]) == 0xff)
81 #define	ETHER_IS_ZERO(addr) \
82 	(((addr)[0] | (addr)[1] | (addr)[2] | \
83 	  (addr)[3] | (addr)[4] | (addr)[5]) == 0x00)
84 
85 /*
86  * 802.1q Virtual LAN header.
87  */
88 struct ether_vlan_header {
89 	uint8_t evl_dhost[ETHER_ADDR_LEN];
90 	uint8_t evl_shost[ETHER_ADDR_LEN];
91 	uint16_t evl_encap_proto;
92 	uint16_t evl_tag;
93 	uint16_t evl_proto;
94 } __packed;
95 
96 #define	EVL_VLID_MASK		0x0FFF
97 #define	EVL_PRI_MASK		0xE000
98 #define	EVL_VLANOFTAG(tag)	((tag) & EVL_VLID_MASK)
99 #define	EVL_PRIOFTAG(tag)	(((tag) >> 13) & 7)
100 #define	EVL_CFIOFTAG(tag)	(((tag) >> 12) & 1)
101 #define	EVL_MAKETAG(vlid, pri, cfi)					\
102 	((((((pri) & 7) << 1) | ((cfi) & 1)) << 12) | ((vlid) & EVL_VLID_MASK))
103 
104 /*
105  * Ethernet protocol types.
106  *
107  * A public list is available from the IEEE Registration Authority:
108  *	https://standards.ieee.org/products-services/regauth/
109  *
110  *  NOTE: 0x0000-0x05DC (0..1500) are generally IEEE 802.3 length fields.
111  *  However, there are some conflicts.
112  */
113 
114 #define	ETHERTYPE_8023		0x0004	/* IEEE 802.3 packet */
115 		   /* 0x0101 .. 0x1FF	   Experimental */
116 #define	ETHERTYPE_PUP		0x0200	/* Xerox PUP protocol - see 0A00 */
117 #define	ETHERTYPE_PUPAT		0x0200	/* PUP Address Translation - see 0A01 */
118 #define	ETHERTYPE_SPRITE	0x0500	/* ??? */
119 			     /* 0x0400	   Nixdorf */
120 #define	ETHERTYPE_NS		0x0600	/* XNS */
121 #define	ETHERTYPE_NSAT		0x0601	/* XNS Address Translation (3Mb only) */
122 #define	ETHERTYPE_DLOG1 	0x0660	/* DLOG (?) */
123 #define	ETHERTYPE_DLOG2 	0x0661	/* DLOG (?) */
124 #define	ETHERTYPE_IP		0x0800	/* IP protocol */
125 #define	ETHERTYPE_X75		0x0801	/* X.75 Internet */
126 #define	ETHERTYPE_NBS		0x0802	/* NBS Internet */
127 #define	ETHERTYPE_ECMA		0x0803	/* ECMA Internet */
128 #define	ETHERTYPE_CHAOS 	0x0804	/* CHAOSnet */
129 #define	ETHERTYPE_X25		0x0805	/* X.25 Level 3 */
130 #define	ETHERTYPE_ARP		0x0806	/* Address resolution protocol */
131 #define	ETHERTYPE_NSCOMPAT	0x0807	/* XNS Compatibility */
132 #define	ETHERTYPE_FRARP 	0x0808	/* Frame Relay ARP (RFC1701) */
133 			     /* 0x081C	   Symbolics Private */
134 		    /* 0x0888 - 0x088A	   Xyplex */
135 #define	ETHERTYPE_UBDEBUG	0x0900	/* Ungermann-Bass network debugger */
136 #define	ETHERTYPE_IEEEPUP	0x0A00	/* Xerox IEEE802.3 PUP */
137 #define	ETHERTYPE_IEEEPUPAT	0x0A01	/* Xerox IEEE802.3 PUP Address Translation */
138 #define	ETHERTYPE_VINES 	0x0BAD	/* Banyan VINES */
139 #define	ETHERTYPE_VINESLOOP	0x0BAE	/* Banyan VINES Loopback */
140 #define	ETHERTYPE_VINESECHO	0x0BAF	/* Banyan VINES Echo */
141 
142 /*		       0x1000 - 0x100F	   Berkeley Trailer */
143 /*
144  * The ETHERTYPE_NTRAILER packet types starting at ETHERTYPE_TRAIL have
145  * (type-ETHERTYPE_TRAIL)*512 bytes of data followed
146  * by an ETHER type (as given above) and then the (variable-length) header.
147  */
148 #define	ETHERTYPE_TRAIL		0x1000	/* Trailer packet */
149 #define	ETHERTYPE_NTRAILER	16
150 
151 #define	ETHERTYPE_DCA		0x1234	/* DCA - Multicast */
152 #define	ETHERTYPE_VALID 	0x1600	/* VALID system protocol */
153 #define	ETHERTYPE_DOGFIGHT	0x1989	/* Artificial Horizons ("Aviator" dogfight simulator [on Sun]) */
154 #define	ETHERTYPE_RCL		0x1995	/* Datapoint Corporation (RCL lan protocol) */
155 
156 					/* The following 3C0x types
157 					   are unregistered: */
158 #define	ETHERTYPE_NBPVCD	0x3C00	/* 3Com NBP virtual circuit datagram (like XNS SPP) not registered */
159 #define	ETHERTYPE_NBPSCD	0x3C01	/* 3Com NBP System control datagram not registered */
160 #define	ETHERTYPE_NBPCREQ	0x3C02	/* 3Com NBP Connect request (virtual cct) not registered */
161 #define	ETHERTYPE_NBPCRSP	0x3C03	/* 3Com NBP Connect response not registered */
162 #define	ETHERTYPE_NBPCC		0x3C04	/* 3Com NBP Connect complete not registered */
163 #define	ETHERTYPE_NBPCLREQ	0x3C05	/* 3Com NBP Close request (virtual cct) not registered */
164 #define	ETHERTYPE_NBPCLRSP	0x3C06	/* 3Com NBP Close response not registered */
165 #define	ETHERTYPE_NBPDG		0x3C07	/* 3Com NBP Datagram (like XNS IDP) not registered */
166 #define	ETHERTYPE_NBPDGB	0x3C08	/* 3Com NBP Datagram broadcast not registered */
167 #define	ETHERTYPE_NBPCLAIM	0x3C09	/* 3Com NBP Claim NetBIOS name not registered */
168 #define	ETHERTYPE_NBPDLTE	0x3C0A	/* 3Com NBP Delete NetBIOS name not registered */
169 #define	ETHERTYPE_NBPRAS	0x3C0B	/* 3Com NBP Remote adaptor status request not registered */
170 #define	ETHERTYPE_NBPRAR	0x3C0C	/* 3Com NBP Remote adaptor response not registered */
171 #define	ETHERTYPE_NBPRST	0x3C0D	/* 3Com NBP Reset not registered */
172 
173 #define	ETHERTYPE_PCS		0x4242	/* PCS Basic Block Protocol */
174 #define	ETHERTYPE_IMLBLDIAG	0x424C	/* Information Modes Little Big LAN diagnostic */
175 #define	ETHERTYPE_DIDDLE	0x4321	/* THD - Diddle */
176 #define	ETHERTYPE_IMLBL		0x4C42	/* Information Modes Little Big LAN */
177 #define	ETHERTYPE_SIMNET	0x5208	/* BBN Simnet Private */
178 #define	ETHERTYPE_DECEXPER	0x6000	/* DEC Unassigned, experimental */
179 #define	ETHERTYPE_MOPDL		0x6001	/* DEC MOP dump/load */
180 #define	ETHERTYPE_MOPRC		0x6002	/* DEC MOP remote console */
181 #define	ETHERTYPE_DECnet	0x6003	/* DEC DECNET Phase IV route */
182 #define	ETHERTYPE_DN		ETHERTYPE_DECnet	/* libpcap, tcpdump */
183 #define	ETHERTYPE_LAT		0x6004	/* DEC LAT */
184 #define	ETHERTYPE_DECDIAG	0x6005	/* DEC diagnostic protocol (at interface initialization?) */
185 #define	ETHERTYPE_DECCUST	0x6006	/* DEC customer protocol */
186 #define	ETHERTYPE_SCA		0x6007	/* DEC LAVC, SCA */
187 #define	ETHERTYPE_AMBER		0x6008	/* DEC AMBER */
188 #define	ETHERTYPE_DECMUMPS	0x6009	/* DEC MUMPS */
189 		    /* 0x6010 - 0x6014	   3Com Corporation */
190 #define	ETHERTYPE_TRANSETHER	0x6558	/* Trans Ether Bridging (RFC1701)*/
191 #define	ETHERTYPE_RAWFR		0x6559	/* Raw Frame Relay (RFC1701) */
192 #define	ETHERTYPE_UBDL		0x7000	/* Ungermann-Bass download */
193 #define	ETHERTYPE_UBNIU		0x7001	/* Ungermann-Bass NIUs */
194 #define	ETHERTYPE_UBDIAGLOOP	0x7002	/* Ungermann-Bass diagnostic/loopback */
195 #define	ETHERTYPE_UBNMC		0x7003	/* Ungermann-Bass ??? (NMC to/from UB Bridge) */
196 #define	ETHERTYPE_UBBST		0x7005	/* Ungermann-Bass Bridge Spanning Tree */
197 #define	ETHERTYPE_OS9		0x7007	/* OS/9 Microware */
198 #define	ETHERTYPE_OS9NET	0x7009	/* OS/9 Net? */
199 		    /* 0x7020 - 0x7029	   LRT (England) (now Sintrom) */
200 #define	ETHERTYPE_RACAL		0x7030	/* Racal-Interlan */
201 #define	ETHERTYPE_PRIMENTS	0x7031	/* Prime NTS (Network Terminal Service) */
202 #define	ETHERTYPE_CABLETRON	0x7034	/* Cabletron */
203 #define	ETHERTYPE_CRONUSVLN	0x8003	/* Cronus VLN */
204 #define	ETHERTYPE_CRONUS	0x8004	/* Cronus Direct */
205 #define	ETHERTYPE_HP		0x8005	/* HP Probe */
206 #define	ETHERTYPE_NESTAR	0x8006	/* Nestar */
207 #define	ETHERTYPE_ATTSTANFORD	0x8008	/* AT&T/Stanford (local use) */
208 #define	ETHERTYPE_EXCELAN	0x8010	/* Excelan */
209 #define	ETHERTYPE_SG_DIAG	0x8013	/* SGI diagnostic type */
210 #define	ETHERTYPE_SG_NETGAMES	0x8014	/* SGI network games */
211 #define	ETHERTYPE_SG_RESV	0x8015	/* SGI reserved type */
212 #define	ETHERTYPE_SG_BOUNCE	0x8016	/* SGI bounce server */
213 #define	ETHERTYPE_APOLLODOMAIN	0x8019	/* Apollo DOMAIN */
214 #define	ETHERTYPE_TYMSHARE	0x802E	/* Tymeshare */
215 #define	ETHERTYPE_TIGAN		0x802F	/* Tigan, Inc. */
216 #define	ETHERTYPE_REVARP	0x8035	/* Reverse addr resolution protocol */
217 #define	ETHERTYPE_AEONIC	0x8036	/* Aeonic Systems */
218 #define	ETHERTYPE_IPXNEW	0x8037	/* IPX (Novell Netware?) */
219 #define	ETHERTYPE_LANBRIDGE	0x8038	/* DEC LANBridge */
220 #define	ETHERTYPE_DSMD	0x8039	/* DEC DSM/DDP */
221 #define	ETHERTYPE_ARGONAUT	0x803A	/* DEC Argonaut Console */
222 #define	ETHERTYPE_VAXELN	0x803B	/* DEC VAXELN */
223 #define	ETHERTYPE_DECDNS	0x803C	/* DEC DNS Naming Service */
224 #define	ETHERTYPE_ENCRYPT	0x803D	/* DEC Ethernet Encryption */
225 #define	ETHERTYPE_DECDTS	0x803E	/* DEC Distributed Time Service */
226 #define	ETHERTYPE_DECLTM	0x803F	/* DEC LAN Traffic Monitor */
227 #define	ETHERTYPE_DECNETBIOS	0x8040	/* DEC PATHWORKS DECnet NETBIOS Emulation */
228 #define	ETHERTYPE_DECLAST	0x8041	/* DEC Local Area System Transport */
229 			     /* 0x8042	   DEC Unassigned */
230 #define	ETHERTYPE_PLANNING	0x8044	/* Planning Research Corp. */
231 		    /* 0x8046 - 0x8047	   AT&T */
232 #define	ETHERTYPE_DECAM		0x8048	/* DEC Availability Manager for Distributed Systems DECamds (but someone at DEC says not) */
233 #define	ETHERTYPE_EXPERDATA	0x8049	/* ExperData */
234 #define	ETHERTYPE_VEXP		0x805B	/* Stanford V Kernel exp. */
235 #define	ETHERTYPE_VPROD		0x805C	/* Stanford V Kernel prod. */
236 #define	ETHERTYPE_ES		0x805D	/* Evans & Sutherland */
237 #define	ETHERTYPE_LITTLE	0x8060	/* Little Machines */
238 #define	ETHERTYPE_COUNTERPOINT	0x8062	/* Counterpoint Computers */
239 		    /* 0x8065 - 0x8066	   Univ. of Mass @ Amherst */
240 #define	ETHERTYPE_VEECO		0x8067	/* Veeco Integrated Auto. */
241 #define	ETHERTYPE_GENDYN	0x8068	/* General Dynamics */
242 #define	ETHERTYPE_ATT		0x8069	/* AT&T */
243 #define	ETHERTYPE_AUTOPHON	0x806A	/* Autophon */
244 #define	ETHERTYPE_COMDESIGN	0x806C	/* ComDesign */
245 #define	ETHERTYPE_COMPUGRAPHIC	0x806D	/* Compugraphic Corporation */
246 		    /* 0x806E - 0x8077	   Landmark Graphics Corp. */
247 #define	ETHERTYPE_MATRA		0x807A	/* Matra */
248 #define	ETHERTYPE_DDE		0x807B	/* Dansk Data Elektronik */
249 #define	ETHERTYPE_MERIT		0x807C	/* Merit Internodal (or Univ of Michigan?) */
250 		    /* 0x807D - 0x807F	   Vitalink Communications */
251 #define	ETHERTYPE_VLTLMAN	0x8080	/* Vitalink TransLAN III Management */
252 		    /* 0x8081 - 0x8083	   Counterpoint Computers */
253 		    /* 0x8088 - 0x808A	   Xyplex */
254 #define	ETHERTYPE_ATALK		0x809B	/* AppleTalk */
255 #define	ETHERTYPE_AT		ETHERTYPE_ATALK		/* old NetBSD */
256 #define	ETHERTYPE_APPLETALK	ETHERTYPE_ATALK		/* HP-UX */
257 		    /* 0x809C - 0x809E	   Datability */
258 #define	ETHERTYPE_SPIDER	0x809F	/* Spider Systems Ltd. */
259 			     /* 0x80A3	   Nixdorf */
260 		    /* 0x80A4 - 0x80B3	   Siemens Gammasonics Inc. */
261 		    /* 0x80C0 - 0x80C3	   DCA (Digital Comm. Assoc.) Data Exchange Cluster */
262 		    /* 0x80C4 - 0x80C5	   Banyan Systems */
263 #define	ETHERTYPE_PACER		0x80C6	/* Pacer Software */
264 #define	ETHERTYPE_APPLITEK	0x80C7	/* Applitek Corporation */
265 		    /* 0x80C8 - 0x80CC	   Intergraph Corporation */
266 		    /* 0x80CD - 0x80CE	   Harris Corporation */
267 		    /* 0x80CF - 0x80D2	   Taylor Instrument */
268 		    /* 0x80D3 - 0x80D4	   Rosemount Corporation */
269 #define	ETHERTYPE_SNA		0x80D5	/* IBM SNA Services over Ethernet */
270 #define	ETHERTYPE_VARIAN	0x80DD	/* Varian Associates */
271 		    /* 0x80DE - 0x80DF	   TRFS (Integrated Solutions Transparent Remote File System) */
272 		    /* 0x80E0 - 0x80E3	   Allen-Bradley */
273 		    /* 0x80E4 - 0x80F0	   Datability */
274 #define	ETHERTYPE_RETIX		0x80F2	/* Retix */
275 #define	ETHERTYPE_AARP		0x80F3	/* AppleTalk AARP */
276 		    /* 0x80F4 - 0x80F5	   Kinetics */
277 #define	ETHERTYPE_APOLLO	0x80F7	/* Apollo Computer */
278 #define	ETHERTYPE_VLAN		0x8100	/* IEEE 802.1Q VLAN tagging (XXX conflicts) */
279 		    /* 0x80FF - 0x8101	   Wellfleet Communications (XXX conflicts) */
280 #define	ETHERTYPE_BOFL		0x8102	/* Wellfleet; BOFL (Breath OF Life) pkts [every 5-10 secs.] */
281 #define	ETHERTYPE_WELLFLEET	0x8103	/* Wellfleet Communications */
282 		    /* 0x8107 - 0x8109	   Symbolics Private */
283 #define	ETHERTYPE_TALARIS	0x812B	/* Talaris */
284 #define	ETHERTYPE_WATERLOO	0x8130	/* Waterloo Microsystems Inc. (XXX which?) */
285 #define	ETHERTYPE_HAYES		0x8130	/* Hayes Microcomputers (XXX which?) */
286 #define	ETHERTYPE_VGLAB		0x8131	/* VG Laboratory Systems */
287 		    /* 0x8132 - 0x8137	   Bridge Communications */
288 #define	ETHERTYPE_IPX		0x8137	/* Novell (old) NetWare IPX (ECONFIG E option) */
289 #define	ETHERTYPE_NOVELL	0x8138	/* Novell, Inc. */
290 		    /* 0x8139 - 0x813D	   KTI */
291 #define	ETHERTYPE_MUMPS		0x813F	/* M/MUMPS data sharing */
292 #define	ETHERTYPE_AMOEBA	0x8145	/* Vrije Universiteit (NL) Amoeba 4 RPC (obsolete) */
293 #define	ETHERTYPE_FLIP		0x8146	/* Vrije Universiteit (NL) FLIP (Fast Local Internet Protocol) */
294 #define	ETHERTYPE_VURESERVED	0x8147	/* Vrije Universiteit (NL) [reserved] */
295 #define	ETHERTYPE_LOGICRAFT	0x8148	/* Logicraft */
296 #define	ETHERTYPE_NCD		0x8149	/* Network Computing Devices */
297 #define	ETHERTYPE_ALPHA		0x814A	/* Alpha Micro */
298 #define	ETHERTYPE_SNMP		0x814C	/* SNMP over Ethernet (see RFC1089) */
299 		    /* 0x814D - 0x814E	   BIIN */
300 #define	ETHERTYPE_TEC	0x814F	/* Technically Elite Concepts */
301 #define	ETHERTYPE_RATIONAL	0x8150	/* Rational Corp */
302 		    /* 0x8151 - 0x8153	   Qualcomm */
303 		    /* 0x815C - 0x815E	   Computer Protocol Pty Ltd */
304 		    /* 0x8164 - 0x8166	   Charles River Data Systems */
305 #define	ETHERTYPE_XTP		0x817D	/* Protocol Engines XTP */
306 #define	ETHERTYPE_SGITW		0x817E	/* SGI/Time Warner prop. */
307 #define	ETHERTYPE_HIPPI_FP	0x8180	/* HIPPI-FP encapsulation */
308 #define	ETHERTYPE_STP		0x8181	/* Scheduled Transfer STP, HIPPI-ST */
309 		    /* 0x8182 - 0x8183	   Reserved for HIPPI-6400 */
310 		    /* 0x8184 - 0x818C	   SGI prop. */
311 #define	ETHERTYPE_MOTOROLA	0x818D	/* Motorola */
312 #define	ETHERTYPE_NETBEUI	0x8191	/* PowerLAN NetBIOS/NetBEUI (PC) */
313 		    /* 0x819A - 0x81A3	   RAD Network Devices */
314 		    /* 0x81B7 - 0x81B9	   Xyplex */
315 		    /* 0x81CC - 0x81D5	   Apricot Computers */
316 		    /* 0x81D6 - 0x81DD	   Artisoft Lantastic */
317 		    /* 0x81E6 - 0x81EF	   Polygon */
318 		    /* 0x81F0 - 0x81F2	   Comsat Labs */
319 		    /* 0x81F3 - 0x81F5	   SAIC */
320 		    /* 0x81F6 - 0x81F8	   VG Analytical */
321 		    /* 0x8203 - 0x8205	   QNX Software Systems Ltd. */
322 		    /* 0x8221 - 0x8222	   Ascom Banking Systems */
323 		    /* 0x823E - 0x8240	   Advanced Encryption Systems */
324 		    /* 0x8263 - 0x826A	   Charles River Data Systems */
325 		    /* 0x827F - 0x8282	   Athena Programming */
326 		    /* 0x829A - 0x829B	   Inst Ind Info Tech */
327 		    /* 0x829C - 0x82AB	   Taurus Controls */
328 		    /* 0x82AC - 0x8693	   Walker Richer & Quinn */
329 #define	ETHERTYPE_ACCTON	0x8390	/* Accton Technologies (unregistered) */
330 #define	ETHERTYPE_TALARISMC	0x852B	/* Talaris multicast */
331 #define	ETHERTYPE_KALPANA	0x8582	/* Kalpana */
332 		    /* 0x8694 - 0x869D	   Idea Courier */
333 		    /* 0x869E - 0x86A1	   Computer Network Tech */
334 		    /* 0x86A3 - 0x86AC	   Gateway Communications */
335 #define	ETHERTYPE_SECTRA	0x86DB	/* SECTRA */
336 #define	ETHERTYPE_IPV6		0x86DD	/* IP protocol version 6 */
337 #define	ETHERTYPE_DELTACON	0x86DE	/* Delta Controls */
338 #define	ETHERTYPE_ATOMIC	0x86DF	/* ATOMIC */
339 		    /* 0x86E0 - 0x86EF	   Landis & Gyr Powers */
340 		    /* 0x8700 - 0x8710	   Motorola */
341 #define	ETHERTYPE_RDP		0x8739	/* Control Technology Inc. RDP Without IP */
342 #define	ETHERTYPE_MICP		0x873A	/* Control Technology Inc. Mcast Industrial Ctrl Proto. */
343 		    /* 0x873B - 0x873C	   Control Technology Inc. Proprietary */
344 #define	ETHERTYPE_TCPCOMP	0x876B	/* TCP/IP Compression (RFC1701) */
345 #define	ETHERTYPE_IPAS		0x876C	/* IP Autonomous Systems (RFC1701) */
346 #define	ETHERTYPE_SECUREDATA	0x876D	/* Secure Data (RFC1701) */
347 #define	ETHERTYPE_FLOWCONTROL	0x8808	/* 802.3x flow control packet */
348 #define	ETHERTYPE_SLOW		0x8809	/* 802.3ad link aggregation (LACP) */
349 #define	ETHERTYPE_PPP		0x880B	/* PPP (obsolete by PPPoE) */
350 #define	ETHERTYPE_HITACHI	0x8820	/* Hitachi Cable (Optoelectronic Systems Laboratory) */
351 #define	ETHERTYPE_TEST		0x8822	/* Network Conformance Testing */
352 #define	ETHERTYPE_MPLS		0x8847	/* MPLS Unicast */
353 #define	ETHERTYPE_MPLS_MCAST	0x8848	/* MPLS Multicast */
354 #define	ETHERTYPE_AXIS		0x8856	/* Axis Communications AB proprietary bootstrap/config */
355 #define	ETHERTYPE_PPPOEDISC	0x8863	/* PPP Over Ethernet Discovery Stage */
356 #define	ETHERTYPE_PPPOE		0x8864	/* PPP Over Ethernet Session Stage */
357 #define	ETHERTYPE_LANPROBE	0x8888	/* HP LanProbe test? */
358 #define	ETHERTYPE_PAE		0x888E	/* EAPOL PAE/802.1x */
359 #define	ETHERTYPE_PROFINET	0x8892	/* PROFINET RT Protocol */
360 #define	ETHERTYPE_AOE		0x88A2	/* ATA Protocol */
361 #define	ETHERTYPE_ETHERCAT	0x88A4	/* EtherCat Protocol */
362 #define	ETHERTYPE_QINQ		0x88A8	/* 802.1ad VLAN stacking */
363 #define	ETHERTYPE_POWERLINK	0x88AB	/* Ethernet Powerlink (EPL) */
364 #define	ETHERTYPE_LLDP		0x88CC	/* Link Layer Discovery Protocol */
365 #define	ETHERTYPE_SERCOS	0x88CD	/* SERCOS III Protocol */
366 #define	ETHERTYPE_MACSEC	0x88E5	/* 802.1AE MAC Security */
367 #define	ETHERTYPE_PBB		0x88E7	/* 802.1Q Provider Backbone Bridges */
368 #define	ETHERTYPE_FCOE		0x8906	/* Fibre Channel over Ethernet */
369 #define	ETHERTYPE_LOOPBACK	0x9000	/* Loopback: used to test interfaces */
370 #define	ETHERTYPE_8021Q9100	0x9100	/* IEEE 802.1Q stacking (proprietary) */
371 #define	ETHERTYPE_LBACK		ETHERTYPE_LOOPBACK	/* DEC MOP loopback */
372 #define	ETHERTYPE_XNSSM		0x9001	/* 3Com (Formerly Bridge Communications), XNS Systems Management */
373 #define	ETHERTYPE_TCPSM		0x9002	/* 3Com (Formerly Bridge Communications), TCP/IP Systems Management */
374 #define	ETHERTYPE_BCLOOP	0x9003	/* 3Com (Formerly Bridge Communications), loopback detection */
375 #define	ETHERTYPE_8021Q9200	0x9200	/* IEEE 802.1Q stacking (proprietary) */
376 #define	ETHERTYPE_8021Q9300	0x9300	/* IEEE 802.1Q stacking (proprietary) */
377 #define	ETHERTYPE_DEBNI		0xAAAA	/* DECNET? Used by VAX 6220 DEBNI */
378 #define	ETHERTYPE_SONIX		0xFAF5	/* Sonix Arpeggio */
379 #define	ETHERTYPE_VITAL		0xFF00	/* BBN VITAL-LanBridge cache wakeups */
380 		    /* 0xFF00 - 0xFFOF	   ISC Bunker Ramo */
381 
382 #define	ETHERTYPE_MAX		0xFFFF	/* Maximum valid ethernet type, reserved */
383 
384 /*
385  * The ETHERTYPE_NTRAILER packet types starting at ETHERTYPE_TRAIL have
386  * (type-ETHERTYPE_TRAIL)*512 bytes of data followed
387  * by an ETHER type (as given above) and then the (variable-length) header.
388  */
389 #define	ETHERTYPE_TRAIL		0x1000		/* Trailer packet */
390 #define	ETHERTYPE_NTRAILER	16
391 
392 #define	ETHERMTU	(ETHER_MAX_LEN-ETHER_HDR_LEN-ETHER_CRC_LEN)
393 #define	ETHERMIN	(ETHER_MIN_LEN-ETHER_HDR_LEN-ETHER_CRC_LEN)
394 #define	ETHERMTU_JUMBO	(ETHER_MAX_LEN_JUMBO - ETHER_HDR_LEN - ETHER_CRC_LEN)
395 /*
396  * The ETHER_BPF_MTAP macro should be used by drivers which support hardware
397  * offload for VLAN tag processing.  It will check the mbuf to see if it has
398  * M_VLANTAG set, and if it does, will pass the packet along to
399  * ether_vlan_mtap.  This function will re-insert VLAN tags for the duration
400  * of the tap, so they show up properly for network analyzers.
401  */
402 #define	ETHER_BPF_MTAP(_ifp, _m) do {					\
403 	if (bpf_peers_present((_ifp)->if_bpf)) {			\
404 		M_ASSERTVALID(_m);					\
405 		if (((_m)->m_flags & M_VLANTAG) != 0)			\
406 			ether_vlan_mtap((_ifp)->if_bpf, (_m), NULL, 0);	\
407 		else							\
408 			bpf_mtap((_ifp)->if_bpf, (_m));			\
409 	}								\
410 } while (0)
411 
412 /*
413  * Names for 802.1q priorities ("802.1p").  Notice that in this scheme,
414  * (0 < 1), allowing default 0-tagged traffic to take priority over background
415  * tagged traffic.
416  */
417 #define	IEEE8021Q_PCP_BK	1	/* Background (lowest) */
418 #define	IEEE8021Q_PCP_BE	0	/* Best effort (default) */
419 #define	IEEE8021Q_PCP_EE	2	/* Excellent effort */
420 #define	IEEE8021Q_PCP_CA	3	/* Critical applications */
421 #define	IEEE8021Q_PCP_VI	4	/* Video, < 100ms latency and jitter */
422 #define	IEEE8021Q_PCP_VO	5	/* Voice, < 10ms latency and jitter */
423 #define	IEEE8021Q_PCP_IC	6	/* Internetwork control */
424 #define	IEEE8021Q_PCP_NC	7	/* Network control (highest) */
425 
426 #ifdef _KERNEL
427 
428 #include <sys/_eventhandler.h>
429 
430 struct ifnet;
431 struct mbuf;
432 struct route;
433 struct sockaddr;
434 struct bpf_if;
435 struct ether_8021q_tag;
436 
437 extern	uint32_t ether_crc32_le(const uint8_t *, size_t);
438 extern	uint32_t ether_crc32_be(const uint8_t *, size_t);
439 extern	void ether_demux(struct ifnet *, struct mbuf *);
440 extern	void ether_ifattach(struct ifnet *, const u_int8_t *);
441 extern	void ether_ifdetach(struct ifnet *);
442 #ifdef VIMAGE
443 struct vnet;
444 extern	void ether_reassign(struct ifnet *, struct vnet *, char *);
445 #endif
446 extern	int  ether_ioctl(struct ifnet *, u_long, caddr_t);
447 extern	int  ether_output(struct ifnet *, struct mbuf *,
448 	    const struct sockaddr *, struct route *);
449 extern	int  ether_output_frame(struct ifnet *, struct mbuf *);
450 extern	char *ether_sprintf(const u_int8_t *);
451 void	ether_vlan_mtap(struct bpf_if *, struct mbuf *,
452 	    void *, u_int);
453 struct mbuf  *ether_vlanencap_proto(struct mbuf *, uint16_t, uint16_t);
454 bool	ether_8021q_frame(struct mbuf **mp, struct ifnet *ife,
455 		struct ifnet *p, struct ether_8021q_tag *);
456 void	ether_gen_addr(struct ifnet *ifp, struct ether_addr *hwaddr);
457 
458 static __inline struct mbuf *ether_vlanencap(struct mbuf *m, uint16_t tag)
459 {
460 
461 	return ether_vlanencap_proto(m, tag, ETHERTYPE_VLAN);
462 }
463 
464 /* new ethernet interface attached event */
465 typedef void (*ether_ifattach_event_handler_t)(void *, struct ifnet *);
466 EVENTHANDLER_DECLARE(ether_ifattach_event, ether_ifattach_event_handler_t);
467 
468 #else /* _KERNEL */
469 
470 #include <sys/cdefs.h>
471 
472 /*
473  * Ethernet address conversion/parsing routines.
474  */
475 __BEGIN_DECLS
476 struct	ether_addr *ether_aton(const char *);
477 struct	ether_addr *ether_aton_r(const char *, struct ether_addr *);
478 int	ether_hostton(const char *, struct ether_addr *);
479 int	ether_line(const char *, struct ether_addr *, char *);
480 char 	*ether_ntoa(const struct ether_addr *);
481 char 	*ether_ntoa_r(const struct ether_addr *, char *);
482 int	ether_ntohost(char *, const struct ether_addr *);
483 __END_DECLS
484 
485 #endif /* !_KERNEL */
486 
487 #endif /* !_NET_ETHERNET_H_ */
488