[884672b] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?> |
---|
| 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" |
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ |
---|
| 4 | <!ENTITY % general-entities SYSTEM "../../general.ent"> |
---|
| 5 | %general-entities; |
---|
| 6 | ]> |
---|
| 7 | |
---|
[64a2454] | 8 | <sect1 id="ch-beyond-net-hostapd" role="wrap"> |
---|
[884672b] | 9 | <?dbhtml filename="hostapd.html"?> |
---|
| 10 | |
---|
| 11 | <title>hostapd-&hostapd-version;</title> |
---|
| 12 | |
---|
[64a2454] | 13 | <indexterm zone="ch-beyond-net-hostapd"> |
---|
[884672b] | 14 | <primary sortas="a-hostapd">hostapd</primary> |
---|
| 15 | </indexterm> |
---|
| 16 | |
---|
| 17 | <sect2 role="package"> |
---|
| 18 | <title/> |
---|
| 19 | |
---|
[ba1a2ff] | 20 | <para>Hostapd is a daemon required for setting up a wireless access point, |
---|
| 21 | it supports WEP, WPA and WPA2 encryption and can optionally use EAP for |
---|
| 22 | authentification, but since this feature requires OpenSSL only basic |
---|
| 23 | WEP/WPA/WPA2 encryption will be compiled here.</para> |
---|
[884672b] | 24 | |
---|
| 25 | </sect2> |
---|
| 26 | |
---|
| 27 | <sect2 role="installation"> |
---|
| 28 | <title>Installation of hostapd</title> |
---|
| 29 | |
---|
[ba1a2ff] | 30 | <para os="a">By default only a very basic hostapd is made, but hostapd |
---|
| 31 | supports a lot of other options as well. Write a basic config file for |
---|
| 32 | hostapd:</para> |
---|
[884672b] | 33 | |
---|
[ba1a2ff] | 34 | <screen os="b"><userinput>cd hostapd; cat > .config << EOF |
---|
[baaf929] | 35 | <literal># Support for nl80211 driver |
---|
[884672b] | 36 | CONFIG_DRIVER_NL80211=y |
---|
| 37 | # Use v2.0 of the netlink appi |
---|
| 38 | CFLAGS += -DCONFIG_LIBNL20 |
---|
| 39 | LDFLAGS += -lnl-genl |
---|
| 40 | |
---|
| 41 | CONFIG_RSN_PREAUTH=y |
---|
| 42 | |
---|
| 43 | # PeerKey handshake for Station to Station Link (IEEE 802.11e DLS) |
---|
| 44 | CONFIG_PEERKEY=y |
---|
| 45 | # Support draft ieee 802.11n |
---|
| 46 | CONFIG_IEEE80211N=y |
---|
| 47 | |
---|
| 48 | # Remove debugging code that is printing out debug messages to stdout. |
---|
| 49 | # This can be used to reduce the size of the hostapd considerably if debugging |
---|
| 50 | # code is not needed. |
---|
| 51 | CONFIG_NO_STDOUT_DEBUG=y |
---|
[baaf929] | 52 | EOF</literal></userinput></screen> |
---|
[884672b] | 53 | |
---|
| 54 | <para os="c">Compile the package:</para> |
---|
| 55 | |
---|
[819598b] | 56 | <screen os="d"><userinput>make CFLAGS="-g -Os -Wall"</userinput></screen> |
---|
[884672b] | 57 | |
---|
| 58 | <para os="e">Install the package:</para> |
---|
| 59 | |
---|
| 60 | <screen os="f"><userinput>cp hostapd hostapd_cli ${CLFS}/usr/sbin</userinput></screen> |
---|
| 61 | |
---|
[38a917a] | 62 | </sect2> |
---|
| 63 | |
---|
| 64 | <sect2 role="bootscripts"> |
---|
| 65 | <title>Installation of hostapd Bootscripts</title> |
---|
| 66 | |
---|
| 67 | <para os="h">From the clfs-bootscripts package, install the hostapd bootscripts:</para> |
---|
| 68 | |
---|
| 69 | <screen os="i"><userinput>make install-hostapd DESTDIR=${CLFS}</userinput></screen> |
---|
| 70 | |
---|
| 71 | </sect2> |
---|
[884672b] | 72 | |
---|
[38a917a] | 73 | <sect2 role="configuration"> |
---|
| 74 | <title>Configure hostapd</title> |
---|
[884672b] | 75 | |
---|
[38a917a] | 76 | <para os="j">Create hostapd.conf, this example file will create a WPA2 |
---|
[ba1a2ff] | 77 | encrypted host access point with the name dummy and password foobar123 on |
---|
| 78 | channel 4:</para> |
---|
[baaf929] | 79 | |
---|
[38a917a] | 80 | <screen os="k"><userinput>cat > ${CLFS}/etc/hostapd.conf << EOF |
---|
[baaf929] | 81 | <literal># Sample hostapd.conf |
---|
| 82 | # See hostapd/hostapd.conf in your hostap source tree for a more detailed version |
---|
| 83 | interface=wlan0 |
---|
| 84 | bridge=br0 |
---|
| 85 | ctrl_interface=/var/run/hostapd |
---|
| 86 | ssid=<replaceable>dummy</replaceable> |
---|
| 87 | #country_code=US |
---|
| 88 | country_code=<replaceable>EU</replaceable> |
---|
| 89 | hw_mode=g |
---|
| 90 | channel=<replaceable>4</replaceable> |
---|
| 91 | |
---|
| 92 | # wpa=1 only allow WPA1 |
---|
| 93 | # wpa=2 allow WPA2 only |
---|
| 94 | # wpa=3 allow WPA1 + WPA2 |
---|
| 95 | wpa=2 |
---|
| 96 | wpa_passphrase=<replaceable>foobar123</replaceable> |
---|
[2a6b48f] | 97 | # b43 drivers seem to have issues at the moment with CCMP encryption |
---|
| 98 | # dropping packets among other things so use TKIP (AES) only for now |
---|
| 99 | wpa_pairwise=TKIP |
---|
| 100 | rsn_pairwise=TKIP |
---|
[baaf929] | 101 | EOF</literal></userinput></screen> |
---|
| 102 | |
---|
[884672b] | 103 | </sect2> |
---|
| 104 | |
---|
| 105 | <sect2 id="contents-hostapd" role="content"> |
---|
| 106 | <title>Contents of hostapd</title> |
---|
| 107 | |
---|
| 108 | <segmentedlist> |
---|
| 109 | <segtitle>Installed programs</segtitle> |
---|
| 110 | |
---|
| 111 | <seglistitem> |
---|
| 112 | <seg>To be Written</seg> |
---|
| 113 | </seglistitem> |
---|
| 114 | </segmentedlist> |
---|
| 115 | |
---|
| 116 | </sect2> |
---|
| 117 | |
---|
| 118 | </sect1> |
---|