source: clfs-embedded/BOOK/beyond-net/common/hostapd.xml @ 3c75105

Last change on this file since 3c75105 was 3c75105, checked in by Andrew Bradford <andrew@…>, 10 years ago

beyond-net: Use ${CLFS}/targetfs

  • Property mode set to 100644
File size: 3.4 KB
RevLine 
[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 &gt; .config &lt;&lt; EOF
[baaf929]35<literal># Support for nl80211 driver
[884672b]36CONFIG_DRIVER_NL80211=y
37# Use v2.0 of the netlink appi
38CFLAGS += -DCONFIG_LIBNL20
39LDFLAGS += -lnl-genl
40
41CONFIG_RSN_PREAUTH=y
42
43# PeerKey handshake for Station to Station Link (IEEE 802.11e DLS)
44CONFIG_PEERKEY=y
45# Support draft ieee 802.11n
46CONFIG_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.
51CONFIG_NO_STDOUT_DEBUG=y
[baaf929]52EOF</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
[3c75105]60<screen os="f"><userinput>cp hostapd hostapd_cli ${CLFS}/targetfs/usr/sbin</userinput></screen>
[884672b]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
[3c75105]69<screen os="i"><userinput>make install-hostapd DESTDIR=${CLFS}/targetfs</userinput></screen>
[38a917a]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
[3c75105]80<screen os="k"><userinput>cat &gt; ${CLFS}/targetfs/etc/hostapd.conf &lt;&lt; EOF
[baaf929]81<literal># Sample hostapd.conf
82# See hostapd/hostapd.conf in your hostap source tree for a more detailed version
83interface=wlan0
84bridge=br0
85ctrl_interface=/var/run/hostapd
86ssid=<replaceable>dummy</replaceable>
87#country_code=US
88country_code=<replaceable>EU</replaceable>
89hw_mode=g
90channel=<replaceable>4</replaceable>
91
92# wpa=1 only allow WPA1
93# wpa=2 allow WPA2 only
94# wpa=3 allow WPA1 + WPA2
95wpa=2
96wpa_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
99wpa_pairwise=TKIP
100rsn_pairwise=TKIP
[baaf929]101EOF</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>
Note: See TracBrowser for help on using the repository browser.