Merge from vendor branch GCC:
[dragonfly.git] / contrib / hostapd-0.4.9 / hostapd.conf
1 ##### hostapd configuration file ##############################################
2 # Empty lines and lines starting with # are ignored
3
4 # AP netdevice name (without 'ap' postfix, i.e., wlan0 uses wlan0ap for
5 # management frames); ath0 for madwifi
6 interface=wlan0
7
8 # In case of madwifi driver, an additional configuration parameter, bridge,
9 # must be used to notify hostapd if the interface is included in a bridge. This
10 # parameter is not used with Host AP driver.
11 #bridge=br0
12
13 # Driver interface type (hostap/wired/madwifi/prism54; default: hostap)
14 # driver=hostap
15
16 # hostapd event logger configuration
17 #
18 # Two output method: syslog and stdout (only usable if not forking to
19 # background).
20 #
21 # Module bitfield (ORed bitfield of modules that will be logged; -1 = all
22 # modules):
23 # bit 0 (1) = IEEE 802.11
24 # bit 1 (2) = IEEE 802.1X
25 # bit 2 (4) = RADIUS
26 # bit 3 (8) = WPA
27 # bit 4 (16) = driver interface
28 # bit 5 (32) = IAPP
29 #
30 # Levels (minimum value for logged events):
31 #  0 = verbose debugging
32 #  1 = debugging
33 #  2 = informational messages
34 #  3 = notification
35 #  4 = warning
36 #
37 logger_syslog=-1
38 logger_syslog_level=2
39 logger_stdout=-1
40 logger_stdout_level=2
41
42 # Debugging: 0 = no, 1 = minimal, 2 = verbose, 3 = msg dumps, 4 = excessive
43 debug=0
44
45 # Dump file for state information (on SIGUSR1)
46 dump_file=/tmp/hostapd.dump
47
48 # Interface for separate control program. If this is specified, hostapd
49 # will create this directory and a UNIX domain socket for listening to requests
50 # from external programs (CLI/GUI, etc.) for status information and
51 # configuration. The socket file will be named based on the interface name, so
52 # multiple hostapd processes/interfaces can be run at the same time if more
53 # than one interface is used.
54 # /var/run/hostapd is the recommended directory for sockets and by default,
55 # hostapd_cli will use it when trying to connect with hostapd.
56 ctrl_interface=/var/run/hostapd
57
58 # Access control for the control interface can be configured by setting the
59 # directory to allow only members of a group to use sockets. This way, it is
60 # possible to run hostapd as root (since it needs to change network
61 # configuration and open raw sockets) and still allow GUI/CLI components to be
62 # run as non-root users. However, since the control interface can be used to
63 # change the network configuration, this access needs to be protected in many
64 # cases. By default, hostapd is configured to use gid 0 (root). If you
65 # want to allow non-root users to use the contron interface, add a new group
66 # and change this value to match with that group. Add users that should have
67 # control interface access to this group.
68 #
69 # This variable can be a group name or gid.
70 #ctrl_interface_group=wheel
71 ctrl_interface_group=0
72
73
74 ##### IEEE 802.11 related configuration #######################################
75
76 # SSID to be used in IEEE 802.11 management frames
77 ssid=test
78
79 # Station MAC address -based authentication
80 # 0 = accept unless in deny list
81 # 1 = deny unless in accept list
82 # 2 = use external RADIUS server (accept/deny lists are searched first)
83 macaddr_acl=0
84
85 # Accept/deny lists are read from separate files (containing list of
86 # MAC addresses, one per line). Use absolute path name to make sure that the
87 # files can be read on SIGHUP configuration reloads.
88 #accept_mac_file=/etc/hostapd.accept
89 #deny_mac_file=/etc/hostapd.deny
90
91 # IEEE 802.11 specifies two authentication algorithms. hostapd can be
92 # configured to allow both of these or only one. Open system authentication
93 # should be used with IEEE 802.1X.
94 # Bit fields of allowed authentication algorithms:
95 # bit 0 = Open System Authentication
96 # bit 1 = Shared Key Authentication (requires WEP)
97 auth_algs=3
98
99 # Associate as a station to another AP while still acting as an AP on the same
100 # channel.
101 #assoc_ap_addr=00:12:34:56:78:9a
102
103
104 ##### IEEE 802.1X-2004 related configuration ##################################
105
106 # Require IEEE 802.1X authorization
107 #ieee8021x=1
108
109 # IEEE 802.1X/EAPOL version
110 # hostapd is implemented based on IEEE Std 802.1X-2004 which defines EAPOL
111 # version 2. However, there are many client implementations that do not handle
112 # the new version number correctly (they seem to drop the frames completely).
113 # In order to make hostapd interoperate with these clients, the version number
114 # can be set to the older version (1) with this configuration value.
115 #eapol_version=2
116
117 # Optional displayable message sent with EAP Request-Identity. The first \0
118 # in this string will be converted to ASCII-0 (nul). This can be used to
119 # separate network info (comma separated list of attribute=value pairs); see,
120 # e.g., draft-adrangi-eap-network-discovery-07.txt.
121 #eap_message=hello
122 #eap_message=hello\0networkid=netw,nasid=foo,portid=0,NAIRealms=example.com
123
124 # WEP rekeying (disabled if key lengths are not set or are set to 0)
125 # Key lengths for default/broadcast and individual/unicast keys:
126 # 5 = 40-bit WEP (also known as 64-bit WEP with 40 secret bits)
127 # 13 = 104-bit WEP (also known as 128-bit WEP with 104 secret bits)
128 #wep_key_len_broadcast=5
129 #wep_key_len_unicast=5
130 # Rekeying period in seconds. 0 = do not rekey (i.e., set keys only once)
131 #wep_rekey_period=300
132
133 # EAPOL-Key index workaround (set bit7) for WinXP Supplicant (needed only if
134 # only broadcast keys are used)
135 eapol_key_index_workaround=0
136
137 # EAP reauthentication period in seconds (default: 3600 seconds; 0 = disable
138 # reauthentication).
139 #eap_reauth_period=3600
140
141 # Use PAE group address (01:80:c2:00:00:03) instead of individual target
142 # address when sending EAPOL frames with driver=wired. This is the most common
143 # mechanism used in wired authentication, but it also requires that the port
144 # is only used by one station.
145 #use_pae_group_addr=1
146
147 ##### Integrated EAP server ###################################################
148
149 # Optionally, hostapd can be configured to use an integrated EAP server
150 # to process EAP authentication locally without need for an external RADIUS
151 # server. This functionality can be used both as a local authentication server
152 # for IEEE 802.1X/EAPOL and as a RADIUS server for other devices.
153
154 # Use integrated EAP server instead of external RADIUS authentication
155 # server. This is also needed if hostapd is configured to act as a RADIUS
156 # authentication server.
157 eap_server=0
158
159 # Path for EAP server user database
160 #eap_user_file=/etc/hostapd.eap_user
161
162 # CA certificate (PEM or DER file) for EAP-TLS/PEAP/TTLS
163 #ca_cert=/etc/hostapd.ca.pem
164
165 # Server certificate (PEM or DER file) for EAP-TLS/PEAP/TTLS
166 #server_cert=/etc/hostapd.server.pem
167
168 # Private key matching with the server certificate for EAP-TLS/PEAP/TTLS
169 # This may point to the same file as server_cert if both certificate and key
170 # are included in a single file. PKCS#12 (PFX) file (.p12/.pfx) can also be
171 # used by commenting out server_cert and specifying the PFX file as the
172 # private_key.
173 #private_key=/etc/hostapd.server.prv
174
175 # Passphrase for private key
176 #private_key_passwd=secret passphrase
177
178 # Enable CRL verification.
179 # Note: hostapd does not yet support CRL downloading based on CDP. Thus, a
180 # valid CRL signed by the CA is required to be included in the ca_cert file.
181 # This can be done by using PEM format for CA certificate and CRL and
182 # concatenating these into one file. Whenever CRL changes, hostapd needs to be
183 # restarted to take the new CRL into use.
184 # 0 = do not verify CRLs (default)
185 # 1 = check the CRL of the user certificate
186 # 2 = check all CRLs in the certificate path
187 #check_crl=1
188
189 # Configuration data for EAP-SIM database/authentication gateway interface.
190 # This is a text string in implementation specific format. The example
191 # implementation in eap_sim_db.c uses this as the file name for the GSM
192 # authentication triplets.
193 #eap_sim_db=/etc/hostapd.sim_db
194
195
196 ##### IEEE 802.11f - Inter-Access Point Protocol (IAPP) #######################
197
198 # Interface to be used for IAPP broadcast packets
199 #iapp_interface=eth0
200
201
202 ##### RADIUS client configuration #############################################
203 # for IEEE 802.1X with external Authentication Server, IEEE 802.11
204 # authentication with external ACL for MAC addresses, and accounting
205
206 # The own IP address of the access point (used as NAS-IP-Address)
207 own_ip_addr=127.0.0.1
208
209 # Optional NAS-Identifier string for RADIUS messages. When used, this should be
210 # a unique to the NAS within the scope of the RADIUS server. For example, a
211 # fully qualified domain name can be used here.
212 #nas_identifier=ap.example.com
213
214 # RADIUS authentication server
215 #auth_server_addr=127.0.0.1
216 #auth_server_port=1812
217 #auth_server_shared_secret=secret
218
219 # RADIUS accounting server
220 #acct_server_addr=127.0.0.1
221 #acct_server_port=1813
222 #acct_server_shared_secret=secret
223
224 # Secondary RADIUS servers; to be used if primary one does not reply to
225 # RADIUS packets. These are optional and there can be more than one secondary
226 # server listed.
227 #auth_server_addr=127.0.0.2
228 #auth_server_port=1812
229 #auth_server_shared_secret=secret2
230 #
231 #acct_server_addr=127.0.0.2
232 #acct_server_port=1813
233 #acct_server_shared_secret=secret2
234
235 # Retry interval for trying to return to the primary RADIUS server (in
236 # seconds). RADIUS client code will automatically try to use the next server
237 # when the current server is not replying to requests. If this interval is set,
238 # primary server will be retried after configured amount of time even if the
239 # currently used secondary server is still working.
240 #radius_retry_primary_interval=600
241
242
243 # Interim accounting update interval
244 # If this is set (larger than 0) and acct_server is configured, hostapd will
245 # send interim accounting updates every N seconds. Note: if set, this overrides
246 # possible Acct-Interim-Interval attribute in Access-Accept message. Thus, this
247 # value should not be configured in hostapd.conf, if RADIUS server is used to
248 # control the interim interval.
249 # This value should not be less 600 (10 minutes) and must not be less than
250 # 60 (1 minute).
251 #radius_acct_interim_interval=600
252
253
254 ##### RADIUS authentication server configuration ##############################
255
256 # hostapd can be used as a RADIUS authentication server for other hosts. This
257 # requires that the integrated EAP authenticator is also enabled and both
258 # authentication services are sharing the same configuration.
259
260 # File name of the RADIUS clients configuration for the RADIUS server. If this
261 # commented out, RADIUS server is disabled.
262 #radius_server_clients=/etc/hostapd.radius_clients
263
264 # The UDP port number for the RADIUS authentication server
265 #radius_server_auth_port=1812
266
267 # Use IPv6 with RADIUS server (IPv4 will also be supported using IPv6 API)
268 #radius_server_ipv6=1
269
270
271 ##### WPA/IEEE 802.11i configuration ##########################################
272
273 # Enable WPA. Setting this variable configures the AP to require WPA (either
274 # WPA-PSK or WPA-RADIUS/EAP based on other configuration). For WPA-PSK, either
275 # wpa_psk or wpa_passphrase must be set and wpa_key_mgmt must include WPA-PSK.
276 # For WPA-RADIUS/EAP, ieee8021x must be set (but without dynamic WEP keys),
277 # RADIUS authentication server must be configured, and WPA-EAP must be included
278 # in wpa_key_mgmt.
279 # This field is a bit field that can be used to enable WPA (IEEE 802.11i/D3.0)
280 # and/or WPA2 (full IEEE 802.11i/RSN):
281 # bit0 = WPA
282 # bit1 = IEEE 802.11i/RSN (WPA2) (dot11RSNAEnabled)
283 #wpa=1
284
285 # WPA pre-shared keys for WPA-PSK. This can be either entered as a 256-bit
286 # secret in hex format (64 hex digits), wpa_psk, or as an ASCII passphrase
287 # (8..63 characters) that will be converted to PSK. This conversion uses SSID
288 # so the PSK changes when ASCII passphrase is used and the SSID is changed.
289 # wpa_psk (dot11RSNAConfigPSKValue)
290 # wpa_passphrase (dot11RSNAConfigPSKPassPhrase)
291 #wpa_psk=0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef
292 #wpa_passphrase=secret passphrase
293
294 # Optionally, WPA PSKs can be read from a separate text file (containing list
295 # of (PSK,MAC address) pairs. This allows more than one PSK to be configured.
296 # Use absolute path name to make sure that the files can be read on SIGHUP
297 # configuration reloads.
298 #wpa_psk_file=/etc/hostapd.wpa_psk
299
300 # Set of accepted key management algorithms (WPA-PSK, WPA-EAP, or both). The
301 # entries are separated with a space.
302 # (dot11RSNAConfigAuthenticationSuitesTable)
303 #wpa_key_mgmt=WPA-PSK WPA-EAP
304
305 # Set of accepted cipher suites (encryption algorithms) for pairwise keys
306 # (unicast packets). This is a space separated list of algorithms:
307 # CCMP = AES in Counter mode with CBC-MAC [RFC 3610, IEEE 802.11i/D7.0]
308 # TKIP = Temporal Key Integrity Protocol [IEEE 802.11i/D7.0]
309 # Group cipher suite (encryption algorithm for broadcast and multicast frames)
310 # is automatically selected based on this configuration. If only CCMP is
311 # allowed as the pairwise cipher, group cipher will also be CCMP. Otherwise,
312 # TKIP will be used as the group cipher.
313 # (dot11RSNAConfigPairwiseCiphersTable)
314 #wpa_pairwise=TKIP CCMP
315
316 # Time interval for rekeying GTK (broadcast/multicast encryption keys) in
317 # seconds. (dot11RSNAConfigGroupRekeyTime)
318 #wpa_group_rekey=600
319
320 # Rekey GTK when any STA that possesses the current GTK is leaving the BSS.
321 # (dot11RSNAConfigGroupRekeyStrict)
322 #wpa_strict_rekey=1
323
324 # Time interval for rekeying GMK (master key used internally to generate GTKs
325 # (in seconds).
326 #wpa_gmk_rekey=86400
327
328 # Enable IEEE 802.11i/RSN/WPA2 pre-authentication. This is used to speed up
329 # roaming be pre-authenticating IEEE 802.1X/EAP part of the full RSN
330 # authentication and key handshake before actually associating with a new AP.
331 # (dot11RSNAPreauthenticationEnabled)
332 #rsn_preauth=1
333 #
334 # Space separated list of interfaces from which pre-authentication frames are
335 # accepted (e.g., 'eth0' or 'eth0 wlan0wds0'. This list should include all
336 # interface that are used for connections to other APs. This could include
337 # wired interfaces and WDS links. The normal wireless data interface towards
338 # associated stations (e.g., wlan0) should not be added, since
339 # pre-authentication is only used with APs other than the currently associated
340 # one.
341 #rsn_preauth_interfaces=eth0