hostapd.h File Reference

hostapd / Initialization and configuration More...

#include "common/defs.h"

Go to the source code of this file.

Data Structures
struct	hapd_interfaces
struct	hostapd_probereq_cb
struct	hostapd_rate_data
struct	hostapd_frame_info
struct	hostapd_data
	hostapd per-BSS data structure More...
struct	hostapd_iface
	hostapd per-interface data structure More...
Defines
#define	HOSTAPD_RATE_BASIC   0x00000001
#define	STA_HASH_SIZE   256
#define	STA_HASH(sta)   (sta[5])
#define	AID_WORDS   ((2008 + 31) / 32)
Functions
int	hostapd_for_each_interface (struct hapd_interfaces *interfaces, int(*cb)(struct hostapd_iface *iface, void *ctx), void *ctx)
int	hostapd_reload_config (struct hostapd_iface *iface)
struct hostapd_data *	hostapd_alloc_bss_data (struct hostapd_iface *hapd_iface, struct hostapd_config *conf, struct hostapd_bss_config *bss)
	Allocate and initialize per-BSS data.
int	hostapd_setup_interface (struct hostapd_iface *iface)
	Setup of an interface.
int	hostapd_setup_interface_complete (struct hostapd_iface *iface, int err)
void	hostapd_interface_deinit (struct hostapd_iface *iface)
void	hostapd_interface_free (struct hostapd_iface *iface)
void	hostapd_new_assoc_sta (struct hostapd_data *hapd, struct sta_info *sta, int reassoc)
	Notify that a new station associated with the AP.
int	hostapd_register_probereq_cb (struct hostapd_data *hapd, int(*cb)(void *ctx, const u8 *sa, const u8 *da, const u8 *bssid, const u8 *ie, size_t ie_len, int ssi_signal), void *ctx)
void	hostapd_prune_associations (struct hostapd_data *hapd, const u8 *addr)
	Remove extraneous associations.
int	hostapd_notif_assoc (struct hostapd_data *hapd, const u8 *addr, const u8 *ie, size_t ielen, int reassoc)
void	hostapd_notif_disassoc (struct hostapd_data *hapd, const u8 *addr)
void	hostapd_event_sta_low_ack (struct hostapd_data *hapd, const u8 *addr)
int	hostapd_probe_req_rx (struct hostapd_data *hapd, const u8 *sa, const u8 *da, const u8 *bssid, const u8 *ie, size_t ie_len, int ssi_signal)

---

Detailed Description

hostapd / Initialization and configuration

Copyright

Copyright (c) 2002-2009, Jouni Malinen <j@w1.fi>

This software may be distributed under the terms of the BSD license. See README for more details.

---

Function Documentation

struct hostapd_data* hostapd_alloc_bss_data	(	struct hostapd_iface *	hapd_iface,
		struct hostapd_config *	conf,
		struct hostapd_bss_config *	bss
	)		[read]

Allocate and initialize per-BSS data.

Parameters:

hapd_iface	Pointer to interface data
conf	Pointer to per-interface configuration
bss	Pointer to per-BSS configuration for this BSS

Returns:

Pointer to allocated BSS data

This function is used to allocate per-BSS data structure. This data will be freed after hostapd_cleanup() is called for it during interface deinitialization.

void hostapd_new_assoc_sta	(	struct hostapd_data *	hapd,
		struct sta_info *	sta,
		int	reassoc
	)

Notify that a new station associated with the AP.

Parameters:

hapd	Pointer to BSS data
sta	Pointer to the associated STA data
reassoc	1 to indicate this was a re-association; 0 = first association

This function will be called whenever a station associates with the AP. It can be called from ieee802_11.c for drivers that export MLME to hostapd and from drv_callbacks.c based on driver events for drivers that take care of management frames (IEEE 802.11 authentication and association) internally.

void hostapd_prune_associations	(	struct hostapd_data *	hapd,
		const u8 *	addr
	)

Remove extraneous associations.

Parameters:

hapd	Pointer to BSS data for the most recent association
addr	Associated STA address

This function looks through all radios and BSS's for previous (stale) associations of STA. If any are found they are removed.

int hostapd_setup_interface

(

struct hostapd_iface *

iface

)

Setup of an interface.

Parameters:

iface

Pointer to interface data.

Returns:

0 on success, -1 on failure

Initializes the driver interface, validates the configuration, and sets driver parameters based on the configuration. Flushes old stations, sets the channel, encryption, beacons, and WDS links based on the configuration.