pmksa_cache.c File Reference

hostapd - PMKSA cache for IEEE 802.11i RSN More...

#include "includes.h"
#include "hostapd.h"
#include "common.h"
#include "wpa.h"
#include "eloop.h"
#include "sha1.h"
#include "ieee802_1x.h"
#include "eapol_sm.h"
#include "pmksa_cache.h"

Include dependency graph for pmksa_cache.c:

Go to the source code of this file.

Defines

#define PMKID_HASH_SIZE   128
#define PMKID_HASH(pmkid)   (unsigned int) ((pmkid)[0] & 0x7f)

Functions

void rsn_pmkid (const u8 *pmk, size_t pmk_len, const u8 *aa, const u8 *spa, u8 *pmkid)
 Calculate PMK identifier.
void pmksa_cache_to_eapol_data (struct rsn_pmksa_cache_entry *entry, struct eapol_state_machine *eapol)
rsn_pmksa_cache_entrypmksa_cache_add (struct rsn_pmksa_cache *pmksa, const u8 *pmk, size_t pmk_len, const u8 *aa, const u8 *spa, int session_timeout, struct eapol_state_machine *eapol)
 Add a PMKSA cache entry.
void pmksa_cache_deinit (struct rsn_pmksa_cache *pmksa)
 Free all entries in PMKSA cache.
rsn_pmksa_cache_entrypmksa_cache_get (struct rsn_pmksa_cache *pmksa, const u8 *spa, const u8 *pmkid)
 Fetch a PMKSA cache entry.
rsn_pmksa_cache * pmksa_cache_init (void(*free_cb)(struct rsn_pmksa_cache_entry *entry, void *ctx), void *ctx)
 Initialize PMKSA cache.


Detailed Description

hostapd - PMKSA cache for IEEE 802.11i RSN

Copyright
Copyright (c) 2004-2006, Jouni Malinen <[email protected]>
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation.

Alternatively, this software may be distributed under the terms of BSD license.

See README and COPYING for more details.

Definition in file pmksa_cache.c.


Function Documentation

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,
int  session_timeout,
struct eapol_state_machine *  eapol
 

Add a PMKSA cache entry.

Parameters:
pmksa Pointer to PMKSA cache data from pmksa_cache_init()
pmk The new pairwise master key
pmk_len PMK length in bytes, usually PMK_LEN (32)
aa Authenticator address
spa Supplicant address
session_timeout Session timeout
eapol Pointer to EAPOL state machine data
Returns:
Pointer to the added PMKSA cache entry or NULL on error
This function create a PMKSA entry for a new PMK and adds it to the PMKSA cache. If an old entry is already in the cache for the same Supplicant, this entry will be replaced with the new entry. PMKID will be calculated based on the PMK.

Definition at line 230 of file pmksa_cache.c.

Here is the call graph for this function:

void pmksa_cache_deinit struct rsn_pmksa_cache *  pmksa  ) 
 

Free all entries in PMKSA cache.

Parameters:
pmksa Pointer to PMKSA cache data from pmksa_cache_init()

Definition at line 303 of file pmksa_cache.c.

Here is the call graph for this function:

struct rsn_pmksa_cache_entry* pmksa_cache_get struct rsn_pmksa_cache *  pmksa,
const u8 *  spa,
const u8 *  pmkid
 

Fetch a PMKSA cache entry.

Parameters:
pmksa Pointer to PMKSA cache data from pmksa_cache_init()
spa Supplicant address or NULL to match any
pmkid PMKID or NULL to match any
Returns:
Pointer to PMKSA cache entry or NULL if no match was found

Definition at line 332 of file pmksa_cache.c.

struct rsn_pmksa_cache* pmksa_cache_init void(*)(struct rsn_pmksa_cache_entry *entry, void *ctx)  free_cb,
void *  ctx
 

Initialize PMKSA cache.

Parameters:
free_cb Callback function to be called when a PMKSA cache entry is freed
ctx Context pointer for free_cb function
Returns:
Pointer to PMKSA cache data or NULL on failure

Definition at line 360 of file pmksa_cache.c.

void rsn_pmkid const u8 *  pmk,
size_t  pmk_len,
const u8 *  aa,
const u8 *  spa,
u8 *  pmkid
 

Calculate PMK identifier.

Parameters:
pmk Pairwise master key
pmk_len Length of pmk in bytes
aa Authenticator address
spa Supplicant address
IEEE Std 802.11i-2004 - 8.5.1.2 Pairwise key hierarchy PMKID = HMAC-SHA1-128(PMK, "PMK Name" || AA || SPA)

Definition at line 54 of file pmksa_cache.c.

Here is the call graph for this function:


Generated on Sun Dec 31 13:45:41 2006 for hostapd by  doxygen 1.4.2