/* GDBus - GLib D-Bus Library * * Copyright (C) 2008-2010 Red Hat, Inc. * * 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., 59 Temple Place, Suite 330, * Boston, MA 02111-1307, USA. * * Author: David Zeuthen */ #ifndef __G_DBUS_INTROSPECTION_H__ #define __G_DBUS_INTROSPECTION_H__ #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) #error "Only can be included directly." #endif #include G_BEGIN_DECLS /** * GDBusAnnotationInfo: * @ref_count: The reference count or -1 if statically allocated. * @key: The name of the annotation, e.g. "org.freedesktop.DBus.Deprecated". * @value: The value of the annotation. * @annotations: (array zero-terminated=1): A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations. * * Information about an annotation. * * Since: 2.26 */ struct _GDBusAnnotationInfo { /*< public >*/ volatile gint ref_count; gchar *key; gchar *value; GDBusAnnotationInfo **annotations; }; /** * GDBusArgInfo: * @ref_count: The reference count or -1 if statically allocated. * @name: Name of the argument, e.g. @unix_user_id. * @signature: D-Bus signature of the argument (a single complete type). * @annotations: (array zero-terminated=1): A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations. * * Information about an argument for a method or a signal. * * Since: 2.26 */ struct _GDBusArgInfo { /*< public >*/ volatile gint ref_count; gchar *name; gchar *signature; GDBusAnnotationInfo **annotations; }; /** * GDBusMethodInfo: * @ref_count: The reference count or -1 if statically allocated. * @name: The name of the D-Bus method, e.g. @RequestName. * @in_args: (array zero-terminated=1): A pointer to a %NULL-terminated array of pointers to #GDBusArgInfo structures or %NULL if there are no in arguments. * @out_args: (array zero-terminated=1): A pointer to a %NULL-terminated array of pointers to #GDBusArgInfo structures or %NULL if there are no out arguments. * @annotations: (array zero-terminated=1): A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations. * * Information about a method on an D-Bus interface. * * Since: 2.26 */ struct _GDBusMethodInfo { /*< public >*/ volatile gint ref_count; gchar *name; GDBusArgInfo **in_args; GDBusArgInfo **out_args; GDBusAnnotationInfo **annotations; }; /** * GDBusSignalInfo: * @ref_count: The reference count or -1 if statically allocated. * @name: The name of the D-Bus signal, e.g. "NameOwnerChanged". * @args: (array zero-terminated=1): A pointer to a %NULL-terminated array of pointers to #GDBusArgInfo structures or %NULL if there are no arguments. * @annotations: (array zero-terminated=1): A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations. * * Information about a signal on a D-Bus interface. * * Since: 2.26 */ struct _GDBusSignalInfo { /*< public >*/ volatile gint ref_count; gchar *name; GDBusArgInfo **args; GDBusAnnotationInfo **annotations; }; /** * GDBusPropertyInfo: * @ref_count: The reference count or -1 if statically allocated. * @name: The name of the D-Bus property, e.g. "SupportedFilesystems". * @signature: The D-Bus signature of the property (a single complete type). * @flags: Access control flags for the property. * @annotations: (array zero-terminated=1): A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations. * * Information about a D-Bus property on a D-Bus interface. * * Since: 2.26 */ struct _GDBusPropertyInfo { /*< public >*/ volatile gint ref_count; gchar *name; gchar *signature; GDBusPropertyInfoFlags flags; GDBusAnnotationInfo **annotations; }; /** * GDBusInterfaceInfo: * @ref_count: The reference count or -1 if statically allocated. * @name: The name of the D-Bus interface, e.g. "org.freedesktop.DBus.Properties". * @methods: (array zero-terminated=1): A pointer to a %NULL-terminated array of pointers to #GDBusMethodInfo structures or %NULL if there are no methods. * @signals: (array zero-terminated=1): A pointer to a %NULL-terminated array of pointers to #GDBusSignalInfo structures or %NULL if there are no signals. * @properties: (array zero-terminated=1): A pointer to a %NULL-terminated array of pointers to #GDBusPropertyInfo structures or %NULL if there are no properties. * @annotations: (array zero-terminated=1): A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations. * * Information about a D-Bus interface. * * Since: 2.26 */ struct _GDBusInterfaceInfo { /*< public >*/ volatile gint ref_count; gchar *name; GDBusMethodInfo **methods; GDBusSignalInfo **signals; GDBusPropertyInfo **properties; GDBusAnnotationInfo **annotations; }; /** * GDBusNodeInfo: * @ref_count: The reference count or -1 if statically allocated. * @path: The path of the node or %NULL if omitted. Note that this may be a relative path. See the D-Bus specification for more details. * @interfaces: (array zero-terminated=1): A pointer to a %NULL-terminated array of pointers to #GDBusInterfaceInfo structures or %NULL if there are no interfaces. * @nodes: (array zero-terminated=1): A pointer to a %NULL-terminated array of pointers to #GDBusNodeInfo structures or %NULL if there are no nodes. * @annotations: (array zero-terminated=1): A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations. * * Information about nodes in a remote object hierarchy. * * Since: 2.26 */ struct _GDBusNodeInfo { /*< public >*/ volatile gint ref_count; gchar *path; GDBusInterfaceInfo **interfaces; GDBusNodeInfo **nodes; GDBusAnnotationInfo **annotations; }; const gchar *g_dbus_annotation_info_lookup (GDBusAnnotationInfo **annotations, const gchar *name); GDBusMethodInfo *g_dbus_interface_info_lookup_method (GDBusInterfaceInfo *info, const gchar *name); GDBusSignalInfo *g_dbus_interface_info_lookup_signal (GDBusInterfaceInfo *info, const gchar *name); GDBusPropertyInfo *g_dbus_interface_info_lookup_property (GDBusInterfaceInfo *info, const gchar *name); void g_dbus_interface_info_cache_build (GDBusInterfaceInfo *info); void g_dbus_interface_info_cache_release (GDBusInterfaceInfo *info); void g_dbus_interface_info_generate_xml (GDBusInterfaceInfo *info, guint indent, GString *string_builder); GDBusNodeInfo *g_dbus_node_info_new_for_xml (const gchar *xml_data, GError **error); GDBusInterfaceInfo *g_dbus_node_info_lookup_interface (GDBusNodeInfo *info, const gchar *name); void g_dbus_node_info_generate_xml (GDBusNodeInfo *info, guint indent, GString *string_builder); GDBusNodeInfo *g_dbus_node_info_ref (GDBusNodeInfo *info); GDBusInterfaceInfo *g_dbus_interface_info_ref (GDBusInterfaceInfo *info); GDBusMethodInfo *g_dbus_method_info_ref (GDBusMethodInfo *info); GDBusSignalInfo *g_dbus_signal_info_ref (GDBusSignalInfo *info); GDBusPropertyInfo *g_dbus_property_info_ref (GDBusPropertyInfo *info); GDBusArgInfo *g_dbus_arg_info_ref (GDBusArgInfo *info); GDBusAnnotationInfo *g_dbus_annotation_info_ref (GDBusAnnotationInfo *info); void g_dbus_node_info_unref (GDBusNodeInfo *info); void g_dbus_interface_info_unref (GDBusInterfaceInfo *info); void g_dbus_method_info_unref (GDBusMethodInfo *info); void g_dbus_signal_info_unref (GDBusSignalInfo *info); void g_dbus_property_info_unref (GDBusPropertyInfo *info); void g_dbus_arg_info_unref (GDBusArgInfo *info); void g_dbus_annotation_info_unref (GDBusAnnotationInfo *info); /** * G_TYPE_DBUS_NODE_INFO: * * The #GType for a boxed type holding a #GDBusNodeInfo. * * Since: 2.26 */ #define G_TYPE_DBUS_NODE_INFO (g_dbus_node_info_get_type ()) /** * G_TYPE_DBUS_INTERFACE_INFO: * * The #GType for a boxed type holding a #GDBusInterfaceInfo. * * Since: 2.26 */ #define G_TYPE_DBUS_INTERFACE_INFO (g_dbus_interface_info_get_type ()) /** * G_TYPE_DBUS_METHOD_INFO: * * The #GType for a boxed type holding a #GDBusMethodInfo. * * Since: 2.26 */ #define G_TYPE_DBUS_METHOD_INFO (g_dbus_method_info_get_type ()) /** * G_TYPE_DBUS_SIGNAL_INFO: * * The #GType for a boxed type holding a #GDBusSignalInfo. * * Since: 2.26 */ #define G_TYPE_DBUS_SIGNAL_INFO (g_dbus_signal_info_get_type ()) /** * G_TYPE_DBUS_PROPERTY_INFO: * * The #GType for a boxed type holding a #GDBusPropertyInfo. * * Since: 2.26 */ #define G_TYPE_DBUS_PROPERTY_INFO (g_dbus_property_info_get_type ()) /** * G_TYPE_DBUS_ARG_INFO: * * The #GType for a boxed type holding a #GDBusArgInfo. * * Since: 2.26 */ #define G_TYPE_DBUS_ARG_INFO (g_dbus_arg_info_get_type ()) /** * G_TYPE_DBUS_ANNOTATION_INFO: * * The #GType for a boxed type holding a #GDBusAnnotationInfo. * * Since: 2.26 */ #define G_TYPE_DBUS_ANNOTATION_INFO (g_dbus_annotation_info_get_type ()) GType g_dbus_node_info_get_type (void) G_GNUC_CONST; GType g_dbus_interface_info_get_type (void) G_GNUC_CONST; GType g_dbus_method_info_get_type (void) G_GNUC_CONST; GType g_dbus_signal_info_get_type (void) G_GNUC_CONST; GType g_dbus_property_info_get_type (void) G_GNUC_CONST; GType g_dbus_arg_info_get_type (void) G_GNUC_CONST; GType g_dbus_annotation_info_get_type (void) G_GNUC_CONST; G_END_DECLS #endif /* __G_DBUS_INTROSPECTION_H__ */