key.h 4.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168
  1. /*
  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. #ifndef IEEE80211_KEY_H
  10. #define IEEE80211_KEY_H
  11. #include <linux/types.h>
  12. #include <linux/list.h>
  13. #include <linux/crypto.h>
  14. #include <linux/rcupdate.h>
  15. #include <net/mac80211.h>
  16. #define NUM_DEFAULT_KEYS 4
  17. #define NUM_DEFAULT_MGMT_KEYS 2
  18. struct ieee80211_local;
  19. struct ieee80211_sub_if_data;
  20. struct sta_info;
  21. /**
  22. * enum ieee80211_internal_key_flags - internal key flags
  23. *
  24. * @KEY_FLAG_UPLOADED_TO_HARDWARE: Indicates that this key is present
  25. * in the hardware for TX crypto hardware acceleration.
  26. * @KEY_FLAG_TAINTED: Key is tainted and packets should be dropped.
  27. * @KEY_FLAG_CIPHER_SCHEME: This key is for a hardware cipher scheme
  28. */
  29. enum ieee80211_internal_key_flags {
  30. KEY_FLAG_UPLOADED_TO_HARDWARE = BIT(0),
  31. KEY_FLAG_TAINTED = BIT(1),
  32. KEY_FLAG_CIPHER_SCHEME = BIT(2),
  33. };
  34. enum ieee80211_internal_tkip_state {
  35. TKIP_STATE_NOT_INIT,
  36. TKIP_STATE_PHASE1_DONE,
  37. TKIP_STATE_PHASE1_HW_UPLOADED,
  38. };
  39. struct tkip_ctx {
  40. u16 p1k[5]; /* p1k cache */
  41. u32 p1k_iv32; /* iv32 for which p1k computed */
  42. enum ieee80211_internal_tkip_state state;
  43. };
  44. struct tkip_ctx_rx {
  45. struct tkip_ctx ctx;
  46. u32 iv32; /* current iv32 */
  47. u16 iv16; /* current iv16 */
  48. };
  49. struct ieee80211_key {
  50. struct ieee80211_local *local;
  51. struct ieee80211_sub_if_data *sdata;
  52. struct sta_info *sta;
  53. /* for sdata list */
  54. struct list_head list;
  55. /* protected by key mutex */
  56. unsigned int flags;
  57. union {
  58. struct {
  59. /* protects tx context */
  60. spinlock_t txlock;
  61. /* last used TSC */
  62. struct tkip_ctx tx;
  63. /* last received RSC */
  64. struct tkip_ctx_rx rx[IEEE80211_NUM_TIDS];
  65. /* number of mic failures */
  66. u32 mic_failures;
  67. } tkip;
  68. struct {
  69. /*
  70. * Last received packet number. The first
  71. * IEEE80211_NUM_TIDS counters are used with Data
  72. * frames and the last counter is used with Robust
  73. * Management frames.
  74. */
  75. u8 rx_pn[IEEE80211_NUM_TIDS + 1][IEEE80211_CCMP_PN_LEN];
  76. struct crypto_aead *tfm;
  77. u32 replays; /* dot11RSNAStatsCCMPReplays */
  78. } ccmp;
  79. struct {
  80. u8 rx_pn[IEEE80211_CMAC_PN_LEN];
  81. struct crypto_shash *tfm;
  82. u32 replays; /* dot11RSNAStatsCMACReplays */
  83. u32 icverrors; /* dot11RSNAStatsCMACICVErrors */
  84. } aes_cmac;
  85. struct {
  86. u8 rx_pn[IEEE80211_GMAC_PN_LEN];
  87. struct crypto_aead *tfm;
  88. u32 replays; /* dot11RSNAStatsCMACReplays */
  89. u32 icverrors; /* dot11RSNAStatsCMACICVErrors */
  90. } aes_gmac;
  91. struct {
  92. /* Last received packet number. The first
  93. * IEEE80211_NUM_TIDS counters are used with Data
  94. * frames and the last counter is used with Robust
  95. * Management frames.
  96. */
  97. u8 rx_pn[IEEE80211_NUM_TIDS + 1][IEEE80211_GCMP_PN_LEN];
  98. struct crypto_aead *tfm;
  99. u32 replays; /* dot11RSNAStatsGCMPReplays */
  100. } gcmp;
  101. struct {
  102. /* generic cipher scheme */
  103. u8 rx_pn[IEEE80211_NUM_TIDS + 1][IEEE80211_MAX_PN_LEN];
  104. } gen;
  105. } u;
  106. #ifdef CONFIG_MAC80211_DEBUGFS
  107. struct {
  108. struct dentry *stalink;
  109. struct dentry *dir;
  110. int cnt;
  111. } debugfs;
  112. #endif
  113. /*
  114. * key config, must be last because it contains key
  115. * material as variable length member
  116. */
  117. struct ieee80211_key_conf conf;
  118. };
  119. struct ieee80211_key *
  120. ieee80211_key_alloc(u32 cipher, int idx, size_t key_len,
  121. const u8 *key_data,
  122. size_t seq_len, const u8 *seq,
  123. const struct ieee80211_cipher_scheme *cs);
  124. /*
  125. * Insert a key into data structures (sdata, sta if necessary)
  126. * to make it used, free old key. On failure, also free the new key.
  127. */
  128. int ieee80211_key_link(struct ieee80211_key *key,
  129. struct ieee80211_sub_if_data *sdata,
  130. struct sta_info *sta);
  131. void ieee80211_key_free(struct ieee80211_key *key, bool delay_tailroom);
  132. void ieee80211_key_free_unused(struct ieee80211_key *key);
  133. void ieee80211_set_default_key(struct ieee80211_sub_if_data *sdata, int idx,
  134. bool uni, bool multi);
  135. void ieee80211_set_default_mgmt_key(struct ieee80211_sub_if_data *sdata,
  136. int idx);
  137. void ieee80211_free_keys(struct ieee80211_sub_if_data *sdata,
  138. bool force_synchronize);
  139. void ieee80211_free_sta_keys(struct ieee80211_local *local,
  140. struct sta_info *sta);
  141. void ieee80211_enable_keys(struct ieee80211_sub_if_data *sdata);
  142. void ieee80211_reset_crypto_tx_tailroom(struct ieee80211_sub_if_data *sdata);
  143. #define key_mtx_dereference(local, ref) \
  144. rcu_dereference_protected(ref, lockdep_is_held(&((local)->key_mtx)))
  145. void ieee80211_delayed_tailroom_dec(struct work_struct *wk);
  146. #endif /* IEEE80211_KEY_H */