wpa_ctrl.h

Go to the documentation of this file.

/*
 * wpa_supplicant/hostapd control interface library
 * Copyright (c) 2004-2006, Jouni Malinen <j@w1.fi>
 *
 * 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.
 */

#ifndef WPA_CTRL_H
#define WPA_CTRL_H

#ifdef  __cplusplus
extern "C" {
#endif

/* wpa_supplicant control interface - fixed message prefixes */

#define WPA_CTRL_REQ "CTRL-REQ-"

#define WPA_CTRL_RSP "CTRL-RSP-"

/* Event messages with fixed prefix */
#define WPA_EVENT_CONNECTED "CTRL-EVENT-CONNECTED "

#define WPA_EVENT_DISCONNECTED "CTRL-EVENT-DISCONNECTED "

#define WPA_EVENT_TERMINATING "CTRL-EVENT-TERMINATING "

#define WPA_EVENT_PASSWORD_CHANGED "CTRL-EVENT-PASSWORD-CHANGED "

#define WPA_EVENT_EAP_NOTIFICATION "CTRL-EVENT-EAP-NOTIFICATION "

#define WPA_EVENT_EAP_STARTED "CTRL-EVENT-EAP-STARTED "

#define WPA_EVENT_EAP_PROPOSED_METHOD "CTRL-EVENT-EAP-PROPOSED-METHOD "

#define WPA_EVENT_EAP_METHOD "CTRL-EVENT-EAP-METHOD "

#define WPA_EVENT_EAP_PEER_CERT "CTRL-EVENT-EAP-PEER-CERT "

#define WPA_EVENT_EAP_TLS_CERT_ERROR "CTRL-EVENT-EAP-TLS-CERT-ERROR "

#define WPA_EVENT_EAP_SUCCESS "CTRL-EVENT-EAP-SUCCESS "

#define WPA_EVENT_EAP_FAILURE "CTRL-EVENT-EAP-FAILURE "

#define WPA_EVENT_SCAN_RESULTS "CTRL-EVENT-SCAN-RESULTS "

#define WPA_EVENT_BSS_ADDED "CTRL-EVENT-BSS-ADDED "

#define WPA_EVENT_BSS_REMOVED "CTRL-EVENT-BSS-REMOVED "

#define WPS_EVENT_OVERLAP "WPS-OVERLAP-DETECTED "

#define WPS_EVENT_AP_AVAILABLE_PBC "WPS-AP-AVAILABLE-PBC "

#define WPS_EVENT_AP_AVAILABLE_PIN "WPS-AP-AVAILABLE-PIN "

#define WPS_EVENT_AP_AVAILABLE "WPS-AP-AVAILABLE "

#define WPS_EVENT_CRED_RECEIVED "WPS-CRED-RECEIVED "

#define WPS_EVENT_M2D "WPS-M2D "

#define WPS_EVENT_FAIL "WPS-FAIL "

#define WPS_EVENT_SUCCESS "WPS-SUCCESS "

#define WPS_EVENT_TIMEOUT "WPS-TIMEOUT "

#define WPS_EVENT_ENROLLEE_SEEN "WPS-ENROLLEE-SEEN "

/* WPS ER events */
#define WPS_EVENT_ER_AP_ADD "WPS-ER-AP-ADD "
#define WPS_EVENT_ER_AP_REMOVE "WPS-ER-AP-REMOVE "
#define WPS_EVENT_ER_ENROLLEE_ADD "WPS-ER-ENROLLEE-ADD "
#define WPS_EVENT_ER_ENROLLEE_REMOVE "WPS-ER-ENROLLEE-REMOVE "

/* hostapd control interface - fixed message prefixes */
#define WPS_EVENT_PIN_NEEDED "WPS-PIN-NEEDED "
#define WPS_EVENT_NEW_AP_SETTINGS "WPS-NEW-AP-SETTINGS "
#define WPS_EVENT_REG_SUCCESS "WPS-REG-SUCCESS "
#define WPS_EVENT_AP_SETUP_LOCKED "WPS-AP-SETUP-LOCKED "
#define WPS_EVENT_AP_SETUP_UNLOCKED "WPS-AP-SETUP-UNLOCKED "
#define WPS_EVENT_AP_PIN_ENABLED "WPS-AP-PIN-ENABLED "
#define WPS_EVENT_AP_PIN_DISABLED "WPS-AP-PIN-DISABLED "
#define AP_STA_CONNECTED "AP-STA-CONNECTED "
#define AP_STA_DISCONNECTED "AP-STA-DISCONNECTED "


/* wpa_supplicant/hostapd control interface access */

struct wpa_ctrl * wpa_ctrl_open(const char *ctrl_path);


void wpa_ctrl_close(struct wpa_ctrl *ctrl);


int wpa_ctrl_request(struct wpa_ctrl *ctrl, const char *cmd, size_t cmd_len,
             char *reply, size_t *reply_len,
             void (*msg_cb)(char *msg, size_t len));


int wpa_ctrl_attach(struct wpa_ctrl *ctrl);


int wpa_ctrl_detach(struct wpa_ctrl *ctrl);


int wpa_ctrl_recv(struct wpa_ctrl *ctrl, char *reply, size_t *reply_len);


int wpa_ctrl_pending(struct wpa_ctrl *ctrl);


int wpa_ctrl_get_fd(struct wpa_ctrl *ctrl);

#ifdef CONFIG_CTRL_IFACE_UDP
#define WPA_CTRL_IFACE_PORT 9877
#define WPA_GLOBAL_CTRL_IFACE_PORT 9878
#endif /* CONFIG_CTRL_IFACE_UDP */


#ifdef  __cplusplus
}
#endif

#endif /* WPA_CTRL_H */