2014-06-21 13:41:40 +02:00
|
|
|
/*
|
|
|
|
*
|
|
|
|
* Wireless daemon for Linux
|
|
|
|
*
|
2019-10-25 00:43:08 +02:00
|
|
|
* Copyright (C) 2013-2019 Intel Corporation. All rights reserved.
|
2014-06-21 13:41:40 +02:00
|
|
|
*
|
|
|
|
* This library is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
|
|
* License as published by the Free Software Foundation; either
|
|
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This library is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
* Lesser General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
|
|
* License along with this library; if not, write to the Free Software
|
|
|
|
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include <stdbool.h>
|
|
|
|
|
2015-09-29 02:44:26 +02:00
|
|
|
struct netdev;
|
2018-08-17 21:59:01 +02:00
|
|
|
struct device;
|
2016-06-14 18:17:43 +02:00
|
|
|
struct scan_bss;
|
2016-11-02 23:46:19 +01:00
|
|
|
struct handshake_state;
|
|
|
|
struct eapol_sm;
|
2017-08-31 04:04:45 +02:00
|
|
|
struct mmpdu_header;
|
2016-06-14 18:17:43 +02:00
|
|
|
|
|
|
|
enum netdev_result {
|
|
|
|
NETDEV_RESULT_OK,
|
|
|
|
NETDEV_RESULT_AUTHENTICATION_FAILED,
|
|
|
|
NETDEV_RESULT_ASSOCIATION_FAILED,
|
|
|
|
NETDEV_RESULT_HANDSHAKE_FAILED,
|
|
|
|
NETDEV_RESULT_KEY_SETTING_FAILED,
|
2016-07-26 14:42:21 +02:00
|
|
|
NETDEV_RESULT_ABORTED,
|
2016-06-14 18:17:43 +02:00
|
|
|
};
|
|
|
|
|
|
|
|
enum netdev_event {
|
|
|
|
NETDEV_EVENT_AUTHENTICATING,
|
|
|
|
NETDEV_EVENT_ASSOCIATING,
|
|
|
|
NETDEV_EVENT_LOST_BEACON,
|
2016-06-16 18:21:12 +02:00
|
|
|
NETDEV_EVENT_DISCONNECT_BY_AP,
|
2016-12-12 18:34:28 +01:00
|
|
|
NETDEV_EVENT_DISCONNECT_BY_SME,
|
2016-12-23 11:38:03 +01:00
|
|
|
NETDEV_EVENT_RSSI_THRESHOLD_LOW,
|
|
|
|
NETDEV_EVENT_RSSI_THRESHOLD_HIGH,
|
2017-05-20 16:33:13 +02:00
|
|
|
NETDEV_EVENT_RSSI_LEVEL_NOTIFY,
|
2016-06-14 18:17:43 +02:00
|
|
|
};
|
2015-09-29 02:44:26 +02:00
|
|
|
|
2016-07-14 02:38:05 +02:00
|
|
|
enum netdev_watch_event {
|
2018-08-18 06:40:49 +02:00
|
|
|
NETDEV_WATCH_EVENT_NEW,
|
|
|
|
NETDEV_WATCH_EVENT_DEL,
|
2016-07-20 01:03:21 +02:00
|
|
|
NETDEV_WATCH_EVENT_UP,
|
|
|
|
NETDEV_WATCH_EVENT_DOWN,
|
|
|
|
NETDEV_WATCH_EVENT_NAME_CHANGE,
|
2017-03-08 15:07:14 +01:00
|
|
|
NETDEV_WATCH_EVENT_ADDRESS_CHANGE,
|
2016-07-14 02:38:05 +02:00
|
|
|
};
|
|
|
|
|
2017-08-14 14:49:16 +02:00
|
|
|
enum netdev_iftype {
|
2018-08-07 23:11:10 +02:00
|
|
|
NETDEV_IFTYPE_ADHOC = 1,
|
|
|
|
NETDEV_IFTYPE_STATION = 2,
|
|
|
|
NETDEV_IFTYPE_AP = 3,
|
2019-03-11 15:43:21 +01:00
|
|
|
NETDEV_IFTYPE_P2P_CLIENT,
|
|
|
|
NETDEV_IFTYPE_P2P_GO,
|
2017-08-14 14:49:16 +02:00
|
|
|
};
|
|
|
|
|
2018-08-20 01:25:23 +02:00
|
|
|
typedef void (*netdev_command_cb_t)(struct netdev *netdev, int result,
|
|
|
|
void *user_data);
|
2019-02-28 18:32:40 +01:00
|
|
|
/*
|
|
|
|
* Callback for a connection attempt. This callback is called on both success
|
|
|
|
* and failure. Depending on result, the event_data will have different
|
|
|
|
* meanings:
|
|
|
|
*
|
|
|
|
* NETDEV_RESULT_OK - unused
|
|
|
|
* NETDEV_RESULT_AUTHENTICATION_FAILED - MMPDU_STATUS_CODE
|
|
|
|
* NETDEV_RESULT_ASSOCIATION_FAILED - MMPDU_STATUS_CODE
|
|
|
|
* NETDEV_RESULT_HANDSHAKE_FAILED - MMPDU_REASON_CODE
|
|
|
|
* NETDEV_RESULT_KEY_SETTINGS_FAILED - unused
|
|
|
|
* NETDEV_RESULT_ABORTED - unused.
|
|
|
|
*/
|
2016-06-14 18:17:43 +02:00
|
|
|
typedef void (*netdev_connect_cb_t)(struct netdev *netdev,
|
|
|
|
enum netdev_result result,
|
2019-02-28 18:32:40 +01:00
|
|
|
void *event_data,
|
2016-06-14 18:17:43 +02:00
|
|
|
void *user_data);
|
2019-03-01 00:41:51 +01:00
|
|
|
/*
|
|
|
|
* Notify function for netdev events. Depending on the event type, event_data
|
|
|
|
* will have different meanings:
|
|
|
|
*
|
|
|
|
* NETDEV_EVENT_AUTHENTICATING - unsused
|
|
|
|
* NETDEV_EVENT_ASSOCIATING - unused
|
|
|
|
* NETDEV_EVENT_LOST_BEACON - unused
|
|
|
|
* NETDEV_EVENT_DISCONNECT_BY_AP - MMPDU_REASON_CODE
|
|
|
|
* NETDEV_EVENT_DISCONNECT_BY_SME - MMPDU_REASON_CODE
|
|
|
|
* NETDEV_EVENT_RSSI_THRESHOLD_LOW - unused
|
|
|
|
* NETDEV_EVENT_RSSI_THRESHOLD_HIGH - unused
|
|
|
|
* NETDEV_EVENT_RSSI_LEVEL_NOTIFY - rssi level index (uint8_t)
|
|
|
|
*/
|
2016-06-14 18:17:43 +02:00
|
|
|
typedef void (*netdev_event_func_t)(struct netdev *netdev,
|
|
|
|
enum netdev_event event,
|
2019-03-01 00:41:51 +01:00
|
|
|
void *event_data,
|
2016-06-14 18:17:43 +02:00
|
|
|
void *user_data);
|
2016-06-14 19:15:18 +02:00
|
|
|
typedef void (*netdev_disconnect_cb_t)(struct netdev *netdev, bool result,
|
|
|
|
void *user_data);
|
2016-07-14 02:38:05 +02:00
|
|
|
typedef void (*netdev_watch_func_t)(struct netdev *netdev,
|
|
|
|
enum netdev_watch_event event,
|
2016-06-20 12:42:04 +02:00
|
|
|
void *user_data);
|
2016-07-13 04:26:27 +02:00
|
|
|
typedef void (*netdev_destroy_func_t)(void *user_data);
|
2016-12-12 18:34:18 +01:00
|
|
|
typedef void (*netdev_eapol_event_func_t)(unsigned int event,
|
|
|
|
const void *event_data,
|
|
|
|
void *user_data);
|
2017-01-23 12:38:40 +01:00
|
|
|
typedef void (*netdev_neighbor_report_cb_t)(struct netdev *netdev, int err,
|
2016-12-23 11:38:01 +01:00
|
|
|
const uint8_t *reports,
|
|
|
|
size_t reports_len, void *user_data);
|
2017-04-29 03:53:27 +02:00
|
|
|
typedef void (*netdev_preauthenticate_cb_t)(struct netdev *netdev,
|
|
|
|
enum netdev_result result,
|
|
|
|
const uint8_t *pmk, void *user_data);
|
2017-08-31 04:04:45 +02:00
|
|
|
typedef void (*netdev_frame_watch_func_t)(struct netdev *netdev,
|
|
|
|
const struct mmpdu_header *frame,
|
|
|
|
const void *body, size_t body_len,
|
|
|
|
void *user_data);
|
2018-07-17 00:29:15 +02:00
|
|
|
typedef void (*netdev_station_watch_func_t)(struct netdev *netdev,
|
|
|
|
const uint8_t *mac, bool added,
|
|
|
|
void *user_data);
|
2015-03-27 08:54:24 +01:00
|
|
|
|
2018-05-24 19:12:09 +02:00
|
|
|
struct wiphy *netdev_get_wiphy(struct netdev *netdev);
|
2016-06-01 22:27:39 +02:00
|
|
|
const uint8_t *netdev_get_address(struct netdev *netdev);
|
2016-06-01 22:27:05 +02:00
|
|
|
uint32_t netdev_get_ifindex(struct netdev *netdev);
|
2019-07-08 16:02:58 +02:00
|
|
|
uint64_t netdev_get_wdev_id(struct netdev *netdev);
|
2017-08-14 14:49:16 +02:00
|
|
|
enum netdev_iftype netdev_get_iftype(struct netdev *netdev);
|
2018-08-20 05:07:15 +02:00
|
|
|
int netdev_set_iftype(struct netdev *netdev, enum netdev_iftype type,
|
|
|
|
netdev_command_cb_t cb, void *user_data,
|
|
|
|
netdev_destroy_func_t destroy);
|
2018-06-14 04:11:23 +02:00
|
|
|
int netdev_set_4addr(struct netdev *netdev, bool use_4addr,
|
2018-08-20 01:25:23 +02:00
|
|
|
netdev_command_cb_t cb, void *user_data,
|
2018-06-14 04:11:23 +02:00
|
|
|
netdev_destroy_func_t destroy);
|
|
|
|
bool netdev_get_4addr(struct netdev *netdev);
|
2016-06-02 00:05:56 +02:00
|
|
|
const char *netdev_get_name(struct netdev *netdev);
|
2016-06-20 12:42:03 +02:00
|
|
|
bool netdev_get_is_up(struct netdev *netdev);
|
2018-08-17 21:59:01 +02:00
|
|
|
struct device *netdev_get_device(struct netdev *netdev);
|
2018-08-20 06:12:14 +02:00
|
|
|
const char *netdev_get_path(struct netdev *netdev);
|
2018-06-22 02:32:55 +02:00
|
|
|
|
|
|
|
struct handshake_state *netdev_handshake_state_new(struct netdev *netdev);
|
2016-12-23 11:38:07 +01:00
|
|
|
struct handshake_state *netdev_get_handshake(struct netdev *netdev);
|
2016-06-01 22:27:05 +02:00
|
|
|
|
2016-06-14 18:17:43 +02:00
|
|
|
int netdev_connect(struct netdev *netdev, struct scan_bss *bss,
|
2016-12-12 18:34:20 +01:00
|
|
|
struct handshake_state *hs,
|
2019-09-06 20:11:05 +02:00
|
|
|
const struct iovec *vendor_ies,
|
2019-07-12 23:00:01 +02:00
|
|
|
size_t num_vendor_ies,
|
2016-06-14 18:17:43 +02:00
|
|
|
netdev_event_func_t event_filter,
|
|
|
|
netdev_connect_cb_t cb, void *user_data);
|
2016-09-14 03:50:24 +02:00
|
|
|
int netdev_connect_wsc(struct netdev *netdev, struct scan_bss *bss,
|
2016-12-12 18:34:18 +01:00
|
|
|
struct handshake_state *hs,
|
2016-09-14 03:50:24 +02:00
|
|
|
netdev_event_func_t event_filter,
|
2016-12-12 18:34:18 +01:00
|
|
|
netdev_connect_cb_t cb,
|
|
|
|
netdev_eapol_event_func_t eapol_cb,
|
|
|
|
void *user_data);
|
2016-06-14 19:15:18 +02:00
|
|
|
int netdev_disconnect(struct netdev *netdev,
|
|
|
|
netdev_disconnect_cb_t cb, void *user_data);
|
2017-03-31 14:43:01 +02:00
|
|
|
int netdev_reassociate(struct netdev *netdev, struct scan_bss *target_bss,
|
2017-08-14 14:31:19 +02:00
|
|
|
struct scan_bss *orig_bss, struct handshake_state *hs,
|
|
|
|
netdev_event_func_t event_filter,
|
|
|
|
netdev_connect_cb_t cb, void *user_data);
|
2017-01-12 09:36:00 +01:00
|
|
|
int netdev_fast_transition(struct netdev *netdev, struct scan_bss *target_bss,
|
|
|
|
netdev_connect_cb_t cb);
|
2019-05-09 20:16:28 +02:00
|
|
|
int netdev_fast_transition_over_ds(struct netdev *netdev,
|
|
|
|
struct scan_bss *target_bss,
|
|
|
|
netdev_connect_cb_t cb);
|
2017-04-29 03:53:27 +02:00
|
|
|
int netdev_preauthenticate(struct netdev *netdev, struct scan_bss *target_bss,
|
|
|
|
netdev_preauthenticate_cb_t cb,
|
|
|
|
void *user_data);
|
2016-06-14 18:17:43 +02:00
|
|
|
|
2018-07-03 23:36:34 +02:00
|
|
|
int netdev_del_station(struct netdev *netdev, const uint8_t *sta,
|
|
|
|
uint16_t reason_code, bool disassociate);
|
|
|
|
|
2018-07-17 23:15:59 +02:00
|
|
|
int netdev_join_adhoc(struct netdev *netdev, const char *ssid,
|
|
|
|
struct iovec *extra_ie, size_t extra_ie_elems,
|
2018-08-20 01:25:23 +02:00
|
|
|
bool control_port, netdev_command_cb_t cb,
|
2018-07-17 23:15:59 +02:00
|
|
|
void *user_data);
|
2018-08-20 01:25:23 +02:00
|
|
|
int netdev_leave_adhoc(struct netdev *netdev, netdev_command_cb_t cb,
|
2018-07-17 23:15:59 +02:00
|
|
|
void *user_data);
|
|
|
|
|
2016-07-13 04:26:27 +02:00
|
|
|
int netdev_set_powered(struct netdev *netdev, bool powered,
|
2018-08-20 01:25:23 +02:00
|
|
|
netdev_command_cb_t cb, void *user_data,
|
2016-07-13 04:26:27 +02:00
|
|
|
netdev_destroy_func_t destroy);
|
|
|
|
|
2016-12-23 11:38:01 +01:00
|
|
|
int netdev_neighbor_report_req(struct netdev *netdev,
|
|
|
|
netdev_neighbor_report_cb_t cb);
|
|
|
|
|
2017-05-20 16:33:13 +02:00
|
|
|
int netdev_set_rssi_report_levels(struct netdev *netdev, const int8_t *levels,
|
|
|
|
size_t levels_num);
|
|
|
|
|
2017-08-31 04:04:45 +02:00
|
|
|
uint32_t netdev_frame_watch_add(struct netdev *netdev, uint16_t frame_type,
|
|
|
|
const uint8_t *prefix, size_t prefix_len,
|
|
|
|
netdev_frame_watch_func_t handler,
|
|
|
|
void *user_data);
|
|
|
|
bool netdev_frame_watch_remove(struct netdev *netdev, uint32_t id);
|
|
|
|
|
2018-07-03 23:36:33 +02:00
|
|
|
void netdev_handshake_failed(struct handshake_state *hs, uint16_t reason_code);
|
2018-06-27 23:08:24 +02:00
|
|
|
|
2016-06-01 22:35:26 +02:00
|
|
|
struct netdev *netdev_find(int ifindex);
|
|
|
|
|
2018-08-18 06:40:49 +02:00
|
|
|
uint32_t netdev_watch_add(netdev_watch_func_t func,
|
|
|
|
void *user_data, netdev_destroy_func_t destroy);
|
|
|
|
bool netdev_watch_remove(uint32_t id);
|
2016-06-20 12:42:04 +02:00
|
|
|
|
2018-07-17 00:29:15 +02:00
|
|
|
uint32_t netdev_station_watch_add(struct netdev *netdev,
|
|
|
|
netdev_station_watch_func_t func, void *user_data);
|
|
|
|
|
|
|
|
bool netdev_station_watch_remove(struct netdev *netdev, uint32_t id);
|
2019-04-11 03:10:20 +02:00
|
|
|
|
2019-07-02 01:29:37 +02:00
|
|
|
struct netdev *netdev_create_from_genl(struct l_genl_msg *msg, bool random_mac);
|
2019-04-11 03:10:20 +02:00
|
|
|
bool netdev_destroy(struct netdev *netdev);
|