blob: f52c3df1fe9ae38795a1f8d6c99d874a819a785b [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
19/* ALG_TKIP
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)
24 */
25
26#define WEP_IV_LEN 4
27#define WEP_ICV_LEN 4
28
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
34#define TKIP_IV_LEN 8
35#define TKIP_ICV_LEN 4
36
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
41#define CCMP_PN_LEN 6
42
43#define NUM_RX_DATA_QUEUES 17
44
Johannes Berg11a843b2007-08-28 17:01:55 -040045struct ieee80211_local;
46struct ieee80211_sub_if_data;
47struct sta_info;
48
Johannes Bergdb4d1162008-02-25 16:27:45 +010049/**
50 * enum ieee80211_internal_key_flags - internal key flags
51 *
52 * @KEY_FLAG_UPLOADED_TO_HARDWARE: Indicates that this key is present
53 * in the hardware for TX crypto hardware acceleration.
Johannes Berg3b967662008-04-08 17:56:52 +020054 * @KEY_FLAG_TODO_DELETE: Key is marked for deletion and will, after an
55 * RCU grace period, no longer be reachable other than from the
56 * todo list.
Johannes Berg3a245762008-04-09 16:45:37 +020057 * @KEY_FLAG_TODO_HWACCEL_ADD: Key needs to be added to hardware acceleration.
58 * @KEY_FLAG_TODO_HWACCEL_REMOVE: Key needs to be removed from hardware
59 * acceleration.
Johannes Berg3b967662008-04-08 17:56:52 +020060 * @KEY_FLAG_TODO_DEFKEY: Key is default key and debugfs needs to be updated.
61 * @KEY_FLAG_TODO_ADD_DEBUGFS: Key needs to be added to debugfs.
Johannes Bergdb4d1162008-02-25 16:27:45 +010062 */
63enum ieee80211_internal_key_flags {
64 KEY_FLAG_UPLOADED_TO_HARDWARE = BIT(0),
Johannes Berg3b967662008-04-08 17:56:52 +020065 KEY_FLAG_TODO_DELETE = BIT(1),
Johannes Berg3a245762008-04-09 16:45:37 +020066 KEY_FLAG_TODO_HWACCEL_ADD = BIT(2),
67 KEY_FLAG_TODO_HWACCEL_REMOVE = BIT(3),
68 KEY_FLAG_TODO_DEFKEY = BIT(4),
69 KEY_FLAG_TODO_ADD_DEBUGFS = BIT(5),
Johannes Bergdb4d1162008-02-25 16:27:45 +010070};
Johannes Berg11a843b2007-08-28 17:01:55 -040071
Jiri Bencf0706e82007-05-05 11:45:53 -070072struct ieee80211_key {
Johannes Berg11a843b2007-08-28 17:01:55 -040073 struct ieee80211_local *local;
74 struct ieee80211_sub_if_data *sdata;
75 struct sta_info *sta;
76
Johannes Berg3b967662008-04-08 17:56:52 +020077 /* for sdata list */
Johannes Berg11a843b2007-08-28 17:01:55 -040078 struct list_head list;
Johannes Berg3b967662008-04-08 17:56:52 +020079 /* for todo list */
80 struct list_head todo;
Johannes Berg11a843b2007-08-28 17:01:55 -040081
Johannes Berg3b967662008-04-08 17:56:52 +020082 /* protected by todo lock! */
Johannes Berg11a843b2007-08-28 17:01:55 -040083 unsigned int flags;
84
Jiri Bencf0706e82007-05-05 11:45:53 -070085 union {
86 struct {
87 /* last used TSC */
88 u32 iv32;
89 u16 iv16;
90 u16 p1k[5];
91 int tx_initialized;
92
93 /* last received RSC */
94 u32 iv32_rx[NUM_RX_DATA_QUEUES];
95 u16 iv16_rx[NUM_RX_DATA_QUEUES];
96 u16 p1k_rx[NUM_RX_DATA_QUEUES][5];
97 int rx_initialized[NUM_RX_DATA_QUEUES];
98 } tkip;
99 struct {
100 u8 tx_pn[6];
101 u8 rx_pn[NUM_RX_DATA_QUEUES][6];
102 struct crypto_cipher *tfm;
103 u32 replays; /* dot11RSNAStatsCCMPReplays */
104 /* scratch buffers for virt_to_page() (crypto API) */
105#ifndef AES_BLOCK_LEN
106#define AES_BLOCK_LEN 16
107#endif
108 u8 tx_crypto_buf[6 * AES_BLOCK_LEN];
109 u8 rx_crypto_buf[6 * AES_BLOCK_LEN];
110 } ccmp;
111 } u;
Jiri Bencf0706e82007-05-05 11:45:53 -0700112
Johannes Berg8f20fc22007-08-28 17:01:54 -0400113 /* number of times this key has been used */
114 int tx_rx_count;
Jiri Bencf0706e82007-05-05 11:45:53 -0700115
Jiri Bence9f207f2007-05-05 11:46:38 -0700116#ifdef CONFIG_MAC80211_DEBUGFS
117 struct {
118 struct dentry *stalink;
119 struct dentry *dir;
120 struct dentry *keylen;
Johannes Berg8f20fc22007-08-28 17:01:54 -0400121 struct dentry *flags;
Jiri Bence9f207f2007-05-05 11:46:38 -0700122 struct dentry *keyidx;
123 struct dentry *hw_key_idx;
124 struct dentry *tx_rx_count;
125 struct dentry *algorithm;
126 struct dentry *tx_spec;
127 struct dentry *rx_spec;
128 struct dentry *replays;
129 struct dentry *key;
Johannes Berge7a64f12007-08-28 17:01:55 -0400130 struct dentry *ifindex;
Johannes Bergd9c58f32008-04-08 16:46:36 -0400131 int cnt;
Jiri Bence9f207f2007-05-05 11:46:38 -0700132 } debugfs;
133#endif
134
Johannes Berg8f20fc22007-08-28 17:01:54 -0400135 /*
136 * key config, must be last because it contains key
137 * material as variable length member
138 */
139 struct ieee80211_key_conf conf;
Jiri Bencf0706e82007-05-05 11:45:53 -0700140};
141
Johannes Bergdb4d1162008-02-25 16:27:45 +0100142struct ieee80211_key *ieee80211_key_alloc(enum ieee80211_key_alg alg,
Johannes Berg11a843b2007-08-28 17:01:55 -0400143 int idx,
144 size_t key_len,
145 const u8 *key_data);
Johannes Bergdb4d1162008-02-25 16:27:45 +0100146/*
147 * Insert a key into data structures (sdata, sta if necessary)
148 * to make it used, free old key.
149 */
150void ieee80211_key_link(struct ieee80211_key *key,
151 struct ieee80211_sub_if_data *sdata,
152 struct sta_info *sta);
Johannes Berg11a843b2007-08-28 17:01:55 -0400153void ieee80211_key_free(struct ieee80211_key *key);
154void ieee80211_set_default_key(struct ieee80211_sub_if_data *sdata, int idx);
155void ieee80211_free_keys(struct ieee80211_sub_if_data *sdata);
156void ieee80211_enable_keys(struct ieee80211_sub_if_data *sdata);
157void ieee80211_disable_keys(struct ieee80211_sub_if_data *sdata);
158
Johannes Berg3b967662008-04-08 17:56:52 +0200159void ieee80211_key_todo(void);
160
Jiri Bencf0706e82007-05-05 11:45:53 -0700161#endif /* IEEE80211_KEY_H */