aboutsummaryrefslogtreecommitdiffstats log msg author committer range
blob: 26f5f6d8e047efba49d400207788844be480f3cf (plain)
 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322  /** \page code_structure Structure of the source code [ \ref _wpa_supplicant_core "wpa_supplicant core functionality" | \ref generic_helper_func "Generic helper functions" | \ref crypto_func "Cryptographic functions" | \ref tls_func "TLS library" | \ref configuration "Configuration" | \ref ctrl_iface "Control interface" | \ref wpa_code "WPA supplicant" | \ref eap_peer "EAP peer" | \ref eapol_supp "EAPOL supplicant" | \ref win_port "Windows port" | \ref test_programs "Test programs" ] %wpa_supplicant implementation is divided into number of independent modules. Core code includes functionality for controlling the network selection, association, and configuration. Independent modules include WPA code (key handshake, PMKSA caching, pre-authentication), EAPOL state machine, and EAP state machine and methods. In addition, there are number of separate files for generic helper functions. Both WPA and EAPOL/EAP state machines can be used separately in other programs than %wpa_supplicant. As an example, the included test programs eapol_test and preauth_test are using these modules. \ref driver_wrapper "Driver interface API" is defined in driver.h and all hardware/driver dependent functionality is implemented in driver_*.c. \section _wpa_supplicant_core wpa_supplicant core functionality wpa_supplicant.c Program initialization, main control loop main.c main() for UNIX-like operating systems and MinGW (Windows); this uses command line arguments to configure wpa_supplicant events.c Driver event processing; wpa_supplicant_event() and related functions wpa_supplicant_i.h Internal definitions for %wpa_supplicant core; should not be included into independent modules \section generic_helper_func Generic helper functions %wpa_supplicant uses generic helper functions some of which are shared with with hostapd. The following C files are currently used: eloop.c and eloop.h Event loop (select() loop with registerable timeouts, socket read callbacks, and signal callbacks) common.c and common.h Common helper functions defs.h Definitions shared by multiple files l2_packet.h, l2_packet_linux.c, and l2_packet_pcap.c Layer 2 (link) access wrapper (includes native Linux implementation and wrappers for libdnet/libpcap). A new l2_packet implementation may need to be added when porting to new operating systems that are not supported by libdnet/libpcap. Makefile can be used to select which l2_packet implementation is included. l2_packet_linux.c uses Linux packet sockets and l2_packet_pcap.c has a more portable version using libpcap and libdnet. pcsc_funcs.c and pcsc_funcs.h Wrapper for PC/SC lite SIM and smart card readers priv_netlink.h Private version of netlink definitions from Linux kernel header files; this could be replaced with C library header file once suitable version becomes commonly available version.h Version number definitions wireless_copy.h Private version of Linux wireless extensions definitions from kernel header files; this could be replaced with C library header file once suitable version becomes commonly available \section crypto_func Cryptographic functions md5.c and md5.h MD5 (replaced with a crypto library if TLS support is included) HMAC-MD5 (keyed checksum for message authenticity validation) rc4.c and rc4.h RC4 (broadcast/default key encryption) sha1.c and sha1.h SHA-1 (replaced with a crypto library if TLS support is included) HMAC-SHA-1 (keyed checksum for message authenticity validation) PRF-SHA-1 (pseudorandom (key/nonce generation) function) PBKDF2-SHA-1 (ASCII passphrase to shared secret) T-PRF (for EAP-FAST) TLS-PRF (RFC 2246) sha256.c and sha256.h SHA-256 (replaced with a crypto library if TLS support is included) aes_wrap.c, aes_wrap.h, aes.c AES (replaced with a crypto library if TLS support is included), AES Key Wrap Algorithm with 128-bit KEK, RFC3394 (broadcast/default key encryption), One-Key CBC MAC (OMAC1) hash with AES-128, AES-128 CTR mode encryption, AES-128 EAX mode encryption/decryption, AES-128 CBC crypto.h Definition of crypto library wrapper crypto_openssl.c Wrapper functions for libcrypto (OpenSSL) crypto_internal.c Wrapper functions for internal crypto implementation crypto_gnutls.c Wrapper functions for libgcrypt (used by GnuTLS) ms_funcs.c and ms_funcs.h Helper functions for MSCHAPV2 and LEAP tls.h Definition of TLS library wrapper tls_none.c Dummy implementation of TLS library wrapper for cases where TLS functionality is not included. tls_openssl.c TLS library wrapper for openssl tls_internal.c TLS library for internal TLS implementation tls_gnutls.c TLS library wrapper for GnuTLS \section tls_func TLS library asn1.c and asn1.h ASN.1 DER parsing bignum.c and bignum.h Big number math rsa.c and rsa.h RSA x509v3.c and x509v3.h X.509v3 certificate parsing and processing tlsv1_client.c, tlsv1_client.h TLSv1 client (RFC 2246) tlsv1_client_i.h Internal structures for TLSv1 client tlsv1_client_read.c TLSv1 client: read handshake messages tlsv1_client_write.c TLSv1 client: write handshake messages tlsv1_common.c and tlsv1_common.h Common TLSv1 routines and definitions tlsv1_cred.c and tlsv1_cred.h TLSv1 credentials tlsv1_record.c and tlsv1_record.h TLSv1 record protocol \section configuration Configuration config_ssid.h Definition of per network configuration items config.h Definition of the %wpa_supplicant configuration config.c Configuration parser and common functions config_file.c Configuration backend for text files (e.g., wpa_supplicant.conf) config_winreg.c Configuration backend for Windows registry \section ctrl_iface Control interface %wpa_supplicant has a \ref ctrl_iface_page "control interface" that can be used to get status information and manage operations from external programs. An example command line interface (wpa_cli) and GUI (wpa_gui) for this interface are included in the %wpa_supplicant distribution. ctrl_iface.c and ctrl_iface.h %wpa_supplicant-side of the control interface ctrl_iface_unix.c UNIX domain sockets -based control interface backend ctrl_iface_udp.c UDP sockets -based control interface backend ctrl_iface_named_pipe.c Windows named pipes -based control interface backend wpa_ctrl.c and wpa_ctrl.h Library functions for external programs to provide access to the %wpa_supplicant control interface wpa_cli.c Example program for using %wpa_supplicant control interface \section wpa_code WPA supplicant wpa.c and wpa.h WPA state machine and 4-Way/Group Key Handshake processing preauth.c and preauth.h PMKSA caching and pre-authentication (RSN/WPA2) wpa_i.h Internal definitions for WPA code; not to be included to other modules. \section eap_peer EAP peer \ref eap_peer_module "EAP peer implementation" is a separate module that can be used by other programs than just %wpa_supplicant. eap.c and eap.h EAP state machine and method interface eap_defs.h Common EAP definitions eap_i.h Internal definitions for EAP state machine and EAP methods; not to be included in other modules eap_sim_common.c and eap_sim_common.h Common code for EAP-SIM and EAP-AKA eap_tls_common.c and eap_tls_common.h Common code for EAP-PEAP, EAP-TTLS, and EAP-FAST eap_tlv.c and eap_tlv.h EAP-TLV code for EAP-PEAP and EAP-FAST eap_ttls.c and eap_ttls.h EAP-TTLS eap_pax.c, eap_pax_common.h, eap_pax_common.c EAP-PAX eap_psk.c, eap_psk_common.h, eap_psk_common.c EAP-PSK (note: this is not needed for WPA-PSK) eap_sake.c, eap_sake_common.h, eap_sake_common.c EAP-SAKE eap_gpsk.c, eap_gpsk_common.h, eap_gpsk_common.c EAP-GPSK eap_aka.c, eap_fast.c, eap_gtc.c, eap_leap.c, eap_md5.c, eap_mschapv2.c, eap_otp.c, eap_peap.c, eap_sim.c, eap_tls.c Other EAP method implementations \section eapol_supp EAPOL supplicant eapol_supp_sm.c and eapol_supp_sm.h EAPOL supplicant state machine and IEEE 802.1X processing \section win_port Windows port ndis_events.c Code for receiving NdisMIndicateStatus() events and delivering them to %wpa_supplicant driver_ndis.c in more easier to use form win_if_list.c External program for listing current network interface \section test_programs Test programs radius_client.c and radius_client.h RADIUS authentication client implementation for eapol_test radius.c and radius.h RADIUS message processing for eapol_test eapol_test.c Standalone EAP testing tool with integrated RADIUS authentication client preauth_test.c Standalone RSN pre-authentication tool wpa_passphrase.c WPA ASCII passphrase to PSK conversion */