mirror of
https://gitlab.freedesktop.org/NetworkManager/NetworkManager.git
synced 2026-05-02 09:38:14 +02:00
fdf9614ba7
"libnm-core/" is rather complicated. It provides a static library that
is linked into libnm.so and NetworkManager. It also contains public
headers (like "nm-setting.h") which are part of public libnm API.
Then we have helper libraries ("libnm-core/nm-libnm-core-*/") which
only rely on public API of libnm-core, but are themself static
libraries that can be used by anybody who uses libnm-core. And
"libnm-core/nm-libnm-core-intern" is used by libnm-core itself.
Move "libnm-core/" to "src/". But also split it in different
directories so that they have a clearer purpose.
The goal is to have a flat directory hierarchy. The "src/libnm-core*/"
directories correspond to the different modules (static libraries and set
of headers that we have). We have different kinds of such modules because
of how we combine various code together. The directory layout now reflects
this.
393 lines
12 KiB
C
393 lines
12 KiB
C
/* SPDX-License-Identifier: LGPL-2.1-or-later */
|
|
/*
|
|
* Copyright (C) 2018 Lubomir Rintel <lkundrak@v3.sk>
|
|
*/
|
|
|
|
#include "libnm-core-impl/nm-default-libnm-core.h"
|
|
|
|
#include "nm-setting-wpan.h"
|
|
|
|
#include "nm-connection-private.h"
|
|
#include "nm-setting-connection.h"
|
|
#include "nm-setting-private.h"
|
|
#include "nm-utils-private.h"
|
|
|
|
/**
|
|
* SECTION:nm-setting-wpan
|
|
* @short_description: Describes connection properties for IEEE 802.15.4 (WPAN) MAC
|
|
*
|
|
* The #NMSettingWpan object is a #NMSetting subclass that describes properties
|
|
* necessary for configuring IEEE 802.15.4 (WPAN) MAC layer devices.
|
|
**/
|
|
|
|
/* Ideally we'll be able to get these from a public header. */
|
|
#ifndef IEEE802154_ADDR_LEN
|
|
#define IEEE802154_ADDR_LEN 8
|
|
#endif
|
|
|
|
#ifndef IEEE802154_MAX_PAGE
|
|
#define IEEE802154_MAX_PAGE 31
|
|
#endif
|
|
|
|
#ifndef IEEE802154_MAX_CHANNEL
|
|
#define IEEE802154_MAX_CHANNEL 26
|
|
#endif
|
|
|
|
/*****************************************************************************/
|
|
|
|
NM_GOBJECT_PROPERTIES_DEFINE_BASE(PROP_MAC_ADDRESS,
|
|
PROP_PAN_ID,
|
|
PROP_SHORT_ADDRESS,
|
|
PROP_PAGE,
|
|
PROP_CHANNEL, );
|
|
|
|
typedef struct {
|
|
char * mac_address;
|
|
guint16 pan_id;
|
|
guint16 short_address;
|
|
gint16 page;
|
|
gint16 channel;
|
|
} NMSettingWpanPrivate;
|
|
|
|
/**
|
|
* NMSettingWpan:
|
|
*
|
|
* IEEE 802.15.4 (WPAN) MAC Settings
|
|
*/
|
|
struct _NMSettingWpan {
|
|
NMSetting parent;
|
|
};
|
|
|
|
struct _NMSettingWpanClass {
|
|
NMSettingClass parent;
|
|
};
|
|
|
|
G_DEFINE_TYPE(NMSettingWpan, nm_setting_wpan, NM_TYPE_SETTING)
|
|
|
|
#define NM_SETTING_WPAN_GET_PRIVATE(o) \
|
|
(G_TYPE_INSTANCE_GET_PRIVATE((o), NM_TYPE_SETTING_WPAN, NMSettingWpanPrivate))
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* nm_setting_wpan_get_mac_address:
|
|
* @setting: the #NMSettingWpan
|
|
*
|
|
* Returns: the #NMSettingWpan:mac-address property of the setting
|
|
*
|
|
* Since: 1.14
|
|
**/
|
|
const char *
|
|
nm_setting_wpan_get_mac_address(NMSettingWpan *setting)
|
|
{
|
|
g_return_val_if_fail(NM_IS_SETTING_WPAN(setting), NULL);
|
|
|
|
return NM_SETTING_WPAN_GET_PRIVATE(setting)->mac_address;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_wpan_get_pan_id:
|
|
* @setting: the #NMSettingWpan
|
|
*
|
|
* Returns: the #NMSettingWpan:pan-id property of the setting
|
|
*
|
|
* Since: 1.14
|
|
**/
|
|
guint16
|
|
nm_setting_wpan_get_pan_id(NMSettingWpan *setting)
|
|
{
|
|
g_return_val_if_fail(NM_IS_SETTING_WPAN(setting), G_MAXUINT16);
|
|
|
|
return NM_SETTING_WPAN_GET_PRIVATE(setting)->pan_id;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_wpan_get_short_address:
|
|
* @setting: the #NMSettingWpan
|
|
*
|
|
* Returns: the #NMSettingWpan:short-address property of the setting
|
|
*
|
|
* Since: 1.14
|
|
**/
|
|
guint16
|
|
nm_setting_wpan_get_short_address(NMSettingWpan *setting)
|
|
{
|
|
g_return_val_if_fail(NM_IS_SETTING_WPAN(setting), G_MAXUINT16);
|
|
|
|
return NM_SETTING_WPAN_GET_PRIVATE(setting)->short_address;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_wpan_get_page:
|
|
* @setting: the #NMSettingWpan
|
|
*
|
|
* Returns: the #NMSettingWpan:page property of the setting
|
|
*
|
|
* Since: 1.16
|
|
**/
|
|
gint16
|
|
nm_setting_wpan_get_page(NMSettingWpan *setting)
|
|
{
|
|
g_return_val_if_fail(NM_IS_SETTING_WPAN(setting), NM_SETTING_WPAN_PAGE_DEFAULT);
|
|
|
|
return NM_SETTING_WPAN_GET_PRIVATE(setting)->page;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_wpan_get_channel:
|
|
* @setting: the #NMSettingWpan
|
|
*
|
|
* Returns: the #NMSettingWpan:channel property of the setting
|
|
*
|
|
* Since: 1.16
|
|
**/
|
|
gint16
|
|
nm_setting_wpan_get_channel(NMSettingWpan *setting)
|
|
{
|
|
g_return_val_if_fail(NM_IS_SETTING_WPAN(setting), NM_SETTING_WPAN_CHANNEL_DEFAULT);
|
|
|
|
return NM_SETTING_WPAN_GET_PRIVATE(setting)->channel;
|
|
}
|
|
|
|
static gboolean
|
|
verify(NMSetting *setting, NMConnection *connection, GError **error)
|
|
{
|
|
NMSettingWpanPrivate *priv = NM_SETTING_WPAN_GET_PRIVATE(setting);
|
|
|
|
if (priv->mac_address && !nm_utils_hwaddr_valid(priv->mac_address, IEEE802154_ADDR_LEN)) {
|
|
g_set_error_literal(error,
|
|
NM_CONNECTION_ERROR,
|
|
NM_CONNECTION_ERROR_INVALID_PROPERTY,
|
|
_("property is invalid"));
|
|
g_prefix_error(error, "%s.%s: ", NM_SETTING_WPAN_SETTING_NAME, NM_SETTING_WPAN_MAC_ADDRESS);
|
|
return FALSE;
|
|
}
|
|
|
|
if ((priv->page == NM_SETTING_WPAN_PAGE_DEFAULT)
|
|
!= (priv->channel == NM_SETTING_WPAN_CHANNEL_DEFAULT)) {
|
|
g_set_error_literal(error,
|
|
NM_CONNECTION_ERROR,
|
|
NM_CONNECTION_ERROR_INVALID_PROPERTY,
|
|
_("page must be defined along with a channel"));
|
|
g_prefix_error(error, "%s.%s: ", NM_SETTING_WPAN_SETTING_NAME, NM_SETTING_WPAN_PAGE);
|
|
return FALSE;
|
|
}
|
|
|
|
if (priv->page < NM_SETTING_WPAN_PAGE_DEFAULT || priv->page > IEEE802154_MAX_PAGE) {
|
|
g_set_error(error,
|
|
NM_CONNECTION_ERROR,
|
|
NM_CONNECTION_ERROR_INVALID_PROPERTY,
|
|
_("page must be between %d and %d"),
|
|
NM_SETTING_WPAN_PAGE_DEFAULT,
|
|
IEEE802154_MAX_PAGE);
|
|
g_prefix_error(error, "%s.%s: ", NM_SETTING_WPAN_SETTING_NAME, NM_SETTING_WPAN_PAGE);
|
|
return FALSE;
|
|
}
|
|
|
|
if (priv->channel < NM_SETTING_WPAN_CHANNEL_DEFAULT || priv->channel > IEEE802154_MAX_CHANNEL) {
|
|
g_set_error(error,
|
|
NM_CONNECTION_ERROR,
|
|
NM_CONNECTION_ERROR_INVALID_PROPERTY,
|
|
_("channel must not be between %d and %d"),
|
|
NM_SETTING_WPAN_CHANNEL_DEFAULT,
|
|
IEEE802154_MAX_CHANNEL);
|
|
g_prefix_error(error, "%s.%s: ", NM_SETTING_WPAN_SETTING_NAME, NM_SETTING_WPAN_CHANNEL);
|
|
return FALSE;
|
|
}
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
static void
|
|
get_property(GObject *object, guint prop_id, GValue *value, GParamSpec *pspec)
|
|
{
|
|
NMSettingWpan *setting = NM_SETTING_WPAN(object);
|
|
|
|
switch (prop_id) {
|
|
case PROP_MAC_ADDRESS:
|
|
g_value_set_string(value, nm_setting_wpan_get_mac_address(setting));
|
|
break;
|
|
case PROP_PAN_ID:
|
|
g_value_set_uint(value, nm_setting_wpan_get_pan_id(setting));
|
|
break;
|
|
case PROP_SHORT_ADDRESS:
|
|
g_value_set_uint(value, nm_setting_wpan_get_short_address(setting));
|
|
break;
|
|
case PROP_PAGE:
|
|
g_value_set_int(value, nm_setting_wpan_get_page(setting));
|
|
break;
|
|
case PROP_CHANNEL:
|
|
g_value_set_int(value, nm_setting_wpan_get_channel(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)
|
|
{
|
|
NMSettingWpanPrivate *priv = NM_SETTING_WPAN_GET_PRIVATE(object);
|
|
|
|
switch (prop_id) {
|
|
case PROP_MAC_ADDRESS:
|
|
g_free(priv->mac_address);
|
|
priv->mac_address =
|
|
_nm_utils_hwaddr_canonical_or_invalid(g_value_get_string(value), IEEE802154_ADDR_LEN);
|
|
break;
|
|
case PROP_PAN_ID:
|
|
priv->pan_id = g_value_get_uint(value);
|
|
break;
|
|
case PROP_SHORT_ADDRESS:
|
|
priv->short_address = g_value_get_uint(value);
|
|
break;
|
|
case PROP_PAGE:
|
|
priv->page = g_value_get_int(value);
|
|
break;
|
|
case PROP_CHANNEL:
|
|
priv->channel = g_value_get_int(value);
|
|
break;
|
|
default:
|
|
G_OBJECT_WARN_INVALID_PROPERTY_ID(object, prop_id, pspec);
|
|
break;
|
|
}
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
static void
|
|
nm_setting_wpan_init(NMSettingWpan *setting)
|
|
{
|
|
NMSettingWpanPrivate *priv = NM_SETTING_WPAN_GET_PRIVATE(setting);
|
|
|
|
priv->pan_id = G_MAXUINT16;
|
|
priv->short_address = G_MAXUINT16;
|
|
priv->page = NM_SETTING_WPAN_PAGE_DEFAULT;
|
|
priv->channel = NM_SETTING_WPAN_CHANNEL_DEFAULT;
|
|
}
|
|
|
|
/**
|
|
* nm_setting_wpan_new:
|
|
*
|
|
* Creates a new #NMSettingWpan object with default values.
|
|
*
|
|
* Returns: (transfer full): the new empty #NMSettingWpan object
|
|
*
|
|
* Since: 1.14
|
|
**/
|
|
NMSetting *
|
|
nm_setting_wpan_new(void)
|
|
{
|
|
return g_object_new(NM_TYPE_SETTING_WPAN, NULL);
|
|
}
|
|
|
|
static void
|
|
finalize(GObject *object)
|
|
{
|
|
NMSettingWpanPrivate *priv = NM_SETTING_WPAN_GET_PRIVATE(object);
|
|
|
|
g_free(priv->mac_address);
|
|
|
|
G_OBJECT_CLASS(nm_setting_wpan_parent_class)->finalize(object);
|
|
}
|
|
|
|
static void
|
|
nm_setting_wpan_class_init(NMSettingWpanClass *klass)
|
|
{
|
|
GObjectClass * object_class = G_OBJECT_CLASS(klass);
|
|
NMSettingClass *setting_class = NM_SETTING_CLASS(klass);
|
|
|
|
g_type_class_add_private(setting_class, sizeof(NMSettingWpanPrivate));
|
|
|
|
object_class->get_property = get_property;
|
|
object_class->set_property = set_property;
|
|
object_class->finalize = finalize;
|
|
|
|
setting_class->verify = verify;
|
|
|
|
/**
|
|
* NMSettingWpan:mac-address:
|
|
*
|
|
* If specified, this connection will only apply to the IEEE 802.15.4 (WPAN)
|
|
* MAC layer device whose permanent MAC address matches.
|
|
**/
|
|
/* ---keyfile---
|
|
* property: mac-address
|
|
* format: usual hex-digits-and-colons notation
|
|
* description: MAC address in hex-digits-and-colons notation
|
|
* (e.g. 76:d8:9b:87:66:60:84:ee).
|
|
* ---end---
|
|
*/
|
|
obj_properties[PROP_MAC_ADDRESS] =
|
|
g_param_spec_string(NM_SETTING_WPAN_MAC_ADDRESS,
|
|
"",
|
|
"",
|
|
NULL,
|
|
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
|
|
|
|
/**
|
|
* NMSettingWpan:pan-id:
|
|
*
|
|
* IEEE 802.15.4 Personal Area Network (PAN) identifier.
|
|
**/
|
|
obj_properties[PROP_PAN_ID] = g_param_spec_uint(NM_SETTING_WPAN_PAN_ID,
|
|
"",
|
|
"",
|
|
0,
|
|
G_MAXUINT16,
|
|
G_MAXUINT16,
|
|
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
|
|
|
|
/**
|
|
* NMSettingWpan:short-address:
|
|
*
|
|
* Short IEEE 802.15.4 address to be used within a restricted environment.
|
|
**/
|
|
obj_properties[PROP_SHORT_ADDRESS] =
|
|
g_param_spec_uint(NM_SETTING_WPAN_SHORT_ADDRESS,
|
|
"",
|
|
"",
|
|
0,
|
|
G_MAXUINT16,
|
|
G_MAXUINT16,
|
|
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
|
|
|
|
/**
|
|
* NMSettingWpan:page:
|
|
*
|
|
* IEEE 802.15.4 channel page. A positive integer or -1, meaning "do not
|
|
* set, use whatever the device is already set to".
|
|
*
|
|
* Since: 1.16
|
|
**/
|
|
obj_properties[PROP_PAGE] = g_param_spec_int(NM_SETTING_WPAN_PAGE,
|
|
"",
|
|
"",
|
|
G_MININT16,
|
|
G_MAXINT16,
|
|
NM_SETTING_WPAN_PAGE_DEFAULT,
|
|
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
|
|
|
|
/**
|
|
* NMSettingWpan:channel:
|
|
*
|
|
* IEEE 802.15.4 channel. A positive integer or -1, meaning "do not
|
|
* set, use whatever the device is already set to".
|
|
*
|
|
* Since: 1.16
|
|
**/
|
|
obj_properties[PROP_CHANNEL] = g_param_spec_int(NM_SETTING_WPAN_CHANNEL,
|
|
"",
|
|
"",
|
|
G_MININT16,
|
|
G_MAXINT16,
|
|
NM_SETTING_WPAN_CHANNEL_DEFAULT,
|
|
G_PARAM_READWRITE | 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_WPAN);
|
|
}
|