mirror of
https://gitlab.freedesktop.org/NetworkManager/NetworkManager.git
synced 2026-05-23 10:38:10 +02:00
2eb398648f
While we request a scan, we are not yet actually scanning. That means, the supplicant's
"scanning" property will only change to TRUE a while after we initiate the scan. It may
even never happen.
We thus need to handle that the request is currently pending and react when the
request completes.
(cherry picked from commit 16c1869476)
192 lines
8.5 KiB
C
192 lines
8.5 KiB
C
// SPDX-License-Identifier: GPL-2.0+
|
|
/*
|
|
* Copyright (C) 2006 - 2017 Red Hat, Inc.
|
|
* Copyright (C) 2007 - 2008 Novell, Inc.
|
|
*/
|
|
|
|
#ifndef __NM_SUPPLICANT_INTERFACE_H__
|
|
#define __NM_SUPPLICANT_INTERFACE_H__
|
|
|
|
#include "nm-supplicant-types.h"
|
|
|
|
#include "c-list/src/c-list.h"
|
|
|
|
/*
|
|
* Supplicant interface states
|
|
* A mix of wpa_supplicant interface states and internal states.
|
|
*/
|
|
typedef enum {
|
|
NM_SUPPLICANT_INTERFACE_STATE_INVALID = 0,
|
|
|
|
NM_SUPPLICANT_INTERFACE_STATE_STARTING = 1,
|
|
|
|
NM_SUPPLICANT_INTERFACE_STATE_DISABLED,
|
|
NM_SUPPLICANT_INTERFACE_STATE_DISCONNECTED,
|
|
NM_SUPPLICANT_INTERFACE_STATE_INACTIVE,
|
|
NM_SUPPLICANT_INTERFACE_STATE_SCANNING,
|
|
NM_SUPPLICANT_INTERFACE_STATE_AUTHENTICATING,
|
|
NM_SUPPLICANT_INTERFACE_STATE_ASSOCIATING,
|
|
NM_SUPPLICANT_INTERFACE_STATE_ASSOCIATED,
|
|
NM_SUPPLICANT_INTERFACE_STATE_4WAY_HANDSHAKE,
|
|
NM_SUPPLICANT_INTERFACE_STATE_GROUP_HANDSHAKE,
|
|
NM_SUPPLICANT_INTERFACE_STATE_COMPLETED,
|
|
|
|
NM_SUPPLICANT_INTERFACE_STATE_DOWN,
|
|
} NMSupplicantInterfaceState;
|
|
|
|
static inline gboolean
|
|
nm_supplicant_interface_state_is_operational (NMSupplicantInterfaceState state)
|
|
{
|
|
return state > NM_SUPPLICANT_INTERFACE_STATE_STARTING
|
|
&& state < NM_SUPPLICANT_INTERFACE_STATE_DOWN;
|
|
}
|
|
|
|
static inline gboolean
|
|
nm_supplicant_interface_state_is_associated (NMSupplicantInterfaceState state)
|
|
{
|
|
return state >= NM_SUPPLICANT_INTERFACE_STATE_AUTHENTICATING
|
|
&& state <= NM_SUPPLICANT_INTERFACE_STATE_COMPLETED;
|
|
}
|
|
|
|
typedef enum {
|
|
NM_SUPPLICANT_AUTH_STATE_UNKNOWN,
|
|
NM_SUPPLICANT_AUTH_STATE_STARTED,
|
|
NM_SUPPLICANT_AUTH_STATE_SUCCESS,
|
|
NM_SUPPLICANT_AUTH_STATE_FAILURE,
|
|
_NM_SUPPLICANT_AUTH_STATE_NUM,
|
|
} NMSupplicantAuthState;
|
|
|
|
#define NM_TYPE_SUPPLICANT_INTERFACE (nm_supplicant_interface_get_type ())
|
|
#define NM_SUPPLICANT_INTERFACE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), NM_TYPE_SUPPLICANT_INTERFACE, NMSupplicantInterface))
|
|
#define NM_SUPPLICANT_INTERFACE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), NM_TYPE_SUPPLICANT_INTERFACE, NMSupplicantInterfaceClass))
|
|
#define NM_IS_SUPPLICANT_INTERFACE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), NM_TYPE_SUPPLICANT_INTERFACE))
|
|
#define NM_IS_SUPPLICANT_INTERFACE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), NM_TYPE_SUPPLICANT_INTERFACE))
|
|
#define NM_SUPPLICANT_INTERFACE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), NM_TYPE_SUPPLICANT_INTERFACE, NMSupplicantInterfaceClass))
|
|
|
|
#define NM_SUPPLICANT_INTERFACE_SUPPLICANT_MANAGER "supplicant-manager"
|
|
#define NM_SUPPLICANT_INTERFACE_DBUS_OBJECT_PATH "dbus-object-path"
|
|
#define NM_SUPPLICANT_INTERFACE_IFINDEX "ifindex"
|
|
#define NM_SUPPLICANT_INTERFACE_SCANNING "scanning"
|
|
#define NM_SUPPLICANT_INTERFACE_CURRENT_BSS "current-bss"
|
|
#define NM_SUPPLICANT_INTERFACE_P2P_GROUP_JOINED "p2p-group-joined"
|
|
#define NM_SUPPLICANT_INTERFACE_P2P_GROUP_PATH "p2p-group-path"
|
|
#define NM_SUPPLICANT_INTERFACE_P2P_GROUP_OWNER "p2p-group-owner"
|
|
#define NM_SUPPLICANT_INTERFACE_DRIVER "driver"
|
|
#define NM_SUPPLICANT_INTERFACE_P2P_AVAILABLE "p2p-available"
|
|
#define NM_SUPPLICANT_INTERFACE_AUTH_STATE "auth-state"
|
|
|
|
#define NM_SUPPLICANT_INTERFACE_STATE "state"
|
|
#define NM_SUPPLICANT_INTERFACE_BSS_CHANGED "bss-changed"
|
|
#define NM_SUPPLICANT_INTERFACE_PEER_CHANGED "peer-changed"
|
|
#define NM_SUPPLICANT_INTERFACE_WPS_CREDENTIALS "wps-credentials"
|
|
#define NM_SUPPLICANT_INTERFACE_GROUP_STARTED "group-started"
|
|
#define NM_SUPPLICANT_INTERFACE_GROUP_FINISHED "group-finished"
|
|
|
|
typedef struct _NMSupplicantInterfaceClass NMSupplicantInterfaceClass;
|
|
|
|
struct _NMSupplicantInterfacePrivate;
|
|
|
|
struct _NMSupplicantInterface {
|
|
GObject parent;
|
|
CList supp_lst;
|
|
struct _NMSupplicantInterfacePrivate *_priv;
|
|
};
|
|
|
|
GType nm_supplicant_interface_get_type (void);
|
|
|
|
NMSupplicantInterface *nm_supplicant_interface_new (NMSupplicantManager *supplicant_manager,
|
|
NMRefString *object_path,
|
|
int ifindex,
|
|
NMSupplicantDriver driver);
|
|
|
|
NMRefString *nm_supplicant_interface_get_name_owner (NMSupplicantInterface *self);
|
|
NMRefString *nm_supplicant_interface_get_object_path (NMSupplicantInterface * iface);
|
|
|
|
void _nm_supplicant_interface_set_state_down (NMSupplicantInterface * self,
|
|
gboolean force_remove_from_supplicant,
|
|
const char *reason);
|
|
|
|
typedef void (*NMSupplicantInterfaceAssocCb) (NMSupplicantInterface *iface,
|
|
GError *error,
|
|
gpointer user_data);
|
|
|
|
void
|
|
nm_supplicant_interface_assoc (NMSupplicantInterface *self,
|
|
NMSupplicantConfig *cfg,
|
|
NMSupplicantInterfaceAssocCb callback,
|
|
gpointer user_data);
|
|
|
|
void nm_supplicant_interface_disconnect (NMSupplicantInterface * iface);
|
|
|
|
typedef void (*NMSupplicantInterfaceDisconnectCb) (NMSupplicantInterface *iface,
|
|
GError *error,
|
|
gpointer user_data);
|
|
|
|
void
|
|
nm_supplicant_interface_disconnect_async (NMSupplicantInterface * self,
|
|
GCancellable * cancellable,
|
|
NMSupplicantInterfaceDisconnectCb callback,
|
|
gpointer user_data);
|
|
|
|
typedef void (*NMSupplicantInterfaceRequestScanCallback) (NMSupplicantInterface *self,
|
|
GCancellable *cancellable,
|
|
gpointer user_data);
|
|
|
|
void nm_supplicant_interface_request_scan (NMSupplicantInterface *self,
|
|
GBytes *const*ssids,
|
|
guint ssids_len,
|
|
GCancellable *cancellable,
|
|
NMSupplicantInterfaceRequestScanCallback callback,
|
|
gpointer user_data);
|
|
|
|
NMSupplicantInterfaceState nm_supplicant_interface_get_state (NMSupplicantInterface * self);
|
|
|
|
const char *nm_supplicant_interface_state_to_string (NMSupplicantInterfaceState state);
|
|
|
|
gboolean nm_supplicant_interface_get_scanning (NMSupplicantInterface *self);
|
|
|
|
NMRefString *nm_supplicant_interface_get_current_bss (NMSupplicantInterface *self);
|
|
|
|
gint64 nm_supplicant_interface_get_last_scan (NMSupplicantInterface *self);
|
|
|
|
const char *nm_supplicant_interface_get_ifname (NMSupplicantInterface *self);
|
|
|
|
guint nm_supplicant_interface_get_max_scan_ssids (NMSupplicantInterface *self);
|
|
|
|
gboolean nm_supplicant_interface_get_p2p_available (NMSupplicantInterface *self);
|
|
|
|
gboolean nm_supplicant_interface_get_p2p_group_joined (NMSupplicantInterface *self);
|
|
|
|
const char* nm_supplicant_interface_get_p2p_group_path (NMSupplicantInterface *self);
|
|
|
|
gboolean nm_supplicant_interface_get_p2p_group_owner (NMSupplicantInterface *self);
|
|
|
|
void nm_supplicant_interface_p2p_start_find (NMSupplicantInterface *self,
|
|
guint timeout);
|
|
void nm_supplicant_interface_p2p_stop_find (NMSupplicantInterface *self);
|
|
|
|
void nm_supplicant_interface_p2p_connect (NMSupplicantInterface * self,
|
|
const char * peer,
|
|
const char * wps_method,
|
|
const char * wps_pin);
|
|
void nm_supplicant_interface_p2p_cancel_connect (NMSupplicantInterface * self);
|
|
void nm_supplicant_interface_p2p_disconnect (NMSupplicantInterface * self);
|
|
|
|
void nm_supplicant_interface_set_global_capabilities (NMSupplicantInterface *self,
|
|
NMSupplCapMask value);
|
|
|
|
NMTernary nm_supplicant_interface_get_capability (NMSupplicantInterface *self,
|
|
NMSupplCapType type);
|
|
|
|
NMSupplCapMask nm_supplicant_interface_get_capabilities (NMSupplicantInterface *self);
|
|
|
|
void nm_supplicant_interface_enroll_wps (NMSupplicantInterface *self,
|
|
const char *const type,
|
|
const char *bssid,
|
|
const char *pin);
|
|
|
|
void nm_supplicant_interface_cancel_wps (NMSupplicantInterface *self);
|
|
|
|
NMSupplicantAuthState nm_supplicant_interface_get_auth_state (NMSupplicantInterface *self);
|
|
|
|
#endif /* __NM_SUPPLICANT_INTERFACE_H__ */
|