driver_wext.h File Reference

WPA Supplicant - driver_wext exported functions. More...

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
int	wpa_driver_wext_get_ifflags (struct wpa_driver_wext_data *drv, int *flags)
	Get interface flags (SIOCGIFFLAGS).
int	wpa_driver_wext_set_ifflags (struct wpa_driver_wext_data *drv, int flags)
	Set interface flags (SIOCSIFFLAGS).
int	wpa_driver_wext_get_bssid (void *priv, u8 *bssid)
	Get BSSID, SIOCGIWAP.
int	wpa_driver_wext_set_bssid (void *priv, const u8 *bssid)
	Set BSSID, SIOCSIWAP.
int	wpa_driver_wext_get_ssid (void *priv, u8 *ssid)
	Get SSID, SIOCGIWESSID.
int	wpa_driver_wext_set_ssid (void *priv, const u8 *ssid, size_t ssid_len)
	Set SSID, SIOCSIWESSID.
int	wpa_driver_wext_set_freq (void *priv, int freq)
	Set frequency/channel, SIOCSIWFREQ.
int	wpa_driver_wext_set_mode (void *priv, int mode)
	Set wireless mode (infra/adhoc), SIOCSIWMODE.
int	wpa_driver_wext_set_key (void *priv, wpa_alg alg, const u8 *addr, int key_idx, int set_tx, const u8 *seq, size_t seq_len, const u8 *key, size_t key_len)
	Configure encryption key.
int	wpa_driver_wext_scan (void *priv, const u8 *ssid, size_t ssid_len)
	Request the driver to initiate scan.
int	wpa_driver_wext_get_scan_results (void *priv, struct wpa_scan_result *results, size_t max_size)
	Fetch the latest scan results.
void	wpa_driver_wext_scan_timeout (void *eloop_ctx, void *timeout_ctx)
	Scan timeout to report scan completion.
int	wpa_driver_wext_alternative_ifindex (struct wpa_driver_wext_data *drv, const char *ifname)
void *	wpa_driver_wext_init (void *ctx, const char *ifname)
	Initialize WE driver interface.
void	wpa_driver_wext_deinit (void *priv)
	Deinitialize WE driver interface.
int	wpa_driver_wext_set_operstate (void *priv, int state)
int	wpa_driver_wext_get_version (struct wpa_driver_wext_data *drv)

---

Detailed Description

WPA Supplicant - driver_wext exported functions.

Copyright

Copyright (c) 2003-2005, 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 driver_wext.h.

---

Function Documentation

void wpa_driver_wext_deinit (  void *  priv  )

Deinitialize WE driver interface. Parameters: priv  Pointer to private wext data from wpa_driver_wext_init() Shut down driver interface and processing of driver events. Free private data buffer if one was allocated in wpa_driver_wext_init(). Definition at line 952 of file driver_wext.c. Here is the call graph for this function:

int wpa_driver_wext_get_bssid (  void *  priv, u8 *  bssid )

Get BSSID, SIOCGIWAP. Parameters: priv  Pointer to private wext data from wpa_driver_wext_init() bssid  Buffer for BSSID Returns: 0 on success, -1 on failure Definition at line 164 of file driver_wext.c.

int wpa_driver_wext_get_ifflags (  struct wpa_driver_wext_data *  drv, int *  flags )

Get interface flags (SIOCGIFFLAGS). Parameters: drv  driver_wext private data flags  Pointer to returned flags value Returns: 0 on success, -1 on failure Definition at line 819 of file driver_wext.c.

int wpa_driver_wext_get_scan_results (  void *  priv, struct wpa_scan_result *  results, size_t  max_size )

Fetch the latest scan results. Parameters: priv  Pointer to private wext data from wpa_driver_wext_init() results  Pointer to buffer for scan results max_size  Maximum number of entries (buffer size) Returns: Number of scan result entries used on success, -1 on failure If scan results include more than max_size BSSes, max_size will be returned and the remaining entries will not be included in the buffer. Definition at line 1109 of file driver_wext.c. Here is the call graph for this function:

int wpa_driver_wext_get_ssid (  void *  priv, u8 *  ssid )

Get SSID, SIOCGIWESSID. Parameters: priv  Pointer to private wext data from wpa_driver_wext_init() ssid  Buffer for the SSID; must be at least 32 bytes long Returns: SSID length on success, -1 on failure Definition at line 220 of file driver_wext.c.

void* wpa_driver_wext_init (  void *  ctx, const char *  ifname )

Initialize WE driver interface. Parameters: ctx  context to be used when calling wpa_supplicant functions, e.g., wpa_supplicant_event() ifname  interface name, e.g., wlan0 Returns: Pointer to private data, NULL on failure Definition at line 862 of file driver_wext.c. Here is the call graph for this function:

int wpa_driver_wext_scan (  void *  priv, const u8 *  ssid, size_t  ssid_len )

Request the driver to initiate scan. Parameters: priv  Pointer to private wext data from wpa_driver_wext_init() ssid  Specific SSID to scan for (ProbeReq) or NULL to scan for all SSIDs (either active scan with broadcast SSID or passive scan ssid_len  Length of the SSID Returns: 0 on success, -1 on failure Definition at line 1017 of file driver_wext.c. Here is the call graph for this function:

void wpa_driver_wext_scan_timeout (  void *  eloop_ctx, void *  timeout_ctx )

Scan timeout to report scan completion. Parameters: eloop_ctx  Unused timeout_ctx  ctx argument given to wpa_driver_wext_init() This function can be used as registered timeout when starting a scan to generate a scan completed event if the driver does not report this. Definition at line 1000 of file driver_wext.c. Here is the call graph for this function:

int wpa_driver_wext_set_bssid (  void *  priv, const u8 *  bssid )

Set BSSID, SIOCSIWAP. Parameters: priv  Pointer to private wext data from wpa_driver_wext_init() bssid  BSSID Returns: 0 on success, -1 on failure Definition at line 190 of file driver_wext.c.

int wpa_driver_wext_set_freq (  void *  priv, int  freq )

Set frequency/channel, SIOCSIWFREQ. Parameters: priv  Pointer to private wext data from wpa_driver_wext_init() freq  Frequency in MHz Returns: 0 on success, -1 on failure Definition at line 306 of file driver_wext.c.

int wpa_driver_wext_set_ifflags (  struct wpa_driver_wext_data *  drv, int  flags )

Set interface flags (SIOCSIFFLAGS). Parameters: drv  driver_wext private data flags  New value for flags Returns: 0 on success, -1 on failure Definition at line 848 of file driver_wext.c.

int wpa_driver_wext_set_key (  void *  priv, wpa_alg  alg, const u8 *  addr, int  key_idx, int  set_tx, const u8 *  seq, size_t  seq_len, const u8 *  key, size_t  key_len )

Configure encryption key. Parameters: priv  Pointer to private wext data from wpa_driver_wext_init() priv  Private driver interface data alg  Encryption algorithm (WPA_ALG_NONE, WPA_ALG_WEP, WPA_ALG_TKIP, WPA_ALG_CCMP); WPA_ALG_NONE clears the key. addr  Address of the peer STA or ff:ff:ff:ff:ff:ff for broadcast/default keys key_idx  key index (0..3), usually 0 for unicast keys set_tx  Configure this key as the default Tx key (only used when driver does not support separate unicast/individual key seq  Sequence number/packet number, seq_len octets, the next packet number to be used for in replay protection; configured for Rx keys (in most cases, this is only used with broadcast keys and set to zero for unicast keys) seq_len  Length of the seq, depends on the algorithm: TKIP: 6 octets, CCMP: 6 octets key  Key buffer; TKIP: 16-byte temporal key, 8-byte Tx Mic key, 8-byte Rx Mic Key key_len  Length of the key buffer in octets (WEP: 5 or 13, TKIP: 32, CCMP: 16) Returns: 0 on success, -1 on failure This function uses SIOCSIWENCODEEXT by default, but tries to use SIOCSIWENCODE if the extended ioctl fails when configuring a WEP key. Definition at line 1571 of file driver_wext.c. Here is the call graph for this function:

int wpa_driver_wext_set_mode (  void *  priv, int  mode )

Set wireless mode (infra/adhoc), SIOCSIWMODE. Parameters: priv  Pointer to private wext data from wpa_driver_wext_init() mode  0 = infra/BSS (associate with an AP), 1 = adhoc/IBSS Returns: 0 on success, -1 on failure Definition at line 1909 of file driver_wext.c.

int wpa_driver_wext_set_ssid (  void *  priv, const u8 *  ssid, size_t  ssid_len )

Set SSID, SIOCSIWESSID. Parameters: priv  Pointer to private wext data from wpa_driver_wext_init() ssid  SSID ssid_len  Length of SSID (0..32) Returns: 0 on success, -1 on failure Definition at line 259 of file driver_wext.c.

---