X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=gio%2Fgdbusintrospection.h;h=51b8f9b8077c5ab37fab2b59aaee333097bf5ae5;hb=145391d249eff80bb6b1c67de9a6df354211b55e;hp=fedfbf77595aa4627a7f5264bcd105930505392d;hpb=2aca3b506a2405927a621bb37447dc96b2aa6174;p=platform%2Fupstream%2Fglib.git
diff --git a/gio/gdbusintrospection.h b/gio/gdbusintrospection.h
index fedfbf7..51b8f9b 100644
--- a/gio/gdbusintrospection.h
+++ b/gio/gdbusintrospection.h
@@ -2,10 +2,12 @@
*
* Copyright (C) 2008-2010 Red Hat, Inc.
*
+ * SPDX-License-Identifier: LGPL-2.1-or-later
+ *
* 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.
+ * version 2.1 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
@@ -13,21 +15,20 @@
* 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.
+ * Public License along with this library; if not, see .
*
* 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
-#ifndef __G_DBUS_INTROSPECTION_H__
-#define __G_DBUS_INTROSPECTION_H__
-
#include
+#include /* for TIZEN_PUBLIC_DEPRECATED_API */
G_BEGIN_DECLS
@@ -36,7 +37,7 @@ G_BEGIN_DECLS
* @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: A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.
+ * @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.
*
@@ -44,7 +45,8 @@ G_BEGIN_DECLS
*/
struct _GDBusAnnotationInfo
{
- volatile gint ref_count;
+ /*< public >*/
+ gint ref_count; /* (atomic) */
gchar *key;
gchar *value;
GDBusAnnotationInfo **annotations;
@@ -55,7 +57,7 @@ struct _GDBusAnnotationInfo
* @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: A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.
+ * @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.
*
@@ -63,7 +65,8 @@ struct _GDBusAnnotationInfo
*/
struct _GDBusArgInfo
{
- volatile gint ref_count;
+ /*< public >*/
+ gint ref_count; /* (atomic) */
gchar *name;
gchar *signature;
GDBusAnnotationInfo **annotations;
@@ -73,9 +76,9 @@ struct _GDBusArgInfo
* GDBusMethodInfo:
* @ref_count: The reference count or -1 if statically allocated.
* @name: The name of the D-Bus method, e.g. @RequestName.
- * @in_args: A pointer to a %NULL-terminated array of pointers to #GDBusArgInfo structures or %NULL if there are no in arguments.
- * @out_args: A pointer to a %NULL-terminated array of pointers to #GDBusArgInfo structures or %NULL if there are no out arguments.
- * @annotations: A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.
+ * @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.
*
@@ -83,7 +86,8 @@ struct _GDBusArgInfo
*/
struct _GDBusMethodInfo
{
- volatile gint ref_count;
+ /*< public >*/
+ gint ref_count; /* (atomic) */
gchar *name;
GDBusArgInfo **in_args;
GDBusArgInfo **out_args;
@@ -94,8 +98,8 @@ struct _GDBusMethodInfo
* GDBusSignalInfo:
* @ref_count: The reference count or -1 if statically allocated.
* @name: The name of the D-Bus signal, e.g. "NameOwnerChanged".
- * @args: A pointer to a %NULL-terminated array of pointers to #GDBusArgInfo structures or %NULL if there are no arguments.
- * @annotations: A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.
+ * @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.
*
@@ -103,7 +107,8 @@ struct _GDBusMethodInfo
*/
struct _GDBusSignalInfo
{
- volatile gint ref_count;
+ /*< public >*/
+ gint ref_count; /* (atomic) */
gchar *name;
GDBusArgInfo **args;
GDBusAnnotationInfo **annotations;
@@ -115,7 +120,7 @@ struct _GDBusSignalInfo
* @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: A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.
+ * @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.
*
@@ -123,7 +128,8 @@ struct _GDBusSignalInfo
*/
struct _GDBusPropertyInfo
{
- volatile gint ref_count;
+ /*< public >*/
+ gint ref_count; /* (atomic) */
gchar *name;
gchar *signature;
GDBusPropertyInfoFlags flags;
@@ -134,10 +140,10 @@ struct _GDBusPropertyInfo
* 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: A pointer to a %NULL-terminated array of pointers to #GDBusMethodInfo structures or %NULL if there are no methods.
- * @signals: A pointer to a %NULL-terminated array of pointers to #GDBusSignalInfo structures or %NULL if there are no signals.
- * @properties: A pointer to a %NULL-terminated array of pointers to #GDBusPropertyInfo structures or %NULL if there are no properties.
- * @annotations: A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.
+ * @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.
*
@@ -145,7 +151,8 @@ struct _GDBusPropertyInfo
*/
struct _GDBusInterfaceInfo
{
- volatile gint ref_count;
+ /*< public >*/
+ gint ref_count; /* (atomic) */
gchar *name;
GDBusMethodInfo **methods;
GDBusSignalInfo **signals;
@@ -157,9 +164,9 @@ struct _GDBusInterfaceInfo
* 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: A pointer to a %NULL-terminated array of pointers to #GDBusInterfaceInfo structures or %NULL if there are no interfaces.
- * @nodes: A pointer to a %NULL-terminated array of pointers to #GDBusNodeInfo structures or %NULL if there are no nodes.
- * @annotations: A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.
+ * @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.
*
@@ -167,49 +174,76 @@ struct _GDBusInterfaceInfo
*/
struct _GDBusNodeInfo
{
- volatile gint ref_count;
+ /*< public >*/
+ gint ref_count; /* (atomic) */
gchar *path;
GDBusInterfaceInfo **interfaces;
GDBusNodeInfo **nodes;
GDBusAnnotationInfo **annotations;
};
-const gchar *g_dbus_annotation_info_lookup (const GDBusAnnotationInfo **annotations,
- const gchar *name);
-const GDBusMethodInfo *g_dbus_interface_info_lookup_method (const GDBusInterfaceInfo *info,
- const gchar *name);
-const GDBusSignalInfo *g_dbus_interface_info_lookup_signal (const GDBusInterfaceInfo *info,
- const gchar *name);
-const GDBusPropertyInfo *g_dbus_interface_info_lookup_property (const GDBusInterfaceInfo *info,
- const gchar *name);
-void g_dbus_interface_info_generate_xml (const GDBusInterfaceInfo *info,
- guint indent,
- GString *string_builder);
+GIO_AVAILABLE_IN_ALL
+const gchar *g_dbus_annotation_info_lookup (GDBusAnnotationInfo **annotations,
+ const gchar *name) TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+GDBusMethodInfo *g_dbus_interface_info_lookup_method (GDBusInterfaceInfo *info,
+ const gchar *name) TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+GDBusSignalInfo *g_dbus_interface_info_lookup_signal (GDBusInterfaceInfo *info,
+ const gchar *name) TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+GDBusPropertyInfo *g_dbus_interface_info_lookup_property (GDBusInterfaceInfo *info,
+ const gchar *name) TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+void g_dbus_interface_info_cache_build (GDBusInterfaceInfo *info) TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+void g_dbus_interface_info_cache_release (GDBusInterfaceInfo *info) TIZEN_PUBLIC_DEPRECATED_API;
-GDBusNodeInfo *g_dbus_node_info_new_for_xml (const gchar *xml_data,
- GError **error);
-const GDBusInterfaceInfo *g_dbus_node_info_lookup_interface (const GDBusNodeInfo *info,
- const gchar *name);
-void g_dbus_node_info_generate_xml (const GDBusNodeInfo *info,
- guint indent,
- GString *string_builder);
+GIO_AVAILABLE_IN_ALL
+void g_dbus_interface_info_generate_xml (GDBusInterfaceInfo *info,
+ guint indent,
+ GString *string_builder) TIZEN_PUBLIC_DEPRECATED_API;
-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);
+GIO_AVAILABLE_IN_ALL
+GDBusNodeInfo *g_dbus_node_info_new_for_xml (const gchar *xml_data,
+ GError **error) TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+GDBusInterfaceInfo *g_dbus_node_info_lookup_interface (GDBusNodeInfo *info,
+ const gchar *name) TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+void g_dbus_node_info_generate_xml (GDBusNodeInfo *info,
+ guint indent,
+ GString *string_builder) TIZEN_PUBLIC_DEPRECATED_API;
-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);
+GIO_AVAILABLE_IN_ALL
+GDBusNodeInfo *g_dbus_node_info_ref (GDBusNodeInfo *info) TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+GDBusInterfaceInfo *g_dbus_interface_info_ref (GDBusInterfaceInfo *info) TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+GDBusMethodInfo *g_dbus_method_info_ref (GDBusMethodInfo *info) TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+GDBusSignalInfo *g_dbus_signal_info_ref (GDBusSignalInfo *info) TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+GDBusPropertyInfo *g_dbus_property_info_ref (GDBusPropertyInfo *info) TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+GDBusArgInfo *g_dbus_arg_info_ref (GDBusArgInfo *info) TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+GDBusAnnotationInfo *g_dbus_annotation_info_ref (GDBusAnnotationInfo *info) TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+void g_dbus_node_info_unref (GDBusNodeInfo *info) TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+void g_dbus_interface_info_unref (GDBusInterfaceInfo *info) TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+void g_dbus_method_info_unref (GDBusMethodInfo *info) TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+void g_dbus_signal_info_unref (GDBusSignalInfo *info) TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+void g_dbus_property_info_unref (GDBusPropertyInfo *info) TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+void g_dbus_arg_info_unref (GDBusArgInfo *info) TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+void g_dbus_annotation_info_unref (GDBusAnnotationInfo *info) TIZEN_PUBLIC_DEPRECATED_API;
/**
* G_TYPE_DBUS_NODE_INFO:
@@ -274,13 +308,20 @@ void g_dbus_annotation_info_unref (GDBusAnnotatio
*/
#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;
+GIO_AVAILABLE_IN_ALL
+GType g_dbus_node_info_get_type (void) G_GNUC_CONST TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+GType g_dbus_interface_info_get_type (void) G_GNUC_CONST TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+GType g_dbus_method_info_get_type (void) G_GNUC_CONST TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+GType g_dbus_signal_info_get_type (void) G_GNUC_CONST TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+GType g_dbus_property_info_get_type (void) G_GNUC_CONST TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+GType g_dbus_arg_info_get_type (void) G_GNUC_CONST TIZEN_PUBLIC_DEPRECATED_API;
+GIO_AVAILABLE_IN_ALL
+GType g_dbus_annotation_info_get_type (void) G_GNUC_CONST TIZEN_PUBLIC_DEPRECATED_API;
G_END_DECLS