source: clfs-embedded/BOOK/beyond-net/common/hostapd.xml @ 38a917a

Last change on this file since 38a917a was 38a917a, checked in by William Harrington <kb0iic@…>, 10 years ago

Change Beyond Net hostapd page to include bootscript and configuration sections.

  • Property mode set to 100644
File size: 3.4 KB
Line 
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
8<sect1 id="ch-beyond-net-hostapd" role="wrap">
9  <?dbhtml filename="hostapd.html"?>
10
11  <title>hostapd-&hostapd-version;</title>
12
13  <indexterm zone="ch-beyond-net-hostapd">
14    <primary sortas="a-hostapd">hostapd</primary>
15  </indexterm>
16
17  <sect2 role="package">
18    <title/>
19
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>
24
25  </sect2>
26
27  <sect2 role="installation">
28    <title>Installation of hostapd</title>
29
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>
33
34<screen os="b"><userinput>cd hostapd; cat &gt; .config &lt;&lt; EOF
35<literal># Support for nl80211 driver
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
52EOF</literal></userinput></screen>
53
54    <para os="c">Compile the package:</para>
55
56<screen os="d"><userinput>make CFLAGS="-g -Os -Wall"</userinput></screen>
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
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>
72
73  <sect2 role="configuration">
74   <title>Configure hostapd</title>
75
76    <para os="j">Create hostapd.conf, this example file will create a WPA2
77    encrypted host access point with the name dummy and password foobar123 on
78    channel 4:</para>
79
80<screen os="k"><userinput>cat &gt; ${CLFS}/etc/hostapd.conf &lt;&lt; EOF
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>
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
101EOF</literal></userinput></screen>
102
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.