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>
20 * struct ieee80211_key::key is encoded as a 256-bit (32 byte) data block:
21 * Temporal Encryption Key (128 bits)
22 * Temporal Authenticator Tx MIC Key (64 bits)
23 * Temporal Authenticator Rx MIC Key (64 bits)
29 #define ALG_TKIP_KEY_LEN 32
30 /* Starting offsets for each key */
31 #define ALG_TKIP_TEMP_ENCR_KEY 0
32 #define ALG_TKIP_TEMP_AUTH_TX_MIC_KEY 16
33 #define ALG_TKIP_TEMP_AUTH_RX_MIC_KEY 24
35 #define TKIP_ICV_LEN 4
37 #define ALG_CCMP_KEY_LEN 16
38 #define CCMP_HDR_LEN 8
39 #define CCMP_MIC_LEN 8
40 #define CCMP_TK_LEN 16
43 #define NUM_RX_DATA_QUEUES 17
45 struct ieee80211_local;
46 struct ieee80211_sub_if_data;
50 * enum ieee80211_internal_key_flags - internal key flags
52 * @KEY_FLAG_UPLOADED_TO_HARDWARE: Indicates that this key is present
53 * in the hardware for TX crypto hardware acceleration.
54 * @KEY_FLAG_REMOVE_FROM_HARDWARE: Indicates to the key code that this
55 * key is present in the hardware (but it cannot be used for
56 * hardware acceleration any more!)
58 enum ieee80211_internal_key_flags {
59 KEY_FLAG_UPLOADED_TO_HARDWARE = BIT(0),
60 KEY_FLAG_REMOVE_FROM_HARDWARE = BIT(1),
63 struct ieee80211_key {
64 struct ieee80211_local *local;
65 struct ieee80211_sub_if_data *sdata;
68 struct list_head list;
80 /* last received RSC */
81 u32 iv32_rx[NUM_RX_DATA_QUEUES];
82 u16 iv16_rx[NUM_RX_DATA_QUEUES];
83 u16 p1k_rx[NUM_RX_DATA_QUEUES][5];
84 int rx_initialized[NUM_RX_DATA_QUEUES];
88 u8 rx_pn[NUM_RX_DATA_QUEUES][6];
89 struct crypto_cipher *tfm;
90 u32 replays; /* dot11RSNAStatsCCMPReplays */
91 /* scratch buffers for virt_to_page() (crypto API) */
93 #define AES_BLOCK_LEN 16
95 u8 tx_crypto_buf[6 * AES_BLOCK_LEN];
96 u8 rx_crypto_buf[6 * AES_BLOCK_LEN];
100 /* number of times this key has been used */
103 #ifdef CONFIG_MAC80211_DEBUGFS
105 struct dentry *stalink;
107 struct dentry *keylen;
108 struct dentry *flags;
109 struct dentry *keyidx;
110 struct dentry *hw_key_idx;
111 struct dentry *tx_rx_count;
112 struct dentry *algorithm;
113 struct dentry *tx_spec;
114 struct dentry *rx_spec;
115 struct dentry *replays;
117 struct dentry *ifindex;
122 * key config, must be last because it contains key
123 * material as variable length member
125 struct ieee80211_key_conf conf;
128 struct ieee80211_key *ieee80211_key_alloc(enum ieee80211_key_alg alg,
133 * Insert a key into data structures (sdata, sta if necessary)
134 * to make it used, free old key.
136 void ieee80211_key_link(struct ieee80211_key *key,
137 struct ieee80211_sub_if_data *sdata,
138 struct sta_info *sta);
139 void ieee80211_key_free(struct ieee80211_key *key);
140 void ieee80211_set_default_key(struct ieee80211_sub_if_data *sdata, int idx);
141 void ieee80211_free_keys(struct ieee80211_sub_if_data *sdata);
142 void ieee80211_enable_keys(struct ieee80211_sub_if_data *sdata);
143 void ieee80211_disable_keys(struct ieee80211_sub_if_data *sdata);
145 #endif /* IEEE80211_KEY_H */