]> git.ipfire.org Git - thirdparty/hostap.git/blame - src/drivers/driver_bsd.c
projects / thirdparty / hostap.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
Add sanity checks for fseek and ftell return values
[thirdparty/hostap.git] / src / drivers / driver_bsd.c
CommitLineData
6fc6879b
JM		 1/*
2 * WPA Supplicant - driver interaction with BSD net80211 layer
3 * Copyright (c) 2004, Sam Leffler <sam@errno.com>
c5121837 4 * Copyright (c) 2004, 2Wire, Inc
6fc6879b
JM		 5 *
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License version 2 as
8 * published by the Free Software Foundation.
9 *
10 * Alternatively, this software may be distributed under the terms of BSD
11 * license.
12 *
13 * See README and COPYING for more details.
14 */
15
16#include "includes.h"
17#include <sys/ioctl.h>
28878f8b 18#include <sys/sysctl.h>
6fc6879b
JM		 19
20#include "common.h"
21#include "driver.h"
22#include "eloop.h"
90973fb2 23#include "common/ieee802_11_defs.h"
9f2951d2 24#include "common/wpa_common.h"
6fc6879b
JM		 25
26#include <net/if.h>
5197244a 27#include <net/if_media.h>
898d6921
JR		 28
29#ifdef __NetBSD__
30#include <net/if_ether.h>
898d6921 31#else
6fc6879b 32#include <net/ethernet.h>
898d6921 33#endif
131289d8 34#include <net/route.h>
6fc6879b 35
9b336bce
MH		 36#ifdef __DragonFly__
37#include <netproto/802_11/ieee80211_ioctl.h>
38#include <netproto/802_11/ieee80211_dragonfly.h>
39#else /* __DragonFly__ */
09bd6e8c
KM		 40#ifdef __GLIBC__
41#include <netinet/ether.h>
42#endif /* __GLIBC__ */
6fc6879b 43#include <net80211/ieee80211.h>
6fc6879b 44#include <net80211/ieee80211_ioctl.h>
c610dba1 45#include <net80211/ieee80211_crypto.h>
09bd6e8c
KM		 46#endif /* __DragonFly__ || __GLIBC__ */
47#if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
131289d8
MH		 48#include <net80211/ieee80211_freebsd.h>
49#endif
50#if __NetBSD__
51#include <net80211/ieee80211_netbsd.h>
52#endif
53
42f34a9b
MH		 54#include "l2_packet/l2_packet.h"
55
86b24ea9
MH		 56struct bsd_driver_data {
57 struct hostapd_data *hapd; /* back pointer */
58
59 int sock; /* open socket for 802.11 ioctls */
60 struct l2_packet_data *sock_xmit;/* raw packet xmit socket */
61 int route; /* routing socket for events */
62 char ifname[IFNAMSIZ+1]; /* interface name */
63 unsigned int ifindex; /* interface index */
64 void *ctx;
65 struct wpa_driver_capa capa; /* driver capability */
66 int is_ap; /* Access point mode */
67 int prev_roaming; /* roaming state to restore on deinit */
68 int prev_privacy; /* privacy state to restore on deinit */
69 int prev_wpa; /* wpa state to restore on deinit */
70};
71
66d4085f
RM		 72/* Generic functions for hostapd and wpa_supplicant */
73
74static int
0c6bdf91 75bsd_set80211(void *priv, int op, int val, const void *arg, int arg_len)
66d4085f 76{
0c6bdf91 77 struct bsd_driver_data *drv = priv;
66d4085f
RM		 78 struct ieee80211req ireq;
79
80 os_memset(&ireq, 0, sizeof(ireq));
0c6bdf91 81 os_strlcpy(ireq.i_name, drv->ifname, sizeof(ireq.i_name));
66d4085f 82 ireq.i_type = op;
0c6bdf91 83 ireq.i_val = val;
66d4085f 84 ireq.i_data = (void *) arg;
0c6bdf91 85 ireq.i_len = arg_len;
66d4085f 86
0c6bdf91
MH		 87 if (ioctl(drv->sock, SIOCS80211, &ireq) < 0) {
88 wpa_printf(MSG_ERROR, "ioctl[SIOCS80211, op=%u, val=%u, "
89 "arg_len=%u]: %s", op, val, arg_len,
90 strerror(errno));
66d4085f
RM		 91 return -1;
92 }
93 return 0;
94}
95
96static int
0c6bdf91
MH		 97bsd_get80211(void *priv, struct ieee80211req *ireq, int op, void *arg,
98 int arg_len)
66d4085f 99{
0c6bdf91 100 struct bsd_driver_data *drv = priv;
66d4085f 101
0c6bdf91
MH		 102 os_memset(ireq, 0, sizeof(*ireq));
103 os_strlcpy(ireq->i_name, drv->ifname, sizeof(ireq->i_name));
104 ireq->i_type = op;
105 ireq->i_len = arg_len;
106 ireq->i_data = arg;
66d4085f 107
0c6bdf91
MH		 108 if (ioctl(drv->sock, SIOCG80211, ireq) < 0) {
109 wpa_printf(MSG_ERROR, "ioctl[SIOCS80211, op=%u, "
110 "arg_len=%u]: %s", op, arg_len, strerror(errno));
66d4085f
RM		 111 return -1;
112 }
0c6bdf91 113 return 0;
66d4085f
RM		 114}
115
116static int
0c6bdf91 117get80211var(struct bsd_driver_data *drv, int op, void *arg, int arg_len)
66d4085f
RM		 118{
119 struct ieee80211req ireq;
120
0c6bdf91 121 if (bsd_get80211(drv, &ireq, op, arg, arg_len) < 0)
66d4085f 122 return -1;
0c6bdf91 123 return ireq.i_len;
e1b1309b
MH		 124}
125
126static int
127set80211var(struct bsd_driver_data *drv, int op, const void *arg, int arg_len)
66d4085f 128{
0c6bdf91 129 return bsd_set80211(drv, op, 0, arg, arg_len);
e1b1309b
MH		 130}
131
132static int
133set80211param(struct bsd_driver_data *drv, int op, int arg)
134{
0c6bdf91 135 return bsd_set80211(drv, op, arg, NULL, 0);
e1b1309b
MH		 136}
137
138static int
8709de1a 139bsd_get_ssid(void *priv, u8 *ssid, int len)
e1b1309b
MH		 140{
141 struct bsd_driver_data *drv = priv;
66d4085f
RM		 142#ifdef SIOCG80211NWID
143 struct ieee80211_nwid nwid;
144 struct ifreq ifr;
145
146 os_memset(&ifr, 0, sizeof(ifr));
e1b1309b 147 os_strlcpy(ifr.ifr_name, drv->ifname, sizeof(ifr.ifr_name));
66d4085f 148 ifr.ifr_data = (void *)&nwid;
e1b1309b 149 if (ioctl(drv->sock, SIOCG80211NWID, &ifr) < 0 ||
66d4085f
RM		 150 nwid.i_len > IEEE80211_NWID_LEN)
151 return -1;
152 os_memcpy(ssid, nwid.i_nwid, nwid.i_len);
153 return nwid.i_len;
154#else
e1b1309b 155 return get80211var(drv, IEEE80211_IOC_SSID, ssid, IEEE80211_NWID_LEN);
66d4085f
RM		 156#endif
157}
158
159static int
8709de1a 160bsd_set_ssid(void *priv, const u8 *ssid, int ssid_len)
66d4085f 161{
e1b1309b 162 struct bsd_driver_data *drv = priv;
66d4085f
RM		 163#ifdef SIOCS80211NWID
164 struct ieee80211_nwid nwid;
165 struct ifreq ifr;
166
167 os_memcpy(nwid.i_nwid, ssid, ssid_len);
168 nwid.i_len = ssid_len;
169 os_memset(&ifr, 0, sizeof(ifr));
e1b1309b 170 os_strlcpy(ifr.ifr_name, drv->ifname, sizeof(ifr.ifr_name));
66d4085f 171 ifr.ifr_data = (void *)&nwid;
e1b1309b 172 return ioctl(drv->sock, SIOCS80211NWID, &ifr);
66d4085f 173#else
e1b1309b 174 return set80211var(drv, IEEE80211_IOC_SSID, ssid, ssid_len);
66d4085f
RM		 175#endif
176}
177
5197244a 178static int
e1b1309b 179bsd_get_if_media(void *priv)
5197244a 180{
e1b1309b 181 struct bsd_driver_data *drv = priv;
5197244a
MH		 182 struct ifmediareq ifmr;
183
184 os_memset(&ifmr, 0, sizeof(ifmr));
e1b1309b 185 os_strlcpy(ifmr.ifm_name, drv->ifname, sizeof(ifmr.ifm_name));
5197244a 186
e1b1309b 187 if (ioctl(drv->sock, SIOCGIFMEDIA, &ifmr) < 0) {
5197244a
MH		 188 wpa_printf(MSG_ERROR, "%s: SIOCGIFMEDIA %s", __func__,
189 strerror(errno));
190 return -1;
191 }
192
193 return ifmr.ifm_current;
194}
195
196static int
e1b1309b 197bsd_set_if_media(void *priv, int media)
5197244a 198{
e1b1309b 199 struct bsd_driver_data *drv = priv;
5197244a
MH		 200 struct ifreq ifr;
201
202 os_memset(&ifr, 0, sizeof(ifr));
e1b1309b 203 os_strlcpy(ifr.ifr_name, drv->ifname, sizeof(ifr.ifr_name));
5197244a
MH		 204 ifr.ifr_media = media;
205
e1b1309b 206 if (ioctl(drv->sock, SIOCSIFMEDIA, &ifr) < 0) {
5197244a
MH		 207 wpa_printf(MSG_ERROR, "%s: SIOCSIFMEDIA %s", __func__,
208 strerror(errno));
209 return -1;
210 }
211
212 return 0;
213}
214
215static int
e1b1309b 216bsd_set_mediaopt(void *priv, uint32_t mask, uint32_t mode)
5197244a 217{
e1b1309b 218 int media = bsd_get_if_media(priv);
5197244a
MH		 219
220 if (media < 0)
221 return -1;
222 media &= ~mask;
223 media |= mode;
e1b1309b 224 if (bsd_set_if_media(priv, media) < 0)
5197244a
MH		 225 return -1;
226 return 0;
227}
228
cbdecd2b 229static int
e1b1309b 230bsd_del_key(void *priv, const u8 *addr, int key_idx)
cbdecd2b
MH		 231{
232 struct ieee80211req_del_key wk;
233
234 os_memset(&wk, 0, sizeof(wk));
235 if (addr == NULL) {
236 wpa_printf(MSG_DEBUG, "%s: key_idx=%d", __func__, key_idx);
237 wk.idk_keyix = key_idx;
238 } else {
239 wpa_printf(MSG_DEBUG, "%s: addr=" MACSTR, __func__,
240 MAC2STR(addr));
241 os_memcpy(wk.idk_macaddr, addr, IEEE80211_ADDR_LEN);
242 wk.idk_keyix = (u_int8_t) IEEE80211_KEYIX_NONE; /* XXX */
243 }
244
e1b1309b 245 return set80211var(priv, IEEE80211_IOC_DELKEY, &wk, sizeof(wk));
cbdecd2b
MH		 246}
247
fa6b8afe 248static int
e1b1309b 249bsd_send_mlme_param(void *priv, const u8 op, const u16 reason, const u8 *addr)
fa6b8afe
MH		 250{
251 struct ieee80211req_mlme mlme;
252
253 os_memset(&mlme, 0, sizeof(mlme));
254 mlme.im_op = op;
255 mlme.im_reason = reason;
256 os_memcpy(mlme.im_macaddr, addr, IEEE80211_ADDR_LEN);
e1b1309b 257 return set80211var(priv, IEEE80211_IOC_MLME, &mlme, sizeof(mlme));
fa6b8afe
MH		 258}
259
60bc3033 260static int
e1b1309b 261bsd_ctrl_iface(void *priv, int enable)
60bc3033 262{
e1b1309b 263 struct bsd_driver_data *drv = priv;
60bc3033
MH		 264 struct ifreq ifr;
265
266 os_memset(&ifr, 0, sizeof(ifr));
e1b1309b 267 os_strlcpy(ifr.ifr_name, drv->ifname, sizeof(ifr.ifr_name));
60bc3033 268
e1b1309b 269 if (ioctl(drv->sock, SIOCGIFFLAGS, &ifr) < 0) {
60bc3033
MH		 270 perror("ioctl[SIOCGIFFLAGS]");
271 return -1;
272 }
273
274 if (enable)
275 ifr.ifr_flags |= IFF_UP;
276 else
277 ifr.ifr_flags &= ~IFF_UP;
278
e1b1309b 279 if (ioctl(drv->sock, SIOCSIFFLAGS, &ifr) < 0) {
60bc3033
MH		 280 perror("ioctl[SIOCSIFFLAGS]");
281 return -1;
282 }
283
284 return 0;
285}
286
719196b1 287static int
e1b1309b 288bsd_set_key(const char *ifname, void *priv, enum wpa_alg alg,
719196b1
MH		 289 const unsigned char *addr, int key_idx, int set_tx, const u8 *seq,
290 size_t seq_len, const u8 *key, size_t key_len)
291{
292 struct ieee80211req_key wk;
293
294 wpa_printf(MSG_DEBUG, "%s: alg=%d addr=%p key_idx=%d set_tx=%d "
295 "seq_len=%zu key_len=%zu", __func__, alg, addr, key_idx,
296 set_tx, seq_len, key_len);
297
e1b1309b
MH		 298 if (alg == WPA_ALG_NONE) {
299#ifndef HOSTAPD
0382097e 300 if (addr == NULL || is_broadcast_ether_addr(addr))
e1b1309b
MH		 301 return bsd_del_key(priv, NULL, key_idx);
302 else
303#endif /* HOSTAPD */
304 return bsd_del_key(priv, addr, key_idx);
305 }
306
719196b1
MH		 307 os_memset(&wk, 0, sizeof(wk));
308 switch (alg) {
309 case WPA_ALG_WEP:
310 wk.ik_type = IEEE80211_CIPHER_WEP;
311 break;
312 case WPA_ALG_TKIP:
313 wk.ik_type = IEEE80211_CIPHER_TKIP;
314 break;
315 case WPA_ALG_CCMP:
316 wk.ik_type = IEEE80211_CIPHER_AES_CCM;
317 break;
318 default:
319 wpa_printf(MSG_ERROR, "%s: unknown alg=%d", __func__, alg);
320 return -1;
321 }
322
323 wk.ik_flags = IEEE80211_KEY_RECV;
324 if (set_tx)
325 wk.ik_flags |= IEEE80211_KEY_XMIT;
326
327 if (addr == NULL) {
328 os_memset(wk.ik_macaddr, 0xff, IEEE80211_ADDR_LEN);
329 wk.ik_keyix = key_idx;
330 } else {
331 os_memcpy(wk.ik_macaddr, addr, IEEE80211_ADDR_LEN);
332 /*
333 * Deduce whether group/global or unicast key by checking
334 * the address (yech). Note also that we can only mark global
335 * keys default; doing this for a unicast key is an error.
336 */
0382097e 337 if (is_broadcast_ether_addr(addr)) {
719196b1
MH		 338 wk.ik_flags |= IEEE80211_KEY_GROUP;
339 wk.ik_keyix = key_idx;
340 } else {
341 wk.ik_keyix = key_idx == 0 ? IEEE80211_KEYIX_NONE :
342 key_idx;
343 }
344 }
345 if (wk.ik_keyix != IEEE80211_KEYIX_NONE && set_tx)
346 wk.ik_flags |= IEEE80211_KEY_DEFAULT;
347 wk.ik_keylen = key_len;
da64c266
JM		 348 if (seq)
349 os_memcpy(&wk.ik_keyrsc, seq, seq_len);
719196b1
MH		 350 os_memcpy(wk.ik_keydata, key, key_len);
351
e1b1309b 352 return set80211var(priv, IEEE80211_IOC_WPAKEY, &wk, sizeof(wk));
719196b1
MH		 353}
354
c5121837 355static int
e1b1309b 356bsd_configure_wpa(void *priv, struct wpa_bss_params *params)
c5121837 357{
88487b0e 358#ifndef IEEE80211_IOC_APPIE
c5121837
JM		 359 static const char *ciphernames[] =
360 { "WEP", "TKIP", "AES-OCB", "AES-CCM", "CKIP", "NONE" };
c5121837
JM		 361 int v;
362
af586419 363 switch (params->wpa_group) {
c5121837
JM		 364 case WPA_CIPHER_CCMP:
365 v = IEEE80211_CIPHER_AES_CCM;
366 break;
367 case WPA_CIPHER_TKIP:
368 v = IEEE80211_CIPHER_TKIP;
369 break;
370 case WPA_CIPHER_WEP104:
371 v = IEEE80211_CIPHER_WEP;
372 break;
373 case WPA_CIPHER_WEP40:
374 v = IEEE80211_CIPHER_WEP;
375 break;
376 case WPA_CIPHER_NONE:
377 v = IEEE80211_CIPHER_NONE;
378 break;
379 default:
380 printf("Unknown group key cipher %u\n",
af586419 381 params->wpa_group);
c5121837
JM		 382 return -1;
383 }
384 wpa_printf(MSG_DEBUG, "%s: group key cipher=%s (%u)",
385 __func__, ciphernames[v], v);
e1b1309b 386 if (set80211param(priv, IEEE80211_IOC_MCASTCIPHER, v)) {
c5121837
JM		 387 printf("Unable to set group key cipher to %u (%s)\n",
388 v, ciphernames[v]);
389 return -1;
390 }
391 if (v == IEEE80211_CIPHER_WEP) {
392 /* key length is done only for specific ciphers */
af586419 393 v = (params->wpa_group == WPA_CIPHER_WEP104 ? 13 : 5);
e1b1309b 394 if (set80211param(priv, IEEE80211_IOC_MCASTKEYLEN, v)) {
c5121837
JM		 395 printf("Unable to set group key length to %u\n", v);
396 return -1;
397 }
398 }
399
400 v = 0;
af586419 401 if (params->wpa_pairwise & WPA_CIPHER_CCMP)
c5121837 402 v |= 1<<IEEE80211_CIPHER_AES_CCM;
af586419 403 if (params->wpa_pairwise & WPA_CIPHER_TKIP)
c5121837 404 v |= 1<<IEEE80211_CIPHER_TKIP;
af586419 405 if (params->wpa_pairwise & WPA_CIPHER_NONE)
c5121837
JM		 406 v |= 1<<IEEE80211_CIPHER_NONE;
407 wpa_printf(MSG_DEBUG, "%s: pairwise key ciphers=0x%x", __func__, v);
e1b1309b 408 if (set80211param(priv, IEEE80211_IOC_UCASTCIPHERS, v)) {
c5121837
JM		 409 printf("Unable to set pairwise key ciphers to 0x%x\n", v);
410 return -1;
411 }
412
413 wpa_printf(MSG_DEBUG, "%s: key management algorithms=0x%x",
af586419 414 __func__, params->wpa_key_mgmt);
e1b1309b
MH		 415 if (set80211param(priv, IEEE80211_IOC_KEYMGTALGS,
416 params->wpa_key_mgmt)) {
c5121837 417 printf("Unable to set key management algorithms to 0x%x\n",
af586419 418 params->wpa_key_mgmt);
c5121837
JM		 419 return -1;
420 }
421
422 v = 0;
af586419 423 if (params->rsn_preauth)
c5121837
JM		 424 v |= BIT(0);
425 wpa_printf(MSG_DEBUG, "%s: rsn capabilities=0x%x",
af586419 426 __func__, params->rsn_preauth);
e1b1309b 427 if (set80211param(priv, IEEE80211_IOC_RSNCAPS, v)) {
c5121837
JM		 428 printf("Unable to set RSN capabilities to 0x%x\n", v);
429 return -1;
430 }
88487b0e 431#endif /* IEEE80211_IOC_APPIE */
c5121837 432
af586419 433 wpa_printf(MSG_DEBUG, "%s: enable WPA= 0x%x", __func__, params->wpa);
e1b1309b 434 if (set80211param(priv, IEEE80211_IOC_WPA, params->wpa)) {
af586419 435 printf("Unable to set WPA to %u\n", params->wpa);
c5121837
JM		 436 return -1;
437 }
438 return 0;
439}
440
c5121837 441static int
e1b1309b 442bsd_set_ieee8021x(void *priv, struct wpa_bss_params *params)
c5121837 443{
af586419 444 wpa_printf(MSG_DEBUG, "%s: enabled=%d", __func__, params->enabled);
c5121837 445
af586419 446 if (!params->enabled) {
c5121837 447 /* XXX restore state */
e1b1309b
MH		 448 return set80211param(priv, IEEE80211_IOC_AUTHMODE,
449 IEEE80211_AUTH_AUTO);
c5121837 450 }
af586419 451 if (!params->wpa && !params->ieee802_1x) {
42f34a9b
MH		 452 wpa_printf(MSG_ERROR, "%s: No 802.1X or WPA enabled",
453 __func__);
c5121837
JM		 454 return -1;
455 }
e1b1309b 456 if (params->wpa && bsd_configure_wpa(priv, params) != 0) {
42f34a9b
MH		 457 wpa_printf(MSG_ERROR, "%s: Failed to configure WPA state",
458 __func__);
c5121837
JM		 459 return -1;
460 }
e1b1309b 461 if (set80211param(priv, IEEE80211_IOC_AUTHMODE,
af586419 462 (params->wpa ? IEEE80211_AUTH_WPA : IEEE80211_AUTH_8021X))) {
42f34a9b
MH		 463 wpa_printf(MSG_ERROR, "%s: Failed to enable WPA/802.1X",
464 __func__);
c5121837
JM		 465 return -1;
466 }
e1b1309b 467 return bsd_ctrl_iface(priv, 1);
c5121837
JM		 468}
469
470static int
3234cba4 471bsd_set_sta_authorized(void *priv, const u8 *addr,
4c32757d 472 int total_flags, int flags_or, int flags_and)
c5121837 473{
42f34a9b 474 int authorized = -1;
c5121837 475
42f34a9b
MH		 476 /* For now, only support setting Authorized flag */
477 if (flags_or & WPA_STA_AUTHORIZED)
478 authorized = 1;
479 if (!(flags_and & WPA_STA_AUTHORIZED))
480 authorized = 0;
c5121837 481
42f34a9b
MH		 482 if (authorized < 0)
483 return 0;
484
e1b1309b 485 return bsd_send_mlme_param(priv, authorized ?
42f34a9b
MH		 486 IEEE80211_MLME_AUTHORIZE :
487 IEEE80211_MLME_UNAUTHORIZE, 0, addr);
488}
489
490static void
e1b1309b 491bsd_new_sta(void *priv, void *ctx, u8 addr[IEEE80211_ADDR_LEN])
42f34a9b
MH		 492{
493 struct ieee80211req_wpaie ie;
494 int ielen = 0;
495 u8 *iebuf = NULL;
496
497 /*
498 * Fetch and validate any negotiated WPA/RSN parameters.
499 */
500 memset(&ie, 0, sizeof(ie));
501 memcpy(ie.wpa_macaddr, addr, IEEE80211_ADDR_LEN);
e1b1309b 502 if (get80211var(priv, IEEE80211_IOC_WPAIE, &ie, sizeof(ie)) < 0) {
42f34a9b
MH		 503 printf("Failed to get WPA/RSN information element.\n");
504 goto no_ie;
505 }
506 iebuf = ie.wpa_ie;
507 ielen = ie.wpa_ie[1];
508 if (ielen == 0)
509 iebuf = NULL;
510 else
511 ielen += 2;
512
513no_ie:
39b08b5f 514 drv_event_assoc(ctx, addr, iebuf, ielen, 0);
42f34a9b
MH		 515}
516
517static int
e1b1309b 518bsd_send_eapol(void *priv, const u8 *addr, const u8 *data, size_t data_len,
4378fc14 519 int encrypt, const u8 *own_addr, u32 flags)
42f34a9b 520{
e1b1309b
MH		 521 struct bsd_driver_data *drv = priv;
522
42f34a9b
MH		 523 wpa_hexdump(MSG_MSGDUMP, "TX EAPOL", data, data_len);
524
e1b1309b
MH		 525 return l2_packet_send(drv->sock_xmit, addr, ETH_P_EAPOL, data,
526 data_len);
c5121837
JM		 527}
528
529static int
6db1602d 530bsd_set_freq(void *priv, struct hostapd_freq_params *freq)
42f34a9b 531{
e1b1309b 532 struct bsd_driver_data *drv = priv;
aba7569e 533#ifdef SIOCS80211CHANNEL
42f34a9b 534 struct ieee80211chanreq creq;
362468d1 535#endif /* SIOCS80211CHANNEL */
42f34a9b 536 u32 mode;
6db1602d 537 int channel = freq->channel;
42f34a9b
MH		 538
539 if (channel < 14)
540 mode = IFM_IEEE80211_11G;
541 else if (channel == 14)
542 mode = IFM_IEEE80211_11B;
543 else
544 mode = IFM_IEEE80211_11A;
e1b1309b 545 if (bsd_set_mediaopt(drv, IFM_MMASK, mode) < 0) {
42f34a9b
MH		 546 wpa_printf(MSG_ERROR, "%s: failed to set modulation mode",
547 __func__);
548 return -1;
549 }
550
362468d1 551#ifdef SIOCS80211CHANNEL
42f34a9b 552 os_memset(&creq, 0, sizeof(creq));
e1b1309b 553 os_strlcpy(creq.i_name, drv->ifname, sizeof(creq.i_name));
6db1602d 554 creq.i_channel = (u_int16_t)channel;
e1b1309b 555 return ioctl(drv->sock, SIOCS80211CHANNEL, &creq);
362468d1
MH		 556#else /* SIOCS80211CHANNEL */
557 return set80211param(priv, IEEE80211_IOC_CHANNEL, channel);
558#endif /* SIOCS80211CHANNEL */
42f34a9b
MH		 559}
560
88487b0e 561static int
aa484516 562bsd_set_opt_ie(void *priv, const u8 *ie, size_t ie_len)
88487b0e
MH		 563{
564#ifdef IEEE80211_IOC_APPIE
88487b0e
MH		 565 wpa_printf(MSG_DEBUG, "%s: set WPA+RSN ie (len %lu)", __func__,
566 (unsigned long)ie_len);
0c6bdf91
MH		 567 return bsd_set80211(priv, IEEE80211_IOC_APPIE, IEEE80211_APPIE_WPA,
568 ie, ie_len);
88487b0e
MH		 569#endif /* IEEE80211_IOC_APPIE */
570 return 0;
571}
572
28878f8b
MH		 573static int
574rtbuf_len(void)
575{
576 size_t len;
577
d4a747f0 578 int mib[6] = {CTL_NET, AF_ROUTE, 0, AF_INET, NET_RT_DUMP, 0};
28878f8b
MH		 579
580 if (sysctl(mib, 6, NULL, &len, NULL, 0) < 0) {
d4a747f0 581 wpa_printf(MSG_WARNING, "%s failed: %s\n", __func__,
28878f8b 582 strerror(errno));
d4a747f0 583 len = 2048;
28878f8b
MH		 584 }
585
586 return len;
587}
42f34a9b
MH		 588
589#ifdef HOSTAPD
590
591/*
592 * Avoid conflicts with hostapd definitions by undefining couple of defines
593 * from net80211 header files.
594 */
595#undef RSN_VERSION
596#undef WPA_VERSION
597#undef WPA_OUI_TYPE
598
42f34a9b
MH		 599static int bsd_sta_deauth(void *priv, const u8 *own_addr, const u8 *addr,
600 int reason_code);
601
42f34a9b
MH		 602static const char *
603ether_sprintf(const u8 *addr)
604{
605 static char buf[sizeof(MACSTR)];
606
607 if (addr != NULL)
608 snprintf(buf, sizeof(buf), MACSTR, MAC2STR(addr));
609 else
610 snprintf(buf, sizeof(buf), MACSTR, 0,0,0,0,0,0);
611 return buf;
612}
613
42f34a9b 614static int
d5dd016a 615bsd_set_privacy(void *priv, int enabled)
c5121837 616{
42f34a9b
MH		 617 wpa_printf(MSG_DEBUG, "%s: enabled=%d", __func__, enabled);
618
e1b1309b 619 return set80211param(priv, IEEE80211_IOC_PRIVACY, enabled);
c5121837
JM		 620}
621
c5121837
JM		 622static int
623bsd_get_seqnum(const char *ifname, void *priv, const u8 *addr, int idx,
624 u8 *seq)
625{
c5121837
JM		 626 struct ieee80211req_key wk;
627
628 wpa_printf(MSG_DEBUG, "%s: addr=%s idx=%d",
629 __func__, ether_sprintf(addr), idx);
630
631 memset(&wk, 0, sizeof(wk));
632 if (addr == NULL)
633 memset(wk.ik_macaddr, 0xff, IEEE80211_ADDR_LEN);
634 else
635 memcpy(wk.ik_macaddr, addr, IEEE80211_ADDR_LEN);
636 wk.ik_keyix = idx;
637
e1b1309b 638 if (get80211var(priv, IEEE80211_IOC_WPAKEY, &wk, sizeof(wk)) < 0) {
c5121837
JM		 639 printf("Failed to get encryption.\n");
640 return -1;
641 }
642
643#ifdef WORDS_BIGENDIAN
644 {
645 /*
646 * wk.ik_keytsc is in host byte order (big endian), need to
647 * swap it to match with the byte order used in WPA.
648 */
649 int i;
650 u8 tmp[WPA_KEY_RSC_LEN];
651 memcpy(tmp, &wk.ik_keytsc, sizeof(wk.ik_keytsc));
652 for (i = 0; i < WPA_KEY_RSC_LEN; i++) {
653 seq[i] = tmp[WPA_KEY_RSC_LEN - i - 1];
654 }
655 }
656#else /* WORDS_BIGENDIAN */
657 memcpy(seq, &wk.ik_keytsc, sizeof(wk.ik_keytsc));
658#endif /* WORDS_BIGENDIAN */
659 return 0;
660}
661
662
663static int
664bsd_flush(void *priv)
665{
666 u8 allsta[IEEE80211_ADDR_LEN];
667
668 memset(allsta, 0xff, IEEE80211_ADDR_LEN);
731723a5 669 return bsd_sta_deauth(priv, NULL, allsta, IEEE80211_REASON_AUTH_LEAVE);
c5121837
JM		 670}
671
672
673static int
674bsd_read_sta_driver_data(void *priv, struct hostap_sta_driver_data *data,
675 const u8 *addr)
676{
c5121837
JM		 677 struct ieee80211req_sta_stats stats;
678
679 memcpy(stats.is_u.macaddr, addr, IEEE80211_ADDR_LEN);
e1b1309b
MH		 680 if (get80211var(priv, IEEE80211_IOC_STA_STATS, &stats, sizeof(stats))
681 > 0) {
c5121837
JM		 682 /* XXX? do packets counts include non-data frames? */
683 data->rx_packets = stats.is_stats.ns_rx_data;
684 data->rx_bytes = stats.is_stats.ns_rx_bytes;
685 data->tx_packets = stats.is_stats.ns_tx_data;
686 data->tx_bytes = stats.is_stats.ns_tx_bytes;
687 }
688 return 0;
689}
690
c5121837 691static int
731723a5 692bsd_sta_deauth(void *priv, const u8 *own_addr, const u8 *addr, int reason_code)
c5121837 693{
e1b1309b
MH		 694 return bsd_send_mlme_param(priv, IEEE80211_MLME_DEAUTH, reason_code,
695 addr);
c5121837
JM		 696}
697
698static int
731723a5
JM		 699bsd_sta_disassoc(void *priv, const u8 *own_addr, const u8 *addr,
700 int reason_code)
c5121837 701{
e1b1309b
MH		 702 return bsd_send_mlme_param(priv, IEEE80211_MLME_DISASSOC, reason_code,
703 addr);
c5121837
JM		 704}
705
c5121837
JM		 706static void
707bsd_wireless_event_receive(int sock, void *ctx, void *sock_ctx)
708{
709 struct bsd_driver_data *drv = ctx;
28878f8b 710 char *buf;
c5121837
JM		 711 struct if_announcemsghdr *ifan;
712 struct rt_msghdr *rtm;
713 struct ieee80211_michael_event *mic;
714 struct ieee80211_join_event *join;
715 struct ieee80211_leave_event *leave;
28878f8b 716 int n, len;
1cd973d5 717 union wpa_event_data data;
c5121837 718
28878f8b 719 len = rtbuf_len();
28878f8b
MH		 720
721 buf = os_malloc(len);
722 if (buf == NULL) {
723 wpa_printf(MSG_ERROR, "%s os_malloc() failed\n", __func__);
724 return;
725 }
726
727 n = read(sock, buf, len);
c5121837
JM		 728 if (n < 0) {
729 if (errno != EINTR && errno != EAGAIN)
28878f8b
MH		 730 wpa_printf(MSG_ERROR, "%s read() failed: %s\n",
731 __func__, strerror(errno));
732 os_free(buf);
c5121837
JM		 733 return;
734 }
735
736 rtm = (struct rt_msghdr *) buf;
737 if (rtm->rtm_version != RTM_VERSION) {
28878f8b
MH		 738 wpa_printf(MSG_DEBUG, "Invalid routing message version=%d",
739 rtm->rtm_version);
740 os_free(buf);
c5121837
JM		 741 return;
742 }
743 ifan = (struct if_announcemsghdr *) rtm;
744 switch (rtm->rtm_type) {
745 case RTM_IEEE80211:
746 switch (ifan->ifan_what) {
747 case RTM_IEEE80211_ASSOC:
748 case RTM_IEEE80211_REASSOC:
749 case RTM_IEEE80211_DISASSOC:
750 case RTM_IEEE80211_SCAN:
751 break;
752 case RTM_IEEE80211_LEAVE:
753 leave = (struct ieee80211_leave_event *) &ifan[1];
69378b79 754 drv_event_disassoc(drv->hapd, leave->iev_addr);
c5121837
JM		 755 break;
756 case RTM_IEEE80211_JOIN:
757#ifdef RTM_IEEE80211_REJOIN
758 case RTM_IEEE80211_REJOIN:
759#endif
760 join = (struct ieee80211_join_event *) &ifan[1];
e1b1309b 761 bsd_new_sta(drv, drv->hapd, join->iev_addr);
c5121837
JM		 762 break;
763 case RTM_IEEE80211_REPLAY:
764 /* ignore */
765 break;
766 case RTM_IEEE80211_MICHAEL:
767 mic = (struct ieee80211_michael_event *) &ifan[1];
768 wpa_printf(MSG_DEBUG,
769 "Michael MIC failure wireless event: "
770 "keyix=%u src_addr=" MACSTR, mic->iev_keyix,
771 MAC2STR(mic->iev_src));
1cd973d5
JM		 772 os_memset(&data, 0, sizeof(data));
773 data.michael_mic_failure.unicast = 1;
774 data.michael_mic_failure.src = mic->iev_src;
775 wpa_supplicant_event(drv->hapd,
776 EVENT_MICHAEL_MIC_FAILURE, &data);
c5121837
JM		 777 break;
778 }
779 break;
780 }
28878f8b 781 os_free(buf);
c5121837
JM		 782}
783
c5121837
JM		 784static void
785handle_read(void *ctx, const u8 *src_addr, const u8 *buf, size_t len)
786{
787 struct bsd_driver_data *drv = ctx;
d3737256 788 drv_event_eapol_rx(drv->hapd, src_addr, buf, len);
c5121837
JM		 789}
790
c5121837 791static void *
92f475b4 792bsd_init(struct hostapd_data *hapd, struct wpa_init_params *params)
c5121837
JM		 793{
794 struct bsd_driver_data *drv;
795
796 drv = os_zalloc(sizeof(struct bsd_driver_data));
797 if (drv == NULL) {
798 printf("Could not allocate memory for bsd driver data\n");
799 goto bad;
800 }
801
802 drv->hapd = hapd;
6850c707
MH		 803 drv->sock = socket(PF_INET, SOCK_DGRAM, 0);
804 if (drv->sock < 0) {
c5121837
JM		 805 perror("socket[PF_INET,SOCK_DGRAM]");
806 goto bad;
807 }
6850c707 808 os_strlcpy(drv->ifname, params->ifname, sizeof(drv->ifname));
c5121837 809
6850c707 810 drv->sock_xmit = l2_packet_init(drv->ifname, NULL, ETH_P_EAPOL,
d3737256 811 handle_read, drv, 0);
c5121837
JM		 812 if (drv->sock_xmit == NULL)
813 goto bad;
412036f5 814 if (l2_packet_get_own_addr(drv->sock_xmit, params->own_addr))
c5121837
JM		 815 goto bad;
816
60bc3033 817 /* mark down during setup */
e1b1309b 818 if (bsd_ctrl_iface(drv, 0) < 0)
60bc3033 819 goto bad;
6850c707
MH		 820
821 drv->route = socket(PF_ROUTE, SOCK_RAW, 0);
822 if (drv->route < 0) {
823 perror("socket(PF_ROUTE,SOCK_RAW)");
c5121837 824 goto bad;
6850c707
MH		 825 }
826 eloop_register_read_sock(drv->route, bsd_wireless_event_receive, drv,
827 NULL);
c5121837 828
e1b1309b 829 if (bsd_set_mediaopt(drv, IFM_OMASK, IFM_IEEE80211_HOSTAP) < 0) {
5197244a
MH		 830 wpa_printf(MSG_ERROR, "%s: failed to set operation mode",
831 __func__);
832 goto bad;
833 }
834
c5121837
JM		 835 return drv;
836bad:
837 if (drv->sock_xmit != NULL)
838 l2_packet_deinit(drv->sock_xmit);
6850c707
MH		 839 if (drv->sock >= 0)
840 close(drv->sock);
c5121837 841 if (drv != NULL)
82f36163 842 os_free(drv);
c5121837
JM		 843 return NULL;
844}
845
846
847static void
848bsd_deinit(void *priv)
849{
850 struct bsd_driver_data *drv = priv;
851
6850c707
MH		 852 if (drv->route >= 0) {
853 eloop_unregister_read_sock(drv->route);
854 close(drv->route);
855 }
e1b1309b 856 bsd_ctrl_iface(drv, 0);
6850c707
MH		 857 if (drv->sock >= 0)
858 close(drv->sock);
c5121837
JM		 859 if (drv->sock_xmit != NULL)
860 l2_packet_deinit(drv->sock_xmit);
82f36163 861 os_free(drv);
c5121837
JM		 862}
863
c5121837
JM		 864#else /* HOSTAPD */
865
6fc6879b 866static int
86b24ea9 867get80211param(struct bsd_driver_data *drv, int op)
6fc6879b
JM		 868{
869 struct ieee80211req ireq;
870
0c6bdf91 871 if (bsd_get80211(drv, &ireq, op, NULL, 0) < 0)
6fc6879b 872 return -1;
6fc6879b
JM		 873 return ireq.i_val;
874}
875
6fc6879b
JM		 876static int
877wpa_driver_bsd_get_bssid(void *priv, u8 *bssid)
878{
86b24ea9 879 struct bsd_driver_data *drv = priv;
66d4085f 880#ifdef SIOCG80211BSSID
a65f4a57 881 struct ieee80211_bssid bs;
6fc6879b 882
e1b1309b 883 os_strlcpy(bs.i_name, drv->ifname, sizeof(bs.i_name));
a65f4a57
MH		 884 if (ioctl(drv->sock, SIOCG80211BSSID, &bs) < 0)
885 return -1;
886 os_memcpy(bssid, bs.i_bssid, sizeof(bs.i_bssid));
887 return 0;
888#else
6fc6879b
JM		 889 return get80211var(drv, IEEE80211_IOC_BSSID,
890 bssid, IEEE80211_ADDR_LEN) < 0 ? -1 : 0;
a65f4a57 891#endif
6fc6879b
JM		 892}
893
6fc6879b
JM		 894static int
895wpa_driver_bsd_get_ssid(void *priv, u8 *ssid)
896{
86b24ea9 897 struct bsd_driver_data *drv = priv;
c1bbb0ce 898 return bsd_get_ssid(drv, ssid, 0);
6fc6879b
JM		 899}
900
901static int
86b24ea9
MH		 902wpa_driver_bsd_set_wpa_ie(struct bsd_driver_data *drv, const u8 *wpa_ie,
903 size_t wpa_ie_len)
6fc6879b 904{
c610dba1 905#ifdef IEEE80211_IOC_APPIE
aa484516 906 return bsd_set_opt_ie(drv, wpa_ie, wpa_ie_len);
c610dba1 907#else /* IEEE80211_IOC_APPIE */
6fc6879b 908 return set80211var(drv, IEEE80211_IOC_OPTIE, wpa_ie, wpa_ie_len);
c610dba1 909#endif /* IEEE80211_IOC_APPIE */
6fc6879b
JM		 910}
911
912static int
913wpa_driver_bsd_set_wpa_internal(void *priv, int wpa, int privacy)
914{
6fc6879b
JM		 915 int ret = 0;
916
917 wpa_printf(MSG_DEBUG, "%s: wpa=%d privacy=%d",
918 __FUNCTION__, wpa, privacy);
919
e1b1309b 920 if (!wpa && wpa_driver_bsd_set_wpa_ie(priv, NULL, 0) < 0)
6fc6879b 921 ret = -1;
e1b1309b 922 if (set80211param(priv, IEEE80211_IOC_PRIVACY, privacy) < 0)
6fc6879b 923 ret = -1;
e1b1309b 924 if (set80211param(priv, IEEE80211_IOC_WPA, wpa) < 0)
6fc6879b
JM		 925 ret = -1;
926
927 return ret;
928}
929
930static int
931wpa_driver_bsd_set_wpa(void *priv, int enabled)
932{
933 wpa_printf(MSG_DEBUG, "%s: enabled=%d", __FUNCTION__, enabled);
934
935 return wpa_driver_bsd_set_wpa_internal(priv, enabled ? 3 : 0, enabled);
936}
937
6fc6879b
JM		 938static int
939wpa_driver_bsd_set_countermeasures(void *priv, int enabled)
940{
6fc6879b 941 wpa_printf(MSG_DEBUG, "%s: enabled=%d", __func__, enabled);
e1b1309b 942 return set80211param(priv, IEEE80211_IOC_COUNTERMEASURES, enabled);
6fc6879b
JM		 943}
944
945
946static int
947wpa_driver_bsd_set_drop_unencrypted(void *priv, int enabled)
948{
6fc6879b 949 wpa_printf(MSG_DEBUG, "%s: enabled=%d", __func__, enabled);
e1b1309b 950 return set80211param(priv, IEEE80211_IOC_DROPUNENCRYPTED, enabled);
6fc6879b
JM		 951}
952
953static int
954wpa_driver_bsd_deauthenticate(void *priv, const u8 *addr, int reason_code)
955{
e1b1309b
MH		 956 return bsd_send_mlme_param(priv, IEEE80211_MLME_DEAUTH, reason_code,
957 addr);
6fc6879b
JM		 958}
959
960static int
961wpa_driver_bsd_disassociate(void *priv, const u8 *addr, int reason_code)
962{
e1b1309b
MH		 963 return bsd_send_mlme_param(priv, IEEE80211_MLME_DISASSOC, reason_code,
964 addr);
6fc6879b
JM		 965}
966
2a91091e
MH		 967static int
968wpa_driver_bsd_set_auth_alg(void *priv, int auth_alg)
969{
2a91091e
MH		 970 int authmode;
971
abd9fafa
JM		 972 if ((auth_alg & WPA_AUTH_ALG_OPEN) &&
973 (auth_alg & WPA_AUTH_ALG_SHARED))
2a91091e 974 authmode = IEEE80211_AUTH_AUTO;
abd9fafa 975 else if (auth_alg & WPA_AUTH_ALG_SHARED)
2a91091e
MH		 976 authmode = IEEE80211_AUTH_SHARED;
977 else
978 authmode = IEEE80211_AUTH_OPEN;
979
e1b1309b 980 return set80211param(priv, IEEE80211_IOC_AUTHMODE, authmode);
2a91091e
MH		 981}
982
42f34a9b
MH		 983static void
984handle_read(void *ctx, const u8 *src_addr, const u8 *buf, size_t len)
985{
86b24ea9 986 struct bsd_driver_data *drv = ctx;
42f34a9b
MH		 987
988 drv_event_eapol_rx(drv->ctx, src_addr, buf, len);
989}
990
6fc6879b
JM		 991static int
992wpa_driver_bsd_associate(void *priv, struct wpa_driver_associate_params *params)
993{
86b24ea9 994 struct bsd_driver_data *drv = priv;
6fc6879b 995 struct ieee80211req_mlme mlme;
42f34a9b 996 u32 mode;
6fc6879b 997 int privacy;
4a867032 998 int ret = 0;
6fc6879b
JM		 999
1000 wpa_printf(MSG_DEBUG,
1001 "%s: ssid '%.*s' wpa ie len %u pairwise %u group %u key mgmt %u"
1002 , __func__
92e63aaf
JM		 1003 , (unsigned int) params->ssid_len, params->ssid
1004 , (unsigned int) params->wpa_ie_len
6fc6879b
JM		 1005 , params->pairwise_suite
1006 , params->group_suite
1007 , params->key_mgmt_suite
1008 );
1009
42f34a9b
MH		 1010 switch (params->mode) {
1011 case IEEE80211_MODE_INFRA:
1012 mode = 0 /* STA */;
1013 break;
1014 case IEEE80211_MODE_IBSS:
1015 mode = IFM_IEEE80211_IBSS;
1016 break;
1017 case IEEE80211_MODE_AP:
1018 mode = IFM_IEEE80211_HOSTAP;
1019 break;
1020 default:
1021 wpa_printf(MSG_ERROR, "%s: unknown operation mode", __func__);
1022 return -1;
1023 }
e1b1309b 1024 if (bsd_set_mediaopt(drv, IFM_OMASK, mode) < 0) {
42f34a9b
MH		 1025 wpa_printf(MSG_ERROR, "%s: failed to set operation mode",
1026 __func__);
1027 return -1;
1028 }
1029
1030 if (params->mode == IEEE80211_MODE_AP) {
42f34a9b
MH		 1031 drv->sock_xmit = l2_packet_init(drv->ifname, NULL, ETH_P_EAPOL,
1032 handle_read, drv, 0);
1033 if (drv->sock_xmit == NULL)
1034 return -1;
1035 drv->is_ap = 1;
1036 return 0;
1037 }
1038
4a867032
JM		 1039 if (wpa_driver_bsd_set_drop_unencrypted(drv, params->drop_unencrypted)
1040 < 0)
1041 ret = -1;
1042 if (wpa_driver_bsd_set_auth_alg(drv, params->auth_alg) < 0)
1043 ret = -1;
6fc6879b
JM		 1044 /* XXX error handling is wrong but unclear what to do... */
1045 if (wpa_driver_bsd_set_wpa_ie(drv, params->wpa_ie, params->wpa_ie_len) < 0)
1046 return -1;
6fc6879b
JM		 1047
1048 privacy = !(params->pairwise_suite == CIPHER_NONE &&
1049 params->group_suite == CIPHER_NONE &&
1050 params->key_mgmt_suite == KEY_MGMT_NONE &&
1051 params->wpa_ie_len == 0);
1052 wpa_printf(MSG_DEBUG, "%s: set PRIVACY %u", __func__, privacy);
1053
1054 if (set80211param(drv, IEEE80211_IOC_PRIVACY, privacy) < 0)
1055 return -1;
1056
1057 if (params->wpa_ie_len &&
1058 set80211param(drv, IEEE80211_IOC_WPA,
1059 params->wpa_ie[0] == WLAN_EID_RSN ? 2 : 1) < 0)
1060 return -1;
1061
1062 os_memset(&mlme, 0, sizeof(mlme));
1063 mlme.im_op = IEEE80211_MLME_ASSOC;
6fc6879b
JM		 1064 if (params->ssid != NULL)
1065 os_memcpy(mlme.im_ssid, params->ssid, params->ssid_len);
1066 mlme.im_ssid_len = params->ssid_len;
6fc6879b
JM		 1067 if (params->bssid != NULL)
1068 os_memcpy(mlme.im_macaddr, params->bssid, IEEE80211_ADDR_LEN);
1069 if (set80211var(drv, IEEE80211_IOC_MLME, &mlme, sizeof(mlme)) < 0)
1070 return -1;
4a867032 1071 return ret;
6fc6879b
JM		 1072}
1073
6fc6879b 1074static int
c2e8d0a0 1075wpa_driver_bsd_scan(void *priv, struct wpa_driver_scan_params *params)
6fc6879b 1076{
86b24ea9 1077 struct bsd_driver_data *drv = priv;
88487b0e
MH		 1078#ifdef IEEE80211_IOC_SCAN_MAX_SSID
1079 struct ieee80211_scan_req sr;
1080 int i;
1081#endif /* IEEE80211_IOC_SCAN_MAX_SSID */
1082
1083 if (bsd_set_mediaopt(drv, IFM_OMASK, 0 /* STA */) < 0) {
1084 wpa_printf(MSG_ERROR, "%s: failed to set operation mode",
1085 __func__);
1086 return -1;
1087 }
6fc6879b 1088
42f34a9b
MH		 1089 if (set80211param(drv, IEEE80211_IOC_ROAMING,
1090 IEEE80211_ROAMING_MANUAL) < 0) {
1091 wpa_printf(MSG_ERROR, "%s: failed to set "
1092 "wpa_supplicant-based roaming: %s", __func__,
1093 strerror(errno));
1094 return -1;
1095 }
1096
1097 if (wpa_driver_bsd_set_wpa(drv, 1) < 0) {
1098 wpa_printf(MSG_ERROR, "%s: failed to set wpa: %s", __func__,
1099 strerror(errno));
1100 return -1;
1101 }
1102
6fc6879b 1103 /* NB: interface must be marked UP to do a scan */
e1b1309b 1104 if (bsd_ctrl_iface(drv, 1) < 0)
6fc6879b
JM		 1105 return -1;
1106
88487b0e
MH		 1107#ifdef IEEE80211_IOC_SCAN_MAX_SSID
1108 os_memset(&sr, 0, sizeof(sr));
1109 sr.sr_flags = IEEE80211_IOC_SCAN_ACTIVE | IEEE80211_IOC_SCAN_ONCE |
1110 IEEE80211_IOC_SCAN_NOJOIN;
1111 sr.sr_duration = IEEE80211_IOC_SCAN_FOREVER;
1112 if (params->num_ssids > 0) {
1113 sr.sr_nssid = params->num_ssids;
1114#if 0
1115 /* Boundary check is done by upper layer */
1116 if (sr.sr_nssid > IEEE80211_IOC_SCAN_MAX_SSID)
1117 sr.sr_nssid = IEEE80211_IOC_SCAN_MAX_SSID;
1118#endif
1119
1120 /* NB: check scan cache first */
1121 sr.sr_flags |= IEEE80211_IOC_SCAN_CHECK;
1122 }
1123 for (i = 0; i < sr.sr_nssid; i++) {
1124 sr.sr_ssid[i].len = params->ssids[i].ssid_len;
1125 os_memcpy(sr.sr_ssid[i].ssid, params->ssids[i].ssid,
1126 sr.sr_ssid[i].len);
1127 }
1128
1129 /* NB: net80211 delivers a scan complete event so no need to poll */
1130 return set80211var(drv, IEEE80211_IOC_SCAN_REQ, &sr, sizeof(sr));
1131#else /* IEEE80211_IOC_SCAN_MAX_SSID */
6fc6879b 1132 /* set desired ssid before scan */
c1bbb0ce 1133 if (bsd_set_ssid(drv, params->ssids[0].ssid,
88487b0e 1134 params->ssids[0].ssid_len) < 0)
6fc6879b
JM		 1135 return -1;
1136
1137 /* NB: net80211 delivers a scan complete event so no need to poll */
1138 return set80211param(drv, IEEE80211_IOC_SCAN_REQ, 0);
88487b0e 1139#endif /* IEEE80211_IOC_SCAN_MAX_SSID */
6fc6879b
JM		 1140}
1141
6fc6879b
JM		 1142static void
1143wpa_driver_bsd_event_receive(int sock, void *ctx, void *sock_ctx)
1144{
86b24ea9 1145 struct bsd_driver_data *drv = sock_ctx;
28878f8b 1146 char *buf;
6fc6879b
JM		 1147 struct if_announcemsghdr *ifan;
1148 struct if_msghdr *ifm;
1149 struct rt_msghdr *rtm;
1150 union wpa_event_data event;
1151 struct ieee80211_michael_event *mic;
42f34a9b
MH		 1152 struct ieee80211_leave_event *leave;
1153 struct ieee80211_join_event *join;
28878f8b
MH		 1154 int n, len;
1155
1156 len = rtbuf_len();
28878f8b
MH		 1157
1158 buf = os_malloc(len);
1159 if (buf == NULL) {
1160 wpa_printf(MSG_ERROR, "%s os_malloc() failed\n", __func__);
1161 return;
1162 }
6fc6879b 1163
28878f8b 1164 n = read(sock, buf, len);
6fc6879b
JM		 1165 if (n < 0) {
1166 if (errno != EINTR && errno != EAGAIN)
28878f8b
MH		 1167 wpa_printf(MSG_ERROR, "%s read() failed: %s\n",
1168 __func__, strerror(errno));
1169 os_free(buf);
6fc6879b
JM		 1170 return;
1171 }
1172
1173 rtm = (struct rt_msghdr *) buf;
1174 if (rtm->rtm_version != RTM_VERSION) {
28878f8b
MH		 1175 wpa_printf(MSG_DEBUG, "Invalid routing message version=%d",
1176 rtm->rtm_version);
1177 os_free(buf);
6fc6879b
JM		 1178 return;
1179 }
1180 os_memset(&event, 0, sizeof(event));
1181 switch (rtm->rtm_type) {
1182 case RTM_IFANNOUNCE:
1183 ifan = (struct if_announcemsghdr *) rtm;
1184 if (ifan->ifan_index != drv->ifindex)
1185 break;
d2f46a2b
JM		 1186 os_strlcpy(event.interface_status.ifname, drv->ifname,
1187 sizeof(event.interface_status.ifname));
6fc6879b
JM		 1188 switch (ifan->ifan_what) {
1189 case IFAN_DEPARTURE:
1190 event.interface_status.ievent = EVENT_INTERFACE_REMOVED;
1191 default:
28878f8b 1192 os_free(buf);
6fc6879b
JM		 1193 return;
1194 }
1195 wpa_printf(MSG_DEBUG, "RTM_IFANNOUNCE: Interface '%s' %s",
1196 event.interface_status.ifname,
1197 ifan->ifan_what == IFAN_DEPARTURE ?
1198 "removed" : "added");
1199 wpa_supplicant_event(ctx, EVENT_INTERFACE_STATUS, &event);
1200 break;
1201 case RTM_IEEE80211:
1202 ifan = (struct if_announcemsghdr *) rtm;
1203 if (ifan->ifan_index != drv->ifindex)
1204 break;
1205 switch (ifan->ifan_what) {
1206 case RTM_IEEE80211_ASSOC:
1207 case RTM_IEEE80211_REASSOC:
42f34a9b
MH		 1208 if (drv->is_ap)
1209 break;
6fc6879b
JM		 1210 wpa_supplicant_event(ctx, EVENT_ASSOC, NULL);
1211 break;
1212 case RTM_IEEE80211_DISASSOC:
42f34a9b
MH		 1213 if (drv->is_ap)
1214 break;
6fc6879b
JM		 1215 wpa_supplicant_event(ctx, EVENT_DISASSOC, NULL);
1216 break;
1217 case RTM_IEEE80211_SCAN:
42f34a9b
MH		 1218 if (drv->is_ap)
1219 break;
6fc6879b
JM		 1220 wpa_supplicant_event(ctx, EVENT_SCAN_RESULTS, NULL);
1221 break;
42f34a9b
MH		 1222 case RTM_IEEE80211_LEAVE:
1223 leave = (struct ieee80211_leave_event *) &ifan[1];
1224 drv_event_disassoc(ctx, leave->iev_addr);
1225 break;
1226 case RTM_IEEE80211_JOIN:
1227#ifdef RTM_IEEE80211_REJOIN
1228 case RTM_IEEE80211_REJOIN:
1229#endif
1230 join = (struct ieee80211_join_event *) &ifan[1];
e1b1309b 1231 bsd_new_sta(drv, ctx, join->iev_addr);
42f34a9b 1232 break;
6fc6879b
JM		 1233 case RTM_IEEE80211_REPLAY:
1234 /* ignore */
1235 break;
1236 case RTM_IEEE80211_MICHAEL:
1237 mic = (struct ieee80211_michael_event *) &ifan[1];
1238 wpa_printf(MSG_DEBUG,
1239 "Michael MIC failure wireless event: "
1240 "keyix=%u src_addr=" MACSTR, mic->iev_keyix,
1241 MAC2STR(mic->iev_src));
1242
1243 os_memset(&event, 0, sizeof(event));
1244 event.michael_mic_failure.unicast =
1245 !IEEE80211_IS_MULTICAST(mic->iev_dst);
1246 wpa_supplicant_event(ctx, EVENT_MICHAEL_MIC_FAILURE,
1247 &event);
1248 break;
1249 }
1250 break;
1251 case RTM_IFINFO:
1252 ifm = (struct if_msghdr *) rtm;
1253 if (ifm->ifm_index != drv->ifindex)
1254 break;
1255 if ((rtm->rtm_flags & RTF_UP) == 0) {
d2f46a2b
JM		 1256 os_strlcpy(event.interface_status.ifname, drv->ifname,
1257 sizeof(event.interface_status.ifname));
6fc6879b
JM		 1258 event.interface_status.ievent = EVENT_INTERFACE_REMOVED;
1259 wpa_printf(MSG_DEBUG, "RTM_IFINFO: Interface '%s' DOWN",
1260 event.interface_status.ifname);
1261 wpa_supplicant_event(ctx, EVENT_INTERFACE_STATUS, &event);
1262 }
1263 break;
1264 }
28878f8b 1265 os_free(buf);
6fc6879b
JM		 1266}
1267
a65f4a57
MH		 1268static void
1269wpa_driver_bsd_add_scan_entry(struct wpa_scan_results *res,
1270 struct ieee80211req_scan_result *sr)
6fc6879b 1271{
a65f4a57
MH		 1272 struct wpa_scan_res *result, **tmp;
1273 size_t extra_len;
1274 u8 *pos;
6fc6879b 1275
a65f4a57
MH		 1276 extra_len = 2 + sr->isr_ssid_len;
1277 extra_len += 2 + sr->isr_nrates;
1278 extra_len += 3; /* ERP IE */
1279 extra_len += sr->isr_ie_len;
6fc6879b 1280
a65f4a57
MH		 1281 result = os_zalloc(sizeof(*result) + extra_len);
1282 if (result == NULL)
1283 return;
1284 os_memcpy(result->bssid, sr->isr_bssid, ETH_ALEN);
1285 result->freq = sr->isr_freq;
1286 result->beacon_int = sr->isr_intval;
1287 result->caps = sr->isr_capinfo;
1288 result->qual = sr->isr_rssi;
1289 result->noise = sr->isr_noise;
6fc6879b 1290
a65f4a57 1291 pos = (u8 *)(result + 1);
6fc6879b 1292
a65f4a57
MH		 1293 *pos++ = WLAN_EID_SSID;
1294 *pos++ = sr->isr_ssid_len;
1295 os_memcpy(pos, sr + 1, sr->isr_ssid_len);
1296 pos += sr->isr_ssid_len;
6fc6879b 1297
a65f4a57
MH		 1298 /*
1299 * Deal all rates as supported rate.
1300 * Because net80211 doesn't report extended supported rate or not.
1301 */
1302 *pos++ = WLAN_EID_SUPP_RATES;
1303 *pos++ = sr->isr_nrates;
1304 os_memcpy(pos, sr->isr_rates, sr->isr_nrates);
1305 pos += sr->isr_nrates;
6fc6879b 1306
a65f4a57
MH		 1307 *pos++ = WLAN_EID_ERP_INFO;
1308 *pos++ = 1;
1309 *pos++ = sr->isr_erp;
6fc6879b 1310
a65f4a57
MH		 1311 os_memcpy(pos, (u8 *)(sr + 1) + sr->isr_ssid_len, sr->isr_ie_len);
1312 pos += sr->isr_ie_len;
6fc6879b 1313
a65f4a57
MH		 1314 result->ie_len = pos - (u8 *)(result + 1);
1315
1316 tmp = os_realloc(res->res,
1317 (res->num + 1) * sizeof(struct wpa_scan_res *));
1318 if (tmp == NULL) {
1319 os_free(result);
1320 return;
1321 }
1322 tmp[res->num++] = result;
1323 res->res = tmp;
6fc6879b
JM		 1324}
1325
a65f4a57
MH		 1326struct wpa_scan_results *
1327wpa_driver_bsd_get_scan_results2(void *priv)
6fc6879b 1328{
6fc6879b 1329 struct ieee80211req_scan_result *sr;
a65f4a57
MH		 1330 struct wpa_scan_results *res;
1331 int len, rest;
1332 uint8_t buf[24*1024], *pos;
6fc6879b 1333
e1b1309b 1334 len = get80211var(priv, IEEE80211_IOC_SCAN_RESULTS, buf, 24*1024);
6fc6879b 1335 if (len < 0)
a65f4a57
MH		 1336 return NULL;
1337
1338 res = os_zalloc(sizeof(*res));
1339 if (res == NULL)
1340 return NULL;
6fc6879b 1341
a65f4a57
MH		 1342 pos = buf;
1343 rest = len;
1344 while (rest >= sizeof(struct ieee80211req_scan_result)) {
1345 sr = (struct ieee80211req_scan_result *)pos;
1346 wpa_driver_bsd_add_scan_entry(res, sr);
1347 pos += sr->isr_len;
1348 rest -= sr->isr_len;
6fc6879b 1349 }
6fc6879b 1350
a65f4a57
MH		 1351 wpa_printf(MSG_DEBUG, "Received %d bytes of scan results (%lu BSSes)",
1352 len, (unsigned long)res->num);
6fc6879b 1353
a65f4a57 1354 return res;
6fc6879b
JM		 1355}
1356
86b24ea9 1357static int wpa_driver_bsd_capa(struct bsd_driver_data *drv)
42f34a9b 1358{
c6611ed9
MH		 1359#ifdef IEEE80211_IOC_DEVCAPS
1360/* kernel definitions copied from net80211/ieee80211_var.h */
1361#define IEEE80211_CIPHER_WEP 0
1362#define IEEE80211_CIPHER_TKIP 1
1363#define IEEE80211_CIPHER_AES_CCM 3
1364#define IEEE80211_CRYPTO_WEP (1<<IEEE80211_CIPHER_WEP)
1365#define IEEE80211_CRYPTO_TKIP (1<<IEEE80211_CIPHER_TKIP)
1366#define IEEE80211_CRYPTO_AES_CCM (1<<IEEE80211_CIPHER_AES_CCM)
1367#define IEEE80211_C_HOSTAP 0x00000400 /* CAPABILITY: HOSTAP avail */
1368#define IEEE80211_C_WPA1 0x00800000 /* CAPABILITY: WPA1 avail */
1369#define IEEE80211_C_WPA2 0x01000000 /* CAPABILITY: WPA2 avail */
1370 struct ieee80211_devcaps_req devcaps;
1371
1372 if (get80211var(drv, IEEE80211_IOC_DEVCAPS, &devcaps,
1373 sizeof(devcaps)) < 0) {
1374 wpa_printf(MSG_ERROR, "failed to IEEE80211_IOC_DEVCAPS: %s",
1375 strerror(errno));
1376 return -1;
1377 }
1378
1379 wpa_printf(MSG_DEBUG, "%s: drivercaps=0x%08x,cryptocaps=0x%08x",
1380 __func__, devcaps.dc_drivercaps, devcaps.dc_cryptocaps);
1381
1382 if (devcaps.dc_drivercaps & IEEE80211_C_WPA1)
1383 drv->capa.key_mgmt = WPA_DRIVER_CAPA_KEY_MGMT_WPA |
1384 WPA_DRIVER_CAPA_KEY_MGMT_WPA_PSK;
1385 if (devcaps.dc_drivercaps & IEEE80211_C_WPA2)
1386 drv->capa.key_mgmt = WPA_DRIVER_CAPA_KEY_MGMT_WPA2 |
1387 WPA_DRIVER_CAPA_KEY_MGMT_WPA2_PSK;
1388
1389 if (devcaps.dc_cryptocaps & IEEE80211_CRYPTO_WEP)
1390 drv->capa.enc |= WPA_DRIVER_CAPA_ENC_WEP40 |
1391 WPA_DRIVER_CAPA_ENC_WEP104;
1392 if (devcaps.dc_cryptocaps & IEEE80211_CRYPTO_TKIP)
1393 drv->capa.enc |= WPA_DRIVER_CAPA_ENC_TKIP;
1394 if (devcaps.dc_cryptocaps & IEEE80211_CRYPTO_AES_CCM)
1395 drv->capa.enc |= WPA_DRIVER_CAPA_ENC_CCMP;
1396
1397 if (devcaps.dc_drivercaps & IEEE80211_C_HOSTAP)
1398 drv->capa.flags |= WPA_DRIVER_FLAGS_AP;
1399#undef IEEE80211_CIPHER_WEP
1400#undef IEEE80211_CIPHER_TKIP
1401#undef IEEE80211_CIPHER_AES_CCM
1402#undef IEEE80211_CRYPTO_WEP
1403#undef IEEE80211_CRYPTO_TKIP
1404#undef IEEE80211_CRYPTO_AES_CCM
1405#undef IEEE80211_C_HOSTAP
1406#undef IEEE80211_C_WPA1
1407#undef IEEE80211_C_WPA2
1408#else /* IEEE80211_IOC_DEVCAPS */
42f34a9b
MH		 1409 /* For now, assume TKIP, CCMP, WPA, WPA2 are supported */
1410 drv->capa.key_mgmt = WPA_DRIVER_CAPA_KEY_MGMT_WPA |
1411 WPA_DRIVER_CAPA_KEY_MGMT_WPA_PSK |
1412 WPA_DRIVER_CAPA_KEY_MGMT_WPA2 |
1413 WPA_DRIVER_CAPA_KEY_MGMT_WPA2_PSK;
1414 drv->capa.enc = WPA_DRIVER_CAPA_ENC_WEP40 |
1415 WPA_DRIVER_CAPA_ENC_WEP104 |
1416 WPA_DRIVER_CAPA_ENC_TKIP |
1417 WPA_DRIVER_CAPA_ENC_CCMP;
c6611ed9
MH		 1418 drv->capa.flags |= WPA_DRIVER_FLAGS_AP;
1419#endif /* IEEE80211_IOC_DEVCAPS */
88487b0e
MH		 1420#ifdef IEEE80211_IOC_SCAN_MAX_SSID
1421 drv->capa.max_scan_ssids = IEEE80211_IOC_SCAN_MAX_SSID;
c6611ed9
MH		 1422#else /* IEEE80211_IOC_SCAN_MAX_SSID */
1423 drv->capa.max_scan_ssids = 1;
88487b0e 1424#endif /* IEEE80211_IOC_SCAN_MAX_SSID */
c6611ed9
MH		 1425 drv->capa.auth = WPA_DRIVER_AUTH_OPEN |
1426 WPA_DRIVER_AUTH_SHARED |
1427 WPA_DRIVER_AUTH_LEAP;
42f34a9b
MH		 1428 return 0;
1429}
1430
6fc6879b
JM		 1431static void *
1432wpa_driver_bsd_init(void *ctx, const char *ifname)
1433{
1434#define GETPARAM(drv, param, v) \
1435 (((v) = get80211param(drv, param)) != -1)
86b24ea9 1436 struct bsd_driver_data *drv;
6fc6879b
JM		 1437
1438 drv = os_zalloc(sizeof(*drv));
1439 if (drv == NULL)
1440 return NULL;
1441 /*
1442 * NB: We require the interface name be mappable to an index.
1443 * This implies we do not support having wpa_supplicant
1444 * wait for an interface to appear. This seems ok; that
1445 * doesn't belong here; it's really the job of devd.
1446 */
1447 drv->ifindex = if_nametoindex(ifname);
1448 if (drv->ifindex == 0) {
1449 wpa_printf(MSG_DEBUG, "%s: interface %s does not exist",
1450 __func__, ifname);
1451 goto fail1;
1452 }
1453 drv->sock = socket(PF_INET, SOCK_DGRAM, 0);
1454 if (drv->sock < 0)
1455 goto fail1;
1456 drv->route = socket(PF_ROUTE, SOCK_RAW, 0);
1457 if (drv->route < 0)
1458 goto fail;
1459 eloop_register_read_sock(drv->route,
1460 wpa_driver_bsd_event_receive, ctx, drv);
1461
1462 drv->ctx = ctx;
1463 os_strlcpy(drv->ifname, ifname, sizeof(drv->ifname));
1464
42f34a9b 1465 /* Down interface during setup. */
e1b1309b 1466 if (bsd_ctrl_iface(drv, 0) < 0)
42f34a9b
MH		 1467 goto fail;
1468
6fc6879b
JM		 1469 if (!GETPARAM(drv, IEEE80211_IOC_ROAMING, drv->prev_roaming)) {
1470 wpa_printf(MSG_DEBUG, "%s: failed to get roaming state: %s",
1471 __func__, strerror(errno));
1472 goto fail;
1473 }
1474 if (!GETPARAM(drv, IEEE80211_IOC_PRIVACY, drv->prev_privacy)) {
1475 wpa_printf(MSG_DEBUG, "%s: failed to get privacy state: %s",
1476 __func__, strerror(errno));
1477 goto fail;
1478 }
1479 if (!GETPARAM(drv, IEEE80211_IOC_WPA, drv->prev_wpa)) {
1480 wpa_printf(MSG_DEBUG, "%s: failed to get wpa state: %s",
1481 __func__, strerror(errno));
1482 goto fail;
1483 }
5197244a 1484
42f34a9b 1485 if (wpa_driver_bsd_capa(drv))
6fc6879b 1486 goto fail;
4a867032 1487
6fc6879b
JM		 1488 return drv;
1489fail:
1490 close(drv->sock);
1491fail1:
1492 os_free(drv);
1493 return NULL;
1494#undef GETPARAM
1495}
1496
1497static void
1498wpa_driver_bsd_deinit(void *priv)
1499{
86b24ea9 1500 struct bsd_driver_data *drv = priv;
6fc6879b 1501
4a867032 1502 wpa_driver_bsd_set_wpa(drv, 0);
6fc6879b
JM		 1503 eloop_unregister_read_sock(drv->route);
1504
1505 /* NB: mark interface down */
e1b1309b 1506 bsd_ctrl_iface(drv, 0);
6fc6879b
JM		 1507
1508 wpa_driver_bsd_set_wpa_internal(drv, drv->prev_wpa, drv->prev_privacy);
1509 if (set80211param(drv, IEEE80211_IOC_ROAMING, drv->prev_roaming) < 0)
1510 wpa_printf(MSG_DEBUG, "%s: failed to restore roaming state",
1511 __func__);
1512
42f34a9b
MH		 1513 if (drv->sock_xmit != NULL)
1514 l2_packet_deinit(drv->sock_xmit);
6fc6879b
JM		 1515 (void) close(drv->route); /* ioctl socket */
1516 (void) close(drv->sock); /* event socket */
1517 os_free(drv);
1518}
1519
42f34a9b
MH		 1520static int
1521wpa_driver_bsd_get_capa(void *priv, struct wpa_driver_capa *capa)
1522{
86b24ea9 1523 struct bsd_driver_data *drv = priv;
42f34a9b
MH		 1524
1525 os_memcpy(capa, &drv->capa, sizeof(*capa));
1526 return 0;
1527}
e1b1309b 1528#endif /* HOSTAPD */
42f34a9b 1529
6fc6879b
JM		 1530
1531const struct wpa_driver_ops wpa_driver_bsd_ops = {
1532 .name = "bsd",
66d4085f 1533 .desc = "BSD 802.11 support",
e1b1309b
MH		 1534#ifdef HOSTAPD
1535 .hapd_init = bsd_init,
1536 .hapd_deinit = bsd_deinit,
1537 .set_privacy = bsd_set_privacy,
1538 .get_seqnum = bsd_get_seqnum,
1539 .flush = bsd_flush,
e1b1309b
MH		 1540 .read_sta_data = bsd_read_sta_driver_data,
1541 .sta_disassoc = bsd_sta_disassoc,
1542 .sta_deauth = bsd_sta_deauth,
e1b1309b 1543#else /* HOSTAPD */
6fc6879b
JM		 1544 .init = wpa_driver_bsd_init,
1545 .deinit = wpa_driver_bsd_deinit,
1546 .get_bssid = wpa_driver_bsd_get_bssid,
1547 .get_ssid = wpa_driver_bsd_get_ssid,
6fc6879b 1548 .set_countermeasures = wpa_driver_bsd_set_countermeasures,
c2e8d0a0 1549 .scan2 = wpa_driver_bsd_scan,
a65f4a57 1550 .get_scan_results2 = wpa_driver_bsd_get_scan_results2,
6fc6879b
JM		 1551 .deauthenticate = wpa_driver_bsd_deauthenticate,
1552 .disassociate = wpa_driver_bsd_disassociate,
1553 .associate = wpa_driver_bsd_associate,
42f34a9b 1554 .get_capa = wpa_driver_bsd_get_capa,
c5121837 1555#endif /* HOSTAPD */
6db1602d 1556 .set_freq = bsd_set_freq,
e1b1309b
MH		 1557 .set_key = bsd_set_key,
1558 .set_ieee8021x = bsd_set_ieee8021x,
1559 .hapd_set_ssid = bsd_set_ssid,
1560 .hapd_get_ssid = bsd_get_ssid,
1561 .hapd_send_eapol = bsd_send_eapol,
1562 .sta_set_flags = bsd_set_sta_authorized,
88487b0e 1563 .set_generic_elem = bsd_set_opt_ie,
e1b1309b 1564};
Unnamed repository; edit this file 'description' to name the repository.