diff options
Diffstat (limited to 'src/nm-dbus-utils.h')
| -rw-r--r-- | src/nm-dbus-utils.h | 288 |
1 files changed, 158 insertions, 130 deletions
diff --git a/src/nm-dbus-utils.h b/src/nm-dbus-utils.h index 8ae6cb3a..48177973 100644 --- a/src/nm-dbus-utils.h +++ b/src/nm-dbus-utils.h @@ -1,4 +1,4 @@ -// SPDX-License-Identifier: GPL-2.0+ +/* SPDX-License-Identifier: GPL-2.0+ */ /* * Copyright (C) 2018 Red Hat, Inc. */ @@ -12,187 +12,215 @@ struct _NMDBusInterfaceInfoExtended; struct _NMDBusMethodInfoExtended; struct _NMDBusPropertyInfoExtendedBase { - GDBusPropertyInfo _parent; - const char *property_name; + GDBusPropertyInfo _parent; + const char * property_name; - /* Whether the properties needs to be notified on the legacy - * PropertyChanged signal. This is only to preserve API, new - * properties should not use this. */ - bool include_in_legacy_property_changed; + /* Whether the properties needs to be notified on the legacy + * PropertyChanged signal. This is only to preserve API, new + * properties should not use this. */ + bool include_in_legacy_property_changed; }; struct _NMDBusPropertyInfoExtendedReadWritable { - struct _NMDBusPropertyInfoExtendedBase _base; + struct _NMDBusPropertyInfoExtendedBase _base; - /* this is the polkit permission type for authenticating setting - * the property. */ - const char *permission; + /* this is the polkit permission type for authenticating setting + * the property. */ + const char *permission; - /* this is the audit operation type for writing the property. */ - const char *audit_op; + /* this is the audit operation type for writing the property. */ + const char *audit_op; }; typedef struct { - union { - - GDBusPropertyInfo _parent; - struct _NMDBusPropertyInfoExtendedBase _base; - struct _NMDBusPropertyInfoExtendedReadWritable writable; - - /* duplicate the base structure in the union, so that the common fields - * are accessible directly in the parent struct. */ - struct { - GDBusPropertyInfo parent; - const char *property_name; - - /* Whether the properties needs to be notified on the legacy - * PropertyChanged signal. This is only to preserve API, new - * properties should not use this. */ - bool include_in_legacy_property_changed; - }; - }; + union { + GDBusPropertyInfo _parent; + struct _NMDBusPropertyInfoExtendedBase _base; + struct _NMDBusPropertyInfoExtendedReadWritable writable; + + /* duplicate the base structure in the union, so that the common fields + * are accessible directly in the parent struct. */ + struct { + GDBusPropertyInfo parent; + const char * property_name; + + /* Whether the properties needs to be notified on the legacy + * PropertyChanged signal. This is only to preserve API, new + * properties should not use this. */ + bool include_in_legacy_property_changed; + }; + }; } NMDBusPropertyInfoExtended; -G_STATIC_ASSERT (G_STRUCT_OFFSET (NMDBusPropertyInfoExtended, property_name) == G_STRUCT_OFFSET (struct _NMDBusPropertyInfoExtendedBase, property_name)); -G_STATIC_ASSERT (G_STRUCT_OFFSET (NMDBusPropertyInfoExtended, include_in_legacy_property_changed) == G_STRUCT_OFFSET (struct _NMDBusPropertyInfoExtendedBase, include_in_legacy_property_changed)); - -#define NM_DEFINE_DBUS_PROPERTY_INFO_EXTENDED_READABLE_FULL(m_name, m_signature, m_property_name, m_include_in_legacy_property_changed) \ - ((GDBusPropertyInfo *) &((const struct _NMDBusPropertyInfoExtendedBase) { \ - ._parent = { \ - .ref_count = -1, \ - .name = m_name, \ - .signature = m_signature, \ - .flags = G_DBUS_PROPERTY_INFO_FLAGS_READABLE, \ - }, \ - .property_name = m_property_name, \ - .include_in_legacy_property_changed = m_include_in_legacy_property_changed, \ - })) +G_STATIC_ASSERT(G_STRUCT_OFFSET(NMDBusPropertyInfoExtended, property_name) + == G_STRUCT_OFFSET(struct _NMDBusPropertyInfoExtendedBase, property_name)); +G_STATIC_ASSERT(G_STRUCT_OFFSET(NMDBusPropertyInfoExtended, include_in_legacy_property_changed) + == G_STRUCT_OFFSET(struct _NMDBusPropertyInfoExtendedBase, + include_in_legacy_property_changed)); + +#define NM_DEFINE_DBUS_PROPERTY_INFO_EXTENDED_READABLE_FULL(m_name, \ + m_signature, \ + m_property_name, \ + m_include_in_legacy_property_changed) \ + ((GDBusPropertyInfo *) &((const struct _NMDBusPropertyInfoExtendedBase){ \ + ._parent = \ + { \ + .ref_count = -1, \ + .name = m_name, \ + .signature = m_signature, \ + .flags = G_DBUS_PROPERTY_INFO_FLAGS_READABLE, \ + }, \ + .property_name = m_property_name, \ + .include_in_legacy_property_changed = m_include_in_legacy_property_changed, \ + })) #define NM_DEFINE_DBUS_PROPERTY_INFO_EXTENDED_READABLE(m_name, m_signature, m_property_name) \ - NM_DEFINE_DBUS_PROPERTY_INFO_EXTENDED_READABLE_FULL (m_name, m_signature, m_property_name, FALSE) + NM_DEFINE_DBUS_PROPERTY_INFO_EXTENDED_READABLE_FULL(m_name, m_signature, m_property_name, FALSE) /* define a legacy property. Do not use for new code. */ #define NM_DEFINE_DBUS_PROPERTY_INFO_EXTENDED_READABLE_L(m_name, m_signature, m_property_name) \ - NM_DEFINE_DBUS_PROPERTY_INFO_EXTENDED_READABLE_FULL (m_name, m_signature, m_property_name, TRUE) - -#define NM_DEFINE_DBUS_PROPERTY_INFO_EXTENDED_READWRITABLE_FULL(m_name, m_signature, m_property_name, m_permission, m_audit_op, m_include_in_legacy_property_changed) \ - ((GDBusPropertyInfo *) &((const struct _NMDBusPropertyInfoExtendedReadWritable) { \ - ._base = { \ - ._parent = { \ - .ref_count = -1, \ - .name = m_name, \ - .signature = m_signature, \ - .flags = G_DBUS_PROPERTY_INFO_FLAGS_READABLE | G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE, \ - }, \ - .property_name = m_property_name, \ - .include_in_legacy_property_changed = m_include_in_legacy_property_changed, \ - }, \ - .permission = m_permission, \ - .audit_op = m_audit_op, \ - })) - -#define NM_DEFINE_DBUS_PROPERTY_INFO_EXTENDED_READWRITABLE(m_name, m_signature, m_property_name, m_permission, m_audit_op) \ - NM_DEFINE_DBUS_PROPERTY_INFO_EXTENDED_READWRITABLE_FULL (m_name, m_signature, m_property_name, m_permission, m_audit_op, FALSE) + NM_DEFINE_DBUS_PROPERTY_INFO_EXTENDED_READABLE_FULL(m_name, m_signature, m_property_name, TRUE) + +#define NM_DEFINE_DBUS_PROPERTY_INFO_EXTENDED_READWRITABLE_FULL( \ + m_name, \ + m_signature, \ + m_property_name, \ + m_permission, \ + m_audit_op, \ + m_include_in_legacy_property_changed) \ + ((GDBusPropertyInfo *) &((const struct _NMDBusPropertyInfoExtendedReadWritable){ \ + ._base = \ + { \ + ._parent = \ + { \ + .ref_count = -1, \ + .name = m_name, \ + .signature = m_signature, \ + .flags = G_DBUS_PROPERTY_INFO_FLAGS_READABLE \ + | G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE, \ + }, \ + .property_name = m_property_name, \ + .include_in_legacy_property_changed = m_include_in_legacy_property_changed, \ + }, \ + .permission = m_permission, \ + .audit_op = m_audit_op, \ + })) + +#define NM_DEFINE_DBUS_PROPERTY_INFO_EXTENDED_READWRITABLE(m_name, \ + m_signature, \ + m_property_name, \ + m_permission, \ + m_audit_op) \ + NM_DEFINE_DBUS_PROPERTY_INFO_EXTENDED_READWRITABLE_FULL(m_name, \ + m_signature, \ + m_property_name, \ + m_permission, \ + m_audit_op, \ + FALSE) /* define a legacy property. Do not use for new code. */ -#define NM_DEFINE_DBUS_PROPERTY_INFO_EXTENDED_READWRITABLE_L(m_name, m_signature, m_property_name, m_permission, m_audit_op) \ - NM_DEFINE_DBUS_PROPERTY_INFO_EXTENDED_READWRITABLE_FULL (m_name, m_signature, m_property_name, m_permission, m_audit_op, TRUE) +#define NM_DEFINE_DBUS_PROPERTY_INFO_EXTENDED_READWRITABLE_L(m_name, \ + m_signature, \ + m_property_name, \ + m_permission, \ + m_audit_op) \ + NM_DEFINE_DBUS_PROPERTY_INFO_EXTENDED_READWRITABLE_FULL(m_name, \ + m_signature, \ + m_property_name, \ + m_permission, \ + m_audit_op, \ + TRUE) typedef struct _NMDBusMethodInfoExtended { - GDBusMethodInfo parent; - void (*handle) (NMDBusObject *obj, - const struct _NMDBusInterfaceInfoExtended *interface_info, - const struct _NMDBusMethodInfoExtended *method_info, - GDBusConnection *connection, - const char *sender, - GDBusMethodInvocation *invocation, - GVariant *parameters); - bool allow_during_shutdown; + GDBusMethodInfo parent; + void (*handle)(NMDBusObject * obj, + const struct _NMDBusInterfaceInfoExtended *interface_info, + const struct _NMDBusMethodInfoExtended * method_info, + GDBusConnection * connection, + const char * sender, + GDBusMethodInvocation * invocation, + GVariant * parameters); + bool allow_during_shutdown; } NMDBusMethodInfoExtended; #define NM_DEFINE_DBUS_METHOD_INFO_EXTENDED(parent_, ...) \ - ((GDBusMethodInfo *) (&((const NMDBusMethodInfoExtended) { \ - .parent = parent_, \ - __VA_ARGS__ \ - }))) + ((GDBusMethodInfo *) (&((const NMDBusMethodInfoExtended){.parent = parent_, __VA_ARGS__}))) typedef struct _NMDBusInterfaceInfoExtended { - GDBusInterfaceInfo parent; + GDBusInterfaceInfo parent; - /* Whether the interface has a legacy property changed signal (@nm_signal_info_property_changed_legacy). - * New interfaces should not use this. */ - bool legacy_property_changed:1; + /* Whether the interface has a legacy property changed signal (@nm_signal_info_property_changed_legacy). + * New interfaces should not use this. */ + bool legacy_property_changed : 1; } NMDBusInterfaceInfoExtended; extern const GDBusSignalInfo nm_signal_info_property_changed_legacy; -#define NM_DBUS_INTERFACE_INFOS(...) \ - ({ \ - static const NMDBusInterfaceInfoExtended *const _interface_infos[] = { \ - __VA_ARGS__, \ - NULL, \ - }; \ - _interface_infos; \ - }); +#define NM_DBUS_INTERFACE_INFOS(...) \ + ({ \ + static const NMDBusInterfaceInfoExtended *const _interface_infos[] = { \ + __VA_ARGS__, \ + NULL, \ + }; \ + _interface_infos; \ + }); /*****************************************************************************/ -GDBusPropertyInfo *nm_dbus_utils_interface_info_lookup_property (const GDBusInterfaceInfo *interface_info, - const char *property_name, - guint *property_idx); +GDBusPropertyInfo * +nm_dbus_utils_interface_info_lookup_property(const GDBusInterfaceInfo *interface_info, + const char * property_name, + guint * property_idx); -GDBusMethodInfo *nm_dbus_utils_interface_info_lookup_method (const GDBusInterfaceInfo *interface_info, - const char *method_name); +GDBusMethodInfo * +nm_dbus_utils_interface_info_lookup_method(const GDBusInterfaceInfo *interface_info, + const char * method_name); -GVariant *nm_dbus_utils_get_property (GObject *obj, - const char *signature, - const char *property_name); +GVariant * +nm_dbus_utils_get_property(GObject *obj, const char *signature, const char *property_name); /*****************************************************************************/ struct CList; -const char **nm_dbus_utils_get_paths_for_clist (const struct CList *lst_head, - gssize lst_len, - guint member_offset, - gboolean expect_all_exported); +const char **nm_dbus_utils_get_paths_for_clist(const struct CList *lst_head, + gssize lst_len, + guint member_offset, + gboolean expect_all_exported); -void nm_dbus_utils_g_value_set_object_path (GValue *value, gpointer object); +void nm_dbus_utils_g_value_set_object_path(GValue *value, gpointer object); -void nm_dbus_utils_g_value_set_object_path_still_exported (GValue *value, gpointer object); +void nm_dbus_utils_g_value_set_object_path_still_exported(GValue *value, gpointer object); -void nm_dbus_utils_g_value_set_object_path_from_hash (GValue *value, - GHashTable *hash, - gboolean expect_all_exported); +void nm_dbus_utils_g_value_set_object_path_from_hash(GValue * value, + GHashTable *hash, + gboolean expect_all_exported); /*****************************************************************************/ typedef struct { - union { - gpointer const obj; - gpointer _obj; - }; - GObject *_notify_target; - const GParamSpec *_notify_pspec; - gulong _notify_signal_id; - union { - const bool visible; - bool _visible; - }; + union { + gpointer const obj; + gpointer _obj; + }; + GObject * _notify_target; + const GParamSpec *_notify_pspec; + gulong _notify_signal_id; + union { + const bool visible; + bool _visible; + }; } NMDBusTrackObjPath; -void nm_dbus_track_obj_path_init (NMDBusTrackObjPath *track, - GObject *target, - const GParamSpec *pspec); +void +nm_dbus_track_obj_path_init(NMDBusTrackObjPath *track, GObject *target, const GParamSpec *pspec); -void nm_dbus_track_obj_path_deinit (NMDBusTrackObjPath *track); +void nm_dbus_track_obj_path_deinit(NMDBusTrackObjPath *track); -void nm_dbus_track_obj_path_notify (const NMDBusTrackObjPath *track); +void nm_dbus_track_obj_path_notify(const NMDBusTrackObjPath *track); -const char *nm_dbus_track_obj_path_get (const NMDBusTrackObjPath *track); +const char *nm_dbus_track_obj_path_get(const NMDBusTrackObjPath *track); -void nm_dbus_track_obj_path_set (NMDBusTrackObjPath *track, - gpointer obj, - gboolean visible); +void nm_dbus_track_obj_path_set(NMDBusTrackObjPath *track, gpointer obj, gboolean visible); #endif /* __NM_DBUS_UTILS_H__ */ |