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