mirror of
https://gitlab.freedesktop.org/NetworkManager/NetworkManager
synced 2024-09-06 17:14:02 +00:00
connection: deprecate the NMSettingConnection slave-type property
To embrace inclusive language, deprecate the NMSettingConnection slave-type property and introduce port-type property. Signed-off-by: Fernando Fernandez Mancera <ffmancera@riseup.net>
This commit is contained in:
parent
e0b5725e4c
commit
411e7573a4
|
@ -1957,6 +1957,7 @@ global:
|
|||
nm_ethtool_optname_is_channels;
|
||||
nm_ethtool_optname_is_eee;
|
||||
nm_setting_connection_get_controller;
|
||||
nm_setting_connection_get_port_type;
|
||||
nm_setting_hsr_get_multicast_spec;
|
||||
nm_setting_hsr_get_port1;
|
||||
nm_setting_hsr_get_port2;
|
||||
|
|
|
@ -836,6 +836,10 @@
|
|||
dbus-type="as"
|
||||
gprop-type="GStrv"
|
||||
/>
|
||||
<property name="port-type"
|
||||
dbus-type="s"
|
||||
gprop-type="gchararray"
|
||||
/>
|
||||
<property name="read-only"
|
||||
is-deprecated="1"
|
||||
dbus-type="b"
|
||||
|
@ -846,6 +850,7 @@
|
|||
gprop-type="GStrv"
|
||||
/>
|
||||
<property name="slave-type"
|
||||
is-deprecated="1"
|
||||
dbus-type="s"
|
||||
gprop-type="gchararray"
|
||||
/>
|
||||
|
|
|
@ -58,6 +58,7 @@ NM_GOBJECT_PROPERTIES_DEFINE(NMSettingConnection,
|
|||
PROP_MASTER,
|
||||
PROP_CONTROLLER,
|
||||
PROP_SLAVE_TYPE,
|
||||
PROP_PORT_TYPE,
|
||||
PROP_AUTOCONNECT_SLAVES,
|
||||
PROP_SECONDARIES,
|
||||
PROP_GATEWAY_PING_TIMEOUT,
|
||||
|
@ -82,7 +83,7 @@ typedef struct {
|
|||
char *interface_name;
|
||||
char *type;
|
||||
char *controller;
|
||||
char *slave_type;
|
||||
char *port_type;
|
||||
char *zone;
|
||||
char *mud_url;
|
||||
guint64 timestamp;
|
||||
|
@ -739,6 +740,24 @@ nm_setting_connection_get_controller(NMSettingConnection *setting)
|
|||
return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->controller;
|
||||
}
|
||||
|
||||
/**
|
||||
* nm_setting_connection_get_port_type:
|
||||
* @setting: the #NMSettingConnection
|
||||
*
|
||||
* Returns the #NMSettingConnection:port-type property of the connection.
|
||||
*
|
||||
* Returns: the type of port this connection is, if any.
|
||||
*
|
||||
* Since: 1.46
|
||||
*/
|
||||
const char *
|
||||
nm_setting_connection_get_port_type(NMSettingConnection *setting)
|
||||
{
|
||||
g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), NULL);
|
||||
|
||||
return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->port_type;
|
||||
}
|
||||
|
||||
/**
|
||||
* nm_setting_connection_get_slave_type:
|
||||
* @setting: the #NMSettingConnection
|
||||
|
@ -746,13 +765,14 @@ nm_setting_connection_get_controller(NMSettingConnection *setting)
|
|||
* Returns the #NMSettingConnection:slave-type property of the connection.
|
||||
*
|
||||
* Returns: the type of slave this connection is, if any
|
||||
*
|
||||
* Deprecated: 1.46. Use nm_setting_connection_get_port_type() instead which
|
||||
* is just an alias.
|
||||
*/
|
||||
const char *
|
||||
nm_setting_connection_get_slave_type(NMSettingConnection *setting)
|
||||
{
|
||||
g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), NULL);
|
||||
|
||||
return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->slave_type;
|
||||
return nm_setting_connection_get_port_type(setting);
|
||||
}
|
||||
|
||||
/**
|
||||
|
@ -762,13 +782,15 @@ nm_setting_connection_get_slave_type(NMSettingConnection *setting)
|
|||
* against @setting's slave type
|
||||
*
|
||||
* Returns: %TRUE if connection is of the given slave @type
|
||||
*
|
||||
* Deprecated: 1.46.
|
||||
*/
|
||||
gboolean
|
||||
nm_setting_connection_is_slave_type(NMSettingConnection *setting, const char *type)
|
||||
{
|
||||
g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), FALSE);
|
||||
|
||||
return !g_strcmp0(NM_SETTING_CONNECTION_GET_PRIVATE(setting)->slave_type, type);
|
||||
return !g_strcmp0(NM_SETTING_CONNECTION_GET_PRIVATE(setting)->port_type, type);
|
||||
}
|
||||
|
||||
/**
|
||||
|
@ -1102,7 +1124,7 @@ _nm_connection_detect_slave_type_full(NMSettingConnection *s_con,
|
|||
|
||||
is_slave = FALSE;
|
||||
slave_setting_type = NULL;
|
||||
slave_type = priv->slave_type;
|
||||
slave_type = priv->port_type;
|
||||
if (slave_type) {
|
||||
is_slave = _nm_setting_slave_type_is_valid(slave_type, &slave_setting_type);
|
||||
if (!is_slave) {
|
||||
|
@ -1582,8 +1604,8 @@ after_interface_name:
|
|||
g_set_error(error,
|
||||
NM_CONNECTION_ERROR,
|
||||
NM_CONNECTION_ERROR_MISSING_SETTING,
|
||||
_("slave-type '%s' requires a '%s' setting in the connection"),
|
||||
priv->slave_type,
|
||||
_("port-type '%s' requires a '%s' setting in the connection"),
|
||||
priv->port_type,
|
||||
normerr_slave_setting_type);
|
||||
g_prefix_error(error, "%s: ", normerr_slave_setting_type);
|
||||
return NM_SETTING_VERIFY_NORMALIZABLE_ERROR;
|
||||
|
@ -1609,11 +1631,11 @@ after_interface_name:
|
|||
if (connection) {
|
||||
gboolean has_bridge_port = FALSE;
|
||||
|
||||
if ((!nm_streq0(priv->slave_type, NM_SETTING_BRIDGE_SETTING_NAME)
|
||||
if ((!nm_streq0(priv->port_type, NM_SETTING_BRIDGE_SETTING_NAME)
|
||||
&& (has_bridge_port =
|
||||
!!nm_connection_get_setting_by_name(connection,
|
||||
NM_SETTING_BRIDGE_PORT_SETTING_NAME)))
|
||||
|| (!nm_streq0(priv->slave_type, NM_SETTING_TEAM_SETTING_NAME)
|
||||
|| (!nm_streq0(priv->port_type, NM_SETTING_TEAM_SETTING_NAME)
|
||||
&& nm_connection_get_setting_by_name(connection,
|
||||
NM_SETTING_TEAM_PORT_SETTING_NAME))) {
|
||||
g_set_error(error,
|
||||
|
@ -1621,7 +1643,7 @@ after_interface_name:
|
|||
NM_CONNECTION_ERROR_INVALID_SETTING,
|
||||
_("A slave connection with '%s' set to '%s' cannot have a '%s' setting"),
|
||||
NM_SETTING_CONNECTION_SLAVE_TYPE,
|
||||
priv->slave_type ?: "",
|
||||
priv->port_type ?: "",
|
||||
has_bridge_port ? NM_SETTING_BRIDGE_PORT_SETTING_NAME
|
||||
: NM_SETTING_TEAM_PORT_SETTING_NAME);
|
||||
g_prefix_error(error,
|
||||
|
@ -1871,6 +1893,65 @@ _nm_setting_connection_controller_from_dbus(_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARG
|
|||
return TRUE;
|
||||
}
|
||||
|
||||
gboolean
|
||||
_nm_setting_connection_slave_type_from_dbus(_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil)
|
||||
{
|
||||
const char *str;
|
||||
|
||||
if (!_nm_setting_use_legacy_property(setting,
|
||||
connection_dict,
|
||||
NM_SETTING_CONNECTION_SLAVE_TYPE,
|
||||
NM_SETTING_CONNECTION_PORT_TYPE)) {
|
||||
*out_is_modified = FALSE;
|
||||
return TRUE;
|
||||
}
|
||||
str = g_variant_get_string(value, NULL);
|
||||
|
||||
g_object_set(setting, NM_SETTING_CONNECTION_SLAVE_TYPE, str, NULL);
|
||||
return TRUE;
|
||||
}
|
||||
|
||||
GVariant *
|
||||
_nm_setting_connection_port_type_to_dbus(_NM_SETT_INFO_PROP_TO_DBUS_FCN_ARGS _nm_nil)
|
||||
{
|
||||
const char *port_type;
|
||||
|
||||
/* FIXME: `port-type` is an alias of `slave-type` property. Serializing the
|
||||
* property to the clients would break them as they won't be able to drop
|
||||
* it if they are not aware of the existance of `port-type`. In order to
|
||||
* give them time to adapt their code, NetworkManager is not serializing
|
||||
* `port-type` on DBus.
|
||||
*/
|
||||
if (_nm_utils_is_manager_process) {
|
||||
return NULL;
|
||||
}
|
||||
|
||||
port_type = nm_setting_connection_get_port_type(NM_SETTING_CONNECTION(setting));
|
||||
if (!port_type)
|
||||
return NULL;
|
||||
|
||||
return g_variant_new_string(port_type);
|
||||
}
|
||||
|
||||
gboolean
|
||||
_nm_setting_connection_port_type_from_dbus(_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil)
|
||||
{
|
||||
const char *str;
|
||||
|
||||
/* Ignore 'port-type' if we're going to process 'slave-type' */
|
||||
if (_nm_setting_use_legacy_property(setting,
|
||||
connection_dict,
|
||||
NM_SETTING_CONNECTION_SLAVE_TYPE,
|
||||
NM_SETTING_CONNECTION_PORT_TYPE)) {
|
||||
*out_is_modified = FALSE;
|
||||
return TRUE;
|
||||
}
|
||||
str = g_variant_get_string(value, NULL);
|
||||
|
||||
g_object_set(setting, NM_SETTING_CONNECTION_PORT_TYPE, str, NULL);
|
||||
return TRUE;
|
||||
}
|
||||
|
||||
/*****************************************************************************/
|
||||
|
||||
static void
|
||||
|
@ -2404,6 +2485,8 @@ nm_setting_connection_class_init(NMSettingConnectionClass *klass)
|
|||
* Setting name of the device type of this slave's master connection (eg,
|
||||
* %NM_SETTING_BOND_SETTING_NAME), or %NULL if this connection is not a
|
||||
* slave.
|
||||
*
|
||||
* Deprecated 1.46. Use #NMSettingConnection:port-type instead, this is just an alias.
|
||||
**/
|
||||
/* ---ifcfg-rh---
|
||||
* property: slave-type
|
||||
|
@ -2415,14 +2498,49 @@ nm_setting_connection_class_init(NMSettingConnectionClass *klass)
|
|||
* and BRIDGE_UUID for bridging.
|
||||
* ---end---
|
||||
*/
|
||||
_nm_setting_property_define_direct_string(properties_override,
|
||||
obj_properties,
|
||||
NM_SETTING_CONNECTION_SLAVE_TYPE,
|
||||
PROP_SLAVE_TYPE,
|
||||
NM_SETTING_PARAM_FUZZY_IGNORE
|
||||
| NM_SETTING_PARAM_INFERRABLE,
|
||||
NMSettingConnectionPrivate,
|
||||
slave_type);
|
||||
prop_idx = _nm_setting_property_define_direct_string_full(
|
||||
properties_override,
|
||||
obj_properties,
|
||||
NM_SETTING_CONNECTION_SLAVE_TYPE,
|
||||
PROP_SLAVE_TYPE,
|
||||
NM_SETTING_PARAM_FUZZY_IGNORE | NM_SETTING_PARAM_INFERRABLE,
|
||||
NM_SETT_INFO_PROPERT_TYPE_DBUS(G_VARIANT_TYPE_STRING,
|
||||
.direct_type = NM_VALUE_TYPE_STRING,
|
||||
.compare_fcn = _nm_setting_property_compare_fcn_direct,
|
||||
.to_dbus_fcn = _nm_setting_property_to_dbus_fcn_direct,
|
||||
.from_dbus_fcn =
|
||||
_nm_setting_connection_slave_type_from_dbus, ),
|
||||
NMSettingConnectionPrivate,
|
||||
port_type,
|
||||
.is_deprecated = 1);
|
||||
|
||||
/**
|
||||
* NMSettingConnection:port-type:
|
||||
*
|
||||
* Setting name of the device type of this port's controller connection (eg,
|
||||
* %NM_SETTING_BOND_SETTING_NAME), or %NULL if this connection is not a
|
||||
* port.
|
||||
*
|
||||
* Since: 1.46
|
||||
**/
|
||||
_nm_setting_property_define_direct_string_full(
|
||||
properties_override,
|
||||
obj_properties,
|
||||
NM_SETTING_CONNECTION_PORT_TYPE,
|
||||
PROP_PORT_TYPE,
|
||||
NM_SETTING_PARAM_FUZZY_IGNORE | NM_SETTING_PARAM_INFERRABLE,
|
||||
NM_SETT_INFO_PROPERT_TYPE_DBUS(G_VARIANT_TYPE_STRING,
|
||||
.direct_type = NM_VALUE_TYPE_STRING,
|
||||
.compare_fcn = _nm_setting_property_compare_fcn_direct,
|
||||
.to_dbus_fcn = _nm_setting_connection_port_type_to_dbus,
|
||||
.from_dbus_fcn =
|
||||
_nm_setting_connection_port_type_from_dbus, ),
|
||||
NMSettingConnectionPrivate,
|
||||
port_type,
|
||||
.direct_also_notify = obj_properties[PROP_SLAVE_TYPE]);
|
||||
|
||||
nm_g_array_index(properties_override, NMSettInfoProperty, prop_idx).direct_also_notify =
|
||||
obj_properties[PROP_PORT_TYPE];
|
||||
|
||||
/**
|
||||
* NMSettingConnection:autoconnect-slaves:
|
||||
|
|
|
@ -405,6 +405,12 @@ GVariant *_nm_setting_connection_controller_to_dbus(_NM_SETT_INFO_PROP_TO_DBUS_F
|
|||
|
||||
gboolean _nm_setting_connection_master_from_dbus(_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil);
|
||||
|
||||
gboolean _nm_setting_connection_port_type_from_dbus(_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil);
|
||||
|
||||
GVariant *_nm_setting_connection_port_type_to_dbus(_NM_SETT_INFO_PROP_TO_DBUS_FCN_ARGS _nm_nil);
|
||||
|
||||
gboolean _nm_setting_connection_slave_type_from_dbus(_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil);
|
||||
|
||||
GVariant *_nm_setting_to_dbus(NMSetting *setting,
|
||||
NMConnection *connection,
|
||||
NMConnectionSerializationFlags flags,
|
||||
|
@ -774,7 +780,8 @@ _nm_properties_override(GArray *properties_override, const NMSettInfoProperty *p
|
|||
nm_assert(_property_type->direct_type == NM_VALUE_TYPE_STRING); \
|
||||
nm_assert(NM_IN_SET(_property_type->to_dbus_fcn, \
|
||||
_nm_setting_property_to_dbus_fcn_direct, \
|
||||
_nm_setting_connection_controller_to_dbus)); \
|
||||
_nm_setting_connection_controller_to_dbus, \
|
||||
_nm_setting_connection_port_type_to_dbus)); \
|
||||
\
|
||||
_param_spec = g_param_spec_string("" prop_name "", \
|
||||
"", \
|
||||
|
|
|
@ -2567,7 +2567,8 @@ _nm_setting_property_compare_fcn_direct(_NM_SETT_INFO_PROP_COMPARE_FCN_ARGS _nm_
|
|||
nm_assert(NM_IN_SET(property_info->property_type->to_dbus_fcn,
|
||||
_nm_setting_property_to_dbus_fcn_direct,
|
||||
_nm_setting_property_to_dbus_fcn_direct_mac_address,
|
||||
_nm_setting_connection_controller_to_dbus));
|
||||
_nm_setting_connection_controller_to_dbus,
|
||||
_nm_setting_connection_port_type_to_dbus));
|
||||
|
||||
if (!property_info->param_spec)
|
||||
return nm_assert_unreachable_val(NM_TERNARY_DEFAULT);
|
||||
|
|
|
@ -3962,7 +3962,7 @@ typedef struct {
|
|||
|
||||
typedef struct {
|
||||
const char *name;
|
||||
DiffKey keys[30];
|
||||
DiffKey keys[31];
|
||||
} DiffSetting;
|
||||
|
||||
#define ARRAY_LEN(a) (sizeof(a) / sizeof(a[0]))
|
||||
|
@ -4021,6 +4021,7 @@ test_connection_diff_a_only(void)
|
|||
{NM_SETTING_CONNECTION_MASTER, NM_SETTING_DIFF_RESULT_IN_A},
|
||||
{NM_SETTING_CONNECTION_CONTROLLER, NM_SETTING_DIFF_RESULT_IN_A},
|
||||
{NM_SETTING_CONNECTION_SLAVE_TYPE, NM_SETTING_DIFF_RESULT_IN_A},
|
||||
{NM_SETTING_CONNECTION_PORT_TYPE, NM_SETTING_DIFF_RESULT_IN_A},
|
||||
{NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES, NM_SETTING_DIFF_RESULT_IN_A},
|
||||
{NM_SETTING_CONNECTION_SECONDARIES, NM_SETTING_DIFF_RESULT_IN_A},
|
||||
{NM_SETTING_CONNECTION_GATEWAY_PING_TIMEOUT, NM_SETTING_DIFF_RESULT_IN_A},
|
||||
|
|
|
@ -4708,7 +4708,8 @@ test_setting_metadata(void)
|
|||
g_assert(g_variant_type_equal(sip->property_type->dbus_type, "s"));
|
||||
g_assert(NM_IN_SET(sip->property_type->to_dbus_fcn,
|
||||
_nm_setting_property_to_dbus_fcn_direct,
|
||||
_nm_setting_connection_controller_to_dbus));
|
||||
_nm_setting_connection_controller_to_dbus,
|
||||
_nm_setting_connection_port_type_to_dbus));
|
||||
can_have_direct_set_fcn = TRUE;
|
||||
}
|
||||
g_assert(sip->param_spec);
|
||||
|
@ -4850,6 +4851,8 @@ check_done:;
|
|||
_nm_setting_property_from_dbus_fcn_direct_mac_address,
|
||||
_nm_setting_connection_controller_from_dbus,
|
||||
_nm_setting_connection_master_from_dbus,
|
||||
_nm_setting_connection_slave_type_from_dbus,
|
||||
_nm_setting_connection_port_type_from_dbus,
|
||||
_nm_setting_property_from_dbus_fcn_direct));
|
||||
}
|
||||
}
|
||||
|
@ -4872,7 +4875,8 @@ check_done:;
|
|||
g_assert(NM_IN_SET(sip->property_type->to_dbus_fcn,
|
||||
_nm_setting_property_to_dbus_fcn_direct,
|
||||
_nm_setting_property_to_dbus_fcn_direct_mac_address,
|
||||
_nm_setting_connection_controller_to_dbus));
|
||||
_nm_setting_connection_controller_to_dbus,
|
||||
_nm_setting_connection_port_type_to_dbus));
|
||||
} else if (sip->property_type->compare_fcn == _nm_setting_property_compare_fcn_ignore) {
|
||||
if (NM_IN_SET(sip->property_type,
|
||||
&nm_sett_info_propert_type_deprecated_ignore_i,
|
||||
|
|
|
@ -49,6 +49,7 @@ G_BEGIN_DECLS
|
|||
#define NM_SETTING_CONNECTION_MASTER "master"
|
||||
#define NM_SETTING_CONNECTION_CONTROLLER "controller"
|
||||
#define NM_SETTING_CONNECTION_SLAVE_TYPE "slave-type"
|
||||
#define NM_SETTING_CONNECTION_PORT_TYPE "port-type"
|
||||
#define NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES "autoconnect-slaves"
|
||||
#define NM_SETTING_CONNECTION_SECONDARIES "secondaries"
|
||||
#define NM_SETTING_CONNECTION_GATEWAY_PING_TIMEOUT "gateway-ping-timeout"
|
||||
|
@ -200,8 +201,15 @@ const char *nm_setting_connection_get_master(NMSettingConnection *setting);
|
|||
NM_AVAILABLE_IN_1_46
|
||||
const char *nm_setting_connection_get_controller(NMSettingConnection *setting);
|
||||
|
||||
gboolean nm_setting_connection_is_slave_type(NMSettingConnection *setting, const char *type);
|
||||
NM_DEPRECATED_IN_1_46
|
||||
gboolean nm_setting_connection_is_slave_type(NMSettingConnection *setting, const char *type);
|
||||
|
||||
NM_DEPRECATED_IN_1_46
|
||||
const char *nm_setting_connection_get_slave_type(NMSettingConnection *setting);
|
||||
|
||||
NM_AVAILABLE_IN_1_46
|
||||
const char *nm_setting_connection_get_port_type(NMSettingConnection *setting);
|
||||
|
||||
NM_AVAILABLE_IN_1_2
|
||||
NMSettingConnectionAutoconnectSlaves
|
||||
nm_setting_connection_get_autoconnect_slaves(NMSettingConnection *setting);
|
||||
|
|
|
@ -5668,6 +5668,20 @@ static const NMMetaPropertyInfo *const property_infos_CONNECTION[] = {
|
|||
NM_SETTING_VRF_SETTING_NAME),
|
||||
),
|
||||
),
|
||||
PROPERTY_INFO_WITH_DESC (NM_SETTING_CONNECTION_PORT_TYPE,
|
||||
.is_cli_option = TRUE,
|
||||
.property_alias = "port-type",
|
||||
.inf_flags = NM_META_PROPERTY_INF_FLAG_DONT_ASK,
|
||||
.property_type = &_pt_gobject_string,
|
||||
.property_typ_data = DEFINE_PROPERTY_TYP_DATA (
|
||||
.values_static = NM_MAKE_STRV (NM_SETTING_BOND_SETTING_NAME,
|
||||
NM_SETTING_BRIDGE_SETTING_NAME,
|
||||
NM_SETTING_OVS_BRIDGE_SETTING_NAME,
|
||||
NM_SETTING_OVS_PORT_SETTING_NAME,
|
||||
NM_SETTING_TEAM_SETTING_NAME,
|
||||
NM_SETTING_VRF_SETTING_NAME),
|
||||
),
|
||||
),
|
||||
PROPERTY_INFO_WITH_DESC (NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES,
|
||||
.property_type = &_pt_gobject_enum,
|
||||
),
|
||||
|
|
|
@ -19,9 +19,10 @@
|
|||
#define DESCRIBE_DOC_NM_SETTING_CONNECTION_MUD_URL N_("If configured, set to a Manufacturer Usage Description (MUD) URL that points to manufacturer-recommended network policies for IoT devices. It is transmitted as a DHCPv4 or DHCPv6 option. The value must be a valid URL starting with \"https://\". The special value \"none\" is allowed to indicate that no MUD URL is used. If the per-profile value is unspecified (the default), a global connection default gets consulted. If still unspecified, the ultimate default is \"none\".")
|
||||
#define DESCRIBE_DOC_NM_SETTING_CONNECTION_MULTI_CONNECT N_("Specifies whether the profile can be active multiple times at a particular moment. The value is of type NMConnectionMultiConnect.")
|
||||
#define DESCRIBE_DOC_NM_SETTING_CONNECTION_PERMISSIONS N_("An array of strings defining what access a given user has to this connection. If this is NULL or empty, all users are allowed to access this connection; otherwise users are allowed if and only if they are in this list. When this is not empty, the connection can be active only when one of the specified users is logged into an active session. Each entry is of the form \"[type]:[id]:[reserved]\"; for example, \"user:dcbw:blah\". At this time only the \"user\" [type] is allowed. Any other values are ignored and reserved for future use. [id] is the username that this permission refers to, which may not contain the \":\" character. Any [reserved] information present must be ignored and is reserved for future use. All of [type], [id], and [reserved] must be valid UTF-8.")
|
||||
#define DESCRIBE_DOC_NM_SETTING_CONNECTION_PORT_TYPE N_("Setting name of the device type of this port's controller connection (eg, \"bond\"), or NULL if this connection is not a port.")
|
||||
#define DESCRIBE_DOC_NM_SETTING_CONNECTION_READ_ONLY N_("This property is deprecated and has no meaning.")
|
||||
#define DESCRIBE_DOC_NM_SETTING_CONNECTION_SECONDARIES N_("List of connection UUIDs that should be activated when the base connection itself is activated. Currently, only VPN connections are supported.")
|
||||
#define DESCRIBE_DOC_NM_SETTING_CONNECTION_SLAVE_TYPE N_("Setting name of the device type of this slave's master connection (eg, \"bond\"), or NULL if this connection is not a slave.")
|
||||
#define DESCRIBE_DOC_NM_SETTING_CONNECTION_SLAVE_TYPE N_("Setting name of the device type of this slave's master connection (eg, \"bond\"), or NULL if this connection is not a slave. Deprecated 1.46. Use \"port-type\" instead, this is just an alias.")
|
||||
#define DESCRIBE_DOC_NM_SETTING_CONNECTION_STABLE_ID N_("This represents the identity of the connection used for various purposes. It allows to configure multiple profiles to share the identity. Also, the stable-id can contain placeholders that are substituted dynamically and deterministically depending on the context. The stable-id is used for generating IPv6 stable private addresses with ipv6.addr-gen-mode=stable-privacy. It is also used to seed the generated cloned MAC address for ethernet.cloned-mac-address=stable and wifi.cloned-mac-address=stable. It is also used to derive the DHCP client identifier with ipv4.dhcp-client-id=stable, the DHCPv6 DUID with ipv6.dhcp-duid=stable-[llt,ll,uuid] and the DHCP IAID with ipv4.iaid=stable and ipv6.iaid=stable. Note that depending on the context where it is used, other parameters are also seeded into the generation algorithm. For example, a per-host key is commonly also included, so that different systems end up generating different IDs. Or with ipv6.addr-gen-mode=stable-privacy, also the device's name is included, so that different interfaces yield different addresses. The per-host key is the identity of your machine and stored in /var/lib/NetworkManager/secret_key. See NetworkManager(8) manual about the secret-key and the host identity. The '$' character is treated special to perform dynamic substitutions at activation time. Currently, supported are \"${CONNECTION}\", \"${DEVICE}\", \"${MAC}\", \"${NETWORK_SSID}\", \"${BOOT}\", \"${RANDOM}\". These effectively create unique IDs per-connection, per-device, per-SSID, per-boot, or every time. The \"${CONNECTION}\" uses the profile's connection.uuid, the \"${DEVICE}\" uses the interface name of the device and \"${MAC}\" the permanent MAC address of the device. \"${NETWORK_SSID}\" uses the SSID for Wi-Fi networks and falls back to \"${CONNECTION}\" on other networks. Any unrecognized patterns following '$' are treated verbatim, however are reserved for future use. You are thus advised to avoid '$' or escape it as \"$$\". For example, set it to \"${CONNECTION}-${BOOT}-${DEVICE}\" to create a unique id for this connection that changes with every reboot and differs depending on the interface where the profile activates. If the value is unset, a global connection default is consulted. If the value is still unset, the default is \"default${CONNECTION}\" go generate an ID unique per connection profile.")
|
||||
#define DESCRIBE_DOC_NM_SETTING_CONNECTION_TIMESTAMP N_("The time, in seconds since the Unix Epoch, that the connection was last _successfully_ fully activated. NetworkManager updates the connection timestamp periodically when the connection is active to ensure that an active connection has the latest timestamp. The property is only meant for reading (changes to this property will not be preserved).")
|
||||
#define DESCRIBE_DOC_NM_SETTING_CONNECTION_TYPE N_("Base type of the connection. For hardware-dependent connections, should contain the setting name of the hardware-type specific setting (ie, \"802-3-ethernet\" or \"802-11-wireless\" or \"bluetooth\", etc), and for non-hardware dependent connections like VPN or otherwise, should contain the setting name of that setting type (ie, \"vpn\" or \"bridge\", etc).")
|
||||
|
|
|
@ -662,7 +662,12 @@
|
|||
format="string" />
|
||||
<property name="slave-type"
|
||||
alias="slave-type"
|
||||
nmcli-description="Setting name of the device type of this slave's master connection (eg, "bond"), or NULL if this connection is not a slave."
|
||||
nmcli-description="Setting name of the device type of this slave's master connection (eg, "bond"), or NULL if this connection is not a slave. Deprecated 1.46. Use "port-type" instead, this is just an alias."
|
||||
format="string"
|
||||
values="bond, bridge, ovs-bridge, ovs-port, team, vrf" />
|
||||
<property name="port-type"
|
||||
alias="port-type"
|
||||
nmcli-description="Setting name of the device type of this port's controller connection (eg, "bond"), or NULL if this connection is not a port."
|
||||
format="string"
|
||||
values="bond, bridge, ovs-bridge, ovs-port, team, vrf" />
|
||||
<property name="autoconnect-slaves"
|
||||
|
|
|
@ -502,12 +502,12 @@ NAME UUID TYPE DEVICE
|
|||
con-1 5fcfd6d7-1e63-3332-8826-a7eda103792d ethernet --
|
||||
|
||||
<<<
|
||||
size: 1416
|
||||
size: 1459
|
||||
location: src/tests/client/test-client.py:test_002()/23
|
||||
cmd: $NMCLI c s con-1
|
||||
lang: C
|
||||
returncode: 0
|
||||
stdout: 1288 bytes
|
||||
stdout: 1331 bytes
|
||||
>>>
|
||||
connection.id: con-1
|
||||
connection.uuid: 5fcfd6d7-1e63-3332-8826-a7eda103792d
|
||||
|
@ -525,6 +525,7 @@ connection.zone: --
|
|||
connection.controller: --
|
||||
connection.master: --
|
||||
connection.slave-type: --
|
||||
connection.port-type: --
|
||||
connection.autoconnect-slaves: -1 (default)
|
||||
connection.secondaries: --
|
||||
connection.gateway-ping-timeout: 0
|
||||
|
@ -538,12 +539,12 @@ connection.wait-device-timeout: -1
|
|||
connection.wait-activation-delay: -1
|
||||
|
||||
<<<
|
||||
size: 1427
|
||||
size: 1470
|
||||
location: src/tests/client/test-client.py:test_002()/24
|
||||
cmd: $NMCLI c s con-1
|
||||
lang: pl_PL.UTF-8
|
||||
returncode: 0
|
||||
stdout: 1289 bytes
|
||||
stdout: 1332 bytes
|
||||
>>>
|
||||
connection.id: con-1
|
||||
connection.uuid: 5fcfd6d7-1e63-3332-8826-a7eda103792d
|
||||
|
@ -561,6 +562,7 @@ connection.zone: --
|
|||
connection.controller: --
|
||||
connection.master: --
|
||||
connection.slave-type: --
|
||||
connection.port-type: --
|
||||
connection.autoconnect-slaves: -1 (default)
|
||||
connection.secondaries: --
|
||||
connection.gateway-ping-timeout: 0
|
||||
|
|
File diff suppressed because it is too large
Load diff
File diff suppressed because it is too large
Load diff
Loading…
Reference in a new issue