2014-07-24 12:53:33 +00:00
|
|
|
/* -*- Mode: C; tab-width: 4; indent-tabs-mode: t; c-basic-offset: 4 -*- */
|
|
|
|
/*
|
|
|
|
* 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.
|
|
|
|
*
|
libnm-core/utils: add some special properties for the attributes
"no_value" indicates that the the attribute is a single word, not a
key=value pair. If the type is BOOLEAN then the attribute is considered
true, if it's a STRING then the key is used instead of a value.
"consumes_rest" indicates that the particular key takes the unparseable
tail of the string for a value.
This allows parsing tc-style strings. Consider this filter:
,------ regular key/value pair
,-----'----.
root handle 1234: matchall action simple foo bar baz
| | `-----------.-----------'
| | `- "", STRING, consumes_rest
| `------------------- "kind", STRING, no_value
`-------------------------------------- "root', BOOLEAN, no_value
2017-12-04 10:40:32 +00:00
|
|
|
* Copyright 2005 - 2017 Red Hat, Inc.
|
2014-07-24 12:53:33 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef __NM_UTILS_PRIVATE_H__
|
|
|
|
#define __NM_UTILS_PRIVATE_H__
|
|
|
|
|
2018-01-02 12:37:06 +00:00
|
|
|
#if !((NETWORKMANAGER_COMPILATION) & NM_NETWORKMANAGER_COMPILATION_WITH_LIBNM_CORE_PRIVATE)
|
|
|
|
#error Cannot use this header.
|
2015-05-20 10:23:03 +00:00
|
|
|
#endif
|
|
|
|
|
2014-07-24 12:53:33 +00:00
|
|
|
#include "nm-setting-private.h"
|
2015-03-26 07:57:02 +00:00
|
|
|
#include "nm-setting-ip-config.h"
|
2014-07-24 12:53:33 +00:00
|
|
|
|
2017-03-02 10:08:34 +00:00
|
|
|
struct _NMVariantAttributeSpec {
|
|
|
|
char *name;
|
|
|
|
const GVariantType *type;
|
2017-02-15 14:06:24 +00:00
|
|
|
bool v4:1;
|
|
|
|
bool v6:1;
|
libnm-core/utils: add some special properties for the attributes
"no_value" indicates that the the attribute is a single word, not a
key=value pair. If the type is BOOLEAN then the attribute is considered
true, if it's a STRING then the key is used instead of a value.
"consumes_rest" indicates that the particular key takes the unparseable
tail of the string for a value.
This allows parsing tc-style strings. Consider this filter:
,------ regular key/value pair
,-----'----.
root handle 1234: matchall action simple foo bar baz
| | `-----------.-----------'
| | `- "", STRING, consumes_rest
| `------------------- "kind", STRING, no_value
`-------------------------------------- "root', BOOLEAN, no_value
2017-12-04 10:40:32 +00:00
|
|
|
bool no_value:1;
|
|
|
|
bool consumes_rest:1;
|
2017-02-15 14:06:24 +00:00
|
|
|
char str_type;
|
2017-03-02 10:08:34 +00:00
|
|
|
};
|
|
|
|
|
2014-07-24 12:53:33 +00:00
|
|
|
gboolean _nm_utils_string_slist_validate (GSList *list,
|
|
|
|
const char **valid_values);
|
|
|
|
|
2014-08-16 14:09:48 +00:00
|
|
|
/* D-Bus transform funcs */
|
2014-07-24 12:53:33 +00:00
|
|
|
|
device: extend MAC address handling including randomization for ethernet and wifi
Extend the "ethernet.cloned-mac-address" and "wifi.cloned-mac-address"
settings. Instead of specifying an explicit MAC address, the additional
special values "permanent", "preserve", "random", "random-bia", "stable" and
"stable-bia" are supported.
"permanent" means to use the permanent hardware address. Previously that
was the default if no explict cloned-mac-address was set. The default is
thus still "permanent", but it can be overwritten by global
configuration.
"preserve" means not to configure the MAC address when activating the
device. That was actually the default behavior before introducing MAC
address handling with commit 1b49f941a69af910b0e68530be7339e8053068e5.
"random" and "random-bia" use a randomized MAC address for each
connection. "stable" and "stable-bia" use a generated, stable
address based on some token. The "bia" suffix says to generate a
burned-in address. The stable method by default uses as token the
connection UUID, but the token can be explicitly choosen via
"stable:<TOKEN>" and "stable-bia:<TOKEN>".
On a D-Bus level, the "cloned-mac-address" is a bytestring and thus
cannot express the new forms. It is replaced by the new
"assigned-mac-address" field. For the GObject property, libnm's API,
nmcli, keyfile, etc. the old name "cloned-mac-address" is still used.
Deprecating the old field seems more complicated then just extending
the use of the existing "cloned-mac-address" field, although the name
doesn't match well with the extended meaning.
There is some overlap with the "wifi.mac-address-randomization" setting.
https://bugzilla.gnome.org/show_bug.cgi?id=705545
https://bugzilla.gnome.org/show_bug.cgi?id=708820
https://bugzilla.gnome.org/show_bug.cgi?id=758301
2016-05-24 13:57:16 +00:00
|
|
|
GVariant *_nm_utils_hwaddr_cloned_get (NMSetting *setting,
|
|
|
|
const char *property);
|
|
|
|
gboolean _nm_utils_hwaddr_cloned_set (NMSetting *setting,
|
|
|
|
GVariant *connection_dict,
|
|
|
|
const char *property,
|
|
|
|
GVariant *value,
|
|
|
|
NMSettingParseFlags parse_flags,
|
|
|
|
GError **error);
|
|
|
|
gboolean _nm_utils_hwaddr_cloned_not_set (NMSetting *setting,
|
|
|
|
GVariant *connection_dict,
|
|
|
|
const char *property,
|
|
|
|
NMSettingParseFlags parse_flags,
|
|
|
|
GError **error);
|
|
|
|
GVariant * _nm_utils_hwaddr_cloned_data_synth (NMSetting *setting,
|
|
|
|
NMConnection *connection,
|
|
|
|
const char *property);
|
|
|
|
gboolean _nm_utils_hwaddr_cloned_data_set (NMSetting *setting,
|
|
|
|
GVariant *connection_dict,
|
|
|
|
const char *property,
|
|
|
|
GVariant *value,
|
|
|
|
NMSettingParseFlags parse_flags,
|
|
|
|
GError **error);
|
|
|
|
|
2014-08-16 14:09:48 +00:00
|
|
|
GVariant * _nm_utils_hwaddr_to_dbus (const GValue *prop_value);
|
|
|
|
void _nm_utils_hwaddr_from_dbus (GVariant *dbus_value,
|
2014-07-30 14:57:45 +00:00
|
|
|
GValue *prop_value);
|
|
|
|
|
2014-08-16 14:09:48 +00:00
|
|
|
GVariant * _nm_utils_strdict_to_dbus (const GValue *prop_value);
|
|
|
|
void _nm_utils_strdict_from_dbus (GVariant *dbus_value,
|
2014-06-24 21:40:08 +00:00
|
|
|
GValue *prop_value);
|
|
|
|
|
2014-08-16 14:09:48 +00:00
|
|
|
GVariant * _nm_utils_bytes_to_dbus (const GValue *prop_value);
|
|
|
|
void _nm_utils_bytes_from_dbus (GVariant *dbus_value,
|
2014-06-26 14:42:11 +00:00
|
|
|
GValue *prop_value);
|
|
|
|
|
2014-10-28 12:56:07 +00:00
|
|
|
char * _nm_utils_hwaddr_canonical_or_invalid (const char *mac, gssize length);
|
|
|
|
|
2017-11-07 13:38:45 +00:00
|
|
|
GPtrArray * _nm_utils_team_link_watchers_from_variant (GVariant *value);
|
|
|
|
GVariant * _nm_utils_team_link_watchers_to_variant (GPtrArray *link_watchers);
|
2017-10-30 14:04:52 +00:00
|
|
|
|
|
|
|
/* JSON to GValue conversion macros */
|
|
|
|
|
|
|
|
typedef struct {
|
|
|
|
const char *key1;
|
|
|
|
const char *key2;
|
|
|
|
const char *key3;
|
2017-11-08 17:10:27 +00:00
|
|
|
union {
|
|
|
|
int default_int;
|
|
|
|
gboolean default_bool;
|
|
|
|
const char *default_str;
|
|
|
|
};
|
2017-10-30 14:04:52 +00:00
|
|
|
} _NMUtilsTeamPropertyKeys;
|
|
|
|
|
|
|
|
static inline int
|
|
|
|
_nm_utils_json_extract_int (char *conf,
|
2017-11-08 17:10:27 +00:00
|
|
|
_NMUtilsTeamPropertyKeys key,
|
|
|
|
gboolean is_port)
|
2017-10-30 14:04:52 +00:00
|
|
|
{
|
|
|
|
gs_free GValue *t_value = NULL;
|
|
|
|
int ret;
|
|
|
|
|
2017-11-08 17:10:27 +00:00
|
|
|
t_value = _nm_utils_team_config_get (conf, key.key1, key.key2, key.key3, is_port);
|
2017-10-30 14:04:52 +00:00
|
|
|
if (!t_value)
|
2017-11-08 17:10:27 +00:00
|
|
|
return key.default_int;
|
2017-10-30 14:04:52 +00:00
|
|
|
|
|
|
|
ret = g_value_get_int (t_value);
|
|
|
|
g_value_unset (t_value);
|
|
|
|
return ret;
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline gboolean
|
|
|
|
_nm_utils_json_extract_boolean (char *conf,
|
2017-11-08 17:10:27 +00:00
|
|
|
_NMUtilsTeamPropertyKeys key,
|
|
|
|
gboolean is_port)
|
2017-10-30 14:04:52 +00:00
|
|
|
{
|
|
|
|
gs_free GValue *t_value = NULL;
|
|
|
|
gboolean ret;
|
|
|
|
|
2017-11-08 17:10:27 +00:00
|
|
|
t_value = _nm_utils_team_config_get (conf, key.key1, key.key2, key.key3, is_port);
|
2017-10-30 14:04:52 +00:00
|
|
|
if (!t_value)
|
2017-11-08 17:10:27 +00:00
|
|
|
return key.default_bool;
|
2017-10-30 14:04:52 +00:00
|
|
|
|
|
|
|
ret = g_value_get_boolean (t_value);
|
|
|
|
g_value_unset (t_value);
|
|
|
|
return ret;
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline char *
|
|
|
|
_nm_utils_json_extract_string (char *conf,
|
2017-11-08 17:10:27 +00:00
|
|
|
_NMUtilsTeamPropertyKeys key,
|
|
|
|
gboolean is_port)
|
2017-10-30 14:04:52 +00:00
|
|
|
{
|
|
|
|
gs_free GValue *t_value = NULL;
|
|
|
|
char *ret;
|
|
|
|
|
2017-11-08 17:10:27 +00:00
|
|
|
t_value = _nm_utils_team_config_get (conf, key.key1, key.key2, key.key3, is_port);
|
2017-10-30 14:04:52 +00:00
|
|
|
if (!t_value)
|
2017-11-08 17:10:27 +00:00
|
|
|
return g_strdup (key.default_str);
|
2017-10-30 14:04:52 +00:00
|
|
|
|
|
|
|
ret = g_value_dup_string (t_value);
|
|
|
|
g_value_unset (t_value);
|
|
|
|
return ret;
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline char **
|
|
|
|
_nm_utils_json_extract_strv (char *conf,
|
2017-11-08 17:10:27 +00:00
|
|
|
_NMUtilsTeamPropertyKeys key,
|
|
|
|
gboolean is_port)
|
2017-10-30 14:04:52 +00:00
|
|
|
{
|
|
|
|
gs_free GValue *t_value = NULL;
|
|
|
|
char **ret;
|
|
|
|
|
2017-11-08 17:10:27 +00:00
|
|
|
t_value = _nm_utils_team_config_get (conf, key.key1, key.key2, key.key3, is_port);
|
2017-10-30 14:04:52 +00:00
|
|
|
if (!t_value)
|
|
|
|
return NULL;
|
|
|
|
|
|
|
|
ret = g_strdupv (g_value_get_boxed (t_value));
|
|
|
|
g_value_unset (t_value);
|
|
|
|
return ret;
|
|
|
|
}
|
|
|
|
|
2017-11-11 23:08:03 +00:00
|
|
|
static inline GPtrArray *
|
|
|
|
_nm_utils_json_extract_ptr_array (char *conf,
|
|
|
|
_NMUtilsTeamPropertyKeys key,
|
|
|
|
gboolean is_port)
|
|
|
|
{
|
|
|
|
gs_free GValue *t_value = NULL;
|
|
|
|
GPtrArray *data, *ret;
|
|
|
|
guint i;
|
|
|
|
|
|
|
|
ret = g_ptr_array_new_with_free_func ((GDestroyNotify) nm_team_link_watcher_unref);
|
|
|
|
t_value = _nm_utils_team_config_get (conf, key.key1, key.key2, key.key3, is_port);
|
|
|
|
if (!t_value)
|
|
|
|
return ret;
|
|
|
|
|
|
|
|
data = g_value_get_boxed (t_value);
|
|
|
|
if (!data)
|
|
|
|
return ret;
|
|
|
|
|
|
|
|
for (i = 0; i < data->len; i++)
|
|
|
|
g_ptr_array_add (ret, nm_team_link_watcher_dup (data->pdata[i]));
|
|
|
|
g_value_unset (t_value);
|
|
|
|
return ret;
|
|
|
|
}
|
|
|
|
|
2017-10-30 14:04:52 +00:00
|
|
|
static inline void
|
|
|
|
_nm_utils_json_append_gvalue (char **conf,
|
|
|
|
_NMUtilsTeamPropertyKeys key,
|
|
|
|
const GValue *val)
|
|
|
|
{
|
|
|
|
_nm_utils_team_config_set (conf, key.key1, key.key2, key.key3, val);
|
|
|
|
}
|
|
|
|
|
2014-07-24 12:53:33 +00:00
|
|
|
#endif
|