src/rsn_supp/pmksa_cache.h

   1 /*
   2  * wpa_supplicant - WPA2/RSN PMKSA cache functions
   3  * Copyright (c) 2003-2009, 2011-2012, Jouni Malinen <j@w1.fi>
   4  *
   5  * This software may be distributed under the terms of the BSD license.
   6  * See README for more details.
   7  */
   8
   9 #ifndef PMKSA_CACHE_H
  10 #define PMKSA_CACHE_H
  11
  12 /**
  13  * struct rsn_pmksa_cache_entry - PMKSA cache entry
  14  */
  15 struct rsn_pmksa_cache_entry {
  16         struct rsn_pmksa_cache_entry *next;
  17         u8 pmkid[PMKID_LEN];
  18         u8 pmk[PMK_LEN_MAX];
  19         size_t pmk_len;
  20         os_time_t expiration;
  21         int akmp; /* WPA_KEY_MGMT_* */
  22         u8 aa[ETH_ALEN];
  23
  24         /*
  25          * If FILS Cache Identifier is included (fils_cache_id_set), this PMKSA
  26          * cache entry is applicable to all BSSs (any BSSID/aa[]) that
  27          * advertise the same FILS Cache Identifier within the same ESS.
  28          */
  29         u8 fils_cache_id[2];
  30         unsigned int fils_cache_id_set:1;
  31
  32         os_time_t reauth_time;
  33
  34         /**
  35          * network_ctx - Network configuration context
  36          *
  37          * This field is only used to match PMKSA cache entries to a specific
  38          * network configuration (e.g., a specific SSID and security policy).
  39          * This can be a pointer to the configuration entry, but PMKSA caching
  40          * code does not dereference the value and this could be any kind of
  41          * identifier.
  42          */
  43         void *network_ctx;
  44         int opportunistic;
  45 };
  46
  47 struct rsn_pmksa_cache;
  48
  49 enum pmksa_free_reason {
  50         PMKSA_FREE,
  51         PMKSA_REPLACE,
  52         PMKSA_EXPIRE,
  53 };
  54
  55 #if defined(IEEE8021X_EAPOL) && !defined(CONFIG_NO_WPA)
  56
  57 struct rsn_pmksa_cache *
  58 pmksa_cache_init(void (*free_cb)(struct rsn_pmksa_cache_entry *entry,
  59                                  void *ctx, enum pmksa_free_reason reason),
  60                  void *ctx, struct wpa_sm *sm);
  61 void pmksa_cache_deinit(struct rsn_pmksa_cache *pmksa);
  62 struct rsn_pmksa_cache_entry * pmksa_cache_get(struct rsn_pmksa_cache *pmksa,
  63                                                const u8 *aa, const u8 *pmkid,
  64                                                const void *network_ctx,
  65                                                int akmp);
  66 int pmksa_cache_list(struct rsn_pmksa_cache *pmksa, char *buf, size_t len);
  67 struct rsn_pmksa_cache_entry * pmksa_cache_head(struct rsn_pmksa_cache *pmksa);
  68 struct rsn_pmksa_cache_entry *
  69 pmksa_cache_add(struct rsn_pmksa_cache *pmksa, const u8 *pmk, size_t pmk_len,
  70                 const u8 *pmkid, const u8 *kck, size_t kck_len,
  71                 const u8 *aa, const u8 *spa, void *network_ctx, int akmp,
  72                 const u8 *cache_id);
  73 struct rsn_pmksa_cache_entry *
  74 pmksa_cache_add_entry(struct rsn_pmksa_cache *pmksa,
  75                       struct rsn_pmksa_cache_entry *entry);
  76 struct rsn_pmksa_cache_entry * pmksa_cache_get_current(struct wpa_sm *sm);
  77 void pmksa_cache_clear_current(struct wpa_sm *sm);
  78 int pmksa_cache_set_current(struct wpa_sm *sm, const u8 *pmkid,
  79                             const u8 *bssid, void *network_ctx,
  80                             int try_opportunistic, const u8 *fils_cache_id,
  81                             int akmp);
  82 struct rsn_pmksa_cache_entry *
  83 pmksa_cache_get_opportunistic(struct rsn_pmksa_cache *pmksa,
  84                               void *network_ctx, const u8 *aa, int akmp);
  85 void pmksa_cache_flush(struct rsn_pmksa_cache *pmksa, void *network_ctx,
  86                        const u8 *pmk, size_t pmk_len);
  87
  88 #else /* IEEE8021X_EAPOL */
  89
  90 static inline struct rsn_pmksa_cache *
  91 pmksa_cache_init(void (*free_cb)(struct rsn_pmksa_cache_entry *entry,
  92                                  void *ctx, enum pmksa_free_reason reason),
  93                  void *ctx, struct wpa_sm *sm)
  94 {
  95         return (void *) -1;
  96 }
  97
  98 static inline void pmksa_cache_deinit(struct rsn_pmksa_cache *pmksa)
  99 {
 100 }
 101
 102 static inline struct rsn_pmksa_cache_entry *
 103 pmksa_cache_get(struct rsn_pmksa_cache *pmksa, const u8 *aa, const u8 *pmkid,
 104                 const void *network_ctx, int akmp)
 105 {
 106         return NULL;
 107 }
 108
 109 static inline struct rsn_pmksa_cache_entry *
 110 pmksa_cache_get_current(struct wpa_sm *sm)
 111 {
 112         return NULL;
 113 }
 114
 115 static inline int pmksa_cache_list(struct rsn_pmksa_cache *pmksa, char *buf,
 116                                    size_t len)
 117 {
 118         return -1;
 119 }
 120
 121 static inline struct rsn_pmksa_cache_entry *
 122 pmksa_cache_head(struct rsn_pmksa_cache *pmksa)
 123 {
 124         return NULL;
 125 }
 126
 127 static inline struct rsn_pmksa_cache_entry *
 128 pmksa_cache_add_entry(struct rsn_pmksa_cache *pmksa,
 129                       struct rsn_pmksa_cache_entry *entry)
 130 {
 131         return NULL;
 132 }
 133
 134 static inline struct rsn_pmksa_cache_entry *
 135 pmksa_cache_add(struct rsn_pmksa_cache *pmksa, const u8 *pmk, size_t pmk_len,
 136                 const u8 *pmkid, const u8 *kck, size_t kck_len,
 137                 const u8 *aa, const u8 *spa, void *network_ctx, int akmp,
 138                 const u8 *cache_id)
 139 {
 140         return NULL;
 141 }
 142
 143 static inline void pmksa_cache_clear_current(struct wpa_sm *sm)
 144 {
 145 }
 146
 147 static inline int pmksa_cache_set_current(struct wpa_sm *sm, const u8 *pmkid,
 148                                           const u8 *bssid,
 149                                           void *network_ctx,
 150                                           int try_opportunistic,
 151                                           const u8 *fils_cache_id,
 152                                           int akmp)
 153 {
 154         return -1;
 155 }
 156
 157 static inline void pmksa_cache_flush(struct rsn_pmksa_cache *pmksa,
 158                                      void *network_ctx,
 159                                      const u8 *pmk, size_t pmk_len)
 160 {
 161 }
 162
 163 #endif /* IEEE8021X_EAPOL */
 164
 165 #endif /* PMKSA_CACHE_H */