blob: a49f93b79e9299571eecaa714aef060a62999789 [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;
Johannes Bergd9c58f32008-04-08 16:46:36 -0400121 int cnt;
Jiri Bence9f207f2007-05-05 11:46:38 -0700122 } debugfs;
123#endif
124
Johannes Berg8f20fc22007-08-28 17:01:54 -0400125 /*
126 * key config, must be last because it contains key
127 * material as variable length member
128 */
129 struct ieee80211_key_conf conf;
Jiri Bencf0706e82007-05-05 11:45:53 -0700130};
131
Johannes Bergdb4d1162008-02-25 16:27:45 +0100132struct ieee80211_key *ieee80211_key_alloc(enum ieee80211_key_alg alg,
Johannes Berg11a843b2007-08-28 17:01:55 -0400133 int idx,
134 size_t key_len,
Jouni Malinenfaa8fdc2009-05-11 21:57:58 +0300135 const u8 *key_data,
136 size_t seq_len, const u8 *seq);
Johannes Bergdb4d1162008-02-25 16:27:45 +0100137/*
138 * Insert a key into data structures (sdata, sta if necessary)
139 * to make it used, free old key.
140 */
141void ieee80211_key_link(struct ieee80211_key *key,
142 struct ieee80211_sub_if_data *sdata,
143 struct sta_info *sta);
Johannes Berg11a843b2007-08-28 17:01:55 -0400144void ieee80211_key_free(struct ieee80211_key *key);
145void ieee80211_set_default_key(struct ieee80211_sub_if_data *sdata, int idx);
Jouni Malinen3cfcf6ac2009-01-08 13:32:02 +0200146void ieee80211_set_default_mgmt_key(struct ieee80211_sub_if_data *sdata,
147 int idx);
Johannes Berg11a843b2007-08-28 17:01:55 -0400148void ieee80211_free_keys(struct ieee80211_sub_if_data *sdata);
149void ieee80211_enable_keys(struct ieee80211_sub_if_data *sdata);
150void ieee80211_disable_keys(struct ieee80211_sub_if_data *sdata);
151
Johannes Berg3b967662008-04-08 17:56:52 +0200152void ieee80211_key_todo(void);
153
Jiri Bencf0706e82007-05-05 11:45:53 -0700154#endif /* IEEE80211_KEY_H */