source: clfs-embedded/BOOK/beyond-clfs/common/hostapd.xml@ e03921e

Last change on this file since e03921e was 819598b, checked in by Andrew Bradford <bradfa@…>, 14 years ago

Removed all CC="${CC}"

Left all the CC="${CC} -Os" even though there's inconsistencies on
choosing an optimization level for each package.

  • Property mode set to 100644
File size: 3.2 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-bclfs-hostapd" role="wrap">
9 <?dbhtml filename="hostapd.html"?>
10
11 <title>hostapd-&hostapd-version;</title>
12
13 <indexterm zone="ch-bclfs-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, it supports
21 WEP, WPA and WPA2 encryption and can optionally use EAP for authentification, but since
22 this feature requires OpenSSL only basic WEP/WPA/WPA2 encryption will be compiled here.
23 </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 supports a lot of other options as well. Write a basic config file for hostap:</para>
31
32<screen os="b"><userinput>
33cd hostapd; cat &gt; .config &lt;&lt; EOF
34<literal># Support for nl80211 driver
35CONFIG_DRIVER_NL80211=y
36# Use v2.0 of the netlink appi
37CFLAGS += -DCONFIG_LIBNL20
38LDFLAGS += -lnl-genl
39
40CONFIG_RSN_PREAUTH=y
41
42# PeerKey handshake for Station to Station Link (IEEE 802.11e DLS)
43CONFIG_PEERKEY=y
44# Support draft ieee 802.11n
45CONFIG_IEEE80211N=y
46
47# Remove debugging code that is printing out debug messages to stdout.
48# This can be used to reduce the size of the hostapd considerably if debugging
49# code is not needed.
50CONFIG_NO_STDOUT_DEBUG=y
51EOF</literal></userinput></screen>
52
53 <para os="c">Compile the package:</para>
54
55<screen os="d"><userinput>make CFLAGS="-g -Os -Wall"</userinput></screen>
56
57 <para os="e">Install the package:</para>
58
59<screen os="f"><userinput>cp hostapd hostapd_cli ${CLFS}/usr/sbin</userinput></screen>
60
61 <para os="g">Install the bootscripts from the clfs-bootscripts package:</para>
62
63<screen os="h"><userinput>make install-hostapd DESTDIR=${CLFS}</userinput></screen>
64
65 <para os="i">Create hostapd.conf, this example file will create a WPA2 encrypted
66 host access point with the name dummy and password foobar123 on channel 4:</para>
67
68<screen os="j"><userinput>cat &gt; ${CLFS} &lt;&lt; EOF
69<literal># Sample hostapd.conf
70# See hostapd/hostapd.conf in your hostap source tree for a more detailed version
71interface=wlan0
72bridge=br0
73ctrl_interface=/var/run/hostapd
74ssid=<replaceable>dummy</replaceable>
75#country_code=US
76country_code=<replaceable>EU</replaceable>
77hw_mode=g
78channel=<replaceable>4</replaceable>
79
80# wpa=1 only allow WPA1
81# wpa=2 allow WPA2 only
82# wpa=3 allow WPA1 + WPA2
83wpa=2
84wpa_passphrase=<replaceable>foobar123</replaceable>
85# b43 drivers seem to have issues at the moment with CCMP encryption
86# dropping packets among other things so use TKIP (AES) only for now
87wpa_pairwise=TKIP
88rsn_pairwise=TKIP
89EOF</literal></userinput></screen>
90
91 </sect2>
92
93 <sect2 id="contents-hostapd" role="content">
94 <title>Contents of hostapd</title>
95
96 <segmentedlist>
97 <segtitle>Installed programs</segtitle>
98
99 <seglistitem>
100 <seg>To be Written</seg>
101 </seglistitem>
102 </segmentedlist>
103
104 </sect2>
105
106</sect1>
Note: See TracBrowser for help on using the repository browser.