/**\mainpage Developers' documentation for %wpa_supplicant%wpa_supplicant is a WPA Supplicant for Linux, BSD and Windows withsupport for WPA and WPA2 (IEEE 802.11i / RSN). Supplicant is the IEEE802.1X/WPA component that is used in the client stations. Itimplements key negotiation with a WPA Authenticator and it can optionallycontrol roaming and IEEE 802.11 authentication/association of the wlandriver.The goal of this documentation and comments in the source code is togive enough information for other developers to understand how%wpa_supplicant has been implemented, how it can be modified, how newdrivers can be supported, and how %wpa_supplicant can be ported toother operating systems. If any information is missing, feel free tocontact Jouni Malinen <jkmaline@cc.hut.fi> for moreinformation. Contributions as patch files are also very welcome at thesame address. Please note that %wpa_supplicant is licensed under duallicense, GPLv2 or BSD at user's choice. All contributions to%wpa_supplicant are expected to use compatible licensing terms.The source code and read-only access to %wpa_supplicant CVS repositoryis available from the project home page athttp://hostap.epitest.fi/wpa_supplicant/. This developers' documentationis also available as a PDF file fromhttp://hostap.epitest.fi/wpa_supplicant/wpa_supplicant-devel-04.pdf .The design goal for %wpa_supplicant was to use hardware, driver, andOS independent, portable C code for all WPA functionality. The sourcecode is divided into separate C files as shown on the \refcode_structure "code structure page". All hardware/driver specificfunctionality is in separate files that implement a \refdriver_wrapper "well-defined driver API". Information about portingto different target boards and operating systems is available onthe \ref porting "porting page".EAPOL (IEEE 802.1X) state machines are implemented as a separatemodule that interacts with \ref eap_module "EAP peer implementation".In addition to programs aimed at normal production use,%wpa_supplicant source tree includes number of \ref testing_tools"testing and development tools" that make it easier to test theprograms without having to setup a full test setup with wirelesscards. These tools can also be used to implement automatic testsuites.%wpa_supplicant implements a\ref ctrl_iface_page "control interface" that can be used byexternal programs to control the operations of the %wpa_supplicantdaemon and to get status information and event notifications. There isa small C library that provides helper functions to facilitate the use of thecontrol interface. This library can also be used with C++.\image html wpa_supplicant.png "wpa_supplicant modules"\image latex wpa_supplicant.eps "wpa_supplicant modules" width=15cm*/