ieee80211_var.h revision 147152
1/*- 2 * Copyright (c) 2001 Atsushi Onoe 3 * Copyright (c) 2002-2005 Sam Leffler, Errno Consulting 4 * All rights reserved. 5 * 6 * Redistribution and use in source and binary forms, with or without 7 * modification, are permitted provided that the following conditions 8 * are met: 9 * 1. Redistributions of source code must retain the above copyright 10 * notice, this list of conditions and the following disclaimer. 11 * 2. Redistributions in binary form must reproduce the above copyright 12 * notice, this list of conditions and the following disclaimer in the 13 * documentation and/or other materials provided with the distribution. 14 * 3. The name of the author may not be used to endorse or promote products 15 * derived from this software without specific prior written permission. 16 * 17 * Alternatively, this software may be distributed under the terms of the 18 * GNU General Public License ("GPL") version 2 as published by the Free 19 * Software Foundation. 20 * 21 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 22 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 23 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 24 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 25 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 26 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 27 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 28 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 29 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 30 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 31 * 32 * $FreeBSD: head/sys/net80211/ieee80211_var.h 147152 2005-06-09 04:05:43Z sam $ 33 */ 34#ifndef _NET80211_IEEE80211_VAR_H_ 35#define _NET80211_IEEE80211_VAR_H_ 36 37/* 38 * Definitions for IEEE 802.11 drivers. 39 */ 40#define IEEE80211_DEBUG 41#undef IEEE80211_DEBUG_REFCNT /* node refcnt stuff */ 42 43/* NB: portability glue must go first */ 44#ifdef __NetBSD__ 45#include <net80211/ieee80211_netbsd.h> 46#elif __FreeBSD__ 47#include <net80211/ieee80211_freebsd.h> 48#elif __linux__ 49#include <net80211/ieee80211_linux.h> 50#else 51#error "No support for your operating system!" 52#endif 53 54#include <net80211/_ieee80211.h> 55#include <net80211/ieee80211.h> 56#include <net80211/ieee80211_crypto.h> 57#include <net80211/ieee80211_ioctl.h> /* for ieee80211_stats */ 58#include <net80211/ieee80211_node.h> 59#include <net80211/ieee80211_proto.h> 60 61#define IEEE80211_TXPOWER_MAX 100 /* .5 dbM (XXX units?) */ 62#define IEEE80211_TXPOWER_MIN 0 /* kill radio */ 63 64#define IEEE80211_DTIM_MAX 15 /* max DTIM period */ 65#define IEEE80211_DTIM_MIN 1 /* min DTIM period */ 66#define IEEE80211_DTIM_DEFAULT 1 /* default DTIM period */ 67 68#define IEEE80211_BINTVAL_MAX 500 /* max beacon interval (TU's) */ 69#define IEEE80211_BINTVAL_MIN 25 /* min beacon interval (TU's) */ 70#define IEEE80211_BINTVAL_DEFAULT 100 /* default beacon interval (TU's) */ 71 72#define IEEE80211_PS_SLEEP 0x1 /* STA is in power saving mode */ 73#define IEEE80211_PS_MAX_QUEUE 50 /* maximum saved packets */ 74 75#define IEEE80211_MS_TO_TU(x) (((x) * 1000) / 1024) 76#define IEEE80211_TU_TO_MS(x) (((x) * 1024) / 1000) 77 78struct ieee80211_aclator; 79struct sysctl_ctx_list; 80 81struct ieee80211com { 82 SLIST_ENTRY(ieee80211com) ic_next; 83 struct ifnet *ic_ifp; /* associated device */ 84 struct ieee80211_stats ic_stats; /* statistics */ 85 struct sysctl_ctx_list *ic_sysctl; /* dynamic sysctl context */ 86 u_int32_t ic_debug; /* debug msg flags */ 87 int ic_vap; /* virtual AP index */ 88 ieee80211_beacon_lock_t ic_beaconlock; /* beacon update lock */ 89 90 int (*ic_reset)(struct ifnet *); 91 void (*ic_recv_mgmt)(struct ieee80211com *, 92 struct mbuf *, struct ieee80211_node *, 93 int, int, u_int32_t); 94 int (*ic_send_mgmt)(struct ieee80211com *, 95 struct ieee80211_node *, int, int); 96 int (*ic_newstate)(struct ieee80211com *, 97 enum ieee80211_state, int); 98 void (*ic_newassoc)(struct ieee80211com *, 99 struct ieee80211_node *, int); 100 void (*ic_updateslot)(struct ifnet *); 101 void (*ic_set_tim)(struct ieee80211com *, 102 struct ieee80211_node *, int); 103 u_int8_t ic_myaddr[IEEE80211_ADDR_LEN]; 104 struct ieee80211_rateset ic_sup_rates[IEEE80211_MODE_MAX]; 105 struct ieee80211_channel ic_channels[IEEE80211_CHAN_MAX+1]; 106 u_int8_t ic_chan_avail[IEEE80211_CHAN_BYTES]; 107 u_int8_t ic_chan_active[IEEE80211_CHAN_BYTES]; 108 u_int8_t ic_chan_scan[IEEE80211_CHAN_BYTES]; 109 struct ieee80211_node_table ic_scan; /* scan candidates */ 110 struct ifqueue ic_mgtq; 111 u_int32_t ic_flags; /* state flags */ 112 u_int32_t ic_caps; /* capabilities */ 113 u_int16_t ic_modecaps; /* set of mode capabilities */ 114 u_int16_t ic_curmode; /* current mode */ 115 enum ieee80211_phytype ic_phytype; /* XXX wrong for multi-mode */ 116 enum ieee80211_opmode ic_opmode; /* operation mode */ 117 enum ieee80211_state ic_state; /* 802.11 state */ 118 enum ieee80211_protmode ic_protmode; /* 802.11g protection mode */ 119 enum ieee80211_roamingmode ic_roaming; /* roaming mode */ 120 struct ieee80211_node_table ic_sta; /* stations/neighbors */ 121 u_int32_t *ic_aid_bitmap; /* association id map */ 122 u_int16_t ic_max_aid; 123 u_int16_t ic_sta_assoc; /* stations associated */ 124 u_int16_t ic_ps_sta; /* stations in power save */ 125 u_int16_t ic_ps_pending; /* ps sta's w/ pending frames */ 126 u_int8_t *ic_tim_bitmap; /* power-save stations w/ data*/ 127 u_int16_t ic_tim_len; /* ic_tim_bitmap size (bytes) */ 128 u_int8_t ic_dtim_period; /* DTIM period */ 129 u_int8_t ic_dtim_count; /* DTIM count for last bcn */ 130 struct ifmedia ic_media; /* interface media config */ 131 struct bpf_if *ic_rawbpf; /* packet filter structure */ 132 struct ieee80211_node *ic_bss; /* information for this node */ 133 struct ieee80211_channel *ic_ibss_chan; 134 int ic_fixed_rate; /* index to ic_sup_rates[] */ 135 u_int16_t ic_rtsthreshold; 136 u_int16_t ic_fragthreshold; 137 struct ieee80211_node *(*ic_node_alloc)(struct ieee80211_node_table*); 138 void (*ic_node_free)(struct ieee80211_node *); 139 void (*ic_node_cleanup)(struct ieee80211_node *); 140 u_int8_t (*ic_node_getrssi)(const struct ieee80211_node*); 141 u_int16_t ic_lintval; /* listen interval */ 142 u_int16_t ic_holdover; /* PM hold over duration */ 143 u_int16_t ic_txmin; /* min tx retry count */ 144 u_int16_t ic_txmax; /* max tx retry count */ 145 u_int16_t ic_txlifetime; /* tx lifetime */ 146 u_int16_t ic_txpowlimit; /* global tx power limit */ 147 u_int16_t ic_bmisstimeout;/* beacon miss threshold (ms) */ 148 u_int16_t ic_nonerpsta; /* # non-ERP stations */ 149 u_int16_t ic_longslotsta; /* # long slot time stations */ 150 int ic_mgt_timer; /* mgmt timeout */ 151 int ic_inact_timer; /* inactivity timer wait */ 152 int ic_des_esslen; 153 u_int8_t ic_des_essid[IEEE80211_NWID_LEN]; 154 struct ieee80211_channel *ic_des_chan; /* desired channel */ 155 u_int8_t ic_des_bssid[IEEE80211_ADDR_LEN]; 156 void *ic_opt_ie; /* user-specified IE's */ 157 u_int16_t ic_opt_ie_len; /* length of ni_opt_ie */ 158 /* 159 * Inactivity timer settings for nodes. 160 */ 161 int ic_inact_init; /* initial setting */ 162 int ic_inact_auth; /* auth but not assoc setting */ 163 int ic_inact_run; /* authorized setting */ 164 int ic_inact_probe; /* inactive probe time */ 165 166 /* 167 * WME/WMM state. 168 */ 169 struct ieee80211_wme_state ic_wme; 170 171 /* 172 * Cipher state/configuration. 173 */ 174 struct ieee80211_crypto_state ic_crypto; 175#define ic_nw_keys ic_crypto.cs_nw_keys /* XXX compatibility */ 176#define ic_def_txkey ic_crypto.cs_def_txkey /* XXX compatibility */ 177 178 /* 179 * 802.1x glue. When an authenticator attaches it 180 * fills in this section. We assume that when ic_ec 181 * is setup that the methods are safe to call. 182 */ 183 const struct ieee80211_authenticator *ic_auth; 184 struct eapolcom *ic_ec; 185 186 /* 187 * Access control glue. When a control agent attaches 188 * it fills in this section. We assume that when ic_ac 189 * is setup that the methods are safe to call. 190 */ 191 const struct ieee80211_aclator *ic_acl; 192 void *ic_as; 193}; 194 195#define IEEE80211_ADDR_EQ(a1,a2) (memcmp(a1,a2,IEEE80211_ADDR_LEN) == 0) 196#define IEEE80211_ADDR_COPY(dst,src) memcpy(dst,src,IEEE80211_ADDR_LEN) 197 198/* ic_flags */ 199/* NB: bits 0x6f available */ 200/* NB: this is intentionally setup to be IEEE80211_CAPINFO_PRIVACY */ 201#define IEEE80211_F_PRIVACY 0x00000010 /* CONF: privacy enabled */ 202#define IEEE80211_F_SCAN 0x00000080 /* STATUS: scanning */ 203#define IEEE80211_F_ASCAN 0x00000100 /* STATUS: active scan */ 204#define IEEE80211_F_SIBSS 0x00000200 /* STATUS: start IBSS */ 205/* NB: this is intentionally setup to be IEEE80211_CAPINFO_SHORT_SLOTTIME */ 206#define IEEE80211_F_SHSLOT 0x00000400 /* STATUS: use short slot time*/ 207#define IEEE80211_F_PMGTON 0x00000800 /* CONF: Power mgmt enable */ 208#define IEEE80211_F_DESBSSID 0x00001000 /* CONF: des_bssid is set */ 209#define IEEE80211_F_WME 0x00002000 /* CONF: enable WME use */ 210#define IEEE80211_F_ROAMING 0x00004000 /* CONF: roaming enabled (???)*/ 211#define IEEE80211_F_SWRETRY 0x00008000 /* CONF: sw tx retry enabled */ 212#define IEEE80211_F_TXPOW_FIXED 0x00010000 /* TX Power: fixed rate */ 213#define IEEE80211_F_IBSSON 0x00020000 /* CONF: IBSS creation enable */ 214#define IEEE80211_F_SHPREAMBLE 0x00040000 /* STATUS: use short preamble */ 215#define IEEE80211_F_DATAPAD 0x00080000 /* CONF: do alignment pad */ 216#define IEEE80211_F_USEPROT 0x00100000 /* STATUS: protection enabled */ 217#define IEEE80211_F_USEBARKER 0x00200000 /* STATUS: use barker preamble*/ 218#define IEEE80211_F_TIMUPDATE 0x00400000 /* STATUS: update beacon tim */ 219#define IEEE80211_F_WPA1 0x00800000 /* CONF: WPA enabled */ 220#define IEEE80211_F_WPA2 0x01000000 /* CONF: WPA2 enabled */ 221#define IEEE80211_F_WPA 0x01800000 /* CONF: WPA/WPA2 enabled */ 222#define IEEE80211_F_DROPUNENC 0x02000000 /* CONF: drop unencrypted */ 223#define IEEE80211_F_COUNTERM 0x04000000 /* CONF: TKIP countermeasures */ 224#define IEEE80211_F_HIDESSID 0x08000000 /* CONF: hide SSID in beacon */ 225#define IEEE80211_F_NOBRIDGE 0x10000000 /* CONF: dis. internal bridge */ 226#define IEEE80211_F_WMEUPDATE 0x20000000 /* STATUS: update beacon wme */ 227 228/* ic_caps */ 229#define IEEE80211_C_WEP 0x00000001 /* CAPABILITY: WEP available */ 230#define IEEE80211_C_TKIP 0x00000002 /* CAPABILITY: TKIP available */ 231#define IEEE80211_C_AES 0x00000004 /* CAPABILITY: AES OCB avail */ 232#define IEEE80211_C_AES_CCM 0x00000008 /* CAPABILITY: AES CCM avail */ 233#define IEEE80211_C_CKIP 0x00000020 /* CAPABILITY: CKIP available */ 234#define IEEE80211_C_IBSS 0x00000100 /* CAPABILITY: IBSS available */ 235#define IEEE80211_C_PMGT 0x00000200 /* CAPABILITY: Power mgmt */ 236#define IEEE80211_C_HOSTAP 0x00000400 /* CAPABILITY: HOSTAP avail */ 237#define IEEE80211_C_AHDEMO 0x00000800 /* CAPABILITY: Old Adhoc Demo */ 238#define IEEE80211_C_SWRETRY 0x00001000 /* CAPABILITY: sw tx retry */ 239#define IEEE80211_C_TXPMGT 0x00002000 /* CAPABILITY: tx power mgmt */ 240#define IEEE80211_C_SHSLOT 0x00004000 /* CAPABILITY: short slottime */ 241#define IEEE80211_C_SHPREAMBLE 0x00008000 /* CAPABILITY: short preamble */ 242#define IEEE80211_C_MONITOR 0x00010000 /* CAPABILITY: monitor mode */ 243#define IEEE80211_C_TKIPMIC 0x00020000 /* CAPABILITY: TKIP MIC avail */ 244#define IEEE80211_C_WPA1 0x00800000 /* CAPABILITY: WPA1 avail */ 245#define IEEE80211_C_WPA2 0x01000000 /* CAPABILITY: WPA2 avail */ 246#define IEEE80211_C_WPA 0x01800000 /* CAPABILITY: WPA1+WPA2 avail*/ 247#define IEEE80211_C_BURST 0x02000000 /* CAPABILITY: frame bursting */ 248#define IEEE80211_C_WME 0x04000000 /* CAPABILITY: WME avail */ 249/* XXX protection/barker? */ 250 251#define IEEE80211_C_CRYPTO 0x0000002f /* CAPABILITY: crypto alg's */ 252 253void ieee80211_ifattach(struct ieee80211com *); 254void ieee80211_ifdetach(struct ieee80211com *); 255void ieee80211_announce(struct ieee80211com *); 256void ieee80211_media_init(struct ieee80211com *, 257 ifm_change_cb_t, ifm_stat_cb_t); 258struct ieee80211com *ieee80211_find_vap(const u_int8_t mac[IEEE80211_ADDR_LEN]); 259int ieee80211_media_change(struct ifnet *); 260void ieee80211_media_status(struct ifnet *, struct ifmediareq *); 261int ieee80211_ioctl(struct ieee80211com *, u_long, caddr_t); 262int ieee80211_cfgget(struct ieee80211com *, u_long, caddr_t); 263int ieee80211_cfgset(struct ieee80211com *, u_long, caddr_t); 264void ieee80211_watchdog(struct ieee80211com *); 265int ieee80211_rate2media(struct ieee80211com *, int, 266 enum ieee80211_phymode); 267int ieee80211_media2rate(int); 268u_int ieee80211_mhz2ieee(u_int, u_int); 269u_int ieee80211_chan2ieee(struct ieee80211com *, struct ieee80211_channel *); 270u_int ieee80211_ieee2mhz(u_int, u_int); 271int ieee80211_setmode(struct ieee80211com *, enum ieee80211_phymode); 272enum ieee80211_phymode ieee80211_chan2mode(struct ieee80211com *, 273 struct ieee80211_channel *); 274 275/* 276 * Key update synchronization methods. XXX should not be visible. 277 */ 278static __inline void 279ieee80211_key_update_begin(struct ieee80211com *ic) 280{ 281 ic->ic_crypto.cs_key_update_begin(ic); 282} 283static __inline void 284ieee80211_key_update_end(struct ieee80211com *ic) 285{ 286 ic->ic_crypto.cs_key_update_end(ic); 287} 288 289/* 290 * XXX these need to be here for IEEE80211_F_DATAPAD 291 */ 292 293/* 294 * Return the space occupied by the 802.11 header and any 295 * padding required by the driver. This works for a 296 * management or data frame. 297 */ 298static __inline int 299ieee80211_hdrspace(struct ieee80211com *ic, const void *data) 300{ 301 int size = ieee80211_hdrsize(data); 302 if (ic->ic_flags & IEEE80211_F_DATAPAD) 303 size = roundup(size, sizeof(u_int32_t)); 304 return size; 305} 306 307/* 308 * Like ieee80211_hdrspace, but handles any type of frame. 309 */ 310static __inline int 311ieee80211_anyhdrspace(struct ieee80211com *ic, const void *data) 312{ 313 int size = ieee80211_anyhdrsize(data); 314 if (ic->ic_flags & IEEE80211_F_DATAPAD) 315 size = roundup(size, sizeof(u_int32_t)); 316 return size; 317} 318 319#define IEEE80211_MSG_DEBUG 0x40000000 /* IFF_DEBUG equivalent */ 320#define IEEE80211_MSG_DUMPPKTS 0x20000000 /* IFF_LINK2 equivalant */ 321#define IEEE80211_MSG_CRYPTO 0x10000000 /* crypto work */ 322#define IEEE80211_MSG_INPUT 0x08000000 /* input handling */ 323#define IEEE80211_MSG_XRATE 0x04000000 /* rate set handling */ 324#define IEEE80211_MSG_ELEMID 0x02000000 /* element id parsing */ 325#define IEEE80211_MSG_NODE 0x01000000 /* node handling */ 326#define IEEE80211_MSG_ASSOC 0x00800000 /* association handling */ 327#define IEEE80211_MSG_AUTH 0x00400000 /* authentication handling */ 328#define IEEE80211_MSG_SCAN 0x00200000 /* scanning */ 329#define IEEE80211_MSG_OUTPUT 0x00100000 /* output handling */ 330#define IEEE80211_MSG_STATE 0x00080000 /* state machine */ 331#define IEEE80211_MSG_POWER 0x00040000 /* power save handling */ 332#define IEEE80211_MSG_DOT1X 0x00020000 /* 802.1x authenticator */ 333#define IEEE80211_MSG_DOT1XSM 0x00010000 /* 802.1x state machine */ 334#define IEEE80211_MSG_RADIUS 0x00008000 /* 802.1x radius client */ 335#define IEEE80211_MSG_RADDUMP 0x00004000 /* dump 802.1x radius packets */ 336#define IEEE80211_MSG_RADKEYS 0x00002000 /* dump 802.1x keys */ 337#define IEEE80211_MSG_WPA 0x00001000 /* WPA/RSN protocol */ 338#define IEEE80211_MSG_ACL 0x00000800 /* ACL handling */ 339#define IEEE80211_MSG_WME 0x00000400 /* WME protocol */ 340 341#define IEEE80211_MSG_ANY 0xffffffff /* anything */ 342 343#ifdef IEEE80211_DEBUG 344#define IEEE80211_DPRINTF(_ic, _m, _fmt, ...) do { \ 345 if (_ic->ic_debug & (_m)) \ 346 printf(_fmt, __VA_ARGS__); \ 347} while (0) 348#define ieee80211_msg_debug(_ic) \ 349 ((_ic)->ic_debug & IEEE80211_MSG_DEBUG) 350#define ieee80211_msg_dumppkts(_ic) \ 351 ((_ic)->ic_debug & IEEE80211_MSG_DUMPPKTS) 352#define ieee80211_msg_input(_ic) \ 353 ((_ic)->ic_debug & IEEE80211_MSG_INPUT) 354#define ieee80211_msg_radius(_ic) \ 355 ((_ic)->ic_debug & IEEE80211_MSG_RADIUS) 356#define ieee80211_msg_dumpradius(_ic) \ 357 ((_ic)->ic_debug & IEEE80211_MSG_RADDUMP) 358#define ieee80211_msg_dumpradkeys(_ic) \ 359 ((_ic)->ic_debug & IEEE80211_MSG_RADKEYS) 360#define ieee80211_msg_scan(_ic) \ 361 ((_ic)->ic_debug & IEEE80211_MSG_SCAN) 362#else 363#define IEEE80211_DPRINTF(_ic, _m, _fmt, ...) 364#endif 365 366#endif /* _NET80211_IEEE80211_VAR_H_ */ 367