Changeset 4c869cdd for networking
- Timestamp:
- 05/20/2012 10:13:27 PM (12 years ago)
- Branches:
- 10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
- Children:
- f509830a
- Parents:
- 11f60725
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
networking/netprogs/wpa_supplicant.xml
r11f60725 r4c869cdd 6 6 7 7 <!ENTITY wpa_supplicant-download-http 8 "http://hostap.epitest.fi/releases/wpa_supplicant-&wpa_supplicant-version;.tar.gz"> 8 "http://hostap.epitest.fi/releases/wpa_supplicant-&wpa_supplicant-version;.tar.gz"> 9 <!ENTITY wpa_supplicant-download-ftp " "> 9 10 <!ENTITY wpa_supplicant-md5sum "8650f6aa23646ef634402552d0669640"> 10 11 <!ENTITY wpa_supplicant-size "1.9 MB"> … … 28 29 29 30 <sect2 role="package"> 30 <title>Introduction to wpa_supplicant</title> 31 32 <para><application>wpa_supplicant</application> is a Wi-Fi Protected Access 33 (WPA) client and IEEE 802.1X supplicant. It implements WPA key negotiation 34 with a WPA Authenticator and Extensible Authentication Protocol (EAP) 35 authentication with an Authentication Server. In addition, it controls the 36 roaming and IEEE 802.11 authentication/association of the wireless LAN 37 driver. This is useful for connecting to a password protected wireless 38 access point.</para> 31 <title>Introduction to WPA Supplicant</title> 32 33 <para> 34 <application>WPA Supplicant</application> is a Wi-Fi Protected Access 35 (WPA) client and IEEE 802.1X supplicant. It implements WPA key negotiation 36 with a WPA Authenticator and Extensible Authentication Protocol (EAP) 37 authentication with an Authentication Server. In addition, it controls the 38 roaming and IEEE 802.11 authentication/association of the wireless LAN 39 driver. This is useful for connecting to a password protected wireless 40 access point. 41 </para> 39 42 40 43 &lfs71_checked; … … 43 46 <itemizedlist spacing="compact"> 44 47 <listitem> 45 <para>Download (HTTP): 46 <ulink url="&wpa_supplicant-download-http;"/></para> 47 </listitem> 48 <listitem> 49 <para>Download MD5 sum: &wpa_supplicant-md5sum;</para> 50 </listitem> 51 <listitem> 52 <para>Download size: &wpa_supplicant-size;</para> 53 </listitem> 54 <listitem> 55 <para>Estimated disk space required: &wpa_supplicant-buildsize;</para> 56 </listitem> 57 <listitem> 58 <para>Estimated build time: &wpa_supplicant-time;</para> 48 <para> 49 Download (HTTP): <ulink url="&wpa_supplicant-download-http;"/> 50 </para> 51 </listitem> 52 <listitem> 53 <para> 54 Download (FTP): <ulink url="&wpa_supplicant-download-ftp;"/> 55 </para> 56 </listitem> 57 <listitem> 58 <para> 59 Download MD5 sum: &wpa_supplicant-md5sum; 60 </para> 61 </listitem> 62 <listitem> 63 <para> 64 Download size: &wpa_supplicant-size; 65 </para> 66 </listitem> 67 <listitem> 68 <para> 69 Estimated disk space required: &wpa_supplicant-buildsize; 70 </para> 71 </listitem> 72 <listitem> 73 <para> 74 Estimated build time: &wpa_supplicant-time; 75 </para> 59 76 </listitem> 60 77 </itemizedlist> 61 <!-- 62 <bridgehead renderas="sect3">Additional Downloads</bridgehead> 63 <itemizedlist spacing="compact"> 64 <listitem> 65 <para>Required patch: <ulink 66 url="&patch-root;/wpa_supplicant-&wpa_supplicant-version;-libnl-3-fixes-1.patch"/></para> 67 </listitem> 68 </itemizedlist> 69 --> 70 <bridgehead renderas="sect3">wpa_supplicant Dependencies</bridgehead> 78 79 <bridgehead renderas="sect3">WPA Supplicant Dependencies</bridgehead> 80 81 <bridgehead renderas="sect4">Recommended</bridgehead> 82 <para role="recommended"> 83 <xref linkend="libnl"/> and 84 <!-- From defconfig: WEXT is deprecated in the current Linux kernel 85 version and no new functionality is added to it. nl80211-based 86 interface is the new replacement for WEXT --> 87 <xref linkend="openssl"/> 88 <!-- For EAP-* Methods --> 89 </para> 71 90 72 91 <bridgehead renderas="sect4">Optional</bridgehead> 73 92 <para role="optional"> 74 <xref linkend="openssl"/>,75 <xref linkend="libnl"/> (required to use the nl80211 kernel interface),76 <!-- using CONFIG_TLS=gnutls fails as77 src/crypto/tls_gnutls.c uses functions like gnutls_session_get_client_random78 and gnutls_session_get_server_random which have been removed from current 79 <xref linkend="gnutls"/> -->80 <xref linkend="dbus"/>,81 <ulink url="http://libtom.org/">libtommath</ulink>,82 < xref linkend="libpcap"/> and83 <ulink url="http://libdnet.sourceforge.net/">libdnet</ulink>. 84 < /para>93 <xref linkend="dbus"/> and 94 <xref linkend="libxml2"/> 95 <!-- D-Bus and libxml2 are required for D-Bus Interface which 96 NetworkManager uses. 97 98 WPA Supplicant uses internal Linux specific implemenation 99 for L2_PACKET, libpcap or libdnet are only there for portability 100 with other OS'es. See README if you don't believe me. --> 101 </para> 102 103 <!-- TODO: Write instructions for building wpa_gui --> 85 104 86 105 <para condition="html" role="usernotes">User Notes: 87 <ulink url="&blfs-wiki;/wpa_supplicant"/></para> 106 <ulink url="&blfs-wiki;/wpa_supplicant"/> 107 </para> 88 108 </sect2> 89 109 … … 91 111 <title>Kernel Configuration</title> 92 112 93 <para>Enable the following options in the kernel configuration 94 and recompile the kernel if necessary:</para> 113 <para> 114 Enable the following options in the kernel configuration 115 and recompile the kernel if necessary: 116 </para> 95 117 96 118 <screen><literal>[*] Networking support ---> … … 105 127 </literal></screen> 106 128 107 <para>Select the options that support your hardware: 108 <command>lspci</command> from <xref linkend="pciutils"/> can be used to 109 view your hardware configuration.</para> 129 <para> 130 Select the options that support your hardware: 131 <command>lspci</command> from <xref linkend="pciutils"/> can be used to 132 view your hardware configuration. 133 </para> 110 134 111 135 <indexterm zone="wpa_supplicant wpa_supplicant-kernel"> … … 115 139 116 140 <sect2 role="installation"> 117 <title>Installation of wpa_supplicant</title> 118 119 <para>Install <application>wpa_supplicant</application> by running the 120 following commands:</para> 121 122 <screen><userinput>cd wpa_supplicant && 123 cat > .config << "HERE_DOC" 141 <title>Installation of WPA Supplicant</title> 142 143 <para> 144 First you will need to create an initial configuration file for the 145 build process. You can read <filename>wpa_supplicant/README</filename> 146 and <filename>wpa_supplicant/defconfig</filename> for the explanation 147 of the following options as well as other options that can be used. 148 Create a build configuration file that should work for standard WiFi 149 setups by running the following command: 150 </para> 151 152 <screen><userinput>cat > wpa_supplicant/.config << "EOF" 153 CONFIG_BACKEND=file 154 CONFIG_CTRL_IFACE=y 155 CONFIG_DRIVER_NL80211=y 124 156 CONFIG_DRIVER_WEXT=y 125 CONFIG_EAP_GPSK=y 126 CONFIG_EAP_GPSK_SHA256=y 157 CONFIG_DRIVER_WIRED=y 127 158 CONFIG_EAP_GTC=y 128 CONFIG_EAP_IKEV2=y129 159 CONFIG_EAP_LEAP=y 130 160 CONFIG_EAP_MD5=y 131 161 CONFIG_EAP_MSCHAPV2=y 132 162 CONFIG_EAP_OTP=y 133 CONFIG_EAP_PAX=y134 163 CONFIG_EAP_PEAP=y 135 CONFIG_EAP_PSK=y136 164 CONFIG_EAP_TLS=y 137 165 CONFIG_EAP_TTLS=y 166 CONFIG_IEEE8021X_EAPOL=y 167 CONFIG_IPV6=y 168 CONFIG_LIBNL32=y 138 169 CONFIG_PEERKEY=y 139 170 CONFIG_PKCS12=y 140 CONFIG_CTRL_IFACE=y141 171 CONFIG_READLINE=y 142 CONFIG_IPV6=y 143 CONFIG_LIBNL32=y 144 CFLAGS += -I/usr/include/libnl3 145 146 # If you have not installed openssl, uncomment the next line: 147 # CONFIG_TLS=internal 148 149 # If you want to use the internal TLS and have 150 # not installed libtommath, uncomment the next line: 151 # CONFIG_INTERNAL_LIBTOMMATH=y 152 153 # Uncomment the next line if you want to build the nl80211 driver: 154 # CONFIG_DRIVER_NL80211=y 155 156 # Uncomment the next line if you have a ralink chipset: 157 # CONFIG_DRIVER_RALINK=y 158 159 # Uncomment the next line if you have an Agere Hermes chipset: 160 # CONFIG_DRIVER_HERMES=y 161 162 # Uncomment the next line if you have an Atmel chipset: 163 # CONFIG_DRIVER_ATMEL=y 164 165 # Uncomment the next line if you've installed dbus: 166 # CONFIG_CTRL_IFACE_DBUS_NEW=y 167 168 # Uncomment the next line if you've installed libpcap and libdnet: 169 # CONFIG_L2_PACKET=pcap 170 HERE_DOC 171 make</userinput></screen> 172 173 <para>This package does not come with a test suite.</para> 174 175 <para>Now, as the <systemitem class="username">root</systemitem> 176 user:</para> 177 178 <screen role="root"><userinput>cp wpa_{cli,passphrase,supplicant} /sbin && 179 cp doc/docbook/wpa_supplicant.conf.5 /usr/share/man/man5 && 180 cp doc/docbook/wpa_{cli,passphrase,supplicant}.8 /usr/share/man/man8</userinput></screen> 181 </sect2> 182 183 <sect2 role="commands"> 184 <title>Command Explanations</title> 185 186 <para><command>cat > .config ...</command>: This creates a default 187 configuration that should work in most situations. It uses the WEXT kernel 188 driver which most wireless cards seem to use. For an explanation of these 189 options (and to see what other options you could choose) read the 190 <filename>wpa_supplicant/defconfig</filename> file in the source.</para> 172 CONFIG_SMARTCARD=y 173 CONFIG_WPS=y 174 EOF</userinput></screen> 175 176 <para> 177 If you wish to use <application>WPA Supplicant</application> with 178 <xref linkend="NetworkManager"/>, make sure that you have installed 179 <xref linkend="dbus"/> and <xref linkend="libxml2"/>, then add 180 following options to the <application>WPA Supplicant</application> 181 build configuration file by running the following command: 182 </para> 183 184 <screen><userinput>cat >> wpa_supplicant/.config << "EOF" 185 CONFIG_CTRL_IFACE_DBUS=y 186 CONFIG_CTRL_IFACE_DBUS_NEW=y 187 CONFIG_CTRL_IFACE_DBUS_INTRO=y 188 EOF</userinput></screen> 189 190 <para> 191 Install <application>WPA Supplicant</application> by running the 192 following commands: 193 </para> 194 195 <screen><userinput>cd wpa_supplicant && 196 make BINDIR=/sbin LIBDIR=/lib</userinput></screen> 197 198 <para> 199 This package does not come with a test suite. 200 </para> 201 202 <para> 203 Now, as the <systemitem class="username">root</systemitem> 204 user: 205 </para> 206 207 <screen role="root"><userinput>install -v -m755 wpa_{cli,passphrase,supplicant} /sbin && 208 install -v -m644 doc/docbook/wpa_supplicant.conf.5 /usr/share/man/man5 && 209 install -v -m644 doc/docbook/wpa_{cli,passphrase,supplicant}.8 /usr/share/man/man8</userinput></screen> 210 211 <para> 212 If you have built <application>WPA Supplicant</application> with 213 <application>D-Bus</application> support, you will need to install 214 <application>D-Bus</application> configuration files. Install them 215 by running the following commands as the 216 <systemitem class="username">root</systemitem> user: 217 </para> 218 219 <screen role="root"><userinput>install -v -m644 dbus/fi.{epitest.hostap.WPASupplicant,w1.wpa_supplicant1}.service \ 220 /usr/share/dbus-1/system-services && 221 install -v -m644 dbus/dbus-wpa_supplicant.conf /etc/dbus-1/system.d/wpa_supplicant.conf 222 </userinput></screen> 223 224 <note> 225 <para> 226 You will need to restart system <application>D-Bus</application> daemon before you 227 can use <application>WPA Supplicant</application> <application>D-Bus</application> 228 interface. 229 </para> 230 </note> 231 191 232 </sect2> 192 233 … … 207 248 <title>Configuration Information</title> 208 249 209 <para>To connect to an access point that uses a password you need to put 210 the pre-shared key in <filename>/etc/wpa_supplicant.conf</filename>. Use 211 <command>wpa_passphrase</command> to generate this. SSID is the string 212 that the access point/router transmits to identify itself. As the 213 <systemitem class="username">root</systemitem> user:</para> 250 <para> 251 To connect to an access point that uses a password you need to put 252 the pre-shared key in <filename>/etc/wpa_supplicant.conf</filename>. Use 253 <command>wpa_passphrase</command> to generate this. SSID is the string 254 that the access point/router transmits to identify itself. As the 255 <systemitem class="username">root</systemitem> user: 256 </para> 214 257 215 258 <screen role="root"><userinput>wpa_passphrase <replaceable>SSID</replaceable> <replaceable>SECRET_PASSWORD</replaceable> > /etc/wpa_supplicant.conf</userinput></screen> 216 259 217 <para>/etc/wpa_supplicant.conf can hold the details of several access 218 points. When you run wpa_supplicant it will scan for the SSIDs it can see 219 and choose the appropriate password to connect.</para> 220 221 <para>If you want to connect to an access point that isn't password 222 protected, put an entry like this in 223 <filename>/etc/wpa_supplicant.conf</filename>. Replace 224 "Some-SSID" with the SSID of the access point/router.</para> 260 <para> 261 <filename>/etc/wpa_supplicant.conf</filename> can hold the details of 262 several access points. When you run <command>wpa_supplicant</command> 263 it will scan for the SSIDs it can see and choose the appropriate 264 password to connect. 265 </para> 266 267 <para> 268 If you want to connect to an access point that isn't password 269 protected, put an entry like this in 270 <filename>/etc/wpa_supplicant.conf</filename>. Replace 271 "Some-SSID" with the SSID of the access point/router. 272 </para> 225 273 226 274 <screen>network={ … … 229 277 }</screen> 230 278 231 <para>There are many options that you could use to tweak how you connect 232 to each access point. They are described in some detail in the 233 <filename>wpa_supplicant/wpa_supplicant.conf</filename> file in the 234 source.</para> 235 236 <para>To use <command>wpa_cli</command> to control the running 237 wpa_supplicant daemon, add a control interface to 238 <filename>/etc/wpa_supplicant.conf</filename>. As the 239 <systemitem class="username">root</systemitem> user:</para> 279 <para> 280 There are many options that you could use to tweak how you connect 281 to each access point. They are described in some detail in the 282 <filename>wpa_supplicant/wpa_supplicant.conf</filename> file in the 283 source tree. 284 </para> 285 286 <para> 287 To use <command>wpa_cli</command> to control the running 288 <command>>wpa_supplicant</command> daemon, add a control interface to 289 <filename>/etc/wpa_supplicant.conf</filename> as the 290 <systemitem class="username">root</systemitem> user: 291 </para> 240 292 241 293 <screen role="root"><userinput>echo ctrl_interface=/run/wpa_supplicant >> /etc/wpa_supplicant.conf</userinput></screen> … … 245 297 <title>Connecting to an Access Point</title> 246 298 247 <para>If your router/access point uses DHCP to allocate IP addresses you 248 can install <xref linkend="dhcpcd"/> and use it to connect. As the 249 <systemitem class="username">root</systemitem> user:</para> 299 <para> 300 If your router/access point uses DHCP to allocate IP addresses you 301 can install <xref linkend="dhcpcd"/> and use it to connect. As the 302 <systemitem class="username">root</systemitem> user: 303 </para> 250 304 251 305 <screen role="root"><userinput>wpa_supplicant -B -c/etc/wpa_supplicant.conf -iwlan0 -Dwext … … 253 307 dhcpcd</userinput></screen> 254 308 255 <para>Alternatively, you can use static addresses on your local network. 256 This has the advantage that you can put the hostnames in 257 <filename>/etc/hosts</filename>. Replace 192.168.1.6 with the static 258 address you've chosen. Replace 192.168.1.1 with the local IP address of 259 the access point/router. As the 260 <systemitem class="username">root</systemitem> user:</para> 309 <para> 310 Alternatively, you can use static addresses on your local network. 311 This has the advantage that you can put the hostnames in 312 <filename>/etc/hosts</filename>. Replace 192.168.1.6 with the static 313 address you've chosen. Replace 192.168.1.1 with the local IP address of 314 the access point/router. Run the following commands as the 315 <systemitem class="username">root</systemitem> user: 316 </para> 261 317 262 318 <screen role="root"><userinput>ip addr add 192.168.1.6 dev wlan0 … … 292 348 <term><command>wpa_supplicant</command></term> 293 349 <listitem> 294 <para>is a daemon that can connect to a password protected wireless 295 access point.</para> 350 <para> 351 is a daemon that can connect to a password protected wireless 352 access point. 353 </para> 296 354 <indexterm zone="wpa_supplicant wpa_supplicant-prog"> 297 355 <primary sortas="b-wpa_supplicant">wpa_supplicant</primary> … … 303 361 <term><command>wpa_passphrase</command></term> 304 362 <listitem> 305 <para>takes an SSID and a password and generates a simple 306 configuration that <command>wpa_supplicant</command> can 307 understand.</para> 363 <para> 364 takes an SSID and a password and generates a simple 365 configuration that <command>wpa_supplicant</command> can 366 understand. 367 </para> 308 368 <indexterm zone="wpa_supplicant wpa_passphrase"> 309 369 <primary sortas="b-wpa_passphrase">wpa_passphrase</primary> … … 315 375 <term><command>wpa_cli</command></term> 316 376 <listitem> 317 <para>is a command line interface to control a running wpa_supplicant 318 daemon.</para> 377 <para> 378 is a command line interface used to control a running 379 <command>wpa_supplicant</command> daemon. 380 </para> 319 381 <indexterm zone="wpa_supplicant wpa_cli"> 320 382 <primary sortas="b-wpa_cli">wpa_cli</primary> … … 322 384 </listitem> 323 385 </varlistentry> 386 324 387 </variablelist> 325 </sect2> 388 389 </sect2> 390 326 391 </sect1>
Note:
See TracChangeset
for help on using the changeset viewer.