config_file.c File Reference

WPA Supplicant / Configuration backend: text file. More...

#include "includes.h"
#include "common.h"
#include "config.h"
#include "base64.h"
#include "uuid.h"
#include "p2p/p2p.h"
#include "eap_peer/eap_methods.h"
#include "eap_peer/eap.h"

Macros
#define	STR(t)   write_str(f, #t, ssid)
#define	INT(t)   write_int(f, #t, ssid->t, 0)
#define	INTe(t)   write_int(f, #t, ssid->eap.t, 0)
#define	INT_DEF(t, def)   write_int(f, #t, ssid->t, def)
#define	INT_DEFe(t, def)   write_int(f, #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: text file.

This file implements a configuration backend for text files. All the configuration information is stored in a text file that uses a format described in the sample configuration file, wpa_supplicant.conf.

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.