Home | History | Annotate | Download | only in rsn_supp
      1 /*
      2  * wpa_supplicant - WPA2/RSN PMKSA cache functions
      3  * Copyright (c) 2003-2009, 2011-2012, Jouni Malinen <j (at) 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];
     19 	size_t pmk_len;
     20 	os_time_t expiration;
     21 	int akmp; /* WPA_KEY_MGMT_* */
     22 	u8 aa[ETH_ALEN];
     23 
     24 	os_time_t reauth_time;
     25 
     26 	/**
     27 	 * network_ctx - Network configuration context
     28 	 *
     29 	 * This field is only used to match PMKSA cache entries to a specific
     30 	 * network configuration (e.g., a specific SSID and security policy).
     31 	 * This can be a pointer to the configuration entry, but PMKSA caching
     32 	 * code does not dereference the value and this could be any kind of
     33 	 * identifier.
     34 	 */
     35 	void *network_ctx;
     36 	int opportunistic;
     37 };
     38 
     39 struct rsn_pmksa_cache;
     40 
     41 #if defined(IEEE8021X_EAPOL) && !defined(CONFIG_NO_WPA2)
     42 
     43 struct rsn_pmksa_cache *
     44 pmksa_cache_init(void (*free_cb)(struct rsn_pmksa_cache_entry *entry,
     45 				 void *ctx, int replace),
     46 		 void *ctx, struct wpa_sm *sm);
     47 void pmksa_cache_deinit(struct rsn_pmksa_cache *pmksa);
     48 struct rsn_pmksa_cache_entry * pmksa_cache_get(struct rsn_pmksa_cache *pmksa,
     49 					       const u8 *aa, const u8 *pmkid,
     50 					       const void *network_ctx);
     51 int pmksa_cache_list(struct rsn_pmksa_cache *pmksa, char *buf, size_t len);
     52 struct rsn_pmksa_cache_entry *
     53 pmksa_cache_add(struct rsn_pmksa_cache *pmksa, const u8 *pmk, size_t pmk_len,
     54 		const u8 *aa, const u8 *spa, void *network_ctx, int akmp);
     55 struct rsn_pmksa_cache_entry * pmksa_cache_get_current(struct wpa_sm *sm);
     56 void pmksa_cache_clear_current(struct wpa_sm *sm);
     57 int pmksa_cache_set_current(struct wpa_sm *sm, const u8 *pmkid,
     58 			    const u8 *bssid, void *network_ctx,
     59 			    int try_opportunistic);
     60 struct rsn_pmksa_cache_entry *
     61 pmksa_cache_get_opportunistic(struct rsn_pmksa_cache *pmksa,
     62 			      void *network_ctx, const u8 *aa);
     63 void pmksa_cache_flush(struct rsn_pmksa_cache *pmksa, void *network_ctx);
     64 
     65 #else /* IEEE8021X_EAPOL and !CONFIG_NO_WPA2 */
     66 
     67 static inline struct rsn_pmksa_cache *
     68 pmksa_cache_init(void (*free_cb)(struct rsn_pmksa_cache_entry *entry,
     69 				 void *ctx, int replace),
     70 		 void *ctx, struct wpa_sm *sm)
     71 {
     72 	return (void *) -1;
     73 }
     74 
     75 static inline void pmksa_cache_deinit(struct rsn_pmksa_cache *pmksa)
     76 {
     77 }
     78 
     79 static inline struct rsn_pmksa_cache_entry *
     80 pmksa_cache_get(struct rsn_pmksa_cache *pmksa, const u8 *aa, const u8 *pmkid,
     81 		const void *network_ctx)
     82 {
     83 	return NULL;
     84 }
     85 
     86 static inline struct rsn_pmksa_cache_entry *
     87 pmksa_cache_get_current(struct wpa_sm *sm)
     88 {
     89 	return NULL;
     90 }
     91 
     92 static inline int pmksa_cache_list(struct rsn_pmksa_cache *pmksa, char *buf,
     93 				   size_t len)
     94 {
     95 	return -1;
     96 }
     97 
     98 static inline struct rsn_pmksa_cache_entry *
     99 pmksa_cache_add(struct rsn_pmksa_cache *pmksa, const u8 *pmk, size_t pmk_len,
    100 		const u8 *aa, const u8 *spa, void *network_ctx, int akmp)
    101 {
    102 	return NULL;
    103 }
    104 
    105 static inline void pmksa_cache_clear_current(struct wpa_sm *sm)
    106 {
    107 }
    108 
    109 static inline int pmksa_cache_set_current(struct wpa_sm *sm, const u8 *pmkid,
    110 					  const u8 *bssid,
    111 					  void *network_ctx,
    112 					  int try_opportunistic)
    113 {
    114 	return -1;
    115 }
    116 
    117 static inline void pmksa_cache_flush(struct rsn_pmksa_cache *pmksa,
    118 				     void *network_ctx)
    119 {
    120 }
    121 
    122 #endif /* IEEE8021X_EAPOL and !CONFIG_NO_WPA2 */
    123 
    124 #endif /* PMKSA_CACHE_H */
    125