blob: 7d4e31f037d7c4237e18783ec5ebf18cbc8dba52 [file] [log] [blame]
Jiri Bencf0706e822007-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 Bencf0706e822007-05-05 11:45:53 -070015#include <linux/crypto.h>
Johannes Bergdb4d1162008-02-25 16:27:45 +010016#include <linux/rcupdate.h>
Jiri Bencf0706e822007-05-05 11:45:53 -070017#include <net/mac80211.h>
18
Johannes Berge31b8212010-10-05 19:39:30 +020019#define NUM_DEFAULT_KEYS 4
20#define NUM_DEFAULT_MGMT_KEYS 2
21
Luis R. Rodriguezffd78912008-06-21 10:02:46 -040022#define WEP_IV_LEN 4
23#define WEP_ICV_LEN 4
Luis R. Rodriguezffd78912008-06-21 10:02:46 -040024#define ALG_CCMP_KEY_LEN 16
25#define CCMP_HDR_LEN 8
26#define CCMP_MIC_LEN 8
27#define CCMP_TK_LEN 16
28#define CCMP_PN_LEN 6
29#define TKIP_IV_LEN 8
30#define TKIP_ICV_LEN 4
Johannes Berg3ea542d2011-07-07 18:58:00 +020031#define CMAC_PN_LEN 6
Jiri Bencf0706e822007-05-05 11:45:53 -070032
Johannes Berg9e262972011-07-07 18:45:03 +020033#define NUM_RX_DATA_QUEUES 16
Jiri Bencf0706e822007-05-05 11:45:53 -070034
Johannes Berg11a843b2007-08-28 17:01:55 -040035struct ieee80211_local;
36struct ieee80211_sub_if_data;
37struct sta_info;
38
Johannes Bergdb4d1162008-02-25 16:27:45 +010039/**
40 * enum ieee80211_internal_key_flags - internal key flags
41 *
42 * @KEY_FLAG_UPLOADED_TO_HARDWARE: Indicates that this key is present
43 * in the hardware for TX crypto hardware acceleration.
Johannes Berg95acac62011-07-12 12:30:59 +020044 * @KEY_FLAG_TAINTED: Key is tainted and packets should be dropped.
Johannes Bergdb4d1162008-02-25 16:27:45 +010045 */
46enum ieee80211_internal_key_flags {
47 KEY_FLAG_UPLOADED_TO_HARDWARE = BIT(0),
Johannes Berg95acac62011-07-12 12:30:59 +020048 KEY_FLAG_TAINTED = BIT(1),
Johannes Bergdb4d1162008-02-25 16:27:45 +010049};
Johannes Berg11a843b2007-08-28 17:01:55 -040050
gregor kowskica998612009-12-09 23:25:05 +010051enum ieee80211_internal_tkip_state {
52 TKIP_STATE_NOT_INIT,
53 TKIP_STATE_PHASE1_DONE,
54 TKIP_STATE_PHASE1_HW_UPLOADED,
55};
56
Harvey Harrisonb0f76b32008-05-14 16:26:19 -070057struct tkip_ctx {
Johannes Berg523b02e2011-07-07 22:28:01 +020058 u32 iv32; /* current iv32 */
59 u16 iv16; /* current iv16 */
60 u16 p1k[5]; /* p1k cache */
61 u32 p1k_iv32; /* iv32 for which p1k computed */
gregor kowskica998612009-12-09 23:25:05 +010062 enum ieee80211_internal_tkip_state state;
Harvey Harrisonb0f76b32008-05-14 16:26:19 -070063};
64
Jiri Bencf0706e822007-05-05 11:45:53 -070065struct ieee80211_key {
Johannes Berg11a843b2007-08-28 17:01:55 -040066 struct ieee80211_local *local;
67 struct ieee80211_sub_if_data *sdata;
68 struct sta_info *sta;
69
Johannes Berg3b967662008-04-08 17:56:52 +020070 /* for sdata list */
Johannes Berg11a843b2007-08-28 17:01:55 -040071 struct list_head list;
72
Johannes Bergad0e2b52010-06-01 10:19:19 +020073 /* protected by key mutex */
Johannes Berg11a843b2007-08-28 17:01:55 -040074 unsigned int flags;
75
Jiri Bencf0706e822007-05-05 11:45:53 -070076 union {
77 struct {
Johannes Berg523b02e2011-07-07 22:28:01 +020078 /* protects tx context */
79 spinlock_t txlock;
80
Jiri Bencf0706e822007-05-05 11:45:53 -070081 /* last used TSC */
Harvey Harrisonb0f76b32008-05-14 16:26:19 -070082 struct tkip_ctx tx;
Jiri Bencf0706e822007-05-05 11:45:53 -070083
84 /* last received RSC */
Harvey Harrisonb0f76b32008-05-14 16:26:19 -070085 struct tkip_ctx rx[NUM_RX_DATA_QUEUES];
Jiri Bencf0706e822007-05-05 11:45:53 -070086 } tkip;
87 struct {
Johannes Bergaba83a0b2011-07-06 21:59:39 +020088 atomic64_t tx_pn;
Jouni Malinen91902522010-06-11 10:27:33 -070089 /*
90 * Last received packet number. The first
91 * NUM_RX_DATA_QUEUES counters are used with Data
92 * frames and the last counter is used with Robust
93 * Management frames.
94 */
Johannes Berg3ea542d2011-07-07 18:58:00 +020095 u8 rx_pn[NUM_RX_DATA_QUEUES + 1][CCMP_PN_LEN];
Jiri Bencf0706e822007-05-05 11:45:53 -070096 struct crypto_cipher *tfm;
97 u32 replays; /* dot11RSNAStatsCCMPReplays */
Jiri Bencf0706e822007-05-05 11:45:53 -070098 } ccmp;
Jouni Malinen765cb462009-01-08 13:32:01 +020099 struct {
Johannes Berg75396ae2011-07-06 22:00:35 +0200100 atomic64_t tx_pn;
Johannes Berg3ea542d2011-07-07 18:58:00 +0200101 u8 rx_pn[CMAC_PN_LEN];
Jouni Malinen765cb462009-01-08 13:32:01 +0200102 struct crypto_cipher *tfm;
103 u32 replays; /* dot11RSNAStatsCMACReplays */
104 u32 icverrors; /* dot11RSNAStatsCMACICVErrors */
Jouni Malinen765cb462009-01-08 13:32:01 +0200105 } aes_cmac;
Jiri Bencf0706e822007-05-05 11:45:53 -0700106 } u;
Jiri Bencf0706e822007-05-05 11:45:53 -0700107
Johannes Berg8f20fc22007-08-28 17:01:54 -0400108 /* number of times this key has been used */
109 int tx_rx_count;
Jiri Bencf0706e822007-05-05 11:45:53 -0700110
Jiri Bence9f207f2007-05-05 11:46:38 -0700111#ifdef CONFIG_MAC80211_DEBUGFS
112 struct {
113 struct dentry *stalink;
114 struct dentry *dir;
Johannes Bergd9c58f32008-04-08 16:46:36 -0400115 int cnt;
Jiri Bence9f207f2007-05-05 11:46:38 -0700116 } debugfs;
117#endif
118
Johannes Berg8f20fc22007-08-28 17:01:54 -0400119 /*
120 * key config, must be last because it contains key
121 * material as variable length member
122 */
123 struct ieee80211_key_conf conf;
Jiri Bencf0706e822007-05-05 11:45:53 -0700124};
125
Johannes Berg97359d12010-08-10 09:46:38 +0200126struct ieee80211_key *ieee80211_key_alloc(u32 cipher, int idx, size_t key_len,
Jouni Malinenfaa8fdc2009-05-11 21:57:58 +0300127 const u8 *key_data,
128 size_t seq_len, const u8 *seq);
Johannes Bergdb4d1162008-02-25 16:27:45 +0100129/*
130 * Insert a key into data structures (sdata, sta if necessary)
131 * to make it used, free old key.
132 */
Johannes Berg3ffc2a92010-08-27 14:26:52 +0300133int __must_check ieee80211_key_link(struct ieee80211_key *key,
134 struct ieee80211_sub_if_data *sdata,
135 struct sta_info *sta);
Johannes Berg5c0c3642011-05-12 14:31:49 +0200136void __ieee80211_key_free(struct ieee80211_key *key);
Jouni Malinen32162a42010-07-26 15:52:03 -0700137void ieee80211_key_free(struct ieee80211_local *local,
138 struct ieee80211_key *key);
Johannes Bergf7e01042010-12-09 19:49:02 +0100139void ieee80211_set_default_key(struct ieee80211_sub_if_data *sdata, int idx,
140 bool uni, bool multi);
Jouni Malinen3cfcf6a2009-01-08 13:32:02 +0200141void ieee80211_set_default_mgmt_key(struct ieee80211_sub_if_data *sdata,
142 int idx);
Johannes Berg11a843b2007-08-28 17:01:55 -0400143void ieee80211_free_keys(struct ieee80211_sub_if_data *sdata);
144void ieee80211_enable_keys(struct ieee80211_sub_if_data *sdata);
145void ieee80211_disable_keys(struct ieee80211_sub_if_data *sdata);
146
Johannes Berg40b275b2011-05-13 14:15:49 +0200147#define key_mtx_dereference(local, ref) \
148 rcu_dereference_protected(ref, lockdep_is_held(&((local)->key_mtx)))
149
Jiri Bencf0706e822007-05-05 11:45:53 -0700150#endif /* IEEE80211_KEY_H */