8eed67122c
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 1b49f941a6.
"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
77 lines
3.6 KiB
C
77 lines
3.6 KiB
C
/* -*- 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.
|
|
*
|
|
* Copyright 2005 - 2014 Red Hat, Inc.
|
|
*/
|
|
|
|
#ifndef __NM_UTILS_PRIVATE_H__
|
|
#define __NM_UTILS_PRIVATE_H__
|
|
|
|
#ifdef __NETWORKMANAGER_TYPES_H__
|
|
#error "nm-utils-private.h" must not be used outside of libnm-core/. Do you want "nm-core-internal.h"?
|
|
#endif
|
|
|
|
#include "nm-setting-private.h"
|
|
#include "nm-setting-ip-config.h"
|
|
|
|
gboolean _nm_utils_string_slist_validate (GSList *list,
|
|
const char **valid_values);
|
|
|
|
gboolean _nm_utils_check_valid_json (const char *json, GError **error);
|
|
gboolean _nm_utils_team_config_equal (const char *conf1, const char *conf2, gboolean port);
|
|
|
|
/* D-Bus transform funcs */
|
|
|
|
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);
|
|
|
|
GVariant * _nm_utils_hwaddr_to_dbus (const GValue *prop_value);
|
|
void _nm_utils_hwaddr_from_dbus (GVariant *dbus_value,
|
|
GValue *prop_value);
|
|
|
|
GVariant * _nm_utils_strdict_to_dbus (const GValue *prop_value);
|
|
void _nm_utils_strdict_from_dbus (GVariant *dbus_value,
|
|
GValue *prop_value);
|
|
|
|
GVariant * _nm_utils_bytes_to_dbus (const GValue *prop_value);
|
|
void _nm_utils_bytes_from_dbus (GVariant *dbus_value,
|
|
GValue *prop_value);
|
|
|
|
char * _nm_utils_hwaddr_canonical_or_invalid (const char *mac, gssize length);
|
|
|
|
#endif
|