mirror of
https://gitlab.freedesktop.org/NetworkManager/NetworkManager.git
synced 2025-12-20 02:20:06 +01:00
10e58f7c3c
Detected by lintian: Example: I: network-manager: typo-in-manual-page "allows to" "allows one to" [usr/share/man/man5/NetworkManager.conf.5.gz:1266]
1239 lines
84 KiB
C
1239 lines
84 KiB
C
/* SPDX-License-Identifier: LGPL-2.1-or-later */
|
|
/*
|
|
* Copyright (C) 2011 Red Hat, Inc.
|
|
*/
|
|
|
|
#ifndef __NM_SETTING_PRIVATE_H__
|
|
#define __NM_SETTING_PRIVATE_H__
|
|
|
|
#if !((NETWORKMANAGER_COMPILATION) & NM_NETWORKMANAGER_COMPILATION_WITH_LIBNM_CORE_PRIVATE)
|
|
#error Cannot use this header.
|
|
#endif
|
|
|
|
#include "nm-setting.h"
|
|
#include "nm-setting-bridge.h"
|
|
#include "nm-connection.h"
|
|
#include "nm-simple-connection.h"
|
|
#include "nm-core-enum-types.h"
|
|
|
|
#include "libnm-core-intern/nm-core-internal.h"
|
|
|
|
/*****************************************************************************/
|
|
|
|
/* This holds a property of type NM_VALUE_TYPE_STRV. You probably want
|
|
* to use nm_strvarray_*() API with this. */
|
|
typedef struct {
|
|
GArray *arr;
|
|
} NMValueStrv;
|
|
|
|
/*****************************************************************************/
|
|
|
|
struct _NMRefString;
|
|
|
|
typedef struct {
|
|
NMConnection *self;
|
|
|
|
NMSetting *settings[_NM_META_SETTING_TYPE_NUM];
|
|
|
|
/* D-Bus path of the connection, if any */
|
|
struct _NMRefString *path;
|
|
} NMConnectionPrivate;
|
|
|
|
extern GTypeClass *_nm_simple_connection_class_instance;
|
|
extern int _nm_simple_connection_private_offset;
|
|
|
|
#undef NM_IS_SIMPLE_CONNECTION
|
|
#define NM_IS_SIMPLE_CONNECTION(self) \
|
|
({ \
|
|
gconstpointer _self1 = (self); \
|
|
gboolean _result; \
|
|
\
|
|
_result = \
|
|
(_self1 \
|
|
&& (((GTypeInstance *) _self1)->g_class == _nm_simple_connection_class_instance)); \
|
|
\
|
|
nm_assert(_result == G_TYPE_CHECK_INSTANCE_TYPE(_self1, NM_TYPE_SIMPLE_CONNECTION)); \
|
|
\
|
|
_result; \
|
|
})
|
|
|
|
#undef NM_IS_CONNECTION
|
|
#define NM_IS_CONNECTION(self) \
|
|
({ \
|
|
gconstpointer _self0 = (self); \
|
|
\
|
|
(_self0 \
|
|
&& (NM_IS_SIMPLE_CONNECTION(_self0) \
|
|
|| G_TYPE_CHECK_INSTANCE_TYPE(_self0, NM_TYPE_CONNECTION))); \
|
|
})
|
|
|
|
#define _NM_SIMPLE_CONNECTION_GET_CONNECTION_PRIVATE(connection) \
|
|
({ \
|
|
gpointer _connection_1 = (connection); \
|
|
NMConnectionPrivate *_priv_1; \
|
|
\
|
|
nm_assert(NM_IS_SIMPLE_CONNECTION(_connection_1)); \
|
|
\
|
|
_priv_1 = (void *) (&(((char *) _connection_1)[_nm_simple_connection_private_offset])); \
|
|
\
|
|
nm_assert(_priv_1 \
|
|
== G_TYPE_INSTANCE_GET_PRIVATE(_connection_1, \
|
|
NM_TYPE_SIMPLE_CONNECTION, \
|
|
NMConnectionPrivate)); \
|
|
\
|
|
_priv_1; \
|
|
})
|
|
|
|
void _nm_connection_private_clear(NMConnectionPrivate *priv);
|
|
|
|
/*****************************************************************************/
|
|
|
|
struct _NMSettingPrivate;
|
|
|
|
/**
|
|
* NMSetting:
|
|
*
|
|
* The NMSetting struct contains only private data.
|
|
* It should only be accessed through the functions described below.
|
|
*/
|
|
struct _NMSetting {
|
|
GObject parent;
|
|
struct _NMSettingPrivate *_priv;
|
|
};
|
|
|
|
struct _NMSettingClass {
|
|
GObjectClass parent;
|
|
|
|
int (*verify)(NMSetting *setting, NMConnection *connection, GError **error);
|
|
|
|
gboolean (*verify_secrets)(NMSetting *setting, NMConnection *connection, GError **error);
|
|
|
|
GPtrArray *(*need_secrets)(NMSetting *setting, gboolean check_rerequest);
|
|
|
|
int (*update_one_secret)(NMSetting *setting, const char *key, GVariant *value, GError **error);
|
|
|
|
gboolean (*get_secret_flags)(NMSetting *setting,
|
|
const char *secret_name,
|
|
NMSettingSecretFlags *out_flags,
|
|
GError **error);
|
|
|
|
gboolean (*set_secret_flags)(NMSetting *setting,
|
|
const char *secret_name,
|
|
NMSettingSecretFlags flags,
|
|
GError **error);
|
|
|
|
gboolean (*clear_secrets)(const struct _NMSettInfoSetting *sett_info,
|
|
const NMSettInfoProperty *property_info,
|
|
NMSetting *setting,
|
|
NMSettingClearSecretsWithFlagsFn func,
|
|
gpointer user_data);
|
|
|
|
void (*duplicate_copy_properties)(const struct _NMSettInfoSetting *sett_info,
|
|
NMSetting *src,
|
|
NMSetting *dst);
|
|
|
|
void (*enumerate_values)(const struct _NMSettInfoProperty *property_info,
|
|
NMSetting *setting,
|
|
NMSettingValueIterFn func,
|
|
gpointer user_data);
|
|
|
|
gboolean (*aggregate)(NMSetting *setting, int type_i, gpointer arg);
|
|
|
|
void (*for_each_secret)(NMSetting *setting,
|
|
const char *secret_name,
|
|
GVariant *val,
|
|
gboolean remove_non_secrets,
|
|
_NMConnectionForEachSecretFunc callback,
|
|
gpointer callback_data,
|
|
GVariantBuilder *setting_builder);
|
|
|
|
gboolean (*init_from_dbus)(NMSetting *setting,
|
|
GHashTable *keys,
|
|
GVariant *setting_dict,
|
|
GVariant *connection_dict,
|
|
guint /* NMSettingParseFlags */ parse_flags,
|
|
GError **error);
|
|
|
|
const struct _NMMetaSettingInfo *setting_info;
|
|
};
|
|
|
|
/*****************************************************************************/
|
|
|
|
/**
|
|
* NMSettingIPConfig:
|
|
*/
|
|
struct _NMSettingIPConfig {
|
|
NMSetting parent;
|
|
};
|
|
|
|
struct _NMSettingIPConfigClass {
|
|
NMSettingClass parent;
|
|
int private_offset;
|
|
gint8 addr_family;
|
|
bool is_ipv4;
|
|
};
|
|
|
|
typedef struct {
|
|
NMValueStrv dns_search; /* array of domain name strings */
|
|
NMValueStrv dhcp_reject_servers;
|
|
NMValueStrv dns_options; /* array of DNS options */
|
|
GPtrArray *dns; /* array of IP address strings */
|
|
GPtrArray *addresses; /* array of NMIPAddress */
|
|
GPtrArray *routes; /* array of NMIPRoute */
|
|
GPtrArray *routing_rules;
|
|
char *method;
|
|
char *gateway;
|
|
char *dhcp_hostname;
|
|
char *dhcp_iaid;
|
|
char *dhcp_dscp;
|
|
char *shared_dhcp_range;
|
|
int shared_dhcp_lease_time;
|
|
gint64 route_metric;
|
|
int auto_route_ext_gw;
|
|
int replace_local_rule;
|
|
int dhcp_send_release;
|
|
int routed_dns;
|
|
int dhcp_send_hostname_v2;
|
|
gint32 required_timeout;
|
|
gint32 dad_timeout;
|
|
gint32 dhcp_timeout;
|
|
gint32 dns_priority;
|
|
guint32 route_table;
|
|
guint32 dhcp_hostname_flags;
|
|
bool ignore_auto_routes;
|
|
bool ignore_auto_dns;
|
|
bool dhcp_send_hostname;
|
|
bool never_default;
|
|
bool may_fail;
|
|
} NMSettingIPConfigPrivate;
|
|
|
|
void _nm_setting_ip_config_private_init(gpointer self, NMSettingIPConfigPrivate *priv);
|
|
|
|
#define NM_SETTING_IP_CONFIG_GET_ADDR_FAMILY(setting) \
|
|
(NM_SETTING_IP_CONFIG_GET_CLASS(setting)->addr_family)
|
|
|
|
#define NM_SETTING_IP_CONFIG_IS_IPv4(setting) (NM_SETTING_IP_CONFIG_GET_CLASS(setting)->is_ipv4)
|
|
|
|
/*****************************************************************************/
|
|
|
|
NMSettingPriority _nm_setting_get_base_type_priority(NMSetting *setting);
|
|
int _nm_setting_compare_priority(gconstpointer a, gconstpointer b);
|
|
|
|
int _nm_setting_sort_for_nm_assert(NMSetting *a, NMSetting *b);
|
|
|
|
/*****************************************************************************/
|
|
|
|
#define _nm_assert_setting_info(setting_info, gtype) \
|
|
G_STMT_START \
|
|
{ \
|
|
const NMMetaSettingInfo *_setting_info = (setting_info); \
|
|
\
|
|
if (NM_MORE_ASSERTS > 0) { \
|
|
GType _gtype = (gtype); \
|
|
\
|
|
nm_assert(_setting_info); \
|
|
nm_assert(_NM_INT_NOT_NEGATIVE(_setting_info->meta_type)); \
|
|
nm_assert(_setting_info->meta_type < _NM_META_SETTING_TYPE_NUM); \
|
|
nm_assert(_setting_info->get_setting_gtype); \
|
|
if (_gtype != 0) \
|
|
nm_assert(_setting_info->get_setting_gtype() == _gtype); \
|
|
else \
|
|
_gtype = _setting_info->get_setting_gtype(); \
|
|
nm_assert(g_type_is_a(_gtype, NM_TYPE_SETTING)); \
|
|
} \
|
|
} \
|
|
G_STMT_END
|
|
|
|
static inline const NMMetaSettingInfo *
|
|
_nm_meta_setting_info_from_class(NMSettingClass *klass)
|
|
{
|
|
const NMMetaSettingInfo *setting_info;
|
|
|
|
if (!NM_IS_SETTING_CLASS(klass))
|
|
return NULL;
|
|
|
|
setting_info = klass->setting_info;
|
|
if (!setting_info)
|
|
return NULL;
|
|
|
|
_nm_assert_setting_info(setting_info, G_OBJECT_CLASS_TYPE(klass));
|
|
return setting_info;
|
|
}
|
|
|
|
static inline const NMMetaSettingInfo *
|
|
_nm_meta_setting_info_from_gtype(GType gtype)
|
|
{
|
|
const NMMetaSettingInfo *setting_info;
|
|
|
|
setting_info = nm_meta_setting_infos_by_gtype(gtype);
|
|
if (!setting_info)
|
|
return NULL;
|
|
|
|
_nm_assert_setting_info(setting_info, gtype);
|
|
return setting_info;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
void _nm_setting_emit_property_changed(NMSetting *setting);
|
|
|
|
typedef enum NMSettingUpdateSecretResult {
|
|
NM_SETTING_UPDATE_SECRET_ERROR = FALSE,
|
|
NM_SETTING_UPDATE_SECRET_SUCCESS_MODIFIED = TRUE,
|
|
NM_SETTING_UPDATE_SECRET_SUCCESS_UNCHANGED = 2,
|
|
} NMSettingUpdateSecretResult;
|
|
|
|
NMSettingUpdateSecretResult
|
|
_nm_setting_update_secrets(NMSetting *setting, GVariant *secrets, GError **error);
|
|
gboolean _nm_setting_clear_secrets(NMSetting *setting,
|
|
NMSettingClearSecretsWithFlagsFn func,
|
|
gpointer user_data);
|
|
|
|
/*****************************************************************************/
|
|
|
|
struct _NMRange {
|
|
int refcount;
|
|
guint64 start;
|
|
guint64 end;
|
|
};
|
|
|
|
/*****************************************************************************/
|
|
|
|
#define NM_SETTING_PARAM_NONE 0
|
|
|
|
/* The property of the #NMSetting should be considered during comparisons that
|
|
* use the %NM_SETTING_COMPARE_FLAG_INFERRABLE flag. Properties that don't have
|
|
* this flag, are ignored when doing an inferrable comparison. This flag should
|
|
* be set on all properties that are read from the kernel or the system when a
|
|
* connection is generated. eg, IP addresses/routes can be read from the
|
|
* kernel, but the 'autoconnect' property cannot, so
|
|
* %NM_SETTING_IP4_CONFIG_ADDRESSES gets the INFERRABLE flag, but
|
|
* %NM_SETTING_CONNECTION_AUTOCONNECT would not.
|
|
*
|
|
* This flag should not be used with properties where the default cannot be
|
|
* read separately from the current value, like MTU or wired duplex mode.
|
|
*/
|
|
#define NM_SETTING_PARAM_INFERRABLE (1 << (4 + G_PARAM_USER_SHIFT))
|
|
|
|
/* This flag has no meaning (anymore). It's only kept, because we used it
|
|
* on some older versions of libnm. */
|
|
#define NM_SETTING_PARAM_UNUSED1 (1 << (5 + G_PARAM_USER_SHIFT))
|
|
|
|
/* When a connection is active and gets modified, usually the change
|
|
* to the settings-connection does not propagate automatically to the
|
|
* applied-connection of the device. For certain properties like the
|
|
* firewall zone and the metered property, this is different.
|
|
*
|
|
* Such fields can be ignored during nm_connection_compare() with the
|
|
* NMSettingCompareFlag NM_SETTING_COMPARE_FLAG_IGNORE_REAPPLY_IMMEDIATELY.
|
|
*/
|
|
#define NM_SETTING_PARAM_REAPPLY_IMMEDIATELY (1 << (6 + G_PARAM_USER_SHIFT))
|
|
|
|
/* property_to_dbus() should ignore the property flags, and instead always calls to_dbus_fcn()
|
|
*/
|
|
#define NM_SETTING_PARAM_TO_DBUS_IGNORE_FLAGS (1 << (7 + G_PARAM_USER_SHIFT))
|
|
|
|
extern const NMSettInfoPropertType nm_sett_info_propert_type_setting_name;
|
|
extern const NMSettInfoPropertType nm_sett_info_propert_type_deprecated_interface_name;
|
|
extern const NMSettInfoPropertType nm_sett_info_propert_type_deprecated_ignore_i;
|
|
extern const NMSettInfoPropertType nm_sett_info_propert_type_deprecated_ignore_u;
|
|
extern const NMSettInfoPropertType nm_sett_info_propert_type_gprop_strv_oldstyle;
|
|
|
|
extern const NMSettInfoPropertType nm_sett_info_propert_type_direct_boolean;
|
|
extern const NMSettInfoPropertType nm_sett_info_propert_type_direct_int32;
|
|
extern const NMSettInfoPropertType nm_sett_info_propert_type_direct_uint32;
|
|
extern const NMSettInfoPropertType nm_sett_info_propert_type_direct_int64;
|
|
extern const NMSettInfoPropertType nm_sett_info_propert_type_direct_uint64;
|
|
extern const NMSettInfoPropertType nm_sett_info_propert_type_direct_string;
|
|
extern const NMSettInfoPropertType nm_sett_info_propert_type_direct_bytes;
|
|
extern const NMSettInfoPropertType nm_sett_info_propert_type_direct_strv;
|
|
extern const NMSettInfoPropertType nm_sett_info_propert_type_direct_enum;
|
|
extern const NMSettInfoPropertType nm_sett_info_propert_type_direct_flags;
|
|
extern const NMSettInfoPropertType nm_sett_info_propert_type_direct_mac_address;
|
|
|
|
NMSettingVerifyResult
|
|
_nm_setting_verify(NMSetting *setting, NMConnection *connection, GError **error);
|
|
|
|
gboolean _nm_setting_verify_secret_string(const char *str,
|
|
const char *setting_name,
|
|
const char *property,
|
|
GError **error);
|
|
|
|
gboolean _nm_setting_aggregate(NMSetting *setting, NMConnectionAggregateType type, gpointer arg);
|
|
|
|
gboolean _nm_setting_port_type_is_valid(const char *port_type, const char **out_port_type);
|
|
|
|
gboolean _nm_setting_compare_flags_check(const GParamSpec *param_spec,
|
|
NMSettingCompareFlags flags,
|
|
NMSetting *set_a,
|
|
NMSetting *set_b);
|
|
|
|
NMTernary _nm_setting_property_compare_fcn_ignore(_NM_SETT_INFO_PROP_COMPARE_FCN_ARGS _nm_nil);
|
|
|
|
NMTernary _nm_setting_property_compare_fcn_direct(_NM_SETT_INFO_PROP_COMPARE_FCN_ARGS _nm_nil);
|
|
|
|
NMTernary _nm_setting_property_compare_fcn_default(_NM_SETT_INFO_PROP_COMPARE_FCN_ARGS _nm_nil);
|
|
|
|
void _nm_setting_property_get_property_direct(GObject *object,
|
|
guint prop_id,
|
|
GValue *value,
|
|
GParamSpec *pspec);
|
|
|
|
void _nm_setting_property_set_property_direct(GObject *object,
|
|
guint prop_id,
|
|
const GValue *value,
|
|
GParamSpec *pspec);
|
|
|
|
GVariant *_nm_setting_property_to_dbus_fcn_ignore(_NM_SETT_INFO_PROP_TO_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
GVariant *_nm_setting_property_to_dbus_fcn_gprop(_NM_SETT_INFO_PROP_TO_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
GVariant *_nm_setting_property_to_dbus_fcn_direct(_NM_SETT_INFO_PROP_TO_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
GVariant *
|
|
_nm_setting_property_to_dbus_fcn_direct_mac_address(_NM_SETT_INFO_PROP_TO_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
gboolean _nm_setting_property_from_dbus_fcn_ignore(_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
gboolean _nm_setting_property_from_dbus_fcn_direct_ip_config_gateway(
|
|
_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
gboolean _nm_setting_property_from_dbus_fcn_direct_mac_address(
|
|
_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
gboolean _nm_setting_property_from_dbus_fcn_direct(_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
gboolean _nm_setting_property_from_dbus_fcn_gprop(_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
gboolean _nm_setting_connection_controller_from_dbus(_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
GVariant *_nm_setting_connection_controller_to_dbus(_NM_SETT_INFO_PROP_TO_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
gboolean _nm_setting_connection_master_from_dbus(_NM_SETT_INFO_PROP_FROM_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_connection_port_type_to_dbus(_NM_SETT_INFO_PROP_TO_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
gboolean _nm_setting_connection_port_type_from_dbus(_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
gboolean
|
|
_nm_setting_connection_autoconnect_slaves_from_dbus(_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
GVariant *
|
|
_nm_setting_connection_autoconnect_ports_to_dbus(_NM_SETT_INFO_PROP_TO_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
gboolean
|
|
_nm_setting_connection_autoconnect_ports_from_dbus(_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
gboolean _nm_setting_wireless_mac_denylist_from_dbus(_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
GVariant *_nm_setting_wireless_mac_denylist_to_dbus(_NM_SETT_INFO_PROP_TO_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
gboolean
|
|
_nm_setting_wireless_mac_blacklist_from_dbus(_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
gboolean _nm_setting_wired_mac_denylist_from_dbus(_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
GVariant *_nm_setting_wired_mac_denylist_to_dbus(_NM_SETT_INFO_PROP_TO_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
gboolean _nm_setting_wired_mac_blacklist_from_dbus(_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
GVariant *_nm_setting_to_dbus(NMSetting *setting,
|
|
NMConnection *connection,
|
|
NMConnectionSerializationFlags flags,
|
|
const NMConnectionSerializationOptions *options);
|
|
|
|
NMSetting *_nm_setting_new_from_dbus(GType setting_type,
|
|
GVariant *setting_dict,
|
|
GVariant *connection_dict,
|
|
NMSettingParseFlags parse_flags,
|
|
GError **error);
|
|
|
|
gboolean _nm_setting_property_is_regular_secret(NMSetting *setting, const char *secret_name);
|
|
gboolean _nm_setting_property_is_regular_secret_flags(NMSetting *setting,
|
|
const char *secret_flags_name);
|
|
|
|
/*****************************************************************************/
|
|
|
|
const NMSettInfoProperty *
|
|
_nm_sett_info_property_lookup_by_param_spec(const NMSettInfoSetting *sett_info,
|
|
const GParamSpec *param_spec);
|
|
|
|
GArray *_nm_sett_info_property_override_create_array_sized(guint reserved_size);
|
|
|
|
static inline GArray *
|
|
_nm_sett_info_property_override_create_array(void)
|
|
{
|
|
/* pre-allocate a relatively large buffer to avoid frequent re-allocations.
|
|
* Note that the buffer is only short-lived and will be destroyed by
|
|
* _nm_setting_class_commit(). */
|
|
return _nm_sett_info_property_override_create_array_sized(20);
|
|
}
|
|
|
|
GArray *_nm_sett_info_property_override_create_array_ip_config(int addr_family);
|
|
|
|
void _nm_setting_class_commit(NMSettingClass *setting_class,
|
|
NMMetaSettingType meta_type,
|
|
const NMSettInfoSettDetail *detail,
|
|
GArray *properties_override,
|
|
gint16 private_offset);
|
|
|
|
#define NM_SETT_INFO_SETT_GENDATA(...) \
|
|
({ \
|
|
static const NMSettInfoSettGendata _g = {__VA_ARGS__}; \
|
|
\
|
|
&_g; \
|
|
})
|
|
|
|
#define NM_SETT_INFO_SETT_DETAIL(...) (&((const NMSettInfoSettDetail) {__VA_ARGS__}))
|
|
|
|
#define NM_SETT_INFO_PROPERT_TYPE_DBUS_INIT(_dbus_type, ...) {.dbus_type = _dbus_type, __VA_ARGS__}
|
|
|
|
#define NM_SETT_INFO_PROPERT_TYPE_GPROP_INIT(_dbus_type, ...) \
|
|
NM_SETT_INFO_PROPERT_TYPE_DBUS_INIT(_dbus_type, \
|
|
.to_dbus_fcn = _nm_setting_property_to_dbus_fcn_gprop, \
|
|
__VA_ARGS__)
|
|
|
|
#define NM_SETT_INFO_PROPERT_TYPE(init) \
|
|
({ \
|
|
static const NMSettInfoPropertType _g = init; \
|
|
\
|
|
&_g; \
|
|
})
|
|
|
|
#define NM_SETT_INFO_PROPERT_TYPE_DBUS(_dbus_type, ...) \
|
|
NM_SETT_INFO_PROPERT_TYPE(NM_SETT_INFO_PROPERT_TYPE_DBUS_INIT(_dbus_type, __VA_ARGS__))
|
|
|
|
#define NM_SETT_INFO_PROPERT_TYPE_GPROP(_dbus_type, ...) \
|
|
NM_SETT_INFO_PROPERT_TYPE(NM_SETT_INFO_PROPERT_TYPE_GPROP_INIT(_dbus_type, __VA_ARGS__))
|
|
|
|
#define NM_SETT_INFO_PROPERTY(...) (&((const NMSettInfoProperty) {__VA_ARGS__}))
|
|
|
|
gboolean _nm_properties_override_assert(const NMSettInfoProperty *prop_info);
|
|
|
|
static inline guint
|
|
_nm_properties_override(GArray *properties_override, const NMSettInfoProperty *prop_info)
|
|
{
|
|
nm_assert(properties_override);
|
|
nm_assert(_nm_properties_override_assert(prop_info));
|
|
g_array_append_vals(properties_override, prop_info, 1);
|
|
return properties_override->len - 1u;
|
|
}
|
|
|
|
#define _nm_properties_override_gobj(properties_override, \
|
|
p_param_spec, \
|
|
p_property_type, \
|
|
... /* extra NMSettInfoProperty fields */) \
|
|
({ \
|
|
GParamSpec *const _p_param_spec_2 = (p_param_spec); \
|
|
\
|
|
nm_assert(_p_param_spec_2); \
|
|
\
|
|
_nm_properties_override((properties_override), \
|
|
NM_SETT_INFO_PROPERTY(.name = _p_param_spec_2->name, \
|
|
.param_spec = _p_param_spec_2, \
|
|
.property_type = (p_property_type), \
|
|
__VA_ARGS__)); \
|
|
})
|
|
|
|
#define _nm_properties_override_dbus(properties_override, \
|
|
p_name, \
|
|
p_property_type, \
|
|
... /* extra NMSettInfoProperty fields */) \
|
|
_nm_properties_override((properties_override), \
|
|
NM_SETT_INFO_PROPERTY(.name = ("" p_name ""), \
|
|
.property_type = (p_property_type), \
|
|
__VA_ARGS__))
|
|
|
|
/*****************************************************************************/
|
|
|
|
/* Define "direct" properties. These are properties that have a GParamSpec and
|
|
* NMSettInfoPropertType.direct_type != NM_VALUE_TYPE_NONE.
|
|
*
|
|
* With this, the location of the data is known at
|
|
*
|
|
* _nm_setting_get_private(setting, sett_info, property_info->direct_offset)
|
|
*
|
|
* which allows one to generically handle the property operations (like get, set, compare).
|
|
*/
|
|
|
|
#define _nm_setting_property_define_direct_boolean(properties_override, \
|
|
obj_properties, \
|
|
prop_name, \
|
|
prop_id, \
|
|
default_value, \
|
|
param_flags, \
|
|
private_struct_type, \
|
|
private_struct_field, \
|
|
... /* extra NMSettInfoProperty fields */) \
|
|
G_STMT_START \
|
|
{ \
|
|
const gboolean _default_value = (default_value); \
|
|
GParamSpec *_param_spec; \
|
|
\
|
|
G_STATIC_ASSERT( \
|
|
!NM_FLAGS_ANY((param_flags), \
|
|
~(NM_SETTING_PARAM_FUZZY_IGNORE | NM_SETTING_PARAM_INFERRABLE \
|
|
| NM_SETTING_PARAM_REAPPLY_IMMEDIATELY))); \
|
|
\
|
|
nm_assert(NM_IN_SET(_default_value, 0, 1)); \
|
|
\
|
|
_param_spec = g_param_spec_boolean("" prop_name "", \
|
|
"", \
|
|
"", \
|
|
_default_value, \
|
|
G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY \
|
|
| G_PARAM_STATIC_STRINGS | (param_flags)); \
|
|
\
|
|
(obj_properties)[(prop_id)] = _param_spec; \
|
|
\
|
|
_nm_properties_override_gobj( \
|
|
(properties_override), \
|
|
_param_spec, \
|
|
&nm_sett_info_propert_type_direct_boolean, \
|
|
.direct_offset = \
|
|
NM_STRUCT_OFFSET_ENSURE_TYPE(bool, private_struct_type, private_struct_field), \
|
|
__VA_ARGS__); \
|
|
} \
|
|
G_STMT_END
|
|
|
|
/*****************************************************************************/
|
|
|
|
#define _nm_setting_property_define_direct_uint32(properties_override, \
|
|
obj_properties, \
|
|
prop_name, \
|
|
prop_id, \
|
|
min_value, \
|
|
max_value, \
|
|
default_value, \
|
|
param_flags, \
|
|
private_struct_type, \
|
|
private_struct_field, \
|
|
... /* extra NMSettInfoProperty fields */) \
|
|
G_STMT_START \
|
|
{ \
|
|
GParamSpec *_param_spec; \
|
|
\
|
|
G_STATIC_ASSERT( \
|
|
!NM_FLAGS_ANY((param_flags), \
|
|
~(NM_SETTING_PARAM_FUZZY_IGNORE | NM_SETTING_PARAM_INFERRABLE))); \
|
|
G_STATIC_ASSERT((min_value) <= (guint64) (default_value)); \
|
|
G_STATIC_ASSERT((default_value) <= (guint64) (max_value)); \
|
|
G_STATIC_ASSERT((max_value) <= (guint64) G_MAXUINT32); \
|
|
\
|
|
_param_spec = g_param_spec_uint("" prop_name "", \
|
|
"", \
|
|
"", \
|
|
(min_value), \
|
|
(max_value), \
|
|
(default_value), \
|
|
G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY \
|
|
| G_PARAM_STATIC_STRINGS | (param_flags)); \
|
|
\
|
|
(obj_properties)[(prop_id)] = _param_spec; \
|
|
\
|
|
_nm_properties_override_gobj( \
|
|
(properties_override), \
|
|
_param_spec, \
|
|
&nm_sett_info_propert_type_direct_uint32, \
|
|
.direct_offset = \
|
|
NM_STRUCT_OFFSET_ENSURE_TYPE(guint32, private_struct_type, private_struct_field), \
|
|
__VA_ARGS__); \
|
|
} \
|
|
G_STMT_END
|
|
|
|
/*****************************************************************************/
|
|
|
|
#define _nm_setting_property_define_direct_int32(properties_override, \
|
|
obj_properties, \
|
|
prop_name, \
|
|
prop_id, \
|
|
min_value, \
|
|
max_value, \
|
|
default_value, \
|
|
param_flags, \
|
|
private_struct_type, \
|
|
private_struct_field, \
|
|
... /* extra NMSettInfoProperty fields */) \
|
|
G_STMT_START \
|
|
{ \
|
|
GParamSpec *_param_spec; \
|
|
\
|
|
G_STATIC_ASSERT( \
|
|
!NM_FLAGS_ANY((param_flags), \
|
|
~(NM_SETTING_PARAM_FUZZY_IGNORE | NM_SETTING_PARAM_INFERRABLE))); \
|
|
G_STATIC_ASSERT((min_value) >= (gint64) (G_MININT32)); \
|
|
G_STATIC_ASSERT((min_value) <= (gint64) (default_value)); \
|
|
G_STATIC_ASSERT((default_value) <= (gint64) (max_value)); \
|
|
G_STATIC_ASSERT((max_value) <= (gint64) G_MAXUINT32); \
|
|
\
|
|
_param_spec = g_param_spec_int("" prop_name "", \
|
|
"", \
|
|
"", \
|
|
(min_value), \
|
|
(max_value), \
|
|
(default_value), \
|
|
G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY \
|
|
| G_PARAM_STATIC_STRINGS | (param_flags)); \
|
|
\
|
|
(obj_properties)[(prop_id)] = _param_spec; \
|
|
\
|
|
_nm_properties_override_gobj( \
|
|
(properties_override), \
|
|
_param_spec, \
|
|
&nm_sett_info_propert_type_direct_int32, \
|
|
.direct_offset = \
|
|
NM_STRUCT_OFFSET_ENSURE_TYPE(gint32, private_struct_type, private_struct_field), \
|
|
__VA_ARGS__); \
|
|
} \
|
|
G_STMT_END
|
|
|
|
/*****************************************************************************/
|
|
|
|
#define _nm_setting_property_define_direct_int64(properties_override, \
|
|
obj_properties, \
|
|
prop_name, \
|
|
prop_id, \
|
|
min_value, \
|
|
max_value, \
|
|
default_value, \
|
|
param_flags, \
|
|
private_struct_type, \
|
|
private_struct_field, \
|
|
... /* extra NMSettInfoProperty fields */) \
|
|
G_STMT_START \
|
|
{ \
|
|
GParamSpec *_param_spec; \
|
|
\
|
|
G_STATIC_ASSERT( \
|
|
!NM_FLAGS_ANY((param_flags), \
|
|
~(NM_SETTING_PARAM_FUZZY_IGNORE | NM_SETTING_PARAM_INFERRABLE))); \
|
|
G_STATIC_ASSERT((min_value) >= G_MININT64); \
|
|
G_STATIC_ASSERT((min_value) <= (default_value)); \
|
|
G_STATIC_ASSERT((default_value) <= (max_value)); \
|
|
G_STATIC_ASSERT((max_value) <= G_MAXINT64); \
|
|
\
|
|
_param_spec = g_param_spec_int64("" prop_name "", \
|
|
"", \
|
|
"", \
|
|
(min_value), \
|
|
(max_value), \
|
|
(default_value), \
|
|
G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY \
|
|
| G_PARAM_STATIC_STRINGS | (param_flags)); \
|
|
\
|
|
(obj_properties)[(prop_id)] = _param_spec; \
|
|
\
|
|
_nm_properties_override_gobj( \
|
|
(properties_override), \
|
|
_param_spec, \
|
|
&nm_sett_info_propert_type_direct_int64, \
|
|
.direct_offset = \
|
|
NM_STRUCT_OFFSET_ENSURE_TYPE(gint64, private_struct_type, private_struct_field), \
|
|
__VA_ARGS__); \
|
|
} \
|
|
G_STMT_END
|
|
|
|
/*****************************************************************************/
|
|
|
|
#define _nm_setting_property_define_direct_uint64(properties_override, \
|
|
obj_properties, \
|
|
prop_name, \
|
|
prop_id, \
|
|
min_value, \
|
|
max_value, \
|
|
default_value, \
|
|
param_flags, \
|
|
private_struct_type, \
|
|
private_struct_field, \
|
|
... /* extra NMSettInfoProperty fields */) \
|
|
G_STMT_START \
|
|
{ \
|
|
GParamSpec *_param_spec; \
|
|
\
|
|
G_STATIC_ASSERT( \
|
|
!NM_FLAGS_ANY((param_flags), \
|
|
~(NM_SETTING_PARAM_FUZZY_IGNORE | NM_SETTING_PARAM_INFERRABLE))); \
|
|
G_STATIC_ASSERT((min_value) <= (default_value)); \
|
|
G_STATIC_ASSERT((default_value) == 0 || (default_value) - 1u < (max_value)); \
|
|
G_STATIC_ASSERT((max_value) <= G_MAXUINT64); \
|
|
\
|
|
_param_spec = g_param_spec_uint64("" prop_name "", \
|
|
"", \
|
|
"", \
|
|
(min_value), \
|
|
(max_value), \
|
|
(default_value), \
|
|
G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY \
|
|
| G_PARAM_STATIC_STRINGS | (param_flags)); \
|
|
\
|
|
(obj_properties)[(prop_id)] = _param_spec; \
|
|
\
|
|
_nm_properties_override_gobj( \
|
|
(properties_override), \
|
|
_param_spec, \
|
|
&nm_sett_info_propert_type_direct_uint64, \
|
|
.direct_offset = \
|
|
NM_STRUCT_OFFSET_ENSURE_TYPE(guint64, private_struct_type, private_struct_field), \
|
|
__VA_ARGS__); \
|
|
} \
|
|
G_STMT_END
|
|
|
|
/*****************************************************************************/
|
|
|
|
#define _nm_setting_property_define_direct_string_full(properties_override, \
|
|
obj_properties, \
|
|
prop_name, \
|
|
prop_id, \
|
|
param_flags, \
|
|
property_type, \
|
|
private_struct_type, \
|
|
private_struct_field, \
|
|
... /* extra NMSettInfoProperty fields */) \
|
|
({ \
|
|
GParamSpec *_param_spec; \
|
|
const NMSettInfoPropertType *_property_type = (property_type); \
|
|
\
|
|
G_STATIC_ASSERT(!NM_FLAGS_ANY((param_flags), \
|
|
~(NM_SETTING_PARAM_SECRET | NM_SETTING_PARAM_FUZZY_IGNORE \
|
|
| NM_SETTING_PARAM_INFERRABLE | NM_SETTING_PARAM_REQUIRED \
|
|
| NM_SETTING_PARAM_REAPPLY_IMMEDIATELY))); \
|
|
\
|
|
nm_assert(_property_type); \
|
|
nm_assert(g_variant_type_equal(_property_type->dbus_type, "s")); \
|
|
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_port_type_to_dbus)); \
|
|
\
|
|
_param_spec = g_param_spec_string("" prop_name "", \
|
|
"", \
|
|
"", \
|
|
NULL, \
|
|
G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY \
|
|
| G_PARAM_STATIC_STRINGS | (param_flags)); \
|
|
\
|
|
(obj_properties)[(prop_id)] = _param_spec; \
|
|
\
|
|
_nm_properties_override_gobj( \
|
|
(properties_override), \
|
|
_param_spec, \
|
|
_property_type, \
|
|
.direct_offset = \
|
|
NM_STRUCT_OFFSET_ENSURE_TYPE(char *, private_struct_type, private_struct_field), \
|
|
__VA_ARGS__); \
|
|
})
|
|
|
|
#define _nm_setting_property_define_direct_string(properties_override, \
|
|
obj_properties, \
|
|
prop_name, \
|
|
prop_id, \
|
|
param_flags, \
|
|
private_struct_type, \
|
|
private_struct_field, \
|
|
... /* extra NMSettInfoProperty fields */) \
|
|
_nm_setting_property_define_direct_string_full((properties_override), \
|
|
(obj_properties), \
|
|
prop_name, \
|
|
(prop_id), \
|
|
(param_flags), \
|
|
&nm_sett_info_propert_type_direct_string, \
|
|
private_struct_type, \
|
|
private_struct_field, \
|
|
__VA_ARGS__)
|
|
|
|
/*****************************************************************************/
|
|
|
|
#define _nm_setting_property_define_direct_bytes(properties_override, \
|
|
obj_properties, \
|
|
prop_name, \
|
|
prop_id, \
|
|
param_flags, \
|
|
private_struct_type, \
|
|
private_struct_field, \
|
|
... /* extra NMSettInfoProperty fields */) \
|
|
G_STMT_START \
|
|
{ \
|
|
GParamSpec *_param_spec; \
|
|
\
|
|
G_STATIC_ASSERT(!NM_FLAGS_ANY((param_flags), \
|
|
~(NM_SETTING_PARAM_SECRET | NM_SETTING_PARAM_INFERRABLE \
|
|
| NM_SETTING_PARAM_FUZZY_IGNORE))); \
|
|
\
|
|
_param_spec = g_param_spec_boxed("" prop_name "", \
|
|
"", \
|
|
"", \
|
|
G_TYPE_BYTES, \
|
|
G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY \
|
|
| G_PARAM_STATIC_STRINGS | (param_flags)); \
|
|
\
|
|
(obj_properties)[(prop_id)] = _param_spec; \
|
|
\
|
|
_nm_properties_override_gobj( \
|
|
(properties_override), \
|
|
_param_spec, \
|
|
&nm_sett_info_propert_type_direct_bytes, \
|
|
.direct_offset = \
|
|
NM_STRUCT_OFFSET_ENSURE_TYPE(GBytes *, private_struct_type, private_struct_field), \
|
|
__VA_ARGS__); \
|
|
} \
|
|
G_STMT_END
|
|
|
|
/*****************************************************************************/
|
|
|
|
#define _nm_setting_property_define_direct_strv(properties_override, \
|
|
obj_properties, \
|
|
prop_name, \
|
|
prop_id, \
|
|
param_flags, \
|
|
property_type, \
|
|
private_struct_type, \
|
|
private_struct_field, \
|
|
... /* extra NMSettInfoProperty fields */) \
|
|
({ \
|
|
GParamSpec *_param_spec; \
|
|
const NMSettInfoPropertType *_property_type; \
|
|
G_STATIC_ASSERT(!NM_FLAGS_ANY((param_flags), ~(NM_SETTING_PARAM_FUZZY_IGNORE))); \
|
|
\
|
|
_param_spec = g_param_spec_boxed("" prop_name "", \
|
|
"", \
|
|
"", \
|
|
G_TYPE_STRV, \
|
|
G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY \
|
|
| G_PARAM_STATIC_STRINGS | (param_flags)); \
|
|
\
|
|
(obj_properties)[(prop_id)] = _param_spec; \
|
|
_property_type = (property_type) ?: &nm_sett_info_propert_type_direct_strv; \
|
|
\
|
|
_nm_properties_override_gobj((properties_override), \
|
|
_param_spec, \
|
|
_property_type, \
|
|
.direct_offset = \
|
|
NM_STRUCT_OFFSET_ENSURE_TYPE(NMValueStrv, \
|
|
private_struct_type, \
|
|
private_struct_field), \
|
|
__VA_ARGS__); \
|
|
})
|
|
|
|
/*****************************************************************************/
|
|
|
|
/* Define a direct property of type enum, but using `int` as type in the underlying
|
|
* GObject property. This is the preferred way to define enum properties because using
|
|
* real enums it is not possible to maintain backwards compatibility with clients
|
|
* using an old libnm (glib asserts against new values of the enum not being valid).
|
|
* The main difference from define_direct_real_enum is that this will accept any
|
|
* integer value, and we'll check that it's valid in #NMSetting::verify, as doing
|
|
* 'verify' is optional for clients. */
|
|
#define _nm_setting_property_define_direct_enum(properties_override, \
|
|
obj_properties, \
|
|
prop_name, \
|
|
prop_id, \
|
|
gtype_enum, \
|
|
default_value, \
|
|
param_flags, \
|
|
property_type, \
|
|
private_struct_type, \
|
|
private_struct_field, \
|
|
... /* extra NMSettInfoProperty fields */) \
|
|
({ \
|
|
GParamSpec *_param_spec; \
|
|
const NMSettInfoPropertType *_property_type; \
|
|
\
|
|
G_STATIC_ASSERT( \
|
|
!NM_FLAGS_ANY((param_flags), \
|
|
~(NM_SETTING_PARAM_REAPPLY_IMMEDIATELY | NM_SETTING_PARAM_FUZZY_IGNORE \
|
|
| NM_SETTING_PARAM_INFERRABLE))); \
|
|
\
|
|
nm_assert(G_TYPE_IS_ENUM(gtype_enum)); \
|
|
\
|
|
_param_spec = g_param_spec_int("" prop_name "", \
|
|
"", \
|
|
"", \
|
|
G_MININT32, \
|
|
G_MAXINT32, \
|
|
(default_value), \
|
|
G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY \
|
|
| G_PARAM_STATIC_STRINGS | (param_flags)); \
|
|
\
|
|
(obj_properties)[(prop_id)] = _param_spec; \
|
|
_property_type = (property_type) ?: &nm_sett_info_propert_type_direct_enum; \
|
|
\
|
|
_nm_properties_override_gobj( \
|
|
(properties_override), \
|
|
_param_spec, \
|
|
_property_type, \
|
|
.direct_offset = \
|
|
NM_STRUCT_OFFSET_ENSURE_TYPE(int, private_struct_type, private_struct_field), \
|
|
.direct_data.enum_gtype = (gtype_enum), \
|
|
__VA_ARGS__); \
|
|
})
|
|
|
|
/*****************************************************************************/
|
|
|
|
/* Define an enum property using real enums in the GObject, not integers. Note that
|
|
* this is not backwards compatible because clients with old libnm will reject
|
|
* newer values of the enum. Generally you want to use define_direct_enum and use this
|
|
* one only for properties that already existed as real enums */
|
|
#define _nm_setting_property_define_direct_real_enum(properties_override, \
|
|
obj_properties, \
|
|
prop_name, \
|
|
prop_id, \
|
|
gtype_enum, \
|
|
default_value, \
|
|
param_flags, \
|
|
property_type, \
|
|
private_struct_type, \
|
|
private_struct_field, \
|
|
... /* extra NMSettInfoProperty fields */) \
|
|
({ \
|
|
GParamSpec *_param_spec; \
|
|
const NMSettInfoPropertType *_property_type; \
|
|
\
|
|
G_STATIC_ASSERT( \
|
|
!NM_FLAGS_ANY((param_flags), \
|
|
~(NM_SETTING_PARAM_REAPPLY_IMMEDIATELY | NM_SETTING_PARAM_FUZZY_IGNORE \
|
|
| NM_SETTING_PARAM_INFERRABLE))); \
|
|
\
|
|
nm_assert(G_TYPE_IS_ENUM(gtype_enum)); \
|
|
\
|
|
_param_spec = g_param_spec_enum("" prop_name "", \
|
|
"", \
|
|
"", \
|
|
(gtype_enum), \
|
|
(default_value), \
|
|
G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY \
|
|
| G_PARAM_STATIC_STRINGS | (param_flags)); \
|
|
\
|
|
(obj_properties)[(prop_id)] = _param_spec; \
|
|
_property_type = (property_type) ?: &nm_sett_info_propert_type_direct_enum; \
|
|
\
|
|
_nm_properties_override_gobj( \
|
|
(properties_override), \
|
|
_param_spec, \
|
|
_property_type, \
|
|
.direct_offset = \
|
|
NM_STRUCT_OFFSET_ENSURE_TYPE(int, private_struct_type, private_struct_field), \
|
|
.direct_data.enum_gtype = (gtype_enum), \
|
|
__VA_ARGS__); \
|
|
})
|
|
|
|
/*****************************************************************************/
|
|
|
|
#define _nm_setting_property_is_valid_direct_enum(property_info) \
|
|
({ \
|
|
const NMSettInfoProperty *_property_info = (property_info); \
|
|
NMValueType direct_nmtype = _property_info->property_type->direct_type; \
|
|
GType direct_gtype = _property_info->direct_data.enum_gtype; \
|
|
GParamSpec *spec = _property_info->param_spec; \
|
|
GType spec_gtype = spec ? spec->value_type : G_TYPE_INVALID; \
|
|
\
|
|
direct_nmtype == NM_VALUE_TYPE_ENUM &&direct_gtype &&G_TYPE_IS_ENUM(direct_gtype) \
|
|
&& NM_IN_SET(spec_gtype, G_TYPE_INT, direct_gtype); \
|
|
})
|
|
|
|
/*****************************************************************************/
|
|
|
|
#define _nm_setting_property_define_direct_ternary_enum(properties_override, \
|
|
obj_properties, \
|
|
prop_name, \
|
|
prop_id, \
|
|
param_flags, \
|
|
private_struct_type, \
|
|
private_struct_field, \
|
|
...) \
|
|
_nm_setting_property_define_direct_real_enum((properties_override), \
|
|
(obj_properties), \
|
|
prop_name, \
|
|
(prop_id), \
|
|
NM_TYPE_TERNARY, \
|
|
NM_TERNARY_DEFAULT, \
|
|
(param_flags), \
|
|
NULL, \
|
|
private_struct_type, \
|
|
private_struct_field, \
|
|
__VA_ARGS__)
|
|
|
|
/*****************************************************************************/
|
|
|
|
#define _nm_setting_property_define_direct_flags(properties_override, \
|
|
obj_properties, \
|
|
prop_name, \
|
|
prop_id, \
|
|
gtype_flags, \
|
|
default_value, \
|
|
param_flags, \
|
|
private_struct_type, \
|
|
private_struct_field, \
|
|
... /* extra NMSettInfoProperty fields */) \
|
|
G_STMT_START \
|
|
{ \
|
|
GParamSpec *_param_spec; \
|
|
\
|
|
G_STATIC_ASSERT( \
|
|
!NM_FLAGS_ANY((param_flags), \
|
|
~(NM_SETTING_PARAM_FUZZY_IGNORE | NM_SETTING_PARAM_INFERRABLE))); \
|
|
\
|
|
_param_spec = g_param_spec_flags("" prop_name "", \
|
|
"", \
|
|
"", \
|
|
(gtype_flags), \
|
|
(default_value), \
|
|
G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY \
|
|
| G_PARAM_STATIC_STRINGS | (param_flags)); \
|
|
\
|
|
(obj_properties)[(prop_id)] = _param_spec; \
|
|
\
|
|
_nm_properties_override_gobj( \
|
|
(properties_override), \
|
|
_param_spec, \
|
|
&nm_sett_info_propert_type_direct_flags, \
|
|
.direct_offset = \
|
|
NM_STRUCT_OFFSET_ENSURE_TYPE(guint, private_struct_type, private_struct_field), \
|
|
__VA_ARGS__); \
|
|
} \
|
|
G_STMT_END
|
|
|
|
/*****************************************************************************/
|
|
|
|
#define _nm_setting_property_define_direct_secret_flags(properties_override, \
|
|
obj_properties, \
|
|
prop_name, \
|
|
prop_id, \
|
|
private_struct_type, \
|
|
private_struct_field, \
|
|
... /* extra NMSettInfoProperty fields */) \
|
|
_nm_setting_property_define_direct_flags((properties_override), \
|
|
(obj_properties), \
|
|
prop_name, \
|
|
(prop_id), \
|
|
NM_TYPE_SETTING_SECRET_FLAGS, \
|
|
NM_SETTING_SECRET_FLAG_NONE, \
|
|
NM_SETTING_PARAM_NONE, \
|
|
private_struct_type, \
|
|
private_struct_field, \
|
|
##__VA_ARGS__)
|
|
|
|
/*****************************************************************************/
|
|
|
|
#define _nm_setting_property_define_direct_mac_address(properties_override, \
|
|
obj_properties, \
|
|
prop_name, \
|
|
prop_id, \
|
|
param_flags, \
|
|
private_struct_type, \
|
|
private_struct_field, \
|
|
... /* extra NMSettInfoProperty fields */) \
|
|
G_STMT_START \
|
|
{ \
|
|
GParamSpec *_param_spec; \
|
|
\
|
|
G_STATIC_ASSERT(!NM_FLAGS_ANY((param_flags), \
|
|
~(NM_SETTING_PARAM_SECRET | NM_SETTING_PARAM_FUZZY_IGNORE \
|
|
| NM_SETTING_PARAM_INFERRABLE \
|
|
| NM_SETTING_PARAM_REAPPLY_IMMEDIATELY))); \
|
|
\
|
|
_param_spec = g_param_spec_string("" prop_name "", \
|
|
"", \
|
|
"", \
|
|
NULL, \
|
|
G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY \
|
|
| G_PARAM_STATIC_STRINGS | (param_flags)); \
|
|
\
|
|
(obj_properties)[(prop_id)] = _param_spec; \
|
|
\
|
|
_nm_properties_override_gobj( \
|
|
(properties_override), \
|
|
_param_spec, \
|
|
&nm_sett_info_propert_type_direct_mac_address, \
|
|
.direct_offset = \
|
|
NM_STRUCT_OFFSET_ENSURE_TYPE(char *, private_struct_type, private_struct_field), \
|
|
__VA_ARGS__); \
|
|
} \
|
|
G_STMT_END
|
|
|
|
/* This should not be used for new strv properties. Use _nm_setting_property_define_direct_strv().
|
|
*
|
|
* FIXME: existing properties should migrate to _nm_setting_property_define_direct_strv(). */
|
|
#define _nm_setting_property_define_gprop_strv_oldstyle(properties_override, \
|
|
obj_properties, \
|
|
prop_name, \
|
|
prop_id, \
|
|
param_flags) \
|
|
G_STMT_START \
|
|
{ \
|
|
GParamSpec *_param_spec; \
|
|
\
|
|
G_STATIC_ASSERT(!NM_FLAGS_ANY((param_flags), \
|
|
~(NM_SETTING_PARAM_SECRET | NM_SETTING_PARAM_FUZZY_IGNORE \
|
|
| NM_SETTING_PARAM_INFERRABLE \
|
|
| NM_SETTING_PARAM_REAPPLY_IMMEDIATELY))); \
|
|
\
|
|
_param_spec = \
|
|
g_param_spec_boxed("" prop_name "", \
|
|
"", \
|
|
"", \
|
|
G_TYPE_STRV, \
|
|
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | (param_flags)); \
|
|
\
|
|
(obj_properties)[(prop_id)] = _param_spec; \
|
|
\
|
|
_nm_properties_override_gobj((properties_override), \
|
|
_param_spec, \
|
|
&nm_sett_info_propert_type_gprop_strv_oldstyle); \
|
|
} \
|
|
G_STMT_END
|
|
|
|
/*****************************************************************************/
|
|
|
|
gboolean _nm_setting_use_legacy_property(NMSetting *setting,
|
|
GVariant *connection_dict,
|
|
const char *legacy_property,
|
|
const char *new_property);
|
|
|
|
GPtrArray *_nm_setting_need_secrets(NMSetting *setting, gboolean check_rerequest);
|
|
|
|
gboolean _nm_setting_should_compare_secret_property(NMSetting *setting,
|
|
NMSetting *other,
|
|
const char *secret_name,
|
|
NMSettingCompareFlags flags);
|
|
|
|
NMBridgeVlan *_nm_bridge_vlan_dup(const NMBridgeVlan *vlan);
|
|
NMBridgeVlan *_nm_bridge_vlan_dup_and_seal(const NMBridgeVlan *vlan);
|
|
|
|
gboolean _nm_utils_bridge_vlans_from_dbus(_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
GVariant *_nm_utils_bridge_vlans_to_dbus(_NM_SETT_INFO_PROP_TO_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
gboolean _nm_utils_ranges_from_dbus(_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
NMTernary _nm_utils_ranges_cmp(_NM_SETT_INFO_PROP_COMPARE_FCN_ARGS _nm_nil);
|
|
|
|
GVariant *_nm_utils_ranges_to_dbus(_NM_SETT_INFO_PROP_TO_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
NMTernary _nm_setting_ip_config_compare_fcn_addresses(_NM_SETT_INFO_PROP_COMPARE_FCN_ARGS _nm_nil);
|
|
|
|
NMTernary _nm_setting_ip_config_compare_fcn_routes(_NM_SETT_INFO_PROP_COMPARE_FCN_ARGS _nm_nil);
|
|
|
|
NMTernary _nm_setting_ip_config_compare_fcn_dns(_NM_SETT_INFO_PROP_COMPARE_FCN_ARGS _nm_nil);
|
|
|
|
gboolean _nm_sett_info_prop_missing_from_dbus_fcn_cloned_mac_address(
|
|
_NM_SETT_INFO_PROP_MISSING_FROM_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
GVariant *
|
|
_nm_sett_info_prop_to_dbus_fcn_cloned_mac_address(_NM_SETT_INFO_PROP_TO_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
gboolean
|
|
_nm_sett_info_prop_from_dbus_fcn_cloned_mac_address(_NM_SETT_INFO_PROP_FROM_DBUS_FCN_ARGS _nm_nil);
|
|
|
|
/*****************************************************************************/
|
|
|
|
void _nm_setting_wireless_normalize_mac_address_randomization(
|
|
NMSettingWireless *s_wifi,
|
|
const char **out_cloned_mac_address,
|
|
NMSettingMacRandomization *out_mac_address_randomization);
|
|
|
|
/*****************************************************************************/
|
|
|
|
#endif /* NM_SETTING_PRIVATE_H */
|