1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
|
.\" $OpenBSD: hostapd.8,v 1.2 2005/04/13 18:25:50 reyk Exp $
.\"
.\" Copyright (c) 2004, 2005 Reyk Floeter <reyk@vantronix.net>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd November 13, 2004
.Dt HOSTAPD 8
.Os
.Sh NAME
.Nm hostapd
.Nd Host Access Point daemon
.Sh SYNOPSIS
.Nm hostapd
.Op Fl dvb
.Op Fl a Ar interface
.Oo Xo
.Fl D Ar macro Ns = Ns Ar value Oc
.Xc
.Op Fl f Ar file
.Op Fl i Ar interface
.Sh DESCRIPTION
.Nm
is an daemon which allows communication between different 802.11
wireless access points running in
.Pa Host AP
mode.
.Pp
.Nm
implements the Inter Access Points Protocol (IAPP).
It's purpose is to exchange station association updates between access
points in large wireless networks.
IAPP has been designed to speed up roaming between different access
points in the same
.Pa BSS .
IAPP is described in the
.Pa IEEE 802.11f
standard.
.Pp
.Nm
additionally allows to monitor and to log stations associations on a
non-hostap host which is receiving IAPP messages.
.Pp
.Nm
uses two network interfaces as options on startup.
The first interface
.Pa ( Fl a Ar interface )
is used to access the
.Pa Host AP ,
which is a wireless interface running in Host AP mode. Please use
.Xr ifconfig 4
to enable Host AP mode. The second interface
.Pa ( Fl i Ar interface )
is used to communicate with other
.Nm
in the same broadcast domain or multicast group.
Usually a wired interface is used to communicate with other
.Nm .
.Pp
The
.Nm
will send an
.Pa ADD.notify
IAPP message if a new station has been associated successfully to the
.Pa Host AP .
If the
.Nm
receives
.Pa ADD.notify
messages it will request the
.Pa Host AP
to remove a station which has been associated to another access point.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl a Ar interface
Specify the 802.11 wireless network interface running in
.Pa Host AP
mode.
This this option could be omitted to use the
.Nm
to log received
.Pa IAPP
messages.
.It Fl b
Use UDP broadcast instead of multicast group 224.0.1.178 for IAPP
messages.
.It Fl D Ar macro Ns = Ns Ar value
Define
.Ar macro
to be set to
.Ar value
on the command line.
Overrides the definition of
.Ar macro
in the configuration file.
.It Fl d
Do not daemonize and log to
.Em stderr .
.It Fl f Ar file
Use
.Ar file
as the configuration file, instead of the default
.Pa /etc/hostapd.conf .
.It Fl i Ar interface
Specify the network interface used to send
.Pa IAPP
messages.
It is important that the IAPP interface is on a trusted
network because there is no authentication and an attacker could force
disassociation of selected stations on all listening access points.
.It Fl v
Produce more verbose output.
.El
.Sh FILES
.Bl -tag -width "/etc/hostapd.confXXX" -compact
.It Pa /etc/hostapd.conf
default
.Nm
configuration file
.El
.Sh SEE ALSO
.Xr hostapd.conf 5 ,
.Xr ifconfig 4
.Rs
.%R IEEE 802.11F
.%T Inter Access Point Protocol
.%D March 2001
.Re
.Sh CAVEATS
.Nm
depends on drivers using the
.Pa net80211
kernel wireless layer with support of
.Pa Host AP mode.
For traditional reasons,
the
.Xr wi 4
driver still uses it's own Host AP code in
.Pa if_wi_hostap
which is not supported by
.Nm .
.Sh HISTORY
The
.Nm
program first appeared on the 21th Chaos Communication Congress
(http://www.ccc.de/congress/2004/) and later in
.Ox 3.8 .
.Sh AUTHORS
The
.Nm
program was written by
.An Reyk Floeter Aq reyk@openbsd.org .
|
