]> git.saurik.com Git - apple/xnu.git/blame - bsd/net/if_media.h
xnu-2782.30.5.tar.gz
[apple/xnu.git] / bsd / net / if_media.h
CommitLineData
1c79356b 1/*
39236c6e 2 * Copyright (c) 2000-2013 Apple Inc. All rights reserved.
5d5c5d0d 3 *
2d21ac55 4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
1c79356b 5 *
2d21ac55
A
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. The rights granted to you under the License
10 * may not be used to create, or enable the creation or redistribution of,
11 * unlawful or unlicensed copies of an Apple operating system, or to
12 * circumvent, violate, or enable the circumvention or violation of, any
13 * terms of an Apple operating system software license agreement.
8f6c56a5 14 *
2d21ac55
A
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
17 *
18 * The Original Code and all software distributed under the License are
19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
8f6c56a5
A
20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
2d21ac55
A
22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23 * Please see the License for the specific language governing rights and
24 * limitations under the License.
8f6c56a5 25 *
2d21ac55 26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
1c79356b
A
27 */
28/* $NetBSD: if_media.h,v 1.3 1997/03/26 01:19:27 thorpej Exp $ */
9bccf70c 29/* $FreeBSD: src/sys/net/if_media.h,v 1.9.2.1 2001/07/04 00:12:38 brooks Exp $ */
1c79356b
A
30
31/*
32 * Copyright (c) 1997
33 * Jonathan Stone and Jason R. Thorpe. All rights reserved.
34 *
35 * This software is derived from information provided by Matt Thomas.
36 *
37 * Redistribution and use in source and binary forms, with or without
38 * modification, are permitted provided that the following conditions
39 * are met:
40 * 1. Redistributions of source code must retain the above copyright
41 * notice, this list of conditions and the following disclaimer.
42 * 2. Redistributions in binary form must reproduce the above copyright
43 * notice, this list of conditions and the following disclaimer in the
44 * documentation and/or other materials provided with the distribution.
45 * 3. All advertising materials mentioning features or use of this software
46 * must display the following acknowledgement:
47 * This product includes software developed by Jonathan Stone
48 * and Jason R. Thorpe for the NetBSD Project.
49 * 4. The names of the authors may not be used to endorse or promote products
50 * derived from this software without specific prior written permission.
51 *
52 * THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR
53 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
54 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
55 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
56 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
57 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
58 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
59 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
60 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
61 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
62 * SUCH DAMAGE.
63 */
64
65#ifndef _NET_IF_MEDIA_H_
66#define _NET_IF_MEDIA_H_
9bccf70c 67#include <sys/appleapiopts.h>
1c79356b
A
68
69/*
70 * Prototypes and definitions for BSD/OS-compatible network interface
71 * media selection.
72 *
73 * Where it is safe to do so, this code strays slightly from the BSD/OS
74 * design. Software which uses the API (device drivers, basically)
75 * shouldn't notice any difference.
76 *
77 * Many thanks to Matt Thomas for providing the information necessary
78 * to implement this interface.
79 */
80
91447636 81#ifdef KERNEL_PRIVATE
39236c6e 82/* sigh; some modules are lazy and thus rely on this */
1c79356b 83#include <sys/queue.h>
91447636 84#endif /* KERNEL_PRIVATE */
1c79356b
A
85
86/*
87 * if_media Options word:
88 * Bits Use
89 * ---- -------
90 * 0-4 Media subtype
91 * 5-7 Media type
92 * 8-15 Type specific options
93 * 16-19 RFU
94 * 20-27 Shared (global) options
95 * 28-31 Instance
96 */
97
98/*
99 * Ethernet
100 */
101#define IFM_ETHER 0x00000020
102#define IFM_10_T 3 /* 10BaseT - RJ45 */
103#define IFM_10_2 4 /* 10Base2 - Thinnet */
104#define IFM_10_5 5 /* 10Base5 - AUI */
105#define IFM_100_TX 6 /* 100BaseTX - RJ45 */
106#define IFM_100_FX 7 /* 100BaseFX - Fiber */
107#define IFM_100_T4 8 /* 100BaseT4 - 4 pair cat 3 */
108#define IFM_100_VG 9 /* 100VG-AnyLAN */
109#define IFM_100_T2 10 /* 100BaseT2 */
110#define IFM_1000_SX 11 /* 1000BaseSX - multi-mode fiber */
9bccf70c
A
111#define IFM_10_STP 12 /* 10BaseT over shielded TP */
112#define IFM_10_FL 13 /* 10baseFL - Fiber */
1c79356b
A
113#define IFM_1000_LX 14 /* 1000baseLX - single-mode fiber */
114#define IFM_1000_CX 15 /* 1000baseCX - 150ohm STP */
91447636
A
115#define IFM_1000_T 16 /* 1000baseT - 4 pair cat 5 */
116#ifdef PRIVATE
117#define IFM_1000_TX IFM_1000_T /* For compatibility */
118#endif /* PRIVATE */
1c79356b 119#define IFM_HPNA_1 17 /* HomePNA 1.0 (1Mb/s) */
91447636
A
120#define IFM_10G_SR 18 /* 10GbaseSR - multi-mode fiber */
121#define IFM_10G_LR 19 /* 10GbaseLR - single-mode fiber */
b0d623f7
A
122#define IFM_10G_CX4 20 /* 10GbaseCX4 - copper */
123#define IFM_10G_T 21 /* 10GbaseT - 4 pair cat 6 */
1c79356b
A
124
125/*
126 * Token ring
127 */
128#define IFM_TOKEN 0x00000040
129#define IFM_TOK_STP4 3 /* Shielded twisted pair 4m - DB9 */
130#define IFM_TOK_STP16 4 /* Shielded twisted pair 16m - DB9 */
131#define IFM_TOK_UTP4 5 /* Unshielded twisted pair 4m - RJ45 */
132#define IFM_TOK_UTP16 6 /* Unshielded twisted pair 16m - RJ45 */
9bccf70c
A
133#define IFM_TOK_STP100 7 /* Shielded twisted pair 100m - DB9 */
134#define IFM_TOK_UTP100 8 /* Unshielded twisted pair 100m - RJ45 */
1c79356b
A
135#define IFM_TOK_ETR 0x00000200 /* Early token release */
136#define IFM_TOK_SRCRT 0x00000400 /* Enable source routing features */
137#define IFM_TOK_ALLR 0x00000800 /* All routes / Single route bcast */
9bccf70c
A
138#define IFM_TOK_DTR 0x00002000 /* Dedicated token ring */
139#define IFM_TOK_CLASSIC 0x00004000 /* Classic token ring */
140#define IFM_TOK_AUTO 0x00008000 /* Automatic Dedicate/Classic token ring */
1c79356b
A
141
142/*
143 * FDDI
144 */
145#define IFM_FDDI 0x00000060
146#define IFM_FDDI_SMF 3 /* Single-mode fiber */
147#define IFM_FDDI_MMF 4 /* Multi-mode fiber */
148#define IFM_FDDI_UTP 5 /* CDDI / UTP */
149#define IFM_FDDI_DA 0x00000100 /* Dual attach / single attach */
150
151/*
152 * IEEE 802.11 Wireless
153 */
154#define IFM_IEEE80211 0x00000080
155#define IFM_IEEE80211_FH1 3 /* Frequency Hopping 1Mbps */
156#define IFM_IEEE80211_FH2 4 /* Frequency Hopping 2Mbps */
157#define IFM_IEEE80211_DS2 5 /* Direct Sequence 2Mbps */
158#define IFM_IEEE80211_DS5 6 /* Direct Sequence 5Mbps*/
159#define IFM_IEEE80211_DS11 7 /* Direct Sequence 11Mbps*/
160#define IFM_IEEE80211_DS1 8 /* Direct Sequence 1Mbps */
9bccf70c 161#define IFM_IEEE80211_DS22 9 /* Direct Sequence 22Mbps */
1c79356b
A
162#define IFM_IEEE80211_ADHOC 0x00000100 /* Operate in Adhoc mode */
163
164/*
165 * Shared media sub-types
166 */
167#define IFM_AUTO 0 /* Autoselect best media */
168#define IFM_MANUAL 1 /* Jumper/dipswitch selects media */
169#define IFM_NONE 2 /* Deselect all media */
170
171/*
172 * Shared options
173 */
174#define IFM_FDX 0x00100000 /* Force full duplex */
175#define IFM_HDX 0x00200000 /* Force half duplex */
176#define IFM_FLOW 0x00400000 /* enable hardware flow control */
316670eb 177#define IFM_EEE 0x00800000 /* Support energy efficient ethernet */
1c79356b
A
178#define IFM_FLAG0 0x01000000 /* Driver defined flag */
179#define IFM_FLAG1 0x02000000 /* Driver defined flag */
180#define IFM_FLAG2 0x04000000 /* Driver defined flag */
181#define IFM_LOOP 0x08000000 /* Put hardware in loopback */
182
183/*
184 * Masks
185 */
186#define IFM_NMASK 0x000000e0 /* Network type */
187#define IFM_TMASK 0x0000001f /* Media sub-type */
188#define IFM_IMASK 0xf0000000 /* Instance */
189#define IFM_ISHIFT 28 /* Instance shift */
190#define IFM_OMASK 0x0000ff00 /* Type specific options */
191#define IFM_GMASK 0x0ff00000 /* Global options */
192
193/*
194 * Status bits
195 */
196#define IFM_AVALID 0x00000001 /* Active bit valid */
197#define IFM_ACTIVE 0x00000002 /* Interface attached to working net */
39236c6e 198#define IFM_WAKESAMENET 0x00000004 /* No link transition while asleep */
1c79356b
A
199
200/*
201 * Macros to extract various bits of information from the media word.
202 */
9bccf70c
A
203#define IFM_TYPE(x) ((x) & IFM_NMASK)
204#define IFM_SUBTYPE(x) ((x) & IFM_TMASK)
205#define IFM_TYPE_OPTIONS(x) ((x) & IFM_OMASK)
206#define IFM_INST(x) (((x) & IFM_IMASK) >> IFM_ISHIFT)
207#define IFM_OPTIONS(x) ((x) & (IFM_OMASK|IFM_GMASK))
208
209#define IFM_INST_MAX IFM_INST(IFM_IMASK)
210
211/*
212 * Macro to create a media word.
213 */
214#define IFM_MAKEWORD(type, subtype, options, instance) \
215 ((type) | (subtype) | (options) | ((instance) << IFM_ISHIFT))
1c79356b
A
216
217/*
218 * NetBSD extension not defined in the BSDI API. This is used in various
219 * places to get the canonical description for a given type/subtype.
220 *
221 * NOTE: all but the top-level type descriptions must contain NO whitespace!
222 * Otherwise, parsing these in ifconfig(8) would be a nightmare.
223 */
224struct ifmedia_description {
225 int ifmt_word; /* word value; may be masked */
226 const char *ifmt_string; /* description */
227};
228
229#define IFM_TYPE_DESCRIPTIONS { \
230 { IFM_ETHER, "Ethernet" }, \
231 { IFM_TOKEN, "Token ring" }, \
232 { IFM_FDDI, "FDDI" }, \
233 { IFM_IEEE80211, "IEEE802.11" }, \
234 { 0, NULL }, \
235}
236
237#define IFM_SUBTYPE_ETHERNET_DESCRIPTIONS { \
238 { IFM_10_T, "10baseT/UTP" }, \
239 { IFM_10_2, "10base2/BNC" }, \
240 { IFM_10_5, "10base5/AUI" }, \
241 { IFM_100_TX, "100baseTX" }, \
242 { IFM_100_FX, "100baseFX" }, \
243 { IFM_100_T4, "100baseT4" }, \
244 { IFM_100_VG, "100baseVG" }, \
245 { IFM_100_T2, "100baseT2" }, \
246 { IFM_1000_SX, "1000baseSX" }, \
247 { IFM_10_STP, "10baseSTP" }, \
248 { IFM_10_FL, "10baseFL" }, \
249 { IFM_1000_LX, "1000baseLX" }, \
250 { IFM_1000_CX, "1000baseCX" }, \
91447636 251 { IFM_1000_T, "1000baseT" }, \
1c79356b 252 { IFM_HPNA_1, "HomePNA1" }, \
91447636
A
253 { IFM_10G_SR, "10GbaseSR" }, \
254 { IFM_10G_LR, "10GbaseLR" }, \
b0d623f7
A
255 { IFM_10G_CX4, "10GbaseCX4" }, \
256 { IFM_10G_T, "10GbaseT" }, \
1c79356b
A
257 { 0, NULL }, \
258}
259
260#define IFM_SUBTYPE_ETHERNET_ALIASES { \
261 { IFM_10_T, "UTP" }, \
262 { IFM_10_T, "10UTP" }, \
263 { IFM_10_2, "BNC" }, \
264 { IFM_10_2, "10BNC" }, \
265 { IFM_10_5, "AUI" }, \
266 { IFM_10_5, "10AUI" }, \
267 { IFM_100_TX, "100TX" }, \
268 { IFM_100_FX, "100FX" }, \
269 { IFM_100_T4, "100T4" }, \
270 { IFM_100_VG, "100VG" }, \
271 { IFM_100_T2, "100T2" }, \
272 { IFM_1000_SX, "1000SX" }, \
273 { IFM_10_STP, "STP" }, \
274 { IFM_10_STP, "10STP" }, \
275 { IFM_10_FL, "FL" }, \
276 { IFM_10_FL, "10FL" }, \
277 { IFM_1000_LX, "1000LX" }, \
278 { IFM_1000_CX, "1000CX" }, \
91447636 279 { IFM_1000_T, "1000T" }, \
1c79356b 280 { IFM_HPNA_1, "HPNA1" }, \
91447636
A
281 { IFM_10G_SR, "10GSR" }, \
282 { IFM_10G_LR, "10GLR" }, \
b0d623f7
A
283 { IFM_10G_CX4, "10GCX4" }, \
284 { IFM_10G_T, "10GT" }, \
1c79356b
A
285 { 0, NULL }, \
286}
287
288#define IFM_SUBTYPE_ETHERNET_OPTION_DESCRIPTIONS { \
289 { 0, NULL }, \
290}
291
292#define IFM_SUBTYPE_TOKENRING_DESCRIPTIONS { \
293 { IFM_TOK_STP4, "DB9/4Mbit" }, \
294 { IFM_TOK_STP16, "DB9/16Mbit" }, \
295 { IFM_TOK_UTP4, "UTP/4Mbit" }, \
296 { IFM_TOK_UTP16, "UTP/16Mbit" }, \
297 { 0, NULL }, \
298}
299
300#define IFM_SUBTYPE_TOKENRING_ALIASES { \
301 { IFM_TOK_STP4, "4STP" }, \
302 { IFM_TOK_STP16, "16STP" }, \
303 { IFM_TOK_UTP4, "4UTP" }, \
304 { IFM_TOK_UTP16, "16UTP" }, \
305 { 0, NULL }, \
306}
307
308#define IFM_SUBTYPE_TOKENRING_OPTION_DESCRIPTIONS { \
309 { IFM_TOK_ETR, "EarlyTokenRelease" }, \
310 { IFM_TOK_SRCRT, "SourceRouting" }, \
311 { IFM_TOK_ALLR, "AllRoutes" }, \
312 { 0, NULL }, \
313}
314
315#define IFM_SUBTYPE_FDDI_DESCRIPTIONS { \
316 { IFM_FDDI_SMF, "Single-mode" }, \
317 { IFM_FDDI_MMF, "Multi-mode" }, \
318 { IFM_FDDI_UTP, "UTP" }, \
319 { 0, NULL }, \
320}
321
322#define IFM_SUBTYPE_FDDI_ALIASES { \
323 { IFM_FDDI_SMF, "SMF" }, \
324 { IFM_FDDI_MMF, "MMF" }, \
325 { IFM_FDDI_UTP, "CDDI" }, \
326 { 0, NULL }, \
327}
328
329#define IFM_SUBTYPE_FDDI_OPTION_DESCRIPTIONS { \
330 { IFM_FDDI_DA, "Dual-attach" }, \
331 { 0, NULL }, \
332}
333
334#define IFM_SUBTYPE_IEEE80211_DESCRIPTIONS { \
335 { IFM_IEEE80211_FH1, "FH1" }, \
336 { IFM_IEEE80211_FH2, "FH2" }, \
337 { IFM_IEEE80211_DS1, "DS1" }, \
338 { IFM_IEEE80211_DS2, "DS2" }, \
339 { IFM_IEEE80211_DS5, "DS5" }, \
340 { IFM_IEEE80211_DS11, "DS11" }, \
9bccf70c 341 { IFM_IEEE80211_DS22, "DS22" }, \
1c79356b
A
342 { 0, NULL }, \
343}
344
345#define IFM_SUBTYPE_IEEE80211_OPTION_DESCRIPTIONS { \
346 { IFM_IEEE80211_ADHOC, "adhoc" }, \
347 { 0, NULL }, \
348}
349
350#define IFM_SUBTYPE_SHARED_DESCRIPTIONS { \
351 { IFM_AUTO, "autoselect" }, \
352 { IFM_MANUAL, "manual" }, \
353 { IFM_NONE, "none" }, \
354 { 0, NULL }, \
355}
356
357#define IFM_SUBTYPE_SHARED_ALIASES { \
358 { IFM_AUTO, "auto" }, \
359 { 0, NULL }, \
360}
361
362#define IFM_SHARED_OPTION_DESCRIPTIONS { \
363 { IFM_FDX, "full-duplex" }, \
364 { IFM_HDX, "half-duplex" }, \
365 { IFM_FLOW, "flow-control" }, \
060df5ea 366 { IFM_EEE, "energy-efficient-ethernet" }, \
1c79356b
A
367 { IFM_FLAG0, "flag0" }, \
368 { IFM_FLAG1, "flag1" }, \
369 { IFM_FLAG2, "flag2" }, \
370 { IFM_LOOP, "hw-loopback" }, \
371 { 0, NULL }, \
372}
373
374#endif /* _NET_IF_MEDIA_H_ */