Meg's Mirrors

zig

1	/* $NetBSD: if_media.h,v 1.72 2024/04/18 10:32:03 andvar Exp $ */
2
3	/*-
4	* Copyright (c) 1998, 2000, 2001, 2020 The NetBSD Foundation, Inc.
5	* All rights reserved.
6	*
7	* This code is derived from software contributed to The NetBSD Foundation
8	* by Jason R. Thorpe of the Numerical Aerospace Simulation Facility,
9	* NASA Ames Research Center.
10	*
11	* Redistribution and use in source and binary forms, with or without
12	* modification, are permitted provided that the following conditions
13	* are met:
14	* 1. Redistributions of source code must retain the above copyright
15	* notice, this list of conditions and the following disclaimer.
16	* 2. Redistributions in binary form must reproduce the above copyright
17	* notice, this list of conditions and the following disclaimer in the
18	* documentation and/or other materials provided with the distribution.
19	*
20	* THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
21	* ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
22	* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23	* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
24	* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25	* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26	* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27	* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28	* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29	* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30	* POSSIBILITY OF SUCH DAMAGE.
31	*/
32
33	/*
34	* Copyright (c) 1997
35	* Jonathan Stone and Jason R. Thorpe. All rights reserved.
36	*
37	* This software is derived from information provided by Matt Thomas.
38	*
39	* Redistribution and use in source and binary forms, with or without
40	* modification, are permitted provided that the following conditions
41	* are met:
42	* 1. Redistributions of source code must retain the above copyright
43	* notice, this list of conditions and the following disclaimer.
44	* 2. Redistributions in binary form must reproduce the above copyright
45	* notice, this list of conditions and the following disclaimer in the
46	* documentation and/or other materials provided with the distribution.
47	* 3. All advertising materials mentioning features or use of this software
48	* must display the following acknowledgement:
49	* This product includes software developed by Jonathan Stone
50	* and Jason R. Thorpe for the NetBSD Project.
51	* 4. The names of the authors may not be used to endorse or promote products
52	* derived from this software without specific prior written permission.
53	*
54	* THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR
55	* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
56	* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
57	* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
58	* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
59	* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
60	* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
61	* AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
62	* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
63	* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
64	* SUCH DAMAGE.
65	*/
66
67	#ifndef _NET_IF_MEDIA_H_
68	#define _NET_IF_MEDIA_H_
69
70	/*
71	* Prototypes and definitions for BSD/OS-compatible network interface
72	* media selection.
73	*
74	* Where it is safe to do so, this code strays slightly from the BSD/OS
75	* design. Software which uses the API (device drivers, basically)
76	* shouldn't notice any difference.
77	*
78	* Many thanks to Matt Thomas for providing the information necessary
79	* to implement this interface.
80	*/
81
82	/*
83	* Status bits. THIS IS NOT A MEDIA WORD.
84	*/
85	#define IFM_AVALID 0x00000001 /* Active bit valid */
86	#define IFM_ACTIVE 0x00000002 /* Interface attached to working net */
87
88	/*
89	* if_media Options word:
90	* Bits Use
91	* ---- -------
92	* 0-4 Media subtype MAX SUBTYPE == 255 for ETH and 31 for others
93	* See below (IFM_ETHER part) for the detail.
94	* 5-7 Media type
95	* 8-15 Type specific options
96	* 16-18 Mode (for multi-mode devices)
97	* 19 (Reserved for Future Use)
98	* 20-27 Shared (global) options
99	* 28-31 Instance
100	*
101	* 3 2 1
102	* 1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0
103	* +-------+---------------+-+-----+---------------+-----+---------+
104	* | | |R| | | | |
105	* | IMASK | GMASK |F|MMASK+-----+ OMASK |NMASK| TMASK |
106	* | | |U| |XTMSK| | | |
107	* +-------+---------------+-+-----+-----+---------+-----+---------+
108	* <-----> <---> <--->
109	* IFM_INST() IFM_MODE() IFM_TYPE()
110	*
111	* IFM_SUBTYPE(other than ETH)<------->
112	*
113	* <---> IFM_SUBTYPE(ETH)<------->
114	*
115	*
116	* <-------------> <------------->
117	* IFM_OPTIONS()
118	*/
119
120	/*
121	* Masks
122	*/
123	#define IFM_NMASK 0x000000e0 /* Network type */
124	#define IFM_TMASK 0x0000001f /* Media sub-type */
125	#define IFM_IMASK 0xf0000000 /* Instance */
126	#define IFM_ISHIFT 28 /* Instance shift */
127	#define IFM_OMASK 0x0000ff00 /* Type specific options */
128	#define IFM_MMASK 0x00070000 /* Mode */
129	#define IFM_MSHIFT 16 /* Mode shift */
130	#define IFM_GMASK 0x0ff00000 /* Global options */
131
132	/*
133	* Macros to extract various bits of information from the media word.
134	*/
135	#define IFM_TYPE(x) ((x) & IFM_NMASK)
136	#define IFM_SUBTYPE(x) (IFM_TYPE(x) == IFM_ETHER ? \
137	IFM_ETHER_SUBTYPE_GET(x) : ((x) & IFM_TMASK))
138	#define IFM_TYPE_MATCH(dt, t) \
139	(IFM_TYPE(dt) == 0 || IFM_TYPE(dt) == IFM_TYPE(t))
140	#define IFM_TYPE_SUBTYPE_MATCH(dt, t) \
141	(IFM_TYPE(dt) == IFM_TYPE(t) && IFM_SUBTYPE(dt) == IFM_SUBTYPE(t))
142	#define IFM_INST(x) (((x) & IFM_IMASK) >> IFM_ISHIFT)
143	#define IFM_OPTIONS(x) ((x) & (IFM_OMASK | IFM_GMASK))
144	#define IFM_MODE(x) ((x) & IFM_MMASK)
145
146	#define IFM_INST_MAX IFM_INST(IFM_IMASK)
147	#define IFM_INST_ANY ((u_int) -1)
148
149	/* Mask of "status valid" bits, for ifconfig(8). */
150	#define IFM_STATUS_VALID IFM_AVALID
151
152	/* List of "status valid" bits, for ifconfig(8). */
153	#define IFM_STATUS_VALID_LIST { \
154	IFM_AVALID, \
155	0, \
156	}
157
158	/*
159	* Macro to create a media word.
160	*/
161	#define IFM_MAKEWORD(type, subtype, options, instance) \
162	((type) | (subtype) | (options) | ((instance) << IFM_ISHIFT))
163	#define IFM_MAKEMODE(mode) \
164	(((mode) << IFM_MSHIFT) & IFM_MMASK)
165
166	/*
167	* Media type (IFM_NMASK).
168	*/
169	#define IFM_GENERIC 0x00000000 /* Only used for link status reporting */
170	#define IFM_ETHER 0x00000020
171	#define IFM_TOKEN 0x00000040
172	#define IFM_FDDI 0x00000060
173	#define IFM_IEEE80211 0x00000080
174	#define IFM_CARP 0x000000c0 /* Common Address Redundancy Protocol */
175
176	#define IFM_NMIN IFM_ETHER /* lowest Network type */
177	#define IFM_NMAX IFM_NMASK /* highest Network type */
178
179	/*
180	* Shared media sub-types (IFM_TMASK)
181	*/
182	#define IFM_AUTO 0 /* Autoselect best media */
183	#define IFM_MANUAL 1 /* Jumper/dipswitch selects media */
184	#define IFM_NONE 2 /* Deselect all media */
185
186	/*
187	* Shared (global) options (IFM_GMASK)
188	*/
189	#define IFM_FDX 0x00100000 /* Force full duplex */
190	#define IFM_HDX 0x00200000 /* Force half duplex */
191	#define IFM_FLOW 0x00400000 /* enable hardware flow control */
192	#define IFM_FLAG0 0x01000000 /* Driver defined flag */
193	#define IFM_FLAG1 0x02000000 /* Driver defined flag */
194	#define IFM_FLAG2 0x04000000 /* Driver defined flag */
195	#define IFM_LOOP 0x08000000 /* Put hardware in loopback */
196
197	/*
198	* 0: Generic (IFM_GENERIC). Only used for link status reporting.
199	* No any media specific flag.
200	*/
201
202	/*
203	* 1: Ethernet (IFM_ETHER)
204	*
205	* In order to use more than 31 subtypes, Ethernet uses some of the option
206	* bits as part of the subtype field. See the options section below for
207	* relevant definitions.
208	*/
209	#define IFM_ETHER_SUBTYPE(x) (((x) & IFM_TMASK) | \
210	(((x) & (_IFM_ETH_XTMASK >> IFM_ETH_XSHIFT)) << IFM_ETH_XSHIFT))
211	#define IFM_ETHER_SUBTYPE_GET(x) ((x) & (IFM_TMASK | _IFM_ETH_XTMASK))
212	#define _IFM_EX(x) IFM_ETHER_SUBTYPE(x) /* internal shorthand */
213
214	#define IFM_10_T 3 /* 10BaseT - RJ45 */
215	#define IFM_10_2 4 /* 10Base2 - Thinnet */
216	#define IFM_10_5 5 /* 10Base5 - AUI */
217	#define IFM_100_TX 6 /* 100BaseTX - RJ45 */
218	#define IFM_100_FX 7 /* 100BaseFX - Fiber */
219	#define IFM_100_T4 8 /* 100BaseT4 - 4 pair cat 3 */
220	#define IFM_100_VG 9 /* 100VG-AnyLAN */
221	#define IFM_100_T2 10 /* 100BaseT2 */
222	#define IFM_1000_SX 11 /* 1000BaseSX - multi-mode fiber */
223	#define IFM_10_STP 12 /* 10BaseT over shielded TP */
224	#define IFM_10_FL 13 /* 10BaseFL - Fiber */
225	#define IFM_1000_LX 14 /* 1000baseLX - single-mode fiber */
226	#define IFM_1000_CX 15 /* 1000baseCX - 150ohm STP */
227	#define IFM_1000_T 16 /* 1000baseT - 4 pair cat 5 */
228	#define IFM_HPNA_1 17 /* HomePNA 1.0 (1Mb/s) */
229	#define IFM_10G_LR 18 /* 10GbaseLR - single-mode fiber */
230	#define IFM_10G_SR 19 /* 10GBase-SR 850nm Multi-mode */
231	#define IFM_10G_CX4 20 /* 10GBase CX4 copper */
232	#define IFM_2500_SX 21 /* 2500baseSX - multi-mode fiber */
233	#define IFM_1000_BX10 22 /* 1000base-BX10 */
234	#define IFM_10G_TWINAX 23 /* 10GBase Twinax copper */
235	#define IFM_10G_TWINAX_LONG 24 /* 10GBase Twinax Long copper */
236	#define IFM_10G_LRM 25 /* 10GBase-LRM 850nm Multi-mode */
237	#define IFM_10G_T 26 /* 10GBase-T - RJ45 */
238	#define IFM_1000_KX 27 /* 1000base-KX backplane */
239	#define IFM_2500_KX 28 /* 2500base-KX backplane */
240	#define IFM_2500_T 29 /* 2500base-T - RJ45 */
241	#define IFM_5000_T 30 /* 5Gbase-T - RJ45 */
242	#define IFM_OTHER 31 /*
243	* This number indicates "Not listed".
244	* and also used for backward
245	* compatibility.
246	*/
247	#define IFM_1000_SGMII _IFM_EX(32) /* 1G SGMII */
248	#define IFM_5000_KR _IFM_EX(33) /* 5GBASE-KR backplane */
249	#define IFM_10G_AOC _IFM_EX(34) /* 10G active optical cable */
250	#define IFM_10G_CR1 _IFM_EX(35) /* 10GBASE-CR1 Twinax splitter */
251	#define IFM_10G_ER _IFM_EX(36) /* 10GBASE-ER */
252	#define IFM_10G_KR _IFM_EX(37) /* 10GBASE-KR backplane */
253	#define IFM_10G_KX4 _IFM_EX(38) /* 10GBASE-KX4 backplane */
254	#define IFM_10G_LX4 _IFM_EX(39) /* 10GBASE-LX4 */
255	#define IFM_10G_SFI _IFM_EX(40) /* 10G SFI */
256	#define IFM_10G_ZR _IFM_EX(41) /* 10GBASE-ZR */
257	#define IFM_20G_KR2 _IFM_EX(42) /* 20GBASE-KR2 backplane */
258	#define IFM_25G_AOC _IFM_EX(43) /* 25G active optical cable */
259	#define IFM_25G_AUI _IFM_EX(44) /* 25G-AUI-C2C (chip to chip) */
260	#define IFM_25G_CR _IFM_EX(45) /* 25GBASE-CR (twinax) */
261	#define IFM_25G_ACC _IFM_EX(46) /* 25GBASE-ACC */
262	#define IFM_25G_CR_S _IFM_EX(47) /* 25GBASE-CR-S (CR short) */
263	#define IFM_25G_ER _IFM_EX(48) /* 25GBASE-ER */
264	#define IFM_25G_KR _IFM_EX(49) /* 25GBASE-KR */
265	#define IFM_25G_KR_S _IFM_EX(50) /* 25GBASE-KR-S (KR short) */
266	#define IFM_25G_LR _IFM_EX(51) /* 25GBASE-LR */
267	#define IFM_25G_SR _IFM_EX(52) /* 25GBASE-SR */
268	#define IFM_25G_T _IFM_EX(53) /* 25GBASE-T - RJ45 */
269	#define IFM_40G_AOC _IFM_EX(54) /* 40G Active Optical Cable */
270	#define IFM_40G_CR4 _IFM_EX(55) /* 40GBASE-CR4 */
271	#define IFM_40G_ER4 _IFM_EX(56) /* 40GBASE-ER4 */
272	#define IFM_40G_FR _IFM_EX(57) /* 40GBASE-FR */
273	#define IFM_40G_KR4 _IFM_EX(58) /* 40GBASE-KR4 */
274	#define IFM_40G_LR4 _IFM_EX(59) /* 40GBASE-LR4 */
275	#define IFM_40G_SR4 _IFM_EX(60) /* 40GBASE-SR4 */
276	#define IFM_40G_T _IFM_EX(61) /* 40GBASE-T */
277	#define IFM_40G_XLPPI _IFM_EX(62) /* 40G XLPPI */
278	#define IFM_50G_AUI1 _IFM_EX(63) /* 50GAUI-1 */
279	#define IFM_50G_AUI2 _IFM_EX(64) /* 50GAUI-2 */
280	#define IFM_50G_CR _IFM_EX(65) /* 50GBASE-CR */
281	#define IFM_50G_CR2 _IFM_EX(66) /* 50GBASE-CR2 */
282	#define IFM_50G_FR _IFM_EX(67) /* 50GBASE-FR */
283	#define IFM_50G_KR _IFM_EX(68) /* 50GBASE-KR */
284	#define IFM_50G_KR2 _IFM_EX(69) /* 50GBASE-KR2 */
285	#define IFM_50G_LAUI2 _IFM_EX(70) /* 50GLAUI-2 */
286	#define IFM_50G_LR _IFM_EX(71) /* 50GBASE-LR */
287	/* _IFM_EX(72) Not defined yet */
288	#define IFM_50G_SR _IFM_EX(73) /* 50GBASE-SR */
289	#define IFM_50G_SR2 _IFM_EX(74) /* 50GBASE-SR2 */
290	#define IFM_56G_R4 _IFM_EX(75) /* 56GBASE-R4 */
291	#define IFM_100G_CR2 _IFM_EX(76) /* 100GBASE-CR2 (CP2?) */
292	#define IFM_100G_CR4 _IFM_EX(77) /* 100GBASE-CR4 */
293	#define IFM_100G_CR10 _IFM_EX(78) /* 100GBASE-CR10 */
294	#define IFM_100G_DR _IFM_EX(79) /* 100GBASE-DR */
295	#define IFM_100G_ER4 _IFM_EX(80) /* 100GBASE-ER4 */
296	#define IFM_100G_KP4 _IFM_EX(81) /* 100GBASE-KP4 */
297	#define IFM_100G_KR2 _IFM_EX(82) /* 100GBASE-KR2 */
298	#define IFM_100G_KR4 _IFM_EX(83) /* 100GBASE-KR4 */
299	#define IFM_100G_LR4 _IFM_EX(84) /* 100GBASE-LR4 */
300	#define IFM_100G_SR2 _IFM_EX(85) /* 100GBASE-SR2 */
301	#define IFM_100G_SR4 _IFM_EX(86) /* 100GBASE-SR4 */
302	#define IFM_100G_SR10 _IFM_EX(87) /* 100GBASE-SR10 */
303	#define IFM_200G_CR2 _IFM_EX(88) /* 200GBASE-CR2 */
304	#define IFM_200G_CR4 _IFM_EX(89) /* 200GBASE-CR4 */
305	#define IFM_200G_DR4 _IFM_EX(90) /* 200GBASE-DR4 */
306	#define IFM_200G_FR4 _IFM_EX(91) /* 200GBASE-FR4 */
307	#define IFM_200G_KR2 _IFM_EX(92) /* 200GBASE-KR2 */
308	#define IFM_200G_KR4 _IFM_EX(93) /* 200GBASE-KR4 */
309	#define IFM_200G_LR4 _IFM_EX(94) /* 200GBASE-LR4 */
310	#define IFM_200G_SR4 _IFM_EX(95) /* 200GBASE-SR4 */
311	#define IFM_400G_CR4 _IFM_EX(96) /* 400GBASE-CR4 */
312	#define IFM_400G_DR4 _IFM_EX(97) /* 400GBASE-DR4 */
313	#define IFM_400G_FR8 _IFM_EX(98) /* 400GBASE-FR8 */
314	#define IFM_400G_KR4 _IFM_EX(99) /* 400GBASE-KR4 */
315	#define IFM_400G_LR8 _IFM_EX(100) /* 400GBASE-LR8 */
316	#define IFM_400G_SR16 _IFM_EX(101) /* 400GBASE-SR16 */
317	#define IFM_100G_ACC _IFM_EX(102) /* 100GBASE-ACC */
318	#define IFM_100G_AOC _IFM_EX(103) /* 100GBASE-AOC */
319	#define IFM_100G_FR _IFM_EX(104) /* 100GBASE-FR */
320	#define IFM_100G_LR _IFM_EX(105) /* 100GBASE-LR */
321	#define IFM_200G_ER4 _IFM_EX(106) /* 200GBASE-ER4 */
322	#define IFM_400G_ER8 _IFM_EX(107) /* 400GBASE-ER8 */
323	#define IFM_400G_FR4 _IFM_EX(108) /* 400GBASE-FR4 */
324	#define IFM_400G_LR4 _IFM_EX(109) /* 400GBASE-LR4 */
325	#define IFM_400G_SR4_2 _IFM_EX(110) /* 400GBASE-SR4.2 */
326	#define IFM_400G_SR8 _IFM_EX(111) /* 400GBASE-SR8 */
327
328	/* IFM_OMASK bits */
329	#define IFM_ETH_MASTER 0x00000100 /* master mode (1000baseT) */
330	#define IFM_ETH_RXPAUSE 0x00000200 /* receive PAUSE frames */
331	#define IFM_ETH_TXPAUSE 0x00000400 /* transmit PAUSE frames */
332	#define _IFM_ETH_XTMASK 0x0000e000 /* Media sub-type (MSB) */
333	#define IFM_ETH_XSHIFT (13 - 5) /* shift XTYPE next to TMASK */
334
335	/* Ethernet flow control mask */
336	#define IFM_ETH_FMASK (IFM_FLOW | IFM_ETH_RXPAUSE | IFM_ETH_TXPAUSE)
337
338	/*
339	* 2: Token ring (IFM_TOKEN)
340	*/
341	#define IFM_TOK_STP4 3 /* Shielded twisted pair 4m - DB9 */
342	#define IFM_TOK_STP16 4 /* Shielded twisted pair 16m - DB9 */
343	#define IFM_TOK_UTP4 5 /* Unshielded twisted pair 4m - RJ45 */
344	#define IFM_TOK_UTP16 6 /* Unshielded twisted pair 16m - RJ45 */
345	/* IFM_OMASK bits */
346	#define IFM_TOK_ETR 0x00000200 /* Early token release */
347	#define IFM_TOK_SRCRT 0x00000400 /* Enable source routing features */
348	#define IFM_TOK_ALLR 0x00000800 /* All routes / Single route bcast */
349
350	/*
351	* 3: FDDI (IFM_FDDI)
352	*/
353	#define IFM_FDDI_SMF 3 /* Single-mode fiber */
354	#define IFM_FDDI_MMF 4 /* Multi-mode fiber */
355	#define IFM_FDDI_UTP 5 /* CDDI / UTP */
356	#define IFM_FDDI_DA 0x00000100 /* Dual attach / single attach */
357
358	/*
359	* 4: IEEE 802.11 Wireless (IFM_IEEE80211)
360	*/
361	#define IFM_IEEE80211_FH1 3 /* Frequency Hopping 1Mbps */
362	#define IFM_IEEE80211_FH2 4 /* Frequency Hopping 2Mbps */
363	#define IFM_IEEE80211_DS2 5 /* Direct Sequence 2Mbps */
364	#define IFM_IEEE80211_DS5 6 /* Direct Sequence 5Mbps*/
365	#define IFM_IEEE80211_DS11 7 /* Direct Sequence 11Mbps*/
366	#define IFM_IEEE80211_DS1 8 /* Direct Sequence 1Mbps */
367	#define IFM_IEEE80211_DS22 9 /* Direct Sequence 22Mbps */
368	#define IFM_IEEE80211_OFDM6 10 /* OFDM 6Mbps */
369	#define IFM_IEEE80211_OFDM9 11 /* OFDM 9Mbps */
370	#define IFM_IEEE80211_OFDM12 12 /* OFDM 12Mbps */
371	#define IFM_IEEE80211_OFDM18 13 /* OFDM 18Mbps */
372	#define IFM_IEEE80211_OFDM24 14 /* OFDM 24Mbps */
373	#define IFM_IEEE80211_OFDM36 15 /* OFDM 36Mbps */
374	#define IFM_IEEE80211_OFDM48 16 /* OFDM 48Mbps */
375	#define IFM_IEEE80211_OFDM54 17 /* OFDM 54Mbps */
376	#define IFM_IEEE80211_OFDM72 18 /* OFDM 72Mbps */
377	#define IFM_IEEE80211_DS354k 19 /* Direct Sequence 354Kbps */
378	#define IFM_IEEE80211_DS512k 20 /* Direct Sequence 512Kbps */
379	#define IFM_IEEE80211_OFDM3 21 /* OFDM 3Mbps */
380	#define IFM_IEEE80211_OFDM4 22 /* OFDM 4.5Mbps */
381	#define IFM_IEEE80211_OFDM27 23 /* OFDM 27Mbps */
382	/* NB: not enough bits to express MCS fully */
383	#define IFM_IEEE80211_MCS 24 /* HT MCS rate */
384	#define IFM_IEEE80211_VHT 25 /* VHT MCS rate */
385
386	/* IFM_OMASK bits */
387	#define IFM_IEEE80211_ADHOC 0x00000100 /* Operate in Adhoc mode */
388	#define IFM_IEEE80211_HOSTAP 0x00000200 /* Operate in Host AP mode */
389	#define IFM_IEEE80211_MONITOR 0x00000400 /* Operate in Monitor mode */
390	#define IFM_IEEE80211_TURBO 0x00000800 /* Operate in Turbo mode */
391	#define IFM_IEEE80211_IBSS 0x00001000 /* Operate in IBSS mode */
392	#define IFM_IEEE80211_WDS 0x00002000 /* Operate as an WDS master */
393	#define IFM_IEEE80211_MBSS 0x00004000 /* Operate in MBSS mode */
394
395	/* Operating mode (IFM_MMASK) for multi-mode devices */
396	#define IFM_IEEE80211_11A 0x00010000 /* 5 GHz, OFDM mode */
397	#define IFM_IEEE80211_11B 0x00020000 /* Direct Sequence mode */
398	#define IFM_IEEE80211_11G 0x00030000 /* 2 GHz, CCK mode */
399	#define IFM_IEEE80211_FH 0x00040000 /* 2 GHz, GFSK mode */
400	#define IFM_IEEE80211_11NA 0x00050000 /* 5Ghz, HT mode */
401	#define IFM_IEEE80211_11NG 0x00060000 /* 2Ghz, HT mode */
402	#define IFM_IEEE80211_11AC 0x00070000 /* 2Ghz/5Ghz, VHT mode */
403
404
405	/*
406	* 6: Common Address Redundancy Protocol (IFM_CARP)
407	* No any media specific flag.
408	*/
409
410	/*
411	* NetBSD extension not defined in the BSDI API. This is used in various
412	* places to get the canonical description for a given type/subtype.
413	*
414	* In the subtype and mediaopt descriptions, the valid TYPE bits are OR'd
415	* in to indicate which TYPE the subtype/option corresponds to. If no
416	* TYPE is present, it is a shared media/mediaopt.
417	*
418	* Note that these are parsed case-insensitive.
419	*
420	* Order is important. The first matching entry is the canonical name
421	* for a media type; subsequent matches are aliases.
422	*/
423	struct ifmedia_description {
424	int ifmt_word; /* word value; may be masked */
425	const char *ifmt_string; /* description */
426	};
427
428	#define IFM_TYPE_DESCRIPTIONS { \
429	{ IFM_ETHER, "Ethernet" }, \
430	{ IFM_ETHER, "ether" }, \
431	{ IFM_TOKEN, "TokenRing" }, \
432	{ IFM_TOKEN, "token" }, \
433	{ IFM_FDDI, "FDDI" }, \
434	{ IFM_IEEE80211, "IEEE802.11" }, \
435	{ IFM_CARP, "CARP" }, \
436	{ 0, NULL }, \
437	}
438
439	#define IFM_SUBTYPE_DESCRIPTIONS { \
440	{ IFM_AUTO, "autoselect" }, \
441	{ IFM_AUTO, "auto" }, \
442	{ IFM_MANUAL, "manual" }, \
443	{ IFM_NONE, "none" }, \
444	\
445	{ IFM_ETHER | IFM_10_T, "10baseT" }, \
446	{ IFM_ETHER | IFM_10_T, "10baseT/UTP" }, \
447	{ IFM_ETHER | IFM_10_T, "UTP" }, \
448	{ IFM_ETHER | IFM_10_T, "10UTP" }, \
449	{ IFM_ETHER | IFM_10_T, "10BASE-T" }, \
450	{ IFM_ETHER | IFM_10_2, "10base2" }, \
451	{ IFM_ETHER | IFM_10_2, "10base2/BNC" }, \
452	{ IFM_ETHER | IFM_10_2, "BNC" }, \
453	{ IFM_ETHER | IFM_10_2, "10BNC" }, \
454	{ IFM_ETHER | IFM_10_2, "10BASE2" }, \
455	{ IFM_ETHER | IFM_10_5, "10base5" }, \
456	{ IFM_ETHER | IFM_10_5, "10base5/AUI" }, \
457	{ IFM_ETHER | IFM_10_5, "AUI" }, \
458	{ IFM_ETHER | IFM_10_5, "10AUI" }, \
459	{ IFM_ETHER | IFM_10_5, "10BASE5" }, \
460	{ IFM_ETHER | IFM_100_TX, "100baseTX" }, \
461	{ IFM_ETHER | IFM_100_TX, "100TX" }, \
462	{ IFM_ETHER | IFM_100_TX, "100BASE-TX" }, \
463	{ IFM_ETHER | IFM_100_FX, "100baseFX" }, \
464	{ IFM_ETHER | IFM_100_FX, "100FX" }, \
465	{ IFM_ETHER | IFM_100_FX, "100BASE-FX" }, \
466	{ IFM_ETHER | IFM_100_T4, "100baseT4" }, \
467	{ IFM_ETHER | IFM_100_T4, "100T4" }, \
468	{ IFM_ETHER | IFM_100_T4, "100BASE-T4" }, \
469	{ IFM_ETHER | IFM_100_VG, "100baseVG" }, \
470	{ IFM_ETHER | IFM_100_VG, "100VG" }, \
471	{ IFM_ETHER | IFM_100_VG, "100VG-AnyLAN" }, \
472	{ IFM_ETHER | IFM_100_T2, "100baseT2" }, \
473	{ IFM_ETHER | IFM_100_T2, "100T2" }, \
474	{ IFM_ETHER | IFM_100_T2, "100BASE-T2" }, \
475	{ IFM_ETHER | IFM_1000_SX, "1000baseSX" }, \
476	{ IFM_ETHER | IFM_1000_SX, "1000SX" }, \
477	{ IFM_ETHER | IFM_1000_SX, "1000BASE-SX" }, \
478	{ IFM_ETHER | IFM_10_STP, "10baseSTP" }, \
479	{ IFM_ETHER | IFM_10_STP, "STP" }, \
480	{ IFM_ETHER | IFM_10_STP, "10STP" }, \
481	{ IFM_ETHER | IFM_10_STP, "10BASE-STP" }, \
482	{ IFM_ETHER | IFM_10_FL, "10baseFL" }, \
483	{ IFM_ETHER | IFM_10_FL, "FL" }, \
484	{ IFM_ETHER | IFM_10_FL, "10FL" }, \
485	{ IFM_ETHER | IFM_10_FL, "10BASE-FL" }, \
486	{ IFM_ETHER | IFM_1000_LX, "1000baseLX" }, \
487	{ IFM_ETHER | IFM_1000_LX, "1000LX" }, \
488	{ IFM_ETHER | IFM_1000_LX, "1000BASE-LX" }, \
489	{ IFM_ETHER | IFM_1000_CX, "1000baseCX" }, \
490	{ IFM_ETHER | IFM_1000_CX, "1000CX" }, \
491	{ IFM_ETHER | IFM_1000_CX, "1000BASE-CX" }, \
492	{ IFM_ETHER | IFM_1000_BX10, "1000BASE-BX10" }, \
493	{ IFM_ETHER | IFM_1000_KX, "1000BASE-KX" }, \
494	{ IFM_ETHER | IFM_1000_KX, "1000baseKX" }, \
495	{ IFM_ETHER | IFM_1000_T, "1000baseT" }, \
496	{ IFM_ETHER | IFM_1000_T, "1000T" }, \
497	{ IFM_ETHER | IFM_1000_T, "1000BASE-T" }, \
498	{ IFM_ETHER | IFM_HPNA_1, "HomePNA1" }, \
499	{ IFM_ETHER | IFM_HPNA_1, "HPNA1" }, \
500	{ IFM_ETHER | IFM_2500_KX | IFM_FDX, "2500BASE-KX" }, \
501	{ IFM_ETHER | IFM_2500_KX | IFM_FDX, "2500baseKX" }, \
502	{ IFM_ETHER | IFM_2500_T | IFM_FDX, "2.5GBASE-T" }, \
503	{ IFM_ETHER | IFM_2500_T | IFM_FDX, "2500baseT" }, \
504	{ IFM_ETHER | IFM_5000_T | IFM_FDX, "5GBASE-T" }, \
505	{ IFM_ETHER | IFM_5000_T | IFM_FDX, "5GbaseT" }, \
506	{ IFM_ETHER | IFM_OTHER, "Other" }, \
507	{ IFM_ETHER | IFM_10G_LR | IFM_FDX, "10GbaseLR" }, \
508	{ IFM_ETHER | IFM_10G_LR | IFM_FDX, "10GLR" }, \
509	{ IFM_ETHER | IFM_10G_LR | IFM_FDX, "10GBASE-LR" }, \
510	{ IFM_ETHER | IFM_10G_SR | IFM_FDX, "10GbaseSR" }, \
511	{ IFM_ETHER | IFM_10G_SR | IFM_FDX, "10GSR" }, \
512	{ IFM_ETHER | IFM_10G_SR | IFM_FDX, "10GBASE-SR" }, \
513	{ IFM_ETHER | IFM_10G_LRM | IFM_FDX, "10Gbase-LRM" }, \
514	{ IFM_ETHER | IFM_10G_TWINAX | IFM_FDX, "10Gbase-Twinax" }, \
515	{ IFM_ETHER | IFM_10G_TWINAX_LONG | IFM_FDX, "10Gbase-Twinax-Long" },\
516	{ IFM_ETHER | IFM_10G_T | IFM_FDX, "10Gbase-T" }, \
517	{ IFM_ETHER | IFM_10G_CX4 | IFM_FDX, "10GbaseCX4" }, \
518	{ IFM_ETHER | IFM_10G_CX4 | IFM_FDX, "10GCX4" }, \
519	{ IFM_ETHER | IFM_10G_CX4 | IFM_FDX, "10GBASE-CX4" }, \
520	{ IFM_ETHER | IFM_2500_SX | IFM_FDX, "2500baseSX" }, \
521	{ IFM_ETHER | IFM_2500_SX | IFM_FDX, "2500SX" }, \
522	{ IFM_ETHER | IFM_1000_SGMII | IFM_FDX, "1000BASE-SGMII" }, \
523	{ IFM_ETHER | IFM_5000_KR | IFM_FDX, "5GBASE-KR" }, \
524	{ IFM_ETHER | IFM_10G_AOC | IFM_FDX, "10GBASE-AOC" }, \
525	{ IFM_ETHER | IFM_10G_CR1 | IFM_FDX, "10GBASE-CR1" }, \
526	{ IFM_ETHER | IFM_10G_ER | IFM_FDX, "10GBASE-ER" }, \
527	{ IFM_ETHER | IFM_10G_KR | IFM_FDX, "10GBASE-KR" }, \
528	{ IFM_ETHER | IFM_10G_KX4 | IFM_FDX, "10GBASE-KX4" }, \
529	{ IFM_ETHER | IFM_10G_LX4 | IFM_FDX, "10GBASE-LX4" }, \
530	{ IFM_ETHER | IFM_10G_SFI | IFM_FDX, "10GBASE-SFI" }, \
531	{ IFM_ETHER | IFM_10G_ZR | IFM_FDX, "10GBASE-ZR" }, \
532	{ IFM_ETHER | IFM_20G_KR2 | IFM_FDX, "20GBASE-KR2" }, \
533	{ IFM_ETHER | IFM_25G_ACC | IFM_FDX, "25GBASE-ACC" }, \
534	{ IFM_ETHER | IFM_25G_AOC | IFM_FDX, "25GBASE-AOC" }, \
535	{ IFM_ETHER | IFM_25G_AUI | IFM_FDX, "25G-AUI" }, \
536	{ IFM_ETHER | IFM_25G_CR | IFM_FDX, "25GBASE-CR" }, \
537	{ IFM_ETHER | IFM_25G_CR_S | IFM_FDX, "25GBASE-CR-S" }, \
538	{ IFM_ETHER | IFM_25G_ER | IFM_FDX, "25GBASE-ER" }, \
539	{ IFM_ETHER | IFM_25G_KR | IFM_FDX, "25GBASE-KR" }, \
540	{ IFM_ETHER | IFM_25G_KR_S | IFM_FDX, "25GBASE-KR-S" }, \
541	{ IFM_ETHER | IFM_25G_LR | IFM_FDX, "25GBASE-LR" }, \
542	{ IFM_ETHER | IFM_25G_SR | IFM_FDX, "25GBASE-SR" }, \
543	{ IFM_ETHER | IFM_25G_T | IFM_FDX, "25GBASE-T" }, \
544	{ IFM_ETHER | IFM_40G_AOC | IFM_FDX, "40GBASE-AOC" }, \
545	{ IFM_ETHER | IFM_40G_CR4 | IFM_FDX, "40GBASE-CR4" }, \
546	{ IFM_ETHER | IFM_40G_ER4 | IFM_FDX, "40GBASE-ER4" }, \
547	{ IFM_ETHER | IFM_40G_FR | IFM_FDX, "40GBASE-FR" }, \
548	{ IFM_ETHER | IFM_40G_KR4 | IFM_FDX, "40GBASE-KR4" }, \
549	{ IFM_ETHER | IFM_40G_LR4 | IFM_FDX, "40GBASE-LR4" }, \
550	{ IFM_ETHER | IFM_40G_SR4 | IFM_FDX, "40GBASE-SR4" }, \
551	{ IFM_ETHER | IFM_40G_T | IFM_FDX, "40GBASE-T" }, \
552	{ IFM_ETHER | IFM_40G_XLPPI | IFM_FDX, "40G-XLPPI" }, \
553	{ IFM_ETHER | IFM_50G_AUI1 | IFM_FDX, "50GAUI-1" }, \
554	{ IFM_ETHER | IFM_50G_AUI2 | IFM_FDX, "50GAUI-2" }, \
555	{ IFM_ETHER | IFM_50G_CR | IFM_FDX, "50GBASE-CR" }, \
556	{ IFM_ETHER | IFM_50G_CR2 | IFM_FDX, "50GBASE-CR2" }, \
557	{ IFM_ETHER | IFM_50G_FR | IFM_FDX, "50GBASE-FR" }, \
558	{ IFM_ETHER | IFM_50G_KR | IFM_FDX, "50GBASE-KR" }, \
559	{ IFM_ETHER | IFM_50G_KR2 | IFM_FDX, "50GBASE-KR2" }, \
560	{ IFM_ETHER | IFM_50G_LAUI2 | IFM_FDX, "50GLAUI-2" }, \
561	{ IFM_ETHER | IFM_50G_LR | IFM_FDX, "50GBASE-LR" }, \
562	{ IFM_ETHER | IFM_50G_SR | IFM_FDX, "50GBASE-SR" }, \
563	{ IFM_ETHER | IFM_50G_SR2 | IFM_FDX, "50GBASE-SR2" }, \
564	{ IFM_ETHER | IFM_56G_R4 | IFM_FDX, "56GBASE-R4" }, \
565	{ IFM_ETHER | IFM_100G_ACC | IFM_FDX, "100GBASE-ACC" }, \
566	{ IFM_ETHER | IFM_100G_AOC | IFM_FDX, "100GBASE-AOC" }, \
567	{ IFM_ETHER | IFM_100G_CR2 | IFM_FDX, "100GBASE-CR2" }, \
568	{ IFM_ETHER | IFM_100G_CR4 | IFM_FDX, "100GBASE-CR4" }, \
569	{ IFM_ETHER | IFM_100G_CR10 | IFM_FDX, "100GBASE-CR10" }, \
570	{ IFM_ETHER | IFM_100G_DR | IFM_FDX, "100GBASE-DR" }, \
571	{ IFM_ETHER | IFM_100G_ER4 | IFM_FDX, "100GBASE-ER4" }, \
572	{ IFM_ETHER | IFM_100G_FR | IFM_FDX, "100GBASE-FR" }, \
573	{ IFM_ETHER | IFM_100G_KP4 | IFM_FDX, "100GBASE-KP4" }, \
574	{ IFM_ETHER | IFM_100G_KR2 | IFM_FDX, "100GBASE-KR2" }, \
575	{ IFM_ETHER | IFM_100G_KR4 | IFM_FDX, "100GBASE-KR4" }, \
576	{ IFM_ETHER | IFM_100G_LR | IFM_FDX, "100GBASE-LR" }, \
577	{ IFM_ETHER | IFM_100G_LR4 | IFM_FDX, "100GBASE-LR4" }, \
578	{ IFM_ETHER | IFM_100G_SR2 | IFM_FDX, "100GBASE-SR2" }, \
579	{ IFM_ETHER | IFM_100G_SR4 | IFM_FDX, "100GBASE-SR4" }, \
580	{ IFM_ETHER | IFM_100G_SR10 | IFM_FDX, "100GBASE-SR10" }, \
581	{ IFM_ETHER | IFM_200G_CR2 | IFM_FDX, "200GBASE-CR2" }, \
582	{ IFM_ETHER | IFM_200G_CR4 | IFM_FDX, "200GBASE-CR4" }, \
583	{ IFM_ETHER | IFM_200G_DR4 | IFM_FDX, "200GBASE-DR4" }, \
584	{ IFM_ETHER | IFM_200G_ER4 | IFM_FDX, "200GBASE-ER4" }, \
585	{ IFM_ETHER | IFM_200G_FR4 | IFM_FDX, "200GBASE-FR4" }, \
586	{ IFM_ETHER | IFM_200G_KR2 | IFM_FDX, "200GBASE-KR2" }, \
587	{ IFM_ETHER | IFM_200G_KR4 | IFM_FDX, "200GBASE-KR4" }, \
588	{ IFM_ETHER | IFM_200G_LR4 | IFM_FDX, "200GBASE-LR4" }, \
589	{ IFM_ETHER | IFM_200G_SR4 | IFM_FDX, "200GBASE-SR4" }, \
590	{ IFM_ETHER | IFM_400G_CR4 | IFM_FDX, "400GBASE-CR4" }, \
591	{ IFM_ETHER | IFM_400G_DR4 | IFM_FDX, "400GBASE-DR4" }, \
592	{ IFM_ETHER | IFM_400G_ER8 | IFM_FDX, "400GBASE-ER8" }, \
593	{ IFM_ETHER | IFM_400G_FR4 | IFM_FDX, "400GBASE-FR4" }, \
594	{ IFM_ETHER | IFM_400G_FR8 | IFM_FDX, "400GBASE-FR8" }, \
595	{ IFM_ETHER | IFM_400G_KR4 | IFM_FDX, "400GBASE-KR4" }, \
596	{ IFM_ETHER | IFM_400G_LR4 | IFM_FDX, "400GBASE-LR4" }, \
597	{ IFM_ETHER | IFM_400G_LR8 | IFM_FDX, "400GBASE-LR8" }, \
598	{ IFM_ETHER | IFM_400G_SR4_2 | IFM_FDX, "400GBASE-SR4.2" }, \
599	{ IFM_ETHER | IFM_400G_SR8 | IFM_FDX, "400GBASE-SR8" }, \
600	{ IFM_ETHER | IFM_400G_SR16 | IFM_FDX, "400GBASE-SR16" }, \
601	\
602	{ IFM_TOKEN | IFM_TOK_STP4, "DB9/4Mbit" }, \
603	{ IFM_TOKEN | IFM_TOK_STP4, "4STP" }, \
604	{ IFM_TOKEN | IFM_TOK_STP16, "DB9/16Mbit" }, \
605	{ IFM_TOKEN | IFM_TOK_STP16, "16STP" }, \
606	{ IFM_TOKEN | IFM_TOK_UTP4, "UTP/4Mbit" }, \
607	{ IFM_TOKEN | IFM_TOK_UTP4, "4UTP" }, \
608	{ IFM_TOKEN | IFM_TOK_UTP16, "UTP/16Mbit" }, \
609	{ IFM_TOKEN | IFM_TOK_UTP16, "16UTP" }, \
610	\
611	{ IFM_FDDI | IFM_FDDI_SMF, "Single-mode" }, \
612	{ IFM_FDDI | IFM_FDDI_SMF, "SMF" }, \
613	{ IFM_FDDI | IFM_FDDI_MMF, "Multi-mode" }, \
614	{ IFM_FDDI | IFM_FDDI_MMF, "MMF" }, \
615	{ IFM_FDDI | IFM_FDDI_UTP, "UTP" }, \
616	{ IFM_FDDI | IFM_FDDI_UTP, "CDDI" }, \
617	\
618	/* \
619	* Short-hand for common media+option combos. \
620	*/ \
621	{ IFM_ETHER | IFM_10_T | IFM_FDX, "10baseT-FDX" }, \
622	{ IFM_ETHER | IFM_10_T | IFM_FDX, "10BASE-T-FDX" }, \
623	{ IFM_ETHER | IFM_100_TX | IFM_FDX, "100baseTX-FDX" }, \
624	{ IFM_ETHER | IFM_100_TX | IFM_FDX, "100BASE-TX-FDX" }, \
625	{ IFM_ETHER | IFM_1000_T | IFM_FDX, "1000baseT-FDX" }, \
626	\
627	/* \
628	* IEEE 802.11 \
629	*/ \
630	{ IFM_IEEE80211 | IFM_IEEE80211_FH1, "FH1" }, \
631	{ IFM_IEEE80211 | IFM_IEEE80211_FH2, "FH2" }, \
632	{ IFM_IEEE80211 | IFM_IEEE80211_DS1, "DS1" }, \
633	{ IFM_IEEE80211 | IFM_IEEE80211_DS2, "DS2" }, \
634	{ IFM_IEEE80211 | IFM_IEEE80211_DS5, "DS5" }, \
635	{ IFM_IEEE80211 | IFM_IEEE80211_DS11, "DS11" }, \
636	{ IFM_IEEE80211 | IFM_IEEE80211_DS22, "DS22" }, \
637	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM6, "OFDM6" }, \
638	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM9, "OFDM9" }, \
639	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM12, "OFDM12" }, \
640	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM18, "OFDM18" }, \
641	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM24, "OFDM24" }, \
642	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM36, "OFDM36" }, \
643	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM48, "OFDM48" }, \
644	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM54, "OFDM54" }, \
645	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM72, "OFDM72" }, \
646	{ IFM_IEEE80211 | IFM_IEEE80211_DS354k, "DS/354Kbps" }, \
647	{ IFM_IEEE80211 | IFM_IEEE80211_DS512k, "DS/512Kbps" }, \
648	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM3, "OFDM/3Mbps" }, \
649	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM4, "OFDM/4.5Mbps" }, \
650	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM27, "OFDM/27Mbps" }, \
651	{ IFM_IEEE80211 | IFM_IEEE80211_MCS, "HT" }, \
652	{ IFM_IEEE80211 | IFM_IEEE80211_VHT, "VHT" }, \
653	\
654	{ 0, NULL }, \
655	}
656
657	#define IFM_MODE_DESCRIPTIONS { \
658	{ IFM_AUTO, "autoselect" }, \
659	{ IFM_AUTO, "auto" }, \
660	{ IFM_IEEE80211 | IFM_IEEE80211_11A, "11a" }, \
661	{ IFM_IEEE80211 | IFM_IEEE80211_11B, "11b" }, \
662	{ IFM_IEEE80211 | IFM_IEEE80211_11G, "11g" }, \
663	{ IFM_IEEE80211 | IFM_IEEE80211_FH, "fh" }, \
664	{ IFM_IEEE80211 | IFM_IEEE80211_11NA, "11na" }, \
665	{ IFM_IEEE80211 | IFM_IEEE80211_11NG, "11ng" }, \
666	{ IFM_IEEE80211 | IFM_IEEE80211_11AC, "11ac" }, \
667	{ 0, NULL }, \
668	}
669
670	#define IFM_OPTION_DESCRIPTIONS { \
671	{ IFM_FDX, "full-duplex" }, \
672	{ IFM_FDX, "fdx" }, \
673	{ IFM_HDX, "half-duplex" }, \
674	{ IFM_HDX, "hdx" }, \
675	{ IFM_FLOW, "flowcontrol" }, \
676	{ IFM_FLOW, "flow" }, \
677	{ IFM_FLAG0, "flag0" }, \
678	{ IFM_FLAG1, "flag1" }, \
679	{ IFM_FLAG2, "flag2" }, \
680	{ IFM_LOOP, "loopback" }, \
681	{ IFM_LOOP, "hw-loopback"}, \
682	{ IFM_LOOP, "loop" }, \
683	\
684	{ IFM_ETHER | IFM_ETH_MASTER, "master" }, \
685	{ IFM_ETHER | IFM_ETH_RXPAUSE, "rxpause" }, \
686	{ IFM_ETHER | IFM_ETH_TXPAUSE, "txpause" }, \
687	\
688	{ IFM_TOKEN | IFM_TOK_ETR, "EarlyTokenRelease" }, \
689	{ IFM_TOKEN | IFM_TOK_ETR, "ETR" }, \
690	{ IFM_TOKEN | IFM_TOK_SRCRT, "SourceRouting" }, \
691	{ IFM_TOKEN | IFM_TOK_SRCRT, "SRCRT" }, \
692	{ IFM_TOKEN | IFM_TOK_ALLR, "AllRoutes" }, \
693	{ IFM_TOKEN | IFM_TOK_ALLR, "ALLR" }, \
694	\
695	{ IFM_FDDI | IFM_FDDI_DA, "dual-attach" }, \
696	{ IFM_FDDI | IFM_FDDI_DA, "das" }, \
697	\
698	{ IFM_IEEE80211 | IFM_IEEE80211_ADHOC, "adhoc" }, \
699	{ IFM_IEEE80211 | IFM_IEEE80211_HOSTAP, "hostap" }, \
700	{ IFM_IEEE80211 | IFM_IEEE80211_MONITOR,"monitor" }, \
701	{ IFM_IEEE80211 | IFM_IEEE80211_TURBO, "turbo" }, \
702	{ IFM_IEEE80211 | IFM_IEEE80211_IBSS, "ibss" }, \
703	{ IFM_IEEE80211 | IFM_IEEE80211_WDS, "wds" }, \
704	{ IFM_IEEE80211 | IFM_IEEE80211_MBSS, "mesh" }, \
705	\
706	{ 0, NULL }, \
707	}
708
709	/*
710	* Baudrate descriptions for the various media types.
711	*/
712	struct ifmedia_baudrate {
713	int ifmb_word; /* media word */
714	uint64_t ifmb_baudrate; /* corresponding baudrate */
715	};
716
717	#define IFM_BAUDRATE_DESCRIPTIONS { \
718	{ IFM_ETHER | IFM_10_T, IF_Mbps(10) }, \
719	{ IFM_ETHER | IFM_10_2, IF_Mbps(10) }, \
720	{ IFM_ETHER | IFM_10_5, IF_Mbps(10) }, \
721	{ IFM_ETHER | IFM_100_TX, IF_Mbps(100) }, \
722	{ IFM_ETHER | IFM_100_FX, IF_Mbps(100) }, \
723	{ IFM_ETHER | IFM_100_T4, IF_Mbps(100) }, \
724	{ IFM_ETHER | IFM_100_VG, IF_Mbps(100) }, \
725	{ IFM_ETHER | IFM_100_T2, IF_Mbps(100) }, \
726	{ IFM_ETHER | IFM_1000_SX, IF_Mbps(1000) }, \
727	{ IFM_ETHER | IFM_10_STP, IF_Mbps(10) }, \
728	{ IFM_ETHER | IFM_10_FL, IF_Mbps(10) }, \
729	{ IFM_ETHER | IFM_1000_LX, IF_Mbps(1000) }, \
730	{ IFM_ETHER | IFM_1000_CX, IF_Mbps(1000) }, \
731	{ IFM_ETHER | IFM_1000_T, IF_Mbps(1000) }, \
732	{ IFM_ETHER | IFM_HPNA_1, IF_Mbps(1) }, \
733	{ IFM_ETHER | IFM_10G_LR, IF_Gbps(10ULL) }, \
734	{ IFM_ETHER | IFM_10G_SR, IF_Gbps(10ULL) }, \
735	{ IFM_ETHER | IFM_10G_CX4, IF_Gbps(10ULL) }, \
736	{ IFM_ETHER | IFM_2500_SX, IF_Mbps(2500ULL) }, \
737	{ IFM_ETHER | IFM_1000_BX10, IF_Mbps(1000ULL) }, \
738	{ IFM_ETHER | IFM_10G_TWINAX, IF_Gbps(10) }, \
739	{ IFM_ETHER | IFM_10G_TWINAX_LONG, IF_Gbps(10) }, \
740	{ IFM_ETHER | IFM_10G_LRM, IF_Gbps(10) }, \
741	{ IFM_ETHER | IFM_10G_T, IF_Gbps(10) }, \
742	{ IFM_ETHER | IFM_1000_KX, IF_Mbps(1000ULL) }, \
743	{ IFM_ETHER | IFM_2500_KX, IF_Mbps(2500ULL) }, \
744	{ IFM_ETHER | IFM_2500_T, IF_Mbps(2500ULL) }, \
745	{ IFM_ETHER | IFM_5000_T, IF_Gbps(5) }, \
746	{ IFM_ETHER | IFM_1000_SGMII, IF_Gbps(1) }, \
747	{ IFM_ETHER | IFM_5000_KR, IF_Gbps(5) }, \
748	{ IFM_ETHER | IFM_10G_AOC, IF_Gbps(10) }, \
749	{ IFM_ETHER | IFM_10G_CR1, IF_Gbps(10) }, \
750	{ IFM_ETHER | IFM_10G_ER, IF_Gbps(10) }, \
751	{ IFM_ETHER | IFM_10G_KR, IF_Gbps(10) }, \
752	{ IFM_ETHER | IFM_10G_KX4, IF_Gbps(10) }, \
753	{ IFM_ETHER | IFM_10G_LX4, IF_Gbps(10) }, \
754	{ IFM_ETHER | IFM_10G_SFI, IF_Gbps(10) }, \
755	{ IFM_ETHER | IFM_10G_ZR, IF_Gbps(10) }, \
756	{ IFM_ETHER | IFM_20G_KR2, IF_Gbps(20) }, \
757	{ IFM_ETHER | IFM_25G_ACC, IF_Gbps(25) }, \
758	{ IFM_ETHER | IFM_25G_AOC, IF_Gbps(25) }, \
759	{ IFM_ETHER | IFM_25G_AUI, IF_Gbps(25) }, \
760	{ IFM_ETHER | IFM_25G_CR, IF_Gbps(25) }, \
761	{ IFM_ETHER | IFM_25G_CR_S, IF_Gbps(25) }, \
762	{ IFM_ETHER | IFM_25G_ER, IF_Gbps(25) }, \
763	{ IFM_ETHER | IFM_25G_KR, IF_Gbps(25) }, \
764	{ IFM_ETHER | IFM_25G_KR_S, IF_Gbps(25) }, \
765	{ IFM_ETHER | IFM_25G_LR, IF_Gbps(25) }, \
766	{ IFM_ETHER | IFM_25G_SR, IF_Gbps(25) }, \
767	{ IFM_ETHER | IFM_25G_T, IF_Gbps(25) }, \
768	{ IFM_ETHER | IFM_40G_AOC, IF_Gbps(40) }, \
769	{ IFM_ETHER | IFM_40G_CR4, IF_Gbps(40) }, \
770	{ IFM_ETHER | IFM_40G_ER4, IF_Gbps(40) }, \
771	{ IFM_ETHER | IFM_40G_FR, IF_Gbps(40) }, \
772	{ IFM_ETHER | IFM_40G_KR4, IF_Gbps(40) }, \
773	{ IFM_ETHER | IFM_40G_LR4, IF_Gbps(40) }, \
774	{ IFM_ETHER | IFM_40G_SR4, IF_Gbps(40) }, \
775	{ IFM_ETHER | IFM_40G_T, IF_Gbps(40) }, \
776	{ IFM_ETHER | IFM_40G_XLPPI, IF_Gbps(40) }, \
777	{ IFM_ETHER | IFM_50G_AUI1, IF_Gbps(50) }, \
778	{ IFM_ETHER | IFM_50G_AUI2, IF_Gbps(50) }, \
779	{ IFM_ETHER | IFM_50G_CR, IF_Gbps(50) }, \
780	{ IFM_ETHER | IFM_50G_CR2, IF_Gbps(50) }, \
781	{ IFM_ETHER | IFM_50G_FR, IF_Gbps(50) }, \
782	{ IFM_ETHER | IFM_50G_KR, IF_Gbps(50) }, \
783	{ IFM_ETHER | IFM_50G_KR2, IF_Gbps(50) }, \
784	{ IFM_ETHER | IFM_50G_LAUI2, IF_Gbps(50) }, \
785	{ IFM_ETHER | IFM_50G_LR, IF_Gbps(50) }, \
786	{ IFM_ETHER | IFM_50G_SR, IF_Gbps(50) }, \
787	{ IFM_ETHER | IFM_50G_SR2, IF_Gbps(50) }, \
788	{ IFM_ETHER | IFM_56G_R4, IF_Gbps(56) }, \
789	{ IFM_ETHER | IFM_100G_ACC, IF_Gbps(100) }, \
790	{ IFM_ETHER | IFM_100G_AOC, IF_Gbps(100) }, \
791	{ IFM_ETHER | IFM_100G_CR2, IF_Gbps(100) }, \
792	{ IFM_ETHER | IFM_100G_CR4, IF_Gbps(100) }, \
793	{ IFM_ETHER | IFM_100G_CR10, IF_Gbps(100) }, \
794	{ IFM_ETHER | IFM_100G_DR, IF_Gbps(100) }, \
795	{ IFM_ETHER | IFM_100G_ER4, IF_Gbps(100) }, \
796	{ IFM_ETHER | IFM_100G_FR, IF_Gbps(100) }, \
797	{ IFM_ETHER | IFM_100G_KP4, IF_Gbps(100) }, \
798	{ IFM_ETHER | IFM_100G_KR2, IF_Gbps(100) }, \
799	{ IFM_ETHER | IFM_100G_KR4, IF_Gbps(100) }, \
800	{ IFM_ETHER | IFM_100G_LR, IF_Gbps(100) }, \
801	{ IFM_ETHER | IFM_100G_LR4, IF_Gbps(100) }, \
802	{ IFM_ETHER | IFM_100G_SR2, IF_Gbps(100) }, \
803	{ IFM_ETHER | IFM_100G_SR4, IF_Gbps(100) }, \
804	{ IFM_ETHER | IFM_100G_SR10, IF_Gbps(100) }, \
805	{ IFM_ETHER | IFM_200G_CR2, IF_Gbps(200) }, \
806	{ IFM_ETHER | IFM_200G_CR4, IF_Gbps(200) }, \
807	{ IFM_ETHER | IFM_200G_DR4, IF_Gbps(200) }, \
808	{ IFM_ETHER | IFM_200G_ER4, IF_Gbps(200) }, \
809	{ IFM_ETHER | IFM_200G_FR4, IF_Gbps(200) }, \
810	{ IFM_ETHER | IFM_200G_KR2, IF_Gbps(200) }, \
811	{ IFM_ETHER | IFM_200G_KR4, IF_Gbps(200) }, \
812	{ IFM_ETHER | IFM_200G_LR4, IF_Gbps(200) }, \
813	{ IFM_ETHER | IFM_200G_SR4, IF_Gbps(200) }, \
814	{ IFM_ETHER | IFM_400G_CR4, IF_Gbps(400) }, \
815	{ IFM_ETHER | IFM_400G_DR4, IF_Gbps(400) }, \
816	{ IFM_ETHER | IFM_400G_ER8, IF_Gbps(400) }, \
817	{ IFM_ETHER | IFM_400G_FR4, IF_Gbps(400) }, \
818	{ IFM_ETHER | IFM_400G_FR8, IF_Gbps(400) }, \
819	{ IFM_ETHER | IFM_400G_KR4, IF_Gbps(400) }, \
820	{ IFM_ETHER | IFM_400G_LR4, IF_Gbps(400) }, \
821	{ IFM_ETHER | IFM_400G_LR8, IF_Gbps(400) }, \
822	{ IFM_ETHER | IFM_400G_SR4_2, IF_Gbps(400) }, \
823	{ IFM_ETHER | IFM_400G_SR8, IF_Gbps(400) }, \
824	{ IFM_ETHER | IFM_400G_SR16, IF_Gbps(400) }, \
825	\
826	{ IFM_TOKEN | IFM_TOK_STP4, IF_Mbps(4) }, \
827	{ IFM_TOKEN | IFM_TOK_STP16, IF_Mbps(16) }, \
828	{ IFM_TOKEN | IFM_TOK_UTP4, IF_Mbps(4) }, \
829	{ IFM_TOKEN | IFM_TOK_UTP16, IF_Mbps(16) }, \
830	\
831	{ IFM_FDDI | IFM_FDDI_SMF, IF_Mbps(100) }, \
832	{ IFM_FDDI | IFM_FDDI_MMF, IF_Mbps(100) }, \
833	{ IFM_FDDI | IFM_FDDI_UTP, IF_Mbps(100) }, \
834	\
835	{ IFM_IEEE80211 | IFM_IEEE80211_FH1, IF_Mbps(1) }, \
836	{ IFM_IEEE80211 | IFM_IEEE80211_FH2, IF_Mbps(2) }, \
837	{ IFM_IEEE80211 | IFM_IEEE80211_DS2, IF_Mbps(2) }, \
838	{ IFM_IEEE80211 | IFM_IEEE80211_DS5, IF_Kbps(5500) }, \
839	{ IFM_IEEE80211 | IFM_IEEE80211_DS11, IF_Mbps(11) }, \
840	{ IFM_IEEE80211 | IFM_IEEE80211_DS1, IF_Mbps(1) }, \
841	{ IFM_IEEE80211 | IFM_IEEE80211_DS22, IF_Mbps(22) }, \
842	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM6, IF_Mbps(6) }, \
843	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM9, IF_Mbps(9) }, \
844	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM12, IF_Mbps(12) }, \
845	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM18, IF_Mbps(18) }, \
846	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM24, IF_Mbps(24) }, \
847	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM36, IF_Mbps(36) }, \
848	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM48, IF_Mbps(48) }, \
849	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM54, IF_Mbps(54) }, \
850	{ IFM_IEEE80211 | IFM_IEEE80211_OFDM72, IF_Mbps(72) }, \
851	\
852	{ 0, 0 }, \
853	}
854
855	/*
856	* Status bit descriptions for the various media types.
857	*/
858	struct ifmedia_status_description {
859	int ifms_type;
860	int ifms_valid;
861	int ifms_bit;
862	const char *ifms_string[2];
863	};
864
865	#define IFM_STATUS_DESC(ifms, bit) \
866	(ifms)->ifms_string[((ifms)->ifms_bit & (bit)) ? 1 : 0]
867
868	#define IFM_STATUS_DESCRIPTIONS { \
869	{ IFM_GENERIC, IFM_AVALID, IFM_ACTIVE, \
870	{ "no network", "active" } }, \
871	\
872	{ IFM_ETHER, IFM_AVALID, IFM_ACTIVE, \
873	{ "no carrier", "active" } }, \
874	\
875	{ IFM_FDDI, IFM_AVALID, IFM_ACTIVE, \
876	{ "no ring", "inserted" } }, \
877	\
878	{ IFM_TOKEN, IFM_AVALID, IFM_ACTIVE, \
879	{ "no ring", "inserted" } }, \
880	\
881	{ IFM_IEEE80211, IFM_AVALID, IFM_ACTIVE, \
882	{ "no network", "active" } }, \
883	\
884	{ IFM_CARP, IFM_AVALID, IFM_ACTIVE, \
885	{ "backup", "master" } }, \
886	\
887	{ 0, 0, 0, \
888	{ NULL, NULL } }, \
889	}
890
891	#ifdef _KERNEL
892	#include <sys/mutex.h>
893	#include <sys/queue.h>
894
895	/*
896	* Driver callbacks for media status and change requests.
897	*/
898	typedef int (*ifm_change_cb_t)(struct ifnet *);
899	typedef void (*ifm_stat_cb_t)(struct ifnet *, struct ifmediareq *);
900
901	/*
902	* In-kernel representation of a single supported media type.
903	*/
904	struct ifmedia_entry {
905	TAILQ_ENTRY(ifmedia_entry) ifm_list;
906	u_int ifm_media; /* IFMWD: description of this media */
907	u_int ifm_data; /* for driver-specific use */
908	void *ifm_aux; /* for driver-specific use */
909	};
910
911	/*
912	* One of these goes into a network interface's softc structure.
913	* It is used to keep general media state.
914	*
915	* LOCKING
916	* =======
917	* The ifmedia is protected by a lock provided by the interface
918	* driver. All ifmedia API entry points (with the exception of one)
919	* are expect to be called with this mutex NOT HELD.
920	*
921	* ifmedia_ioctl() is called with the interface's if_ioctl_lock held,
922	* and thus the locking order is:
923	*
924	* IFNET_LOCK -> ifm_lock
925	*
926	* Driver callbacks (ifm_change / ifm_status) are called with ifm_lock HELD.
927	*
928	* Field markings and the corresponding locks:
929	*
930	* m: ifm_lock
931	* :: unlocked, stable
932	*/
933	struct ifmedia {
934	kmutex_t *ifm_lock; /* :: mutex (provided by interface driver) */
935	u_int ifm_mask; /* :: IFMWD: mask of changes we don't care */
936	u_int ifm_media; /*
937	* m: IFMWD: current user-set media word.
938	*
939	* XXX some drivers misuse this entry as
940	* current active media word. Don't use this
941	* entry as this purpose but use driver
942	* specific entry if you don't use mii(4).
943	*/
944	struct ifmedia_entry *ifm_cur; /*
945	* m: entry corresponding to
946	* ifm_media
947	*/
948	TAILQ_HEAD(, ifmedia_entry) ifm_list; /*
949	* m: list of all supported
950	* media
951	*/
952	ifm_change_cb_t ifm_change; /* :: media change driver callback */
953	ifm_stat_cb_t ifm_status; /* :: media status driver callback */
954	uintptr_t ifm_legacy; /* m: legacy driver handling */
955	};
956
957	#define ifmedia_lock(ifm) mutex_enter((ifm)->ifm_lock)
958	#define ifmedia_unlock(ifm) mutex_exit((ifm)->ifm_lock)
959	#define ifmedia_locked(ifm) mutex_owned((ifm)->ifm_lock)
960
961	#ifdef __IFMEDIA_PRIVATE
962	#define ifmedia_islegacy(ifm) ((ifm)->ifm_legacy)
963	void ifmedia_lock_for_legacy(struct ifmedia *);
964	void ifmedia_unlock_for_legacy(struct ifmedia *);
965
966	#define IFMEDIA_LOCK_FOR_LEGACY(ifm) \
967	do { \
968	if (ifmedia_islegacy(ifm)) \
969	ifmedia_lock_for_legacy(ifm); \
970	} while (/*CONSTCOND*/0)
971
972	#define IFMEDIA_UNLOCK_FOR_LEGACY(ifm) \
973	do { \
974	if (ifmedia_islegacy(ifm)) \
975	ifmedia_unlock_for_legacy(ifm); \
976	} while (/*CONSTCOND*/0)
977	#endif /* __IFMEDIA_PRIVATE */
978
979	/* Initialize an interface's struct if_media field. */
980	void ifmedia_init(struct ifmedia *, int, ifm_change_cb_t, ifm_stat_cb_t);
981	void ifmedia_init_with_lock(struct ifmedia *, int, ifm_change_cb_t,
982	ifm_stat_cb_t, kmutex_t *);
983
984	/* Release resources associated with an ifmedia. */
985	void ifmedia_fini(struct ifmedia *);
986
987
988	/* Add one supported medium to a struct ifmedia. */
989	void ifmedia_add(struct ifmedia *, int, int, void *);
990
991	/* Add an array (of ifmedia_entry) media to a struct ifmedia. */
992	void ifmedia_list_add(struct ifmedia *, struct ifmedia_entry *, int);
993
994	/* Set default media type on initialization. */
995	void ifmedia_set(struct ifmedia *ifm, int mword);
996
997	/* Common ioctl function for getting/setting media, called by driver. */
998	int ifmedia_ioctl(struct ifnet *, struct ifreq *, struct ifmedia *, u_long);
999
1000	/* Look up a media entry. */
1001	struct ifmedia_entry *ifmedia_match(struct ifmedia *, u_int, u_int);
1002
1003	/* Delete all media for a given media instance */
1004	void ifmedia_delete_instance(struct ifmedia *, u_int);
1005
1006	/* Remove all media */
1007	void ifmedia_removeall(struct ifmedia *);
1008
1009	/* Compute baudrate for a given media. */
1010	uint64_t ifmedia_baudrate(int);
1011
1012	/*
1013	* This is a thin wrapper around the ifmedia "change" callback that
1014	* is available to drivers to use within their own initialization
1015	* routines.
1016	*
1017	* IFMEDIA must be LOCKED.
1018	*/
1019	int ifmedia_change(struct ifmedia *, struct ifnet *);
1020
1021	#else
1022	/* Functions for converting media to/from strings, in libutil/if_media.c */
1023	const char *get_media_type_string(int);
1024	const char *get_media_subtype_string(int);
1025	const char *get_media_mode_string(int);
1026	const char *get_media_option_string(int *);
1027	int get_media_mode(int, const char *);
1028	int get_media_subtype(int, const char *);
1029	int get_media_options(int, const char *, char **);
1030	int lookup_media_word(struct ifmedia_description *, int, const char *);
1031	#endif /* _KERNEL */
1032
1033	#endif /* !_NET_IF_MEDIA_H_ */