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