wps_registrar_config Struct Reference

WPS Registrar configuration. More...

#include <wps.h>

Data Fields

int(* new_psk_cb )(void *ctx, const u8 *mac_addr, const u8 *psk, size_t psk_len)
 Callback for new PSK.
int(* set_ie_cb )(void *ctx, const u8 *beacon_ie, size_t beacon_ie_len, const u8 *probe_resp_ie, size_t probe_resp_ie_len)
 Callback for WPS IE changes.
void(* pin_needed_cb )(void *ctx, const u8 *uuid_e, const struct wps_device_data *dev)
 Callback for requesting a PIN.
void(* reg_success_cb )(void *ctx, const u8 *mac_addr, const u8 *uuid_e)
 Callback for reporting successful registration.
void(* set_sel_reg_cb )(void *ctx, int sel_reg, u16 dev_passwd_id, u16 sel_reg_config_methods)
 Callback for reporting selected registrar changes.
void * cb_ctx
int skip_cred_build
const u8 * extra_cred
size_t extra_cred_len
int disable_auto_conf
 Disable auto-configuration on first registration.
int static_wep_only
 Whether the BSS supports only static WEP.

Detailed Description

WPS Registrar configuration.

Definition at line 216 of file wps.h.


Field Documentation

cb_ctx: Higher layer context data for Registrar callbacks

Definition at line 296 of file wps.h.

Disable auto-configuration on first registration.

By default, the AP that is started in not configured state will generate a random PSK and move to configured state when the first registration protocol run is completed successfully. This option can be used to disable this functionality and leave it up to an external program to take care of configuration. This requires the extra_cred to be set with a suitable Credential and skip_cred_build being used.

Definition at line 334 of file wps.h.

extra_cred: Additional Credential attribute(s)

This optional data (set to NULL to disable) can be used to add Credential attribute(s) for other networks into M8. If skip_cred_build is set, this will also override the automatically generated Credential attribute.

Definition at line 316 of file wps.h.

extra_cred_len: Length of extra_cred in octets

Definition at line 321 of file wps.h.

int(* wps_registrar_config::new_psk_cb)(void *ctx, const u8 *mac_addr, const u8 *psk, size_t psk_len)

Callback for new PSK.

Parameters:
ctx Higher layer context data (cb_ctx)
mac_addr MAC address of the Enrollee
psk The new PSK
psk_len The length of psk in octets
Returns:
0 on success, -1 on failure

This callback is called when a new per-device PSK is provisioned.

void(* wps_registrar_config::pin_needed_cb)(void *ctx, const u8 *uuid_e, const struct wps_device_data *dev)

Callback for requesting a PIN.

Parameters:
ctx Higher layer context data (cb_ctx)
uuid_e UUID-E of the unknown Enrollee
dev Device Data from the unknown Enrollee

This callback is called whenever an unknown Enrollee requests to use PIN method and a matching PIN (Device Password) is not found in Registrar data.

void(* wps_registrar_config::reg_success_cb)(void *ctx, const u8 *mac_addr, const u8 *uuid_e)

Callback for reporting successful registration.

Parameters:
ctx Higher layer context data (cb_ctx)
mac_addr MAC address of the Enrollee
uuid_e UUID-E of the Enrollee

This callback is called whenever an Enrollee completes registration successfully.

int(* wps_registrar_config::set_ie_cb)(void *ctx, const u8 *beacon_ie, size_t beacon_ie_len, const u8 *probe_resp_ie, size_t probe_resp_ie_len)

Callback for WPS IE changes.

Parameters:
ctx Higher layer context data (cb_ctx)
beacon_ie WPS IE for Beacon
beacon_ie_len WPS IE length for Beacon
probe_resp_ie WPS IE for Probe Response
probe_resp_ie_len WPS IE length for Probe Response
Returns:
0 on success, -1 on failure

This callback is called whenever the WPS IE in Beacon or Probe Response frames needs to be changed (AP only).

void(* wps_registrar_config::set_sel_reg_cb)(void *ctx, int sel_reg, u16 dev_passwd_id, u16 sel_reg_config_methods)

Callback for reporting selected registrar changes.

Parameters:
ctx Higher layer context data (cb_ctx)
sel_reg Whether the Registrar is selected
dev_passwd_id Device Password ID to indicate with method or specific password the Registrar intends to use
sel_reg_config_methods Bit field of active config methods

This callback is called whenever the Selected Registrar state changes (e.g., a new PIN becomes available or PBC is invoked). This callback is only used by External Registrar implementation; set_ie_cb() is used by AP implementation in similar caes, but it provides the full WPS IE data instead of just the minimal Registrar state information.

skip_cred_build: Do not build credential

This option can be used to disable internal code that builds Credential attribute into M8 based on the current network configuration and Enrollee capabilities. The extra_cred data will then be used as the Credential(s).

Definition at line 306 of file wps.h.


The documentation for this struct was generated from the following file:
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Defines

Generated on Sat Nov 21 23:26:21 2009 for hostapd by  doxygen 1.6.1