2 * Copyright 2002-2004, Instant802 Networks, Inc.
3 * Copyright 2005, Devicescape Software, Inc.
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.
10 #ifndef IEEE80211_KEY_H
11 #define IEEE80211_KEY_H
13 #include <linux/types.h>
14 #include <linux/list.h>
15 #include <linux/crypto.h>
16 #include <linux/rcupdate.h>
17 #include <net/mac80211.h>
21 #define ALG_TKIP_KEY_LEN 32
22 #define ALG_CCMP_KEY_LEN 16
23 #define CCMP_HDR_LEN 8
24 #define CCMP_MIC_LEN 8
25 #define CCMP_TK_LEN 16
28 #define TKIP_ICV_LEN 4
30 #define NUM_RX_DATA_QUEUES 17
32 struct ieee80211_local;
33 struct ieee80211_sub_if_data;
37 * enum ieee80211_internal_key_flags - internal key flags
39 * @KEY_FLAG_UPLOADED_TO_HARDWARE: Indicates that this key is present
40 * in the hardware for TX crypto hardware acceleration.
41 * @KEY_FLAG_TODO_DELETE: Key is marked for deletion and will, after an
42 * RCU grace period, no longer be reachable other than from the
44 * @KEY_FLAG_TODO_HWACCEL_ADD: Key needs to be added to hardware acceleration.
45 * @KEY_FLAG_TODO_HWACCEL_REMOVE: Key needs to be removed from hardware
47 * @KEY_FLAG_TODO_DEFKEY: Key is default key and debugfs needs to be updated.
48 * @KEY_FLAG_TODO_ADD_DEBUGFS: Key needs to be added to debugfs.
49 * @KEY_FLAG_TODO_DEFMGMTKEY: Key is default management key and debugfs needs
52 enum ieee80211_internal_key_flags {
53 KEY_FLAG_UPLOADED_TO_HARDWARE = BIT(0),
54 KEY_FLAG_TODO_DELETE = BIT(1),
55 KEY_FLAG_TODO_HWACCEL_ADD = BIT(2),
56 KEY_FLAG_TODO_HWACCEL_REMOVE = BIT(3),
57 KEY_FLAG_TODO_DEFKEY = BIT(4),
58 KEY_FLAG_TODO_ADD_DEBUGFS = BIT(5),
59 KEY_FLAG_TODO_DEFMGMTKEY = BIT(6),
69 struct ieee80211_key {
70 struct ieee80211_local *local;
71 struct ieee80211_sub_if_data *sdata;
75 struct list_head list;
77 struct list_head todo;
79 /* protected by todo lock! */
87 /* last received RSC */
88 struct tkip_ctx rx[NUM_RX_DATA_QUEUES];
92 u8 rx_pn[NUM_RX_DATA_QUEUES][6];
93 struct crypto_cipher *tfm;
94 u32 replays; /* dot11RSNAStatsCCMPReplays */
95 /* scratch buffers for virt_to_page() (crypto API) */
97 #define AES_BLOCK_LEN 16
99 u8 tx_crypto_buf[6 * AES_BLOCK_LEN];
100 u8 rx_crypto_buf[6 * AES_BLOCK_LEN];
105 struct crypto_cipher *tfm;
106 u32 replays; /* dot11RSNAStatsCMACReplays */
107 u32 icverrors; /* dot11RSNAStatsCMACICVErrors */
108 /* scratch buffers for virt_to_page() (crypto API) */
109 u8 tx_crypto_buf[2 * AES_BLOCK_LEN];
110 u8 rx_crypto_buf[2 * AES_BLOCK_LEN];
114 /* number of times this key has been used */
117 #ifdef CONFIG_MAC80211_DEBUGFS
119 struct dentry *stalink;
121 struct dentry *keylen;
122 struct dentry *flags;
123 struct dentry *keyidx;
124 struct dentry *hw_key_idx;
125 struct dentry *tx_rx_count;
126 struct dentry *algorithm;
127 struct dentry *tx_spec;
128 struct dentry *rx_spec;
129 struct dentry *replays;
130 struct dentry *icverrors;
132 struct dentry *ifindex;
138 * key config, must be last because it contains key
139 * material as variable length member
141 struct ieee80211_key_conf conf;
144 struct ieee80211_key *ieee80211_key_alloc(enum ieee80211_key_alg alg,
148 size_t seq_len, const u8 *seq);
150 * Insert a key into data structures (sdata, sta if necessary)
151 * to make it used, free old key.
153 void ieee80211_key_link(struct ieee80211_key *key,
154 struct ieee80211_sub_if_data *sdata,
155 struct sta_info *sta);
156 void ieee80211_key_free(struct ieee80211_key *key);
157 void ieee80211_set_default_key(struct ieee80211_sub_if_data *sdata, int idx);
158 void ieee80211_set_default_mgmt_key(struct ieee80211_sub_if_data *sdata,
160 void ieee80211_free_keys(struct ieee80211_sub_if_data *sdata);
161 void ieee80211_enable_keys(struct ieee80211_sub_if_data *sdata);
162 void ieee80211_disable_keys(struct ieee80211_sub_if_data *sdata);
164 void ieee80211_key_todo(void);
166 #endif /* IEEE80211_KEY_H */