lib80211.h 3.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121
  1. /*
  2. * lib80211.h -- common bits for IEEE802.11 wireless drivers
  3. *
  4. * Copyright (c) 2008, John W. Linville <linville@tuxdriver.com>
  5. *
  6. * Some bits copied from old ieee80211 component, w/ original copyright
  7. * notices below:
  8. *
  9. * Original code based on Host AP (software wireless LAN access point) driver
  10. * for Intersil Prism2/2.5/3.
  11. *
  12. * Copyright (c) 2001-2002, SSH Communications Security Corp and Jouni Malinen
  13. * <j@w1.fi>
  14. * Copyright (c) 2002-2003, Jouni Malinen <j@w1.fi>
  15. *
  16. * Adaption to a generic IEEE 802.11 stack by James Ketrenos
  17. * <jketreno@linux.intel.com>
  18. *
  19. * Copyright (c) 2004, Intel Corporation
  20. *
  21. */
  22. #ifndef LIB80211_H
  23. #define LIB80211_H
  24. #include <linux/types.h>
  25. #include <linux/list.h>
  26. #include <linux/atomic.h>
  27. #include <linux/if.h>
  28. #include <linux/skbuff.h>
  29. #include <linux/ieee80211.h>
  30. #include <linux/timer.h>
  31. #include <linux/seq_file.h>
  32. #define NUM_WEP_KEYS 4
  33. enum {
  34. IEEE80211_CRYPTO_TKIP_COUNTERMEASURES = (1 << 0),
  35. };
  36. struct module;
  37. struct lib80211_crypto_ops {
  38. const char *name;
  39. struct list_head list;
  40. /* init new crypto context (e.g., allocate private data space,
  41. * select IV, etc.); returns NULL on failure or pointer to allocated
  42. * private data on success */
  43. void *(*init) (int keyidx);
  44. /* deinitialize crypto context and free allocated private data */
  45. void (*deinit) (void *priv);
  46. /* encrypt/decrypt return < 0 on error or >= 0 on success. The return
  47. * value from decrypt_mpdu is passed as the keyidx value for
  48. * decrypt_msdu. skb must have enough head and tail room for the
  49. * encryption; if not, error will be returned; these functions are
  50. * called for all MPDUs (i.e., fragments).
  51. */
  52. int (*encrypt_mpdu) (struct sk_buff * skb, int hdr_len, void *priv);
  53. int (*decrypt_mpdu) (struct sk_buff * skb, int hdr_len, void *priv);
  54. /* These functions are called for full MSDUs, i.e. full frames.
  55. * These can be NULL if full MSDU operations are not needed. */
  56. int (*encrypt_msdu) (struct sk_buff * skb, int hdr_len, void *priv);
  57. int (*decrypt_msdu) (struct sk_buff * skb, int keyidx, int hdr_len,
  58. void *priv);
  59. int (*set_key) (void *key, int len, u8 * seq, void *priv);
  60. int (*get_key) (void *key, int len, u8 * seq, void *priv);
  61. /* procfs handler for printing out key information and possible
  62. * statistics */
  63. void (*print_stats) (struct seq_file *m, void *priv);
  64. /* Crypto specific flag get/set for configuration settings */
  65. unsigned long (*get_flags) (void *priv);
  66. unsigned long (*set_flags) (unsigned long flags, void *priv);
  67. /* maximum number of bytes added by encryption; encrypt buf is
  68. * allocated with extra_prefix_len bytes, copy of in_buf, and
  69. * extra_postfix_len; encrypt need not use all this space, but
  70. * the result must start at the beginning of the buffer and correct
  71. * length must be returned */
  72. int extra_mpdu_prefix_len, extra_mpdu_postfix_len;
  73. int extra_msdu_prefix_len, extra_msdu_postfix_len;
  74. struct module *owner;
  75. };
  76. struct lib80211_crypt_data {
  77. struct list_head list; /* delayed deletion list */
  78. struct lib80211_crypto_ops *ops;
  79. void *priv;
  80. atomic_t refcnt;
  81. };
  82. struct lib80211_crypt_info {
  83. char *name;
  84. /* Most clients will already have a lock,
  85. so just point to that. */
  86. spinlock_t *lock;
  87. struct lib80211_crypt_data *crypt[NUM_WEP_KEYS];
  88. int tx_keyidx; /* default TX key index (crypt[tx_keyidx]) */
  89. struct list_head crypt_deinit_list;
  90. struct timer_list crypt_deinit_timer;
  91. int crypt_quiesced;
  92. };
  93. int lib80211_crypt_info_init(struct lib80211_crypt_info *info, char *name,
  94. spinlock_t *lock);
  95. void lib80211_crypt_info_free(struct lib80211_crypt_info *info);
  96. int lib80211_register_crypto_ops(struct lib80211_crypto_ops *ops);
  97. int lib80211_unregister_crypto_ops(struct lib80211_crypto_ops *ops);
  98. struct lib80211_crypto_ops *lib80211_get_crypto_ops(const char *name);
  99. void lib80211_crypt_delayed_deinit(struct lib80211_crypt_info *info,
  100. struct lib80211_crypt_data **crypt);
  101. #endif /* LIB80211_H */