config_winreg.c File Reference

WPA Supplicant / Configuration backend: Windows registry. More...

#include "includes.h"
#include "common.h"
#include "uuid.h"
#include "config.h"

Macros
#define	WPA_KEY_ROOT   HKEY_LOCAL_MACHINE
#define	WPA_KEY_PREFIX   TEXT("SOFTWARE\\wpa_supplicant")
#define	TSTR   "%s"
#define	TNAMELEN   255
#define	STR(t)   write_str(netw, #t, ssid)
#define	INT(t)   write_int(netw, #t, ssid->t, 0)
#define	INTe(t)   write_int(netw, #t, ssid->eap.t, 0)
#define	INT_DEF(t, def)   write_int(netw, #t, ssid->t, def)
#define	INT_DEFe(t, def)   write_int(netw, #t, ssid->eap.t, def)

Functions
struct wpa_config *	wpa_config_read (const char *name, struct wpa_config *cfgp)
	Read and parse configuration database. More...
int	wpa_config_write (const char *name, struct wpa_config *config)
	Write or update configuration data. More...

Detailed Description

WPA Supplicant / Configuration backend: Windows registry.

This file implements a configuration backend for Windows registry. All the configuration information is stored in the registry and the format for network configuration fields is same as described in the sample configuration file, wpa_supplicant.conf.

Configuration data is in HKEY_LOCAL_MACHINE\SOFTWARE\wpa_supplicant\configs key. Each configuration profile has its own key under this. In terms of text files, each profile would map to a separate text file with possibly multiple networks. Under each profile, there is a networks key that lists all networks as a subkey. Each network has set of values in the same way as network block in the configuration file. In addition, blobs subkey has possible blobs as values.

Example network configuration block:

HKEY_LOCAL_MACHINE\SOFTWARE\wpa_supplicant\configs\test\networks\0000
   ssid="example"
   key_mgmt=WPA-PSK

Function Documentation

struct wpa_config* wpa_config_read	(	const char *	name,
		struct wpa_config *	cfgp
	)

Read and parse configuration database.

Parameters

name	Name of the configuration (e.g., path and file name for the configuration file)
cfgp	Pointer to previously allocated configuration data or NULL if none

Returns

Pointer to allocated configuration data or NULL on failure

This function reads configuration data, parses its contents, and allocates data structures needed for storing configuration information. The allocated data can be freed with wpa_config_free().

Each configuration backend needs to implement this function.

int wpa_config_write	(	const char *	name,
		struct wpa_config *	config
	)

Write or update configuration data.

Parameters

name	Name of the configuration (e.g., path and file name for the configuration file)
config	Configuration data from wpa_config_read()

Returns

0 on success, -1 on failure

This function write all configuration data into an external database (e.g., a text file) in a format that can be read with wpa_config_read(). This can be used to allow wpa_supplicant to update its configuration, e.g., when a new network is added or a password is changed.

Each configuration backend needs to implement this function.