www/index.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
   2 <html>
   3   <head>
   4     <title>Host AP Linux driver for Intersil Prism2/2.5/3 wireless LAN cards and WPA Supplicant</title>
   5     <meta name="description" content="Linux driver for Host AP mode of Intersil Prism2/2.5/3 and WPA Supplicant">
   6     <meta name="keywords" content="Host AP, hostap, Prism2, Linux driver for Prism2, Linux access point, software access point, hostapd, IEEE 802.11, IEEE 802.1X, WPA, WPA2, WPA Supplicant, wpa_supplicant, IEEE 802.11i, TKIP, CCMP, EAP-PEAP, EAP-TLS, IEEE 802.1X Supplicant, IEEE 802.1aa, EAPOL, RSN, pre-authentication, PMKSA caching, BSD hostapd, FreeBSD hostapd, RADIUS, authentication server, wireless">
   7     <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   8   </head>
   9
  10   <body>
  11     <h2>Host AP driver for Intersil Prism2/2.5/3, hostapd, and WPA Supplicant</h2>
  12
  13 <h3><a name="intro">Introduction</a></h3>
  14
  15 <p>This project includes three main components:</p>
  16 <ul>
  17 <li>Host AP - Linux driver for Prism2/2.5/3</li>
  18 <li><a href="hostapd/">hostapd</a> - user space daemon for access points,
  19     including, e.g., IEEE 802.1X/WPA/EAP Authenticator for number of Linux and
  20     BSD drivers, RADIUS client, integrated EAP server, and RADIUS
  21     authentication server</li>
  22 <li><a href="wpa_supplicant/">wpa_supplicant</a> user space IEEE 802.1X/WPA
  23     supplicant (wireless client) for number of Linux, BSD, and Windows
  24     drivers</li>
  25 </ul>
  26
  27 <p>
  28 Host AP is a Linux driver for wireless LAN cards based on Intersil's
  29 Prism2/2.5/3 chipset. The driver supports a so called Host AP mode, i.e., it
  30 takes care of IEEE 802.11 management functions in the host computer
  31 and acts as an access point. This does not require any special
  32 firmware for the wireless LAN card. In addition to this, it has
  33 support for normal station operations in BSS and possible also in
  34 IBSS. WPA and RSN (WPA2) is supported when used with accompanied tools,
  35 wpa_supplicant (WPA/RSN Supplicant) and hostapd (WPA/RSN Authenticator). All
  36 these programs have been designed for both desktop/laptop computers and
  37 embedded systems.
  38 </p>
  39
  40 <p>
  41 Intersil's station firmware for Prism2 chipset supports a so called
  42 Host AP mode in which the firmware takes care of time critical tasks
  43 like beacon sending and frame acknowledging, but leaves other
  44 management tasks to host computer driver. This driver implements basic
  45 functionality needed to initialize and configure Prism2-based cards,
  46 to send and receive frames, and to gather statistics. In addition, it
  47 includes an implementation of following IEEE 802.11 functions:
  48 authentication (and deauthentication), association (reassociation, and
  49 disassociation), data transmission between two wireless stations,
  50 power saving (PS) mode signaling and frame buffering for PS
  51 stations. The driver has also various features for development
  52 debugging and for researching IEEE 802.11 environments like access to
  53 hardware configuration records, I/O registers, and frames with 802.11
  54 headers.
  55 </p>
  56
  57 <p>
  58 When used with a user space daemon, the combination of the Host AP
  59 driver and hostapd daemon includes additional features. These include
  60 support for IEEE 802.1X and dynamic WEP rekeying, RADIUS Accounting,
  61 RADIUS-based ACL for IEEE 802.11 authentication, minimal IAPP (IEEE
  62 802.11f), WPA, IEEE 802.11i/RSN/WPA2.
  63 </p>
  64
  65 <p>
  66 <a href="http://www.hpl.hp.com/personal/Jean_Tourrilhes/Linux/Wireless.html">Linux
  67 Wireless LAN Howto</a> has some useful information about wireless LAN support
  68 in Linux. In addition, it includes information about which cards are
  69 Prism2-based (and can thus be used in Host AP mode).
  70 </p>
  71
  72 <h3><a name="wpa_supplicant">WPA/RSN Supplicant (wpa_supplicant)</a></h3>
  73
  74 <p>More information is available on <a
  75 href="wpa_supplicant/">wpa_supplicant's own page</a>.</p>
  76
  77 <p>Supported WPA/IEEE 802.11i features:</p>
  78 <ul>
  79 <li>WPA-PSK ("WPA-Personal")</li>
  80 <li>WPA with EAP (e.g., with RADIUS authentication server) ("WPA-Enterprise")</li>
  81 <li>key management for CCMP, TKIP, WEP104, WEP40</li>
  82 <li>WPA and full IEEE 802.11i/RSN/WPA2</li>
  83 <li>RSN: PMKSA caching, pre-authentication</li>
  84 </ul>
  85
  86 <p>Supported drivers:</p>
  87 <ul>
  88 <li>Linux drivers that support Linux Wireless Extensions v19 or newer with
  89 WPA/WPA2 extensions</li>
  90 <li>Host AP driver for Prism2/2.5/3</li>
  91 <li>Linuxant DriverLoader with Windows NDIS driver supporting WPA</li>
  92 <li>Agere Systems Inc. Linux Driver (Hermes-I/Hermes-II chipset)</li>
  93 <li>madwifi (Atheros ar521x)</li>
  94 <li>ATMEL AT76C5XXx</li>
  95 <li>Linux ndiswrapper with Windows NDIS driver</li>
  96 <li>Broadcom wl.o driver</li>
  97 <li>Intel ipw2100 and ipw2200</li>
  98 <li>Wired Ethernet drivers</li>
  99 <li>BSD net80211 layer (e.g., Atheros driver) (FreeBSD 6-CURRENT)</li>
 100 <li>Windows NDIS drivers (Windows; at least XP and 2000, others not tested)</li>
 101 </ul>
 102
 103 <h3><a name="wpa_authenticator">WPA/RSN/EAP Authenticator (hostapd)</a></h3>
 104
 105 <p>More information is available on <a
 106 href="hostapd/">hostapd's own page</a>.</p>
 107
 108 <p>Supported WPA/IEEE 802.11i features:</p>
 109 <ul>
 110 <li>WPA-PSK ("WPA-Personal")</li>
 111 <li>WPA with EAP (e.g., with RADIUS authentication server) ("WPA-Enterprise")<br>
 112 <li>key management for CCMP, TKIP, WEP104, WEP40</li>
 113 <li>WPA and full IEEE 802.11i/RSN/WPA2</li>
 114 <li>RSN: PMKSA caching, pre-authentication</li>
 115 </ul>
 116
 117 <p>Supported drivers:</p>
 118 <ul>
 119 <li>Linux mac80211-based drivers with AP mode support</li>
 120 <li>Host AP driver for Prism2/2.5/3</li>
 121 <li>madwifi (Atheros ar521x)</li>
 122 <li>BSD net80211 layer (e.g., Atheros driver) (FreeBSD 6-CURRENT)</li>
 123 </ul>
 124
 125 <h3><a name="download">Download</a></h3>
 126
 127 <p>
 128 <b>Host AP driver</b><br>
 129 Copyright (c) 2001-2002, SSH Communications Security Corp and
 130 Jouni Malinen.<br>
 131 Copyright (c) 2002-2007, Jouni Malinen and contributors.<br>
 132
 133 Author: Jouni Malinen &lt;j@w1.fi&gt;
 134 </p>
 135
 136 <p>
 137 <b>Host AP utils</b><br>
 138 Copyright (c) 2002-2005, Jouni Malinen &lt;j@w1.fi&gt;
 139 and contributors.
 140 </p>
 141
 142 <p>
 143 <b>hostapd</b><br>
 144 Copyright (c) 2002-2011, Jouni Malinen &lt;j@w1.fi&gt;
 145 and contributors.
 146 </p>
 147
 148 <p>
 149 <b>wpa_supplicant</b><br>
 150 Copyright (c) 2003-2011, Jouni Malinen &lt;j@w1.fi&gt;
 151 and contributors.
 152 </p>
 153
 154 <p>
 155 This program is free software; you can redistribute it and/or modify
 156 it under the terms of the GNU General Public License version 2 as
 157 published by the Free Software Foundation. See
 158 <a href="/gitweb/gitweb.cgi?p=hostap.git;a=blob_plain;f=COPYING">COPYING</a>
 159 for more details. hostapd and wpa_supplicant are alternatively
 160 available under BSD license.
 161 </p>
 162
 163
 164 <p>
 165 <b>Please see
 166 <a href="/cgi-bin/viewcvs.cgi/*checkout*/hostap/README?rev=HEAD&amp;content-type=text/plain">README</a>
 167 for updated documentation of the driver.
 168 Please also check <a href="/gitweb/gitweb.cgi?p=hostap.git;a=blob_plain;f=FAQ">FAQ</a> before sending problem reports.</b>
 169 </p>
 170
 171
 172 <p>
 173 <b>Note!</b>
 174 Host AP driver was added into the main kernel tree in Linux
 175 v2.6.14. The version in the kernel tree should be used instead of this
 176 external hostap-driver package. The external releases are only for
 177 older kernel versions and all the future development will be in the
 178 main kernel tree.
 179 </p>
 180
 181
 182 <ul>
 183 <li><a href="releases.html">Release graph</a></li>
 184 <li>Latest stable release:
 185 <ul>
 186 <li><a href="releases/hostapd-0.7.3.tar.gz">hostapd-0.7.3.tar.gz</a>
 187 <li><a href="releases/wpa_supplicant-0.7.3.tar.gz">wpa_supplicant-0.7.3.tar.gz</a> (source code for all versions)</li>
 188 <li><a href="releases/wpa_supplicant-0.7.3.exe">wpa_supplicant-0.7.3.exe</a> (binary installer for Windows)</li>
 189 <li><a href="releases/wpa_supplicant-windows-bin-0.7.3.zip">wpa_supplicant-windows-bin-0.7.3.zip</a> (binaries for Windows)</li>
 190 </ul>
 191 <li>Previous stable release:
 192 <ul>
 193 <li><a href="releases/hostapd-0.6.10.tar.gz">hostapd-0.6.10.tar.gz</a>
 194 <li><a href="releases/wpa_supplicant-0.6.10.tar.gz">wpa_supplicant-0.6.10.tar.gz</a> (source code for all versions)</li>
 195 <li><a href="releases/wpa_supplicant-0.6.10.exe">wpa_supplicant-0.6.10.exe</a> (binary installer for Windows)</li>
 196 <li><a href="releases/wpa_supplicant-windows-bin-0.6.10.zip">wpa_supplicant-windows-bin-0.6.10.zip</a> (binaries for Windows)</li>
 197 <li><a href="wpa_supplicant/qt4/wpa_gui-qt433-windows-dll.zip">wpa_gui-qt433-windows-dll.zip</a> (Qt4 libraries from wpa_gui/Windows)</li>
 198 </ul>
 199 <!--
 200 <li>Latest development release:
 201 <ul>
 202 <li><a href="releases/hostapd-0.8.0.tar.gz">hostapd-0.8.0.tar.gz</a>
 203 <li><a href="releases/wpa_supplicant-0.8.0.tar.gz">wpa_supplicant-0.8.0.tar.gz</a> (source code for all versions)</li>
 204 <li><a href="releases/wpa_supplicant-0.8.0.exe">wpa_supplicant-0.8.0.exe</a> (binary installer for Windows)</li>
 205 <li><a href="releases/wpa_supplicant-windows-bin-0.8.0.zip">wpa_supplicant-windows-bin-0.8.0.zip</a> (binaries for Windows)</li>
 206 </ul>
 207 -->
 208 <li>ChangeLog:
 209 <ul>
 210 <li>hostapd:
 211 <a href="/gitweb/gitweb.cgi?p=hostap.git;a=blob_plain;f=hostapd/ChangeLog">[development branch]</a>
 212 <a href="/gitweb/gitweb.cgi?p=hostap-07.git;a=blob_plain;f=hostapd/ChangeLog">[stable branch]</a>
 213 <a href="/gitweb/gitweb.cgi?p=hostap-06.git;a=blob_plain;f=hostapd/ChangeLog">[previous stable branch]</a>
 214 <li>wpa_supplicant:
 215 <a href="/gitweb/gitweb.cgi?p=hostap.git;a=blob_plain;f=wpa_supplicant/ChangeLog">[development branch]</a>
 216 <a href="/gitweb/gitweb.cgi?p=hostap-07.git;a=blob_plain;f=wpa_supplicant/ChangeLog">[stable branch]</a>
 217 <a href="/gitweb/gitweb.cgi?p=hostap-06.git;a=blob_plain;f=wpa_supplicant/ChangeLog">[previous stable branch]</a>
 218 </ul>
 219 <li><a href="releases/">Old releases</a>
 220 <li><a href="http://lists.shmoo.com/mailman/listinfo/hostap">Mailing list</a>
 221 <li><a href="http://lists.shmoo.com/pipermail/hostap/">New mailing list archives</a>
 222 <li><a href="hostap/">Old mailing list archives</a>
 223 <li><a href="htdig/">Search mailing list archives</a>
 224 <li><a href="/gitweb/gitweb.cgi">Web interface to GIT repository (0.6.x and newer)</a></li>
 225 <li><a href="/cgi-bin/viewcvs.cgi/hostap/">Web interface to CVS repository (0.5.x and older)</a></li>
 226 <li><a href="releases/snapshots/">Snapshot releases from all active branches</a>
 227 <li><a href="cvs.html">GIT and read-only anonymous CVS access (pserver)</a>
 228 <li><a href="links.html">Host AP related links</a>
 229 <li><a href="bugz/">Bug and feature request tracking</a></li>
 230 </ul>
 231
 232 <h3>Wireless Tools for Linux</h3>
 233
 234 <p>
 235 Please, note that you will need quite recent version of Wireless Tools
 236 to use some features of the Host AP driver. Using the
 237 <a href="http://www.hpl.hp.com/personal/Jean_Tourrilhes/Linux/Tools.html#latest">latest</a>
 238 version of the tools is recommended. Some features might also require latest beta version.
 239 </p>
 240
 241 <h3>Feedback, comments, mailing list</h3>
 242
 243 <p>
 244 Any comments, reports on success/failure, ideas for further
 245 improvement, feature requests, etc. are welcome at j@w1.fi.
 246 Please note, that I often receive more email than I have time to answer.
 247 Unfortunately, some messages may not get a reply, but I'll try to go
 248 through my mail whenever time permits.
 249 </p>
 250
 251 <p>
 252 There is also a mailing list for Host AP related messages.
 253 Since this list has a broader audience, your likelyhood of getting
 254 responses is higher. This list is recommended for general questions
 255 about Host AP driver and its development. In addition, I will send
 256 release notes to it whenever a new version is available.
 257 </p>
 258
 259 <p>
 260 The mailing list information and web archive is at <a
 261 href="http://lists.shmoo.com/mailman/listinfo/hostap">http://lists.shmoo.com/mailman/listinfo/hostap</a>.
 262 Messages to hostap@shmoo.com will be delivered to the
 263 subscribers. Please note, that due to large number of spam and virus
 264 messages sent to the list address, the list is configured to accept
 265 messages only from subscribed addresses. Messages from unsubscribed addresses
 266 may be accepted manually, but their delivery will be delayed.
 267 </p>
 268
 269 <p>
 270 If you want to make sure your bug report of feature request does not
 271 get lost, please report it through the bug tracking system as
 272 <a href="bugz/enter_bug.cgi">a new bug/feature request</a>.
 273 </p>
 274
 275     <hr>
 276     <div>
 277     <address><a href="mailto:j@w1.fi">Jouni Malinen</a></address>
 278 <!-- Created: Mon May 27 20:08:41 EEST 2002 -->
 279 <!-- hhmts start -->
 280 Last modified: Sun Feb 27 12:48:42 EET 2011
 281 <!-- hhmts end -->
 282     </div>
 283   </body>
 284 </html>