wpa_ctrl.c File Reference

wpa_supplicant/hostapd control interface library More...

#include "includes.h"
#include "wpa_ctrl.h"
#include "common.h"

Data Structures
struct	wpa_ctrl
	Internal structure for control interface library. More...
Functions
int	wpa_ctrl_attach (struct wpa_ctrl *ctrl)
	Register as an event monitor for the control interface.
int	wpa_ctrl_detach (struct wpa_ctrl *ctrl)
	Unregister event monitor from the control interface.

---

Detailed Description

wpa_supplicant/hostapd control interface library

Copyright

Copyright (c) 2004-2007, Jouni Malinen <j@w1.fi>

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

---

Function Documentation

int wpa_ctrl_attach

(

struct wpa_ctrl *

ctrl

)

Register as an event monitor for the control interface.

Parameters:

ctrl	Control interface data from wpa_ctrl_open()

Returns:

0 on success, -1 on failure, -2 on timeout

This function registers the control interface connection as a monitor for wpa_supplicant/hostapd events. After a success wpa_ctrl_attach() call, the control interface connection starts receiving event messages that can be read with wpa_ctrl_recv().

int wpa_ctrl_detach

(

struct wpa_ctrl *

ctrl

)

Unregister event monitor from the control interface.

Parameters:

ctrl	Control interface data from wpa_ctrl_open()

Returns:

0 on success, -1 on failure, -2 on timeout

This function unregisters the control interface connection as a monitor for wpa_supplicant/hostapd events, i.e., cancels the registration done with wpa_ctrl_attach().