blob: 382dc44ed330a9921764431bc88345728b0eab49 [file] [log] [blame]
Jiri Bencf0706e82007-05-05 11:45:53 -07001/*
2 * Copyright 2002-2004, Instant802 Networks, Inc.
3 * Copyright 2005, Devicescape Software, Inc.
4 *
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License version 2 as
7 * published by the Free Software Foundation.
8 */
9
10#ifndef IEEE80211_KEY_H
11#define IEEE80211_KEY_H
12
13#include <linux/types.h>
Johannes Berg8f371712007-08-28 17:01:54 -040014#include <linux/list.h>
Jiri Bencf0706e82007-05-05 11:45:53 -070015#include <linux/crypto.h>
Johannes Bergdb4d1162008-02-25 16:27:45 +010016#include <linux/rcupdate.h>
Jiri Bencf0706e82007-05-05 11:45:53 -070017#include <net/mac80211.h>
18
Johannes Berge31b8212010-10-05 19:39:30 +020019#define NUM_DEFAULT_KEYS 4
20#define NUM_DEFAULT_MGMT_KEYS 2
21
Luis R. Rodriguezffd78912008-06-21 10:02:46 -040022#define WEP_IV_LEN 4
23#define WEP_ICV_LEN 4
Luis R. Rodriguezffd78912008-06-21 10:02:46 -040024#define ALG_CCMP_KEY_LEN 16
25#define CCMP_HDR_LEN 8
26#define CCMP_MIC_LEN 8
27#define CCMP_TK_LEN 16
28#define CCMP_PN_LEN 6
29#define TKIP_IV_LEN 8
30#define TKIP_ICV_LEN 4
Johannes Berg3ea542d2011-07-07 18:58:00 +020031#define CMAC_PN_LEN 6
Jiri Bencf0706e82007-05-05 11:45:53 -070032
Johannes Berg11a843b2007-08-28 17:01:55 -040033struct ieee80211_local;
34struct ieee80211_sub_if_data;
35struct sta_info;
36
Johannes Bergdb4d1162008-02-25 16:27:45 +010037/**
38 * enum ieee80211_internal_key_flags - internal key flags
39 *
40 * @KEY_FLAG_UPLOADED_TO_HARDWARE: Indicates that this key is present
41 * in the hardware for TX crypto hardware acceleration.
Johannes Berg95acac62011-07-12 12:30:59 +020042 * @KEY_FLAG_TAINTED: Key is tainted and packets should be dropped.
Johannes Bergdb4d1162008-02-25 16:27:45 +010043 */
44enum ieee80211_internal_key_flags {
45 KEY_FLAG_UPLOADED_TO_HARDWARE = BIT(0),
Johannes Berg95acac62011-07-12 12:30:59 +020046 KEY_FLAG_TAINTED = BIT(1),
Johannes Bergdb4d1162008-02-25 16:27:45 +010047};
Johannes Berg11a843b2007-08-28 17:01:55 -040048
gregor kowskica998612009-12-09 23:25:05 +010049enum ieee80211_internal_tkip_state {
50 TKIP_STATE_NOT_INIT,
51 TKIP_STATE_PHASE1_DONE,
52 TKIP_STATE_PHASE1_HW_UPLOADED,
53};
54
Harvey Harrisonb0f76b32008-05-14 16:26:19 -070055struct tkip_ctx {
Johannes Berg523b02e2011-07-07 22:28:01 +020056 u32 iv32; /* current iv32 */
57 u16 iv16; /* current iv16 */
58 u16 p1k[5]; /* p1k cache */
59 u32 p1k_iv32; /* iv32 for which p1k computed */
gregor kowskica998612009-12-09 23:25:05 +010060 enum ieee80211_internal_tkip_state state;
Harvey Harrisonb0f76b32008-05-14 16:26:19 -070061};
62
Jiri Bencf0706e82007-05-05 11:45:53 -070063struct ieee80211_key {
Johannes Berg11a843b2007-08-28 17:01:55 -040064 struct ieee80211_local *local;
65 struct ieee80211_sub_if_data *sdata;
66 struct sta_info *sta;
67
Johannes Berg3b967662008-04-08 17:56:52 +020068 /* for sdata list */
Johannes Berg11a843b2007-08-28 17:01:55 -040069 struct list_head list;
70
Johannes Bergad0e2b52010-06-01 10:19:19 +020071 /* protected by key mutex */
Johannes Berg11a843b2007-08-28 17:01:55 -040072 unsigned int flags;
73
Jiri Bencf0706e82007-05-05 11:45:53 -070074 union {
75 struct {
Johannes Berg523b02e2011-07-07 22:28:01 +020076 /* protects tx context */
77 spinlock_t txlock;
78
Jiri Bencf0706e82007-05-05 11:45:53 -070079 /* last used TSC */
Harvey Harrisonb0f76b32008-05-14 16:26:19 -070080 struct tkip_ctx tx;
Jiri Bencf0706e82007-05-05 11:45:53 -070081
82 /* last received RSC */
Johannes Berg5a306f52012-11-14 23:22:21 +010083 struct tkip_ctx rx[IEEE80211_NUM_TIDS];
Saravanab98ea052012-12-04 19:47:42 +053084
85 /* number of mic failures */
86 u32 mic_failures;
Jiri Bencf0706e82007-05-05 11:45:53 -070087 } tkip;
88 struct {
Johannes Bergaba83a0b2011-07-06 21:59:39 +020089 atomic64_t tx_pn;
Jouni Malinen91902522010-06-11 10:27:33 -070090 /*
91 * Last received packet number. The first
Johannes Berg5a306f52012-11-14 23:22:21 +010092 * IEEE80211_NUM_TIDS counters are used with Data
Jouni Malinen91902522010-06-11 10:27:33 -070093 * frames and the last counter is used with Robust
94 * Management frames.
95 */
Johannes Berg5a306f52012-11-14 23:22:21 +010096 u8 rx_pn[IEEE80211_NUM_TIDS + 1][CCMP_PN_LEN];
Jiri Bencf0706e82007-05-05 11:45:53 -070097 struct crypto_cipher *tfm;
98 u32 replays; /* dot11RSNAStatsCCMPReplays */
Jiri Bencf0706e82007-05-05 11:45:53 -070099 } ccmp;
Jouni Malinen765cb462009-01-08 13:32:01 +0200100 struct {
Johannes Berg75396ae2011-07-06 22:00:35 +0200101 atomic64_t tx_pn;
Johannes Berg3ea542d2011-07-07 18:58:00 +0200102 u8 rx_pn[CMAC_PN_LEN];
Jouni Malinen765cb462009-01-08 13:32:01 +0200103 struct crypto_cipher *tfm;
104 u32 replays; /* dot11RSNAStatsCMACReplays */
105 u32 icverrors; /* dot11RSNAStatsCMACICVErrors */
Jouni Malinen765cb462009-01-08 13:32:01 +0200106 } aes_cmac;
Jiri Bencf0706e82007-05-05 11:45:53 -0700107 } u;
Jiri Bencf0706e82007-05-05 11:45:53 -0700108
Johannes Berg8f20fc22007-08-28 17:01:54 -0400109 /* number of times this key has been used */
110 int tx_rx_count;
Jiri Bencf0706e82007-05-05 11:45:53 -0700111
Jiri Bence9f207f2007-05-05 11:46:38 -0700112#ifdef CONFIG_MAC80211_DEBUGFS
113 struct {
114 struct dentry *stalink;
115 struct dentry *dir;
Johannes Bergd9c58f32008-04-08 16:46:36 -0400116 int cnt;
Jiri Bence9f207f2007-05-05 11:46:38 -0700117 } debugfs;
118#endif
119
Johannes Berg8f20fc22007-08-28 17:01:54 -0400120 /*
121 * key config, must be last because it contains key
122 * material as variable length member
123 */
124 struct ieee80211_key_conf conf;
Jiri Bencf0706e82007-05-05 11:45:53 -0700125};
126
Johannes Berg97359d12010-08-10 09:46:38 +0200127struct ieee80211_key *ieee80211_key_alloc(u32 cipher, int idx, size_t key_len,
Jouni Malinenfaa8fdc2009-05-11 21:57:58 +0300128 const u8 *key_data,
129 size_t seq_len, const u8 *seq);
Johannes Bergdb4d1162008-02-25 16:27:45 +0100130/*
131 * Insert a key into data structures (sdata, sta if necessary)
132 * to make it used, free old key.
133 */
Johannes Berg3ffc2a92010-08-27 14:26:52 +0300134int __must_check ieee80211_key_link(struct ieee80211_key *key,
135 struct ieee80211_sub_if_data *sdata,
136 struct sta_info *sta);
Johannes Berg5c0c3642011-05-12 14:31:49 +0200137void __ieee80211_key_free(struct ieee80211_key *key);
Jouni Malinen32162a42010-07-26 15:52:03 -0700138void ieee80211_key_free(struct ieee80211_local *local,
139 struct ieee80211_key *key);
Johannes Bergf7e01042010-12-09 19:49:02 +0100140void ieee80211_set_default_key(struct ieee80211_sub_if_data *sdata, int idx,
141 bool uni, bool multi);
Jouni Malinen3cfcf6ac2009-01-08 13:32:02 +0200142void ieee80211_set_default_mgmt_key(struct ieee80211_sub_if_data *sdata,
143 int idx);
Johannes Berg11a843b2007-08-28 17:01:55 -0400144void ieee80211_free_keys(struct ieee80211_sub_if_data *sdata);
145void ieee80211_enable_keys(struct ieee80211_sub_if_data *sdata);
146void ieee80211_disable_keys(struct ieee80211_sub_if_data *sdata);
147
Johannes Berg40b275b2011-05-13 14:15:49 +0200148#define key_mtx_dereference(local, ref) \
149 rcu_dereference_protected(ref, lockdep_is_held(&((local)->key_mtx)))
150
Jiri Bencf0706e82007-05-05 11:45:53 -0700151#endif /* IEEE80211_KEY_H */