2 * Copyright 2002-2005, Instant802 Networks, Inc.
3 * Copyright 2005-2006, Devicescape Software, Inc.
4 * Copyright 2006-2007 Jiri Benc <jbenc@suse.cz>
5 * Copyright 2007-2008 Johannes Berg <johannes@sipsolutions.net>
6 * Copyright 2013-2014 Intel Mobile Communications GmbH
7 * Copyright 2015-2017 Intel Deutschland GmbH
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License version 2 as
11 * published by the Free Software Foundation.
14 #include <linux/if_ether.h>
15 #include <linux/etherdevice.h>
16 #include <linux/list.h>
17 #include <linux/rcupdate.h>
18 #include <linux/rtnetlink.h>
19 #include <linux/slab.h>
20 #include <linux/export.h>
21 #include <net/mac80211.h>
22 #include <asm/unaligned.h>
23 #include "ieee80211_i.h"
24 #include "driver-ops.h"
25 #include "debugfs_key.h"
33 * DOC: Key handling basics
35 * Key handling in mac80211 is done based on per-interface (sub_if_data)
36 * keys and per-station keys. Since each station belongs to an interface,
37 * each station key also belongs to that interface.
39 * Hardware acceleration is done on a best-effort basis for algorithms
40 * that are implemented in software, for each key the hardware is asked
41 * to enable that key for offloading but if it cannot do that the key is
42 * simply kept for software encryption (unless it is for an algorithm
43 * that isn't implemented in software).
44 * There is currently no way of knowing whether a key is handled in SW
45 * or HW except by looking into debugfs.
47 * All key management is internally protected by a mutex. Within all
48 * other parts of mac80211, key references are, just as STA structure
49 * references, protected by RCU. Note, however, that some things are
50 * unprotected, namely the key->sta dereferences within the hardware
51 * acceleration functions. This means that sta_info_destroy() must
52 * remove the key which waits for an RCU grace period.
55 static const u8 bcast_addr[ETH_ALEN] = { 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF };
57 static void assert_key_lock(struct ieee80211_local *local)
59 lockdep_assert_held(&local->key_mtx);
63 update_vlan_tailroom_need_count(struct ieee80211_sub_if_data *sdata, int delta)
65 struct ieee80211_sub_if_data *vlan;
67 if (sdata->vif.type != NL80211_IFTYPE_AP)
70 /* crypto_tx_tailroom_needed_cnt is protected by this */
71 assert_key_lock(sdata->local);
75 list_for_each_entry_rcu(vlan, &sdata->u.ap.vlans, u.vlan.list)
76 vlan->crypto_tx_tailroom_needed_cnt += delta;
81 static void increment_tailroom_need_count(struct ieee80211_sub_if_data *sdata)
84 * When this count is zero, SKB resizing for allocating tailroom
85 * for IV or MMIC is skipped. But, this check has created two race
86 * cases in xmit path while transiting from zero count to one:
88 * 1. SKB resize was skipped because no key was added but just before
89 * the xmit key is added and SW encryption kicks off.
91 * 2. SKB resize was skipped because all the keys were hw planted but
92 * just before xmit one of the key is deleted and SW encryption kicks
95 * In both the above case SW encryption will find not enough space for
96 * tailroom and exits with WARN_ON. (See WARN_ONs at wpa.c)
98 * Solution has been explained at
99 * http://mid.gmane.org/1308590980.4322.19.camel@jlt3.sipsolutions.net
102 assert_key_lock(sdata->local);
104 update_vlan_tailroom_need_count(sdata, 1);
106 if (!sdata->crypto_tx_tailroom_needed_cnt++) {
108 * Flush all XMIT packets currently using HW encryption or no
109 * encryption at all if the count transition is from 0 -> 1.
115 static void decrease_tailroom_need_count(struct ieee80211_sub_if_data *sdata,
118 assert_key_lock(sdata->local);
120 WARN_ON_ONCE(sdata->crypto_tx_tailroom_needed_cnt < delta);
122 update_vlan_tailroom_need_count(sdata, -delta);
123 sdata->crypto_tx_tailroom_needed_cnt -= delta;
126 static int ieee80211_key_enable_hw_accel(struct ieee80211_key *key)
128 struct ieee80211_sub_if_data *sdata;
129 struct sta_info *sta;
130 int ret = -EOPNOTSUPP;
134 if (key->flags & KEY_FLAG_TAINTED) {
135 /* If we get here, it's during resume and the key is
136 * tainted so shouldn't be used/programmed any more.
137 * However, its flags may still indicate that it was
138 * programmed into the device (since we're in resume)
139 * so clear that flag now to avoid trying to remove
142 key->flags &= ~KEY_FLAG_UPLOADED_TO_HARDWARE;
146 if (!key->local->ops->set_key)
147 goto out_unsupported;
149 assert_key_lock(key->local);
154 * If this is a per-STA GTK, check if it
155 * is supported; if not, return.
157 if (sta && !(key->conf.flags & IEEE80211_KEY_FLAG_PAIRWISE) &&
158 !ieee80211_hw_check(&key->local->hw, SUPPORTS_PER_STA_GTK))
159 goto out_unsupported;
161 if (sta && !sta->uploaded)
162 goto out_unsupported;
165 if (sdata->vif.type == NL80211_IFTYPE_AP_VLAN) {
167 * The driver doesn't know anything about VLAN interfaces.
168 * Hence, don't send GTKs for VLAN interfaces to the driver.
170 if (!(key->conf.flags & IEEE80211_KEY_FLAG_PAIRWISE))
171 goto out_unsupported;
174 ret = drv_set_key(key->local, SET_KEY, sdata,
175 sta ? &sta->sta : NULL, &key->conf);
178 key->flags |= KEY_FLAG_UPLOADED_TO_HARDWARE;
180 if (!((key->conf.flags & IEEE80211_KEY_FLAG_GENERATE_MMIC) ||
181 (key->conf.flags & IEEE80211_KEY_FLAG_RESERVE_TAILROOM)))
182 decrease_tailroom_need_count(sdata, 1);
184 WARN_ON((key->conf.flags & IEEE80211_KEY_FLAG_PUT_IV_SPACE) &&
185 (key->conf.flags & IEEE80211_KEY_FLAG_GENERATE_IV));
190 if (ret != -ENOSPC && ret != -EOPNOTSUPP && ret != 1)
192 "failed to set key (%d, %pM) to hardware (%d)\n",
194 sta ? sta->sta.addr : bcast_addr, ret);
197 switch (key->conf.cipher) {
198 case WLAN_CIPHER_SUITE_WEP40:
199 case WLAN_CIPHER_SUITE_WEP104:
200 case WLAN_CIPHER_SUITE_TKIP:
201 case WLAN_CIPHER_SUITE_CCMP:
202 case WLAN_CIPHER_SUITE_CCMP_256:
203 case WLAN_CIPHER_SUITE_AES_CMAC:
204 case WLAN_CIPHER_SUITE_BIP_CMAC_256:
205 case WLAN_CIPHER_SUITE_BIP_GMAC_128:
206 case WLAN_CIPHER_SUITE_BIP_GMAC_256:
207 case WLAN_CIPHER_SUITE_GCMP:
208 case WLAN_CIPHER_SUITE_GCMP_256:
209 /* all of these we can do in software - if driver can */
212 if (ieee80211_hw_check(&key->local->hw, SW_CRYPTO_CONTROL))
220 static void ieee80211_key_disable_hw_accel(struct ieee80211_key *key)
222 struct ieee80211_sub_if_data *sdata;
223 struct sta_info *sta;
228 if (!key || !key->local->ops->set_key)
231 assert_key_lock(key->local);
233 if (!(key->flags & KEY_FLAG_UPLOADED_TO_HARDWARE))
239 if (!((key->conf.flags & IEEE80211_KEY_FLAG_GENERATE_MMIC) ||
240 (key->conf.flags & IEEE80211_KEY_FLAG_RESERVE_TAILROOM)))
241 increment_tailroom_need_count(sdata);
243 ret = drv_set_key(key->local, DISABLE_KEY, sdata,
244 sta ? &sta->sta : NULL, &key->conf);
248 "failed to remove key (%d, %pM) from hardware (%d)\n",
250 sta ? sta->sta.addr : bcast_addr, ret);
252 key->flags &= ~KEY_FLAG_UPLOADED_TO_HARDWARE;
255 static void __ieee80211_set_default_key(struct ieee80211_sub_if_data *sdata,
256 int idx, bool uni, bool multi)
258 struct ieee80211_key *key = NULL;
260 assert_key_lock(sdata->local);
262 if (idx >= 0 && idx < NUM_DEFAULT_KEYS)
263 key = key_mtx_dereference(sdata->local, sdata->keys[idx]);
266 rcu_assign_pointer(sdata->default_unicast_key, key);
267 ieee80211_check_fast_xmit_iface(sdata);
268 if (sdata->vif.type != NL80211_IFTYPE_AP_VLAN)
269 drv_set_default_unicast_key(sdata->local, sdata, idx);
273 rcu_assign_pointer(sdata->default_multicast_key, key);
275 ieee80211_debugfs_key_update_default(sdata);
278 void ieee80211_set_default_key(struct ieee80211_sub_if_data *sdata, int idx,
279 bool uni, bool multi)
281 mutex_lock(&sdata->local->key_mtx);
282 __ieee80211_set_default_key(sdata, idx, uni, multi);
283 mutex_unlock(&sdata->local->key_mtx);
287 __ieee80211_set_default_mgmt_key(struct ieee80211_sub_if_data *sdata, int idx)
289 struct ieee80211_key *key = NULL;
291 assert_key_lock(sdata->local);
293 if (idx >= NUM_DEFAULT_KEYS &&
294 idx < NUM_DEFAULT_KEYS + NUM_DEFAULT_MGMT_KEYS)
295 key = key_mtx_dereference(sdata->local, sdata->keys[idx]);
297 rcu_assign_pointer(sdata->default_mgmt_key, key);
299 ieee80211_debugfs_key_update_default(sdata);
302 void ieee80211_set_default_mgmt_key(struct ieee80211_sub_if_data *sdata,
305 mutex_lock(&sdata->local->key_mtx);
306 __ieee80211_set_default_mgmt_key(sdata, idx);
307 mutex_unlock(&sdata->local->key_mtx);
311 static void ieee80211_key_replace(struct ieee80211_sub_if_data *sdata,
312 struct sta_info *sta,
314 struct ieee80211_key *old,
315 struct ieee80211_key *new)
318 bool defunikey, defmultikey, defmgmtkey;
320 /* caller must provide at least one old/new */
321 if (WARN_ON(!new && !old))
325 list_add_tail_rcu(&new->list, &sdata->key_list);
327 WARN_ON(new && old && new->conf.keyidx != old->conf.keyidx);
330 idx = old->conf.keyidx;
332 idx = new->conf.keyidx;
336 rcu_assign_pointer(sta->ptk[idx], new);
338 ieee80211_check_fast_xmit(sta);
340 rcu_assign_pointer(sta->gtk[idx], new);
342 ieee80211_check_fast_rx(sta);
345 old == key_mtx_dereference(sdata->local,
346 sdata->default_unicast_key);
348 old == key_mtx_dereference(sdata->local,
349 sdata->default_multicast_key);
351 old == key_mtx_dereference(sdata->local,
352 sdata->default_mgmt_key);
354 if (defunikey && !new)
355 __ieee80211_set_default_key(sdata, -1, true, false);
356 if (defmultikey && !new)
357 __ieee80211_set_default_key(sdata, -1, false, true);
358 if (defmgmtkey && !new)
359 __ieee80211_set_default_mgmt_key(sdata, -1);
361 rcu_assign_pointer(sdata->keys[idx], new);
362 if (defunikey && new)
363 __ieee80211_set_default_key(sdata, new->conf.keyidx,
365 if (defmultikey && new)
366 __ieee80211_set_default_key(sdata, new->conf.keyidx,
368 if (defmgmtkey && new)
369 __ieee80211_set_default_mgmt_key(sdata,
374 list_del_rcu(&old->list);
377 struct ieee80211_key *
378 ieee80211_key_alloc(u32 cipher, int idx, size_t key_len,
380 size_t seq_len, const u8 *seq,
381 const struct ieee80211_cipher_scheme *cs)
383 struct ieee80211_key *key;
386 if (WARN_ON(idx < 0 || idx >= NUM_DEFAULT_KEYS + NUM_DEFAULT_MGMT_KEYS))
387 return ERR_PTR(-EINVAL);
389 key = kzalloc(sizeof(struct ieee80211_key) + key_len, GFP_KERNEL);
391 return ERR_PTR(-ENOMEM);
394 * Default to software encryption; we'll later upload the
395 * key to the hardware if possible.
400 key->conf.cipher = cipher;
401 key->conf.keyidx = idx;
402 key->conf.keylen = key_len;
404 case WLAN_CIPHER_SUITE_WEP40:
405 case WLAN_CIPHER_SUITE_WEP104:
406 key->conf.iv_len = IEEE80211_WEP_IV_LEN;
407 key->conf.icv_len = IEEE80211_WEP_ICV_LEN;
409 case WLAN_CIPHER_SUITE_TKIP:
410 key->conf.iv_len = IEEE80211_TKIP_IV_LEN;
411 key->conf.icv_len = IEEE80211_TKIP_ICV_LEN;
413 for (i = 0; i < IEEE80211_NUM_TIDS; i++) {
414 key->u.tkip.rx[i].iv32 =
415 get_unaligned_le32(&seq[2]);
416 key->u.tkip.rx[i].iv16 =
417 get_unaligned_le16(seq);
420 spin_lock_init(&key->u.tkip.txlock);
422 case WLAN_CIPHER_SUITE_CCMP:
423 key->conf.iv_len = IEEE80211_CCMP_HDR_LEN;
424 key->conf.icv_len = IEEE80211_CCMP_MIC_LEN;
426 for (i = 0; i < IEEE80211_NUM_TIDS + 1; i++)
427 for (j = 0; j < IEEE80211_CCMP_PN_LEN; j++)
428 key->u.ccmp.rx_pn[i][j] =
429 seq[IEEE80211_CCMP_PN_LEN - j - 1];
432 * Initialize AES key state here as an optimization so that
433 * it does not need to be initialized for every packet.
435 key->u.ccmp.tfm = ieee80211_aes_key_setup_encrypt(
436 key_data, key_len, IEEE80211_CCMP_MIC_LEN);
437 if (IS_ERR(key->u.ccmp.tfm)) {
438 err = PTR_ERR(key->u.ccmp.tfm);
443 case WLAN_CIPHER_SUITE_CCMP_256:
444 key->conf.iv_len = IEEE80211_CCMP_256_HDR_LEN;
445 key->conf.icv_len = IEEE80211_CCMP_256_MIC_LEN;
446 for (i = 0; seq && i < IEEE80211_NUM_TIDS + 1; i++)
447 for (j = 0; j < IEEE80211_CCMP_256_PN_LEN; j++)
448 key->u.ccmp.rx_pn[i][j] =
449 seq[IEEE80211_CCMP_256_PN_LEN - j - 1];
450 /* Initialize AES key state here as an optimization so that
451 * it does not need to be initialized for every packet.
453 key->u.ccmp.tfm = ieee80211_aes_key_setup_encrypt(
454 key_data, key_len, IEEE80211_CCMP_256_MIC_LEN);
455 if (IS_ERR(key->u.ccmp.tfm)) {
456 err = PTR_ERR(key->u.ccmp.tfm);
461 case WLAN_CIPHER_SUITE_AES_CMAC:
462 case WLAN_CIPHER_SUITE_BIP_CMAC_256:
463 key->conf.iv_len = 0;
464 if (cipher == WLAN_CIPHER_SUITE_AES_CMAC)
465 key->conf.icv_len = sizeof(struct ieee80211_mmie);
467 key->conf.icv_len = sizeof(struct ieee80211_mmie_16);
469 for (j = 0; j < IEEE80211_CMAC_PN_LEN; j++)
470 key->u.aes_cmac.rx_pn[j] =
471 seq[IEEE80211_CMAC_PN_LEN - j - 1];
473 * Initialize AES key state here as an optimization so that
474 * it does not need to be initialized for every packet.
476 key->u.aes_cmac.tfm =
477 ieee80211_aes_cmac_key_setup(key_data, key_len);
478 if (IS_ERR(key->u.aes_cmac.tfm)) {
479 err = PTR_ERR(key->u.aes_cmac.tfm);
484 case WLAN_CIPHER_SUITE_BIP_GMAC_128:
485 case WLAN_CIPHER_SUITE_BIP_GMAC_256:
486 key->conf.iv_len = 0;
487 key->conf.icv_len = sizeof(struct ieee80211_mmie_16);
489 for (j = 0; j < IEEE80211_GMAC_PN_LEN; j++)
490 key->u.aes_gmac.rx_pn[j] =
491 seq[IEEE80211_GMAC_PN_LEN - j - 1];
492 /* Initialize AES key state here as an optimization so that
493 * it does not need to be initialized for every packet.
495 key->u.aes_gmac.tfm =
496 ieee80211_aes_gmac_key_setup(key_data, key_len);
497 if (IS_ERR(key->u.aes_gmac.tfm)) {
498 err = PTR_ERR(key->u.aes_gmac.tfm);
503 case WLAN_CIPHER_SUITE_GCMP:
504 case WLAN_CIPHER_SUITE_GCMP_256:
505 key->conf.iv_len = IEEE80211_GCMP_HDR_LEN;
506 key->conf.icv_len = IEEE80211_GCMP_MIC_LEN;
507 for (i = 0; seq && i < IEEE80211_NUM_TIDS + 1; i++)
508 for (j = 0; j < IEEE80211_GCMP_PN_LEN; j++)
509 key->u.gcmp.rx_pn[i][j] =
510 seq[IEEE80211_GCMP_PN_LEN - j - 1];
511 /* Initialize AES key state here as an optimization so that
512 * it does not need to be initialized for every packet.
514 key->u.gcmp.tfm = ieee80211_aes_gcm_key_setup_encrypt(key_data,
516 if (IS_ERR(key->u.gcmp.tfm)) {
517 err = PTR_ERR(key->u.gcmp.tfm);
524 if (seq_len && seq_len != cs->pn_len) {
526 return ERR_PTR(-EINVAL);
529 key->conf.iv_len = cs->hdr_len;
530 key->conf.icv_len = cs->mic_len;
531 for (i = 0; i < IEEE80211_NUM_TIDS + 1; i++)
532 for (j = 0; j < seq_len; j++)
533 key->u.gen.rx_pn[i][j] =
534 seq[seq_len - j - 1];
535 key->flags |= KEY_FLAG_CIPHER_SCHEME;
538 memcpy(key->conf.key, key_data, key_len);
539 INIT_LIST_HEAD(&key->list);
544 static void ieee80211_key_free_common(struct ieee80211_key *key)
546 switch (key->conf.cipher) {
547 case WLAN_CIPHER_SUITE_CCMP:
548 case WLAN_CIPHER_SUITE_CCMP_256:
549 ieee80211_aes_key_free(key->u.ccmp.tfm);
551 case WLAN_CIPHER_SUITE_AES_CMAC:
552 case WLAN_CIPHER_SUITE_BIP_CMAC_256:
553 ieee80211_aes_cmac_key_free(key->u.aes_cmac.tfm);
555 case WLAN_CIPHER_SUITE_BIP_GMAC_128:
556 case WLAN_CIPHER_SUITE_BIP_GMAC_256:
557 ieee80211_aes_gmac_key_free(key->u.aes_gmac.tfm);
559 case WLAN_CIPHER_SUITE_GCMP:
560 case WLAN_CIPHER_SUITE_GCMP_256:
561 ieee80211_aes_gcm_key_free(key->u.gcmp.tfm);
567 static void __ieee80211_key_destroy(struct ieee80211_key *key,
571 ieee80211_key_disable_hw_accel(key);
574 struct ieee80211_sub_if_data *sdata = key->sdata;
576 ieee80211_debugfs_key_remove(key);
578 if (delay_tailroom) {
579 /* see ieee80211_delayed_tailroom_dec */
580 sdata->crypto_tx_tailroom_pending_dec++;
581 schedule_delayed_work(&sdata->dec_tailroom_needed_wk,
584 decrease_tailroom_need_count(sdata, 1);
588 ieee80211_key_free_common(key);
591 static void ieee80211_key_destroy(struct ieee80211_key *key,
598 * Synchronize so the TX path and rcu key iterators
599 * can no longer be using this key before we free/remove it.
603 __ieee80211_key_destroy(key, delay_tailroom);
606 void ieee80211_key_free_unused(struct ieee80211_key *key)
608 WARN_ON(key->sdata || key->local);
609 ieee80211_key_free_common(key);
612 int ieee80211_key_link(struct ieee80211_key *key,
613 struct ieee80211_sub_if_data *sdata,
614 struct sta_info *sta)
616 struct ieee80211_local *local = sdata->local;
617 struct ieee80211_key *old_key;
621 pairwise = key->conf.flags & IEEE80211_KEY_FLAG_PAIRWISE;
622 idx = key->conf.keyidx;
624 mutex_lock(&sdata->local->key_mtx);
627 old_key = key_mtx_dereference(sdata->local, sta->ptk[idx]);
629 old_key = key_mtx_dereference(sdata->local, sta->gtk[idx]);
631 old_key = key_mtx_dereference(sdata->local, sdata->keys[idx]);
634 * Silently accept key re-installation without really installing the
635 * new version of the key to avoid nonce reuse or replay issues.
637 if (old_key && key->conf.keylen == old_key->conf.keylen &&
638 !memcmp(key->conf.key, old_key->conf.key, key->conf.keylen)) {
639 ieee80211_key_free_unused(key);
644 key->local = sdata->local;
648 increment_tailroom_need_count(sdata);
650 ieee80211_key_replace(sdata, sta, pairwise, old_key, key);
651 ieee80211_key_destroy(old_key, true);
653 ieee80211_debugfs_key_add(key);
655 if (!local->wowlan) {
656 ret = ieee80211_key_enable_hw_accel(key);
658 ieee80211_key_free(key, true);
664 mutex_unlock(&sdata->local->key_mtx);
669 void ieee80211_key_free(struct ieee80211_key *key, bool delay_tailroom)
675 * Replace key with nothingness if it was ever used.
678 ieee80211_key_replace(key->sdata, key->sta,
679 key->conf.flags & IEEE80211_KEY_FLAG_PAIRWISE,
681 ieee80211_key_destroy(key, delay_tailroom);
684 void ieee80211_enable_keys(struct ieee80211_sub_if_data *sdata)
686 struct ieee80211_key *key;
687 struct ieee80211_sub_if_data *vlan;
691 if (WARN_ON(!ieee80211_sdata_running(sdata)))
694 mutex_lock(&sdata->local->key_mtx);
696 WARN_ON_ONCE(sdata->crypto_tx_tailroom_needed_cnt ||
697 sdata->crypto_tx_tailroom_pending_dec);
699 if (sdata->vif.type == NL80211_IFTYPE_AP) {
700 list_for_each_entry(vlan, &sdata->u.ap.vlans, u.vlan.list)
701 WARN_ON_ONCE(vlan->crypto_tx_tailroom_needed_cnt ||
702 vlan->crypto_tx_tailroom_pending_dec);
705 list_for_each_entry(key, &sdata->key_list, list) {
706 increment_tailroom_need_count(sdata);
707 ieee80211_key_enable_hw_accel(key);
710 mutex_unlock(&sdata->local->key_mtx);
713 void ieee80211_reset_crypto_tx_tailroom(struct ieee80211_sub_if_data *sdata)
715 struct ieee80211_sub_if_data *vlan;
717 mutex_lock(&sdata->local->key_mtx);
719 sdata->crypto_tx_tailroom_needed_cnt = 0;
721 if (sdata->vif.type == NL80211_IFTYPE_AP) {
722 list_for_each_entry(vlan, &sdata->u.ap.vlans, u.vlan.list)
723 vlan->crypto_tx_tailroom_needed_cnt = 0;
726 mutex_unlock(&sdata->local->key_mtx);
729 void ieee80211_iter_keys(struct ieee80211_hw *hw,
730 struct ieee80211_vif *vif,
731 void (*iter)(struct ieee80211_hw *hw,
732 struct ieee80211_vif *vif,
733 struct ieee80211_sta *sta,
734 struct ieee80211_key_conf *key,
738 struct ieee80211_local *local = hw_to_local(hw);
739 struct ieee80211_key *key, *tmp;
740 struct ieee80211_sub_if_data *sdata;
744 mutex_lock(&local->key_mtx);
746 sdata = vif_to_sdata(vif);
747 list_for_each_entry_safe(key, tmp, &sdata->key_list, list)
748 iter(hw, &sdata->vif,
749 key->sta ? &key->sta->sta : NULL,
750 &key->conf, iter_data);
752 list_for_each_entry(sdata, &local->interfaces, list)
753 list_for_each_entry_safe(key, tmp,
754 &sdata->key_list, list)
755 iter(hw, &sdata->vif,
756 key->sta ? &key->sta->sta : NULL,
757 &key->conf, iter_data);
759 mutex_unlock(&local->key_mtx);
761 EXPORT_SYMBOL(ieee80211_iter_keys);
764 _ieee80211_iter_keys_rcu(struct ieee80211_hw *hw,
765 struct ieee80211_sub_if_data *sdata,
766 void (*iter)(struct ieee80211_hw *hw,
767 struct ieee80211_vif *vif,
768 struct ieee80211_sta *sta,
769 struct ieee80211_key_conf *key,
773 struct ieee80211_key *key;
775 list_for_each_entry_rcu(key, &sdata->key_list, list) {
776 /* skip keys of station in removal process */
777 if (key->sta && key->sta->removed)
779 if (!(key->flags & KEY_FLAG_UPLOADED_TO_HARDWARE))
782 iter(hw, &sdata->vif,
783 key->sta ? &key->sta->sta : NULL,
784 &key->conf, iter_data);
788 void ieee80211_iter_keys_rcu(struct ieee80211_hw *hw,
789 struct ieee80211_vif *vif,
790 void (*iter)(struct ieee80211_hw *hw,
791 struct ieee80211_vif *vif,
792 struct ieee80211_sta *sta,
793 struct ieee80211_key_conf *key,
797 struct ieee80211_local *local = hw_to_local(hw);
798 struct ieee80211_sub_if_data *sdata;
801 sdata = vif_to_sdata(vif);
802 _ieee80211_iter_keys_rcu(hw, sdata, iter, iter_data);
804 list_for_each_entry_rcu(sdata, &local->interfaces, list)
805 _ieee80211_iter_keys_rcu(hw, sdata, iter, iter_data);
808 EXPORT_SYMBOL(ieee80211_iter_keys_rcu);
810 static void ieee80211_free_keys_iface(struct ieee80211_sub_if_data *sdata,
811 struct list_head *keys)
813 struct ieee80211_key *key, *tmp;
815 decrease_tailroom_need_count(sdata,
816 sdata->crypto_tx_tailroom_pending_dec);
817 sdata->crypto_tx_tailroom_pending_dec = 0;
819 ieee80211_debugfs_key_remove_mgmt_default(sdata);
821 list_for_each_entry_safe(key, tmp, &sdata->key_list, list) {
822 ieee80211_key_replace(key->sdata, key->sta,
823 key->conf.flags & IEEE80211_KEY_FLAG_PAIRWISE,
825 list_add_tail(&key->list, keys);
828 ieee80211_debugfs_key_update_default(sdata);
831 void ieee80211_free_keys(struct ieee80211_sub_if_data *sdata,
832 bool force_synchronize)
834 struct ieee80211_local *local = sdata->local;
835 struct ieee80211_sub_if_data *vlan;
836 struct ieee80211_sub_if_data *master;
837 struct ieee80211_key *key, *tmp;
840 cancel_delayed_work_sync(&sdata->dec_tailroom_needed_wk);
842 mutex_lock(&local->key_mtx);
844 ieee80211_free_keys_iface(sdata, &keys);
846 if (sdata->vif.type == NL80211_IFTYPE_AP) {
847 list_for_each_entry(vlan, &sdata->u.ap.vlans, u.vlan.list)
848 ieee80211_free_keys_iface(vlan, &keys);
851 if (!list_empty(&keys) || force_synchronize)
853 list_for_each_entry_safe(key, tmp, &keys, list)
854 __ieee80211_key_destroy(key, false);
856 if (sdata->vif.type == NL80211_IFTYPE_AP_VLAN) {
858 master = container_of(sdata->bss,
859 struct ieee80211_sub_if_data,
862 WARN_ON_ONCE(sdata->crypto_tx_tailroom_needed_cnt !=
863 master->crypto_tx_tailroom_needed_cnt);
866 WARN_ON_ONCE(sdata->crypto_tx_tailroom_needed_cnt ||
867 sdata->crypto_tx_tailroom_pending_dec);
870 if (sdata->vif.type == NL80211_IFTYPE_AP) {
871 list_for_each_entry(vlan, &sdata->u.ap.vlans, u.vlan.list)
872 WARN_ON_ONCE(vlan->crypto_tx_tailroom_needed_cnt ||
873 vlan->crypto_tx_tailroom_pending_dec);
876 mutex_unlock(&local->key_mtx);
879 void ieee80211_free_sta_keys(struct ieee80211_local *local,
880 struct sta_info *sta)
882 struct ieee80211_key *key;
885 mutex_lock(&local->key_mtx);
886 for (i = 0; i < ARRAY_SIZE(sta->gtk); i++) {
887 key = key_mtx_dereference(local, sta->gtk[i]);
890 ieee80211_key_replace(key->sdata, key->sta,
891 key->conf.flags & IEEE80211_KEY_FLAG_PAIRWISE,
893 __ieee80211_key_destroy(key, true);
896 for (i = 0; i < NUM_DEFAULT_KEYS; i++) {
897 key = key_mtx_dereference(local, sta->ptk[i]);
900 ieee80211_key_replace(key->sdata, key->sta,
901 key->conf.flags & IEEE80211_KEY_FLAG_PAIRWISE,
903 __ieee80211_key_destroy(key, true);
906 mutex_unlock(&local->key_mtx);
909 void ieee80211_delayed_tailroom_dec(struct work_struct *wk)
911 struct ieee80211_sub_if_data *sdata;
913 sdata = container_of(wk, struct ieee80211_sub_if_data,
914 dec_tailroom_needed_wk.work);
917 * The reason for the delayed tailroom needed decrementing is to
918 * make roaming faster: during roaming, all keys are first deleted
919 * and then new keys are installed. The first new key causes the
920 * crypto_tx_tailroom_needed_cnt to go from 0 to 1, which invokes
921 * the cost of synchronize_net() (which can be slow). Avoid this
922 * by deferring the crypto_tx_tailroom_needed_cnt decrementing on
923 * key removal for a while, so if we roam the value is larger than
924 * zero and no 0->1 transition happens.
926 * The cost is that if the AP switching was from an AP with keys
927 * to one without, we still allocate tailroom while it would no
928 * longer be needed. However, in the typical (fast) roaming case
929 * within an ESS this usually won't happen.
932 mutex_lock(&sdata->local->key_mtx);
933 decrease_tailroom_need_count(sdata,
934 sdata->crypto_tx_tailroom_pending_dec);
935 sdata->crypto_tx_tailroom_pending_dec = 0;
936 mutex_unlock(&sdata->local->key_mtx);
939 void ieee80211_gtk_rekey_notify(struct ieee80211_vif *vif, const u8 *bssid,
940 const u8 *replay_ctr, gfp_t gfp)
942 struct ieee80211_sub_if_data *sdata = vif_to_sdata(vif);
944 trace_api_gtk_rekey_notify(sdata, bssid, replay_ctr);
946 cfg80211_gtk_rekey_notify(sdata->dev, bssid, replay_ctr, gfp);
948 EXPORT_SYMBOL_GPL(ieee80211_gtk_rekey_notify);
950 void ieee80211_get_key_rx_seq(struct ieee80211_key_conf *keyconf,
951 int tid, struct ieee80211_key_seq *seq)
953 struct ieee80211_key *key;
956 key = container_of(keyconf, struct ieee80211_key, conf);
958 switch (key->conf.cipher) {
959 case WLAN_CIPHER_SUITE_TKIP:
960 if (WARN_ON(tid < 0 || tid >= IEEE80211_NUM_TIDS))
962 seq->tkip.iv32 = key->u.tkip.rx[tid].iv32;
963 seq->tkip.iv16 = key->u.tkip.rx[tid].iv16;
965 case WLAN_CIPHER_SUITE_CCMP:
966 case WLAN_CIPHER_SUITE_CCMP_256:
967 if (WARN_ON(tid < -1 || tid >= IEEE80211_NUM_TIDS))
970 pn = key->u.ccmp.rx_pn[IEEE80211_NUM_TIDS];
972 pn = key->u.ccmp.rx_pn[tid];
973 memcpy(seq->ccmp.pn, pn, IEEE80211_CCMP_PN_LEN);
975 case WLAN_CIPHER_SUITE_AES_CMAC:
976 case WLAN_CIPHER_SUITE_BIP_CMAC_256:
977 if (WARN_ON(tid != 0))
979 pn = key->u.aes_cmac.rx_pn;
980 memcpy(seq->aes_cmac.pn, pn, IEEE80211_CMAC_PN_LEN);
982 case WLAN_CIPHER_SUITE_BIP_GMAC_128:
983 case WLAN_CIPHER_SUITE_BIP_GMAC_256:
984 if (WARN_ON(tid != 0))
986 pn = key->u.aes_gmac.rx_pn;
987 memcpy(seq->aes_gmac.pn, pn, IEEE80211_GMAC_PN_LEN);
989 case WLAN_CIPHER_SUITE_GCMP:
990 case WLAN_CIPHER_SUITE_GCMP_256:
991 if (WARN_ON(tid < -1 || tid >= IEEE80211_NUM_TIDS))
994 pn = key->u.gcmp.rx_pn[IEEE80211_NUM_TIDS];
996 pn = key->u.gcmp.rx_pn[tid];
997 memcpy(seq->gcmp.pn, pn, IEEE80211_GCMP_PN_LEN);
1001 EXPORT_SYMBOL(ieee80211_get_key_rx_seq);
1003 void ieee80211_set_key_rx_seq(struct ieee80211_key_conf *keyconf,
1004 int tid, struct ieee80211_key_seq *seq)
1006 struct ieee80211_key *key;
1009 key = container_of(keyconf, struct ieee80211_key, conf);
1011 switch (key->conf.cipher) {
1012 case WLAN_CIPHER_SUITE_TKIP:
1013 if (WARN_ON(tid < 0 || tid >= IEEE80211_NUM_TIDS))
1015 key->u.tkip.rx[tid].iv32 = seq->tkip.iv32;
1016 key->u.tkip.rx[tid].iv16 = seq->tkip.iv16;
1018 case WLAN_CIPHER_SUITE_CCMP:
1019 case WLAN_CIPHER_SUITE_CCMP_256:
1020 if (WARN_ON(tid < -1 || tid >= IEEE80211_NUM_TIDS))
1023 pn = key->u.ccmp.rx_pn[IEEE80211_NUM_TIDS];
1025 pn = key->u.ccmp.rx_pn[tid];
1026 memcpy(pn, seq->ccmp.pn, IEEE80211_CCMP_PN_LEN);
1028 case WLAN_CIPHER_SUITE_AES_CMAC:
1029 case WLAN_CIPHER_SUITE_BIP_CMAC_256:
1030 if (WARN_ON(tid != 0))
1032 pn = key->u.aes_cmac.rx_pn;
1033 memcpy(pn, seq->aes_cmac.pn, IEEE80211_CMAC_PN_LEN);
1035 case WLAN_CIPHER_SUITE_BIP_GMAC_128:
1036 case WLAN_CIPHER_SUITE_BIP_GMAC_256:
1037 if (WARN_ON(tid != 0))
1039 pn = key->u.aes_gmac.rx_pn;
1040 memcpy(pn, seq->aes_gmac.pn, IEEE80211_GMAC_PN_LEN);
1042 case WLAN_CIPHER_SUITE_GCMP:
1043 case WLAN_CIPHER_SUITE_GCMP_256:
1044 if (WARN_ON(tid < -1 || tid >= IEEE80211_NUM_TIDS))
1047 pn = key->u.gcmp.rx_pn[IEEE80211_NUM_TIDS];
1049 pn = key->u.gcmp.rx_pn[tid];
1050 memcpy(pn, seq->gcmp.pn, IEEE80211_GCMP_PN_LEN);
1057 EXPORT_SYMBOL_GPL(ieee80211_set_key_rx_seq);
1059 void ieee80211_remove_key(struct ieee80211_key_conf *keyconf)
1061 struct ieee80211_key *key;
1063 key = container_of(keyconf, struct ieee80211_key, conf);
1065 assert_key_lock(key->local);
1068 * if key was uploaded, we assume the driver will/has remove(d)
1069 * it, so adjust bookkeeping accordingly
1071 if (key->flags & KEY_FLAG_UPLOADED_TO_HARDWARE) {
1072 key->flags &= ~KEY_FLAG_UPLOADED_TO_HARDWARE;
1074 if (!((key->conf.flags & IEEE80211_KEY_FLAG_GENERATE_MMIC) ||
1075 (key->conf.flags & IEEE80211_KEY_FLAG_RESERVE_TAILROOM)))
1076 increment_tailroom_need_count(key->sdata);
1079 ieee80211_key_free(key, false);
1081 EXPORT_SYMBOL_GPL(ieee80211_remove_key);
1083 struct ieee80211_key_conf *
1084 ieee80211_gtk_rekey_add(struct ieee80211_vif *vif,
1085 struct ieee80211_key_conf *keyconf)
1087 struct ieee80211_sub_if_data *sdata = vif_to_sdata(vif);
1088 struct ieee80211_local *local = sdata->local;
1089 struct ieee80211_key *key;
1092 if (WARN_ON(!local->wowlan))
1093 return ERR_PTR(-EINVAL);
1095 if (WARN_ON(vif->type != NL80211_IFTYPE_STATION))
1096 return ERR_PTR(-EINVAL);
1098 key = ieee80211_key_alloc(keyconf->cipher, keyconf->keyidx,
1099 keyconf->keylen, keyconf->key,
1102 return ERR_CAST(key);
1104 if (sdata->u.mgd.mfp != IEEE80211_MFP_DISABLED)
1105 key->conf.flags |= IEEE80211_KEY_FLAG_RX_MGMT;
1107 err = ieee80211_key_link(key, sdata, NULL);
1109 return ERR_PTR(err);
1113 EXPORT_SYMBOL_GPL(ieee80211_gtk_rekey_add);