af07ed01c0
"libnm-core" implements common functionality for "NetworkManager" and
"libnm".
Note that clients like "nmcli" cannot access the internal API provided
by "libnm-core". So, if nmcli wants to do something that is also done by
"libnm-core", , "libnm", or "NetworkManager", the code would have to be
duplicated.
Instead, such code can be in "libnm-libnm-core-{intern|aux}.la".
Note that:
0) "libnm-libnm-core-intern.la" is used by libnm-core itsself.
On the other hand, "libnm-libnm-core-aux.la" is not used by
libnm-core, but provides utilities on top of it.
1) they both extend "libnm-core" with utlities that are not public
API of libnm itself. Maybe part of the code should one day become
public API of libnm. On the other hand, this is code for which
we may not want to commit to a stable interface or which we
don't want to provide as part of the API.
2) "libnm-libnm-core-intern.la" is statically linked by "libnm-core"
and thus directly available to "libnm" and "NetworkManager".
On the other hand, "libnm-libnm-core-aux.la" may be used by "libnm"
and "NetworkManager".
Both libraries may be statically linked by libnm clients (like
nmcli).
3) it must only use glib, libnm-glib-aux.la, and the public API
of libnm-core.
This is important: it must not use "libnm-core/nm-core-internal.h"
nor "libnm-core/nm-utils-private.h" so the static library is usable
by nmcli which couldn't access these.
Note that "shared/nm-meta-setting.c" is an entirely different case,
because it behaves differently depending on whether linking against
"libnm-core" or the client programs. As such, this file must be compiled
twice.
318 lines
9.0 KiB
C
318 lines
9.0 KiB
C
/*
|
|
* 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 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 Street, Fifth Floor,
|
|
* Boston, MA 02110-1301 USA.
|
|
*
|
|
* Copyright 2019 Red Hat, Inc.
|
|
*/
|
|
|
|
#include "nm-default.h"
|
|
|
|
#include "nm-setting-wifi-p2p.h"
|
|
|
|
#include <net/ethernet.h>
|
|
|
|
#include "nm-utils.h"
|
|
#include "nm-libnm-core-intern/nm-common-macros.h"
|
|
#include "nm-utils-private.h"
|
|
#include "nm-setting-private.h"
|
|
|
|
/**
|
|
* SECTION:nm-setting-wifi-p2p
|
|
* @short_description: Describes connection properties for 802.11 Wi-Fi P2P networks
|
|
*
|
|
* The #NMSettingWifiP2P object is a #NMSetting subclass that describes properties
|
|
* necessary for connection to 802.11 Wi-Fi P2P networks (aka Wi-Fi Direct).
|
|
**/
|
|
|
|
/**
|
|
* NMSettingWifiP2P:
|
|
*
|
|
* Wi-Fi P2P Settings
|
|
*
|
|
* Since: 1.16
|
|
*/
|
|
|
|
/*****************************************************************************/
|
|
|
|
NM_GOBJECT_PROPERTIES_DEFINE_BASE (
|
|
PROP_PEER,
|
|
PROP_WPS_METHOD,
|
|
PROP_WFD_IES,
|
|
);
|
|
|
|
typedef struct {
|
|
char *peer_mac_address;
|
|
GBytes *wfd_ies;
|
|
|
|
NMSettingWirelessSecurityWpsMethod wps_method;
|
|
} NMSettingWifiP2PPrivate;
|
|
|
|
struct _NMSettingWifiP2P {
|
|
NMSetting parent;
|
|
NMSettingWifiP2PPrivate _priv;
|
|
};
|
|
|
|
struct _NMSettingWifiP2PClass {
|
|
NMSettingClass parent;
|
|
};
|
|
|
|
G_DEFINE_TYPE (NMSettingWifiP2P, nm_setting_wifi_p2p, NM_TYPE_SETTING)
|
|
|
|
#define NM_SETTING_WIFI_P2P_GET_PRIVATE(self) _NM_GET_PRIVATE (self, NMSettingWifiP2P, NM_IS_SETTING_WIFI_P2P, NMSetting)
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* nm_setting_wifi_p2p_get_peer:
|
|
* @setting: the #NMSettingWifiP2P
|
|
*
|
|
* Returns: the #NMSettingWifiP2P:peer property of the setting
|
|
*
|
|
* Since: 1.16
|
|
**/
|
|
const char *
|
|
nm_setting_wifi_p2p_get_peer (NMSettingWifiP2P *setting)
|
|
{
|
|
g_return_val_if_fail (NM_IS_SETTING_WIFI_P2P (setting), NULL);
|
|
|
|
return NM_SETTING_WIFI_P2P_GET_PRIVATE (setting)->peer_mac_address;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_wifi_p2p_get_wps_method:
|
|
* @setting: the #NMSettingWifiP2P
|
|
*
|
|
* Returns: the #NMSettingWifiP2P:wps-method property of the setting
|
|
*
|
|
* Since: 1.16
|
|
**/
|
|
NMSettingWirelessSecurityWpsMethod
|
|
nm_setting_wifi_p2p_get_wps_method (NMSettingWifiP2P *setting)
|
|
{
|
|
g_return_val_if_fail (NM_IS_SETTING_WIFI_P2P (setting), NM_SETTING_WIRELESS_SECURITY_WPS_METHOD_DEFAULT);
|
|
|
|
return NM_SETTING_WIFI_P2P_GET_PRIVATE (setting)->wps_method;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_wifi_p2p_get_wfd_ies:
|
|
* @setting: the #NMSettingWiFiP2P
|
|
*
|
|
* Returns: (transfer none): the #NMSettingWiFiP2P:wfd-ies property of the setting
|
|
*
|
|
* Since: 1.16
|
|
**/
|
|
GBytes *
|
|
nm_setting_wifi_p2p_get_wfd_ies (NMSettingWifiP2P *setting)
|
|
{
|
|
g_return_val_if_fail (NM_IS_SETTING_WIFI_P2P (setting), NULL);
|
|
|
|
return NM_SETTING_WIFI_P2P_GET_PRIVATE (setting)->wfd_ies;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
static gboolean
|
|
verify (NMSetting *setting, NMConnection *connection, GError **error)
|
|
{
|
|
NMSettingWifiP2PPrivate *priv = NM_SETTING_WIFI_P2P_GET_PRIVATE (setting);
|
|
|
|
if (!priv->peer_mac_address) {
|
|
g_set_error_literal (error,
|
|
NM_CONNECTION_ERROR,
|
|
NM_CONNECTION_ERROR_MISSING_PROPERTY,
|
|
_("property is missing"));
|
|
g_prefix_error (error, "%s.%s: ", NM_SETTING_WIFI_P2P_SETTING_NAME, NM_SETTING_WIFI_P2P_PEER);
|
|
return FALSE;
|
|
}
|
|
|
|
if (!nm_utils_hwaddr_valid (priv->peer_mac_address, ETH_ALEN)) {
|
|
g_set_error_literal (error,
|
|
NM_CONNECTION_ERROR,
|
|
NM_CONNECTION_ERROR_INVALID_PROPERTY,
|
|
_("property is invalid"));
|
|
g_prefix_error (error, "%s.%s: ", NM_SETTING_WIFI_P2P_SETTING_NAME, NM_SETTING_WIFI_P2P_PEER);
|
|
return FALSE;
|
|
}
|
|
|
|
if (!_nm_utils_wps_method_validate (priv->wps_method,
|
|
NM_SETTING_WIFI_P2P_SETTING_NAME,
|
|
NM_SETTING_WIFI_P2P_WPS_METHOD,
|
|
TRUE,
|
|
error))
|
|
return FALSE;
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
static void
|
|
get_property (GObject *object, guint prop_id,
|
|
GValue *value, GParamSpec *pspec)
|
|
{
|
|
NMSettingWifiP2P *setting = NM_SETTING_WIFI_P2P (object);
|
|
|
|
switch (prop_id) {
|
|
case PROP_PEER:
|
|
g_value_set_string (value, nm_setting_wifi_p2p_get_peer (setting));
|
|
break;
|
|
case PROP_WPS_METHOD:
|
|
g_value_set_uint (value, nm_setting_wifi_p2p_get_wps_method (setting));
|
|
break;
|
|
case PROP_WFD_IES:
|
|
g_value_set_boxed (value, nm_setting_wifi_p2p_get_wfd_ies (setting));
|
|
break;
|
|
default:
|
|
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
|
break;
|
|
}
|
|
}
|
|
|
|
static void
|
|
set_property (GObject *object, guint prop_id,
|
|
const GValue *value, GParamSpec *pspec)
|
|
{
|
|
NMSettingWifiP2PPrivate *priv = NM_SETTING_WIFI_P2P_GET_PRIVATE (object);
|
|
|
|
switch (prop_id) {
|
|
case PROP_PEER:
|
|
g_free (priv->peer_mac_address);
|
|
priv->peer_mac_address = _nm_utils_hwaddr_canonical_or_invalid (g_value_get_string (value),
|
|
ETH_ALEN);
|
|
break;
|
|
case PROP_WPS_METHOD:
|
|
priv->wps_method = g_value_get_uint (value);
|
|
break;
|
|
case PROP_WFD_IES:
|
|
g_clear_pointer (&priv->wfd_ies, g_bytes_unref);
|
|
priv->wfd_ies = g_value_dup_boxed (value);
|
|
break;
|
|
default:
|
|
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
|
break;
|
|
}
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
static void
|
|
nm_setting_wifi_p2p_init (NMSettingWifiP2P *setting)
|
|
{
|
|
}
|
|
|
|
/**
|
|
* nm_setting_wifi_p2p_new:
|
|
*
|
|
* Creates a new #NMSettingWifiP2P object with default values.
|
|
*
|
|
* Returns: (transfer full): the new empty #NMSettingWifiP2P object
|
|
*
|
|
* Since: 1.16
|
|
**/
|
|
NMSetting *
|
|
nm_setting_wifi_p2p_new (void)
|
|
{
|
|
return g_object_new (NM_TYPE_SETTING_WIFI_P2P, NULL);
|
|
}
|
|
|
|
static void
|
|
finalize (GObject *object)
|
|
{
|
|
NMSettingWifiP2PPrivate *priv = NM_SETTING_WIFI_P2P_GET_PRIVATE (object);
|
|
|
|
g_free (priv->peer_mac_address);
|
|
g_bytes_unref (priv->wfd_ies);
|
|
|
|
G_OBJECT_CLASS (nm_setting_wifi_p2p_parent_class)->finalize (object);
|
|
}
|
|
|
|
static void
|
|
nm_setting_wifi_p2p_class_init (NMSettingWifiP2PClass *setting_wifi_p2p_class)
|
|
{
|
|
GObjectClass *object_class = G_OBJECT_CLASS (setting_wifi_p2p_class);
|
|
NMSettingClass *setting_class = NM_SETTING_CLASS (setting_wifi_p2p_class);
|
|
|
|
object_class->get_property = get_property;
|
|
object_class->set_property = set_property;
|
|
object_class->finalize = finalize;
|
|
|
|
setting_class->verify = verify;
|
|
|
|
/**
|
|
* NMSettingWifiP2P:peer:
|
|
*
|
|
* The P2P device that should be connected to. Currently this is the only
|
|
* way to create or join a group.
|
|
*
|
|
* Since: 1.16
|
|
*/
|
|
/* ---keyfile---
|
|
* property: peer
|
|
* format: usual hex-digits-and-colons notation
|
|
* description: MAC address in traditional hex-digits-and-colons notation
|
|
* (e.g. 00:22:68:12:79:A2), or semicolon separated list of 6 bytes (obsolete)
|
|
* (e.g. 0;34;104;18;121;162).
|
|
* ---end---
|
|
*/
|
|
obj_properties[PROP_PEER] =
|
|
g_param_spec_string (NM_SETTING_WIFI_P2P_PEER, "", "",
|
|
NULL,
|
|
G_PARAM_READWRITE |
|
|
G_PARAM_STATIC_STRINGS);
|
|
|
|
/**
|
|
* NMSettingWifiP2P:wps-method:
|
|
*
|
|
* Flags indicating which mode of WPS is to be used.
|
|
*
|
|
* There's little point in changing the default setting as NetworkManager will
|
|
* automatically determine the best method to use.
|
|
*
|
|
* Since: 1.16
|
|
*/
|
|
obj_properties[PROP_WPS_METHOD] =
|
|
g_param_spec_uint (NM_SETTING_WIFI_P2P_WPS_METHOD, "", "",
|
|
0,
|
|
G_MAXUINT32,
|
|
NM_SETTING_WIRELESS_SECURITY_WPS_METHOD_DEFAULT,
|
|
G_PARAM_READWRITE |
|
|
NM_SETTING_PARAM_FUZZY_IGNORE |
|
|
G_PARAM_STATIC_STRINGS);
|
|
|
|
/**
|
|
* NMSettingWifiP2P:wfd-ies:
|
|
*
|
|
* The Wi-Fi Display (WFD) Information Elements (IEs) to set.
|
|
*
|
|
* Wi-Fi Display requires a protocol specific information element to be
|
|
* set in certain Wi-Fi frames. These can be specified here for the
|
|
* purpose of establishing a connection.
|
|
* This setting is only useful when implementing a Wi-Fi Display client.
|
|
*
|
|
* Since: 1.16
|
|
*/
|
|
obj_properties[PROP_WFD_IES] =
|
|
g_param_spec_boxed (NM_SETTING_WIFI_P2P_WFD_IES, "", "",
|
|
G_TYPE_BYTES,
|
|
G_PARAM_READWRITE |
|
|
NM_SETTING_PARAM_FUZZY_IGNORE |
|
|
G_PARAM_STATIC_STRINGS);
|
|
|
|
g_object_class_install_properties (object_class, _PROPERTY_ENUMS_LAST, obj_properties);
|
|
|
|
_nm_setting_class_commit (setting_class, NM_META_SETTING_TYPE_WIFI_P2P);
|
|
}
|