blob: 9572e00f532cc670696efb07088a6d0731e2ac17 [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
Luis R. Rodriguezffd78912008-06-21 10:02:46 -040019#define WEP_IV_LEN 4
20#define WEP_ICV_LEN 4
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
26#define CCMP_PN_LEN 6
27#define TKIP_IV_LEN 8
28#define TKIP_ICV_LEN 4
Jiri Bencf0706e82007-05-05 11:45:53 -070029
Luis R. Rodriguezffd78912008-06-21 10:02:46 -040030#define NUM_RX_DATA_QUEUES 17
Jiri Bencf0706e82007-05-05 11:45:53 -070031
Johannes Berg11a843b2007-08-28 17:01:55 -040032struct ieee80211_local;
33struct ieee80211_sub_if_data;
34struct sta_info;
35
Johannes Bergdb4d1162008-02-25 16:27:45 +010036/**
37 * enum ieee80211_internal_key_flags - internal key flags
38 *
39 * @KEY_FLAG_UPLOADED_TO_HARDWARE: Indicates that this key is present
40 * in the hardware for TX crypto hardware acceleration.
Johannes Berg3b967662008-04-08 17:56:52 +020041 * @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
43 * todo list.
Johannes Berg3a245762008-04-09 16:45:37 +020044 * @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
46 * acceleration.
Johannes Berg3b967662008-04-08 17:56:52 +020047 * @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.
Jouni Malinen3cfcf6ac2009-01-08 13:32:02 +020049 * @KEY_FLAG_TODO_DEFMGMTKEY: Key is default management key and debugfs needs
50 * to be updated.
Johannes Bergdb4d1162008-02-25 16:27:45 +010051 */
52enum ieee80211_internal_key_flags {
53 KEY_FLAG_UPLOADED_TO_HARDWARE = BIT(0),
Johannes Berg3b967662008-04-08 17:56:52 +020054 KEY_FLAG_TODO_DELETE = BIT(1),
Johannes Berg3a245762008-04-09 16:45:37 +020055 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),
Jouni Malinen3cfcf6ac2009-01-08 13:32:02 +020059 KEY_FLAG_TODO_DEFMGMTKEY = BIT(6),
Johannes Bergdb4d1162008-02-25 16:27:45 +010060};
Johannes Berg11a843b2007-08-28 17:01:55 -040061
Harvey Harrisonb0f76b32008-05-14 16:26:19 -070062struct tkip_ctx {
63 u32 iv32;
64 u16 iv16;
65 u16 p1k[5];
66 int initialized;
67};
68
Jiri Bencf0706e82007-05-05 11:45:53 -070069struct ieee80211_key {
Johannes Berg11a843b2007-08-28 17:01:55 -040070 struct ieee80211_local *local;
71 struct ieee80211_sub_if_data *sdata;
72 struct sta_info *sta;
73
Johannes Berg3b967662008-04-08 17:56:52 +020074 /* for sdata list */
Johannes Berg11a843b2007-08-28 17:01:55 -040075 struct list_head list;
Johannes Berg3b967662008-04-08 17:56:52 +020076 /* for todo list */
77 struct list_head todo;
Johannes Berg11a843b2007-08-28 17:01:55 -040078
Johannes Berg3b967662008-04-08 17:56:52 +020079 /* protected by todo lock! */
Johannes Berg11a843b2007-08-28 17:01:55 -040080 unsigned int flags;
81
Jiri Bencf0706e82007-05-05 11:45:53 -070082 union {
83 struct {
84 /* last used TSC */
Harvey Harrisonb0f76b32008-05-14 16:26:19 -070085 struct tkip_ctx tx;
Jiri Bencf0706e82007-05-05 11:45:53 -070086
87 /* last received RSC */
Harvey Harrisonb0f76b32008-05-14 16:26:19 -070088 struct tkip_ctx rx[NUM_RX_DATA_QUEUES];
Jiri Bencf0706e82007-05-05 11:45:53 -070089 } tkip;
90 struct {
91 u8 tx_pn[6];
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) */
96#ifndef AES_BLOCK_LEN
97#define AES_BLOCK_LEN 16
98#endif
99 u8 tx_crypto_buf[6 * AES_BLOCK_LEN];
100 u8 rx_crypto_buf[6 * AES_BLOCK_LEN];
101 } ccmp;
Jouni Malinen765cb462009-01-08 13:32:01 +0200102 struct {
103 u8 tx_pn[6];
104 u8 rx_pn[6];
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];
111 } aes_cmac;
Jiri Bencf0706e82007-05-05 11:45:53 -0700112 } u;
Jiri Bencf0706e82007-05-05 11:45:53 -0700113
Johannes Berg8f20fc22007-08-28 17:01:54 -0400114 /* number of times this key has been used */
115 int tx_rx_count;
Jiri Bencf0706e82007-05-05 11:45:53 -0700116
Jiri Bence9f207f2007-05-05 11:46:38 -0700117#ifdef CONFIG_MAC80211_DEBUGFS
118 struct {
119 struct dentry *stalink;
120 struct dentry *dir;
121 struct dentry *keylen;
Johannes Berg8f20fc22007-08-28 17:01:54 -0400122 struct dentry *flags;
Jiri Bence9f207f2007-05-05 11:46:38 -0700123 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;
Jouni Malinen3cfcf6ac2009-01-08 13:32:02 +0200130 struct dentry *icverrors;
Jiri Bence9f207f2007-05-05 11:46:38 -0700131 struct dentry *key;
Johannes Berge7a64f12007-08-28 17:01:55 -0400132 struct dentry *ifindex;
Johannes Bergd9c58f32008-04-08 16:46:36 -0400133 int cnt;
Jiri Bence9f207f2007-05-05 11:46:38 -0700134 } debugfs;
135#endif
136
Johannes Berg8f20fc22007-08-28 17:01:54 -0400137 /*
138 * key config, must be last because it contains key
139 * material as variable length member
140 */
141 struct ieee80211_key_conf conf;
Jiri Bencf0706e82007-05-05 11:45:53 -0700142};
143
Johannes Bergdb4d1162008-02-25 16:27:45 +0100144struct ieee80211_key *ieee80211_key_alloc(enum ieee80211_key_alg alg,
Johannes Berg11a843b2007-08-28 17:01:55 -0400145 int idx,
146 size_t key_len,
Jouni Malinenfaa8fdc2009-05-11 21:57:58 +0300147 const u8 *key_data,
148 size_t seq_len, const u8 *seq);
Johannes Bergdb4d1162008-02-25 16:27:45 +0100149/*
150 * Insert a key into data structures (sdata, sta if necessary)
151 * to make it used, free old key.
152 */
153void ieee80211_key_link(struct ieee80211_key *key,
154 struct ieee80211_sub_if_data *sdata,
155 struct sta_info *sta);
Johannes Berg11a843b2007-08-28 17:01:55 -0400156void ieee80211_key_free(struct ieee80211_key *key);
157void ieee80211_set_default_key(struct ieee80211_sub_if_data *sdata, int idx);
Jouni Malinen3cfcf6ac2009-01-08 13:32:02 +0200158void ieee80211_set_default_mgmt_key(struct ieee80211_sub_if_data *sdata,
159 int idx);
Johannes Berg11a843b2007-08-28 17:01:55 -0400160void ieee80211_free_keys(struct ieee80211_sub_if_data *sdata);
161void ieee80211_enable_keys(struct ieee80211_sub_if_data *sdata);
162void ieee80211_disable_keys(struct ieee80211_sub_if_data *sdata);
163
Johannes Berg3b967662008-04-08 17:56:52 +0200164void ieee80211_key_todo(void);
165
Jiri Bencf0706e82007-05-05 11:45:53 -0700166#endif /* IEEE80211_KEY_H */