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