1 /* GDBus - GLib D-Bus Library
3 * Copyright (C) 2008-2010 Red Hat, Inc.
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
15 * You should have received a copy of the GNU Lesser General
16 * Public License along with this library; if not, write to the
17 * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
18 * Boston, MA 02111-1307, USA.
20 * Author: David Zeuthen <davidz@redhat.com>
28 #include "gdbusintrospection.h"
33 * SECTION:gdbusintrospection
34 * @title: D-Bus Introspection Data
35 * @short_description: Node and interface description data structures
38 * Various data structures and convenience routines to parse and
39 * generate D-Bus introspection XML. Introspection information is
40 * used when registering objects with g_dbus_connection_register_object().
42 * The format of D-Bus introspection XML is specified in the
43 * <ulink url="http://dbus.freedesktop.org/doc/dbus-specification.html#introspection-format">D-Bus specification</ulink>.
46 /* ---------------------------------------------------------------------------------------------------- */
48 #define _MY_DEFINE_BOXED_TYPE(TypeName, type_name) \
49 G_DEFINE_BOXED_TYPE (TypeName, type_name, type_name##_ref, type_name##_unref)
51 _MY_DEFINE_BOXED_TYPE (GDBusNodeInfo
, g_dbus_node_info
);
52 _MY_DEFINE_BOXED_TYPE (GDBusInterfaceInfo
, g_dbus_interface_info
);
53 _MY_DEFINE_BOXED_TYPE (GDBusMethodInfo
, g_dbus_method_info
);
54 _MY_DEFINE_BOXED_TYPE (GDBusSignalInfo
, g_dbus_signal_info
);
55 _MY_DEFINE_BOXED_TYPE (GDBusPropertyInfo
, g_dbus_property_info
);
56 _MY_DEFINE_BOXED_TYPE (GDBusArgInfo
, g_dbus_arg_info
);
57 _MY_DEFINE_BOXED_TYPE (GDBusAnnotationInfo
, g_dbus_annotation_info
);
59 /* ---------------------------------------------------------------------------------------------------- */
63 /* stuff we are currently collecting */
68 GPtrArray
*properties
;
69 GPtrArray
*interfaces
;
71 GPtrArray
*annotations
;
73 /* A list of GPtrArray's containing annotations */
74 GSList
*annotations_stack
;
76 /* A list of GPtrArray's containing interfaces */
77 GSList
*interfaces_stack
;
79 /* A list of GPtrArray's containing nodes */
82 /* Whether the direction was "in" for last parsed arg */
83 gboolean last_arg_was_in
;
85 /* Number of args currently being collected; used for assigning
86 * names to args without a "name" attribute
92 /* ---------------------------------------------------------------------------------------------------- */
95 * g_dbus_node_info_ref:
96 * @info: A #GDBusNodeInfo
98 * If @info is statically allocated does nothing. Otherwise increases
99 * the reference count.
101 * Returns: The same @info.
106 g_dbus_node_info_ref (GDBusNodeInfo
*info
)
108 if (info
->ref_count
== -1)
110 g_atomic_int_inc (&info
->ref_count
);
115 * g_dbus_interface_info_ref:
116 * @info: A #GDBusInterfaceInfo
118 * If @info is statically allocated does nothing. Otherwise increases
119 * the reference count.
121 * Returns: The same @info.
126 g_dbus_interface_info_ref (GDBusInterfaceInfo
*info
)
128 if (info
->ref_count
== -1)
130 g_atomic_int_inc (&info
->ref_count
);
135 * g_dbus_method_info_ref:
136 * @info: A #GDBusMethodInfo
138 * If @info is statically allocated does nothing. Otherwise increases
139 * the reference count.
141 * Returns: The same @info.
146 g_dbus_method_info_ref (GDBusMethodInfo
*info
)
148 if (info
->ref_count
== -1)
150 g_atomic_int_inc (&info
->ref_count
);
155 * g_dbus_signal_info_ref:
156 * @info: A #GDBusSignalInfo
158 * If @info is statically allocated does nothing. Otherwise increases
159 * the reference count.
161 * Returns: The same @info.
166 g_dbus_signal_info_ref (GDBusSignalInfo
*info
)
168 if (info
->ref_count
== -1)
170 g_atomic_int_inc (&info
->ref_count
);
175 * g_dbus_property_info_ref:
176 * @info: A #GDBusPropertyInfo
178 * If @info is statically allocated does nothing. Otherwise increases
179 * the reference count.
181 * Returns: The same @info.
186 g_dbus_property_info_ref (GDBusPropertyInfo
*info
)
188 if (info
->ref_count
== -1)
190 g_atomic_int_inc (&info
->ref_count
);
195 * g_dbus_arg_info_ref:
196 * @info: A #GDBusArgInfo
198 * If @info is statically allocated does nothing. Otherwise increases
199 * the reference count.
201 * Returns: The same @info.
206 g_dbus_arg_info_ref (GDBusArgInfo
*info
)
208 if (info
->ref_count
== -1)
210 g_atomic_int_inc (&info
->ref_count
);
215 * g_dbus_annotation_info_ref:
216 * @info: A #GDBusNodeInfo
218 * If @info is statically allocated does nothing. Otherwise increases
219 * the reference count.
221 * Returns: The same @info.
225 GDBusAnnotationInfo
*
226 g_dbus_annotation_info_ref (GDBusAnnotationInfo
*info
)
228 if (info
->ref_count
== -1)
230 g_atomic_int_inc (&info
->ref_count
);
234 /* ---------------------------------------------------------------------------------------------------- */
237 free_null_terminated_array (gpointer array
, GDestroyNotify unref_func
)
243 for (n
= 0; p
[n
] != NULL
; n
++)
249 * g_dbus_annotation_info_unref:
250 * @info: A #GDBusAnnotationInfo.
252 * If @info is statically allocated, does nothing. Otherwise decreases
253 * the reference count of @info. When its reference count drops to 0,
254 * the memory used is freed.
259 g_dbus_annotation_info_unref (GDBusAnnotationInfo
*info
)
261 if (info
->ref_count
== -1)
263 if (g_atomic_int_dec_and_test (&info
->ref_count
))
266 g_free (info
->value
);
267 free_null_terminated_array (info
->annotations
, (GDestroyNotify
) g_dbus_annotation_info_unref
);
273 * g_dbus_arg_info_unref:
274 * @info: A #GDBusArgInfo.
276 * If @info is statically allocated, does nothing. Otherwise decreases
277 * the reference count of @info. When its reference count drops to 0,
278 * the memory used is freed.
283 g_dbus_arg_info_unref (GDBusArgInfo
*info
)
285 if (info
->ref_count
== -1)
287 if (g_atomic_int_dec_and_test (&info
->ref_count
))
290 g_free (info
->signature
);
291 free_null_terminated_array (info
->annotations
, (GDestroyNotify
) g_dbus_annotation_info_unref
);
297 * g_dbus_method_info_unref:
298 * @info: A #GDBusMethodInfo.
300 * If @info is statically allocated, does nothing. Otherwise decreases
301 * the reference count of @info. When its reference count drops to 0,
302 * the memory used is freed.
307 g_dbus_method_info_unref (GDBusMethodInfo
*info
)
309 if (info
->ref_count
== -1)
311 if (g_atomic_int_dec_and_test (&info
->ref_count
))
314 free_null_terminated_array (info
->in_args
, (GDestroyNotify
) g_dbus_arg_info_unref
);
315 free_null_terminated_array (info
->out_args
, (GDestroyNotify
) g_dbus_arg_info_unref
);
316 free_null_terminated_array (info
->annotations
, (GDestroyNotify
) g_dbus_annotation_info_unref
);
322 * g_dbus_signal_info_unref:
323 * @info: A #GDBusSignalInfo.
325 * If @info is statically allocated, does nothing. Otherwise decreases
326 * the reference count of @info. When its reference count drops to 0,
327 * the memory used is freed.
332 g_dbus_signal_info_unref (GDBusSignalInfo
*info
)
334 if (info
->ref_count
== -1)
336 if (g_atomic_int_dec_and_test (&info
->ref_count
))
339 free_null_terminated_array (info
->args
, (GDestroyNotify
) g_dbus_arg_info_unref
);
340 free_null_terminated_array (info
->annotations
, (GDestroyNotify
) g_dbus_annotation_info_unref
);
346 * g_dbus_property_info_unref:
347 * @info: A #GDBusPropertyInfo.
349 * If @info is statically allocated, does nothing. Otherwise decreases
350 * the reference count of @info. When its reference count drops to 0,
351 * the memory used is freed.
356 g_dbus_property_info_unref (GDBusPropertyInfo
*info
)
358 if (info
->ref_count
== -1)
360 if (g_atomic_int_dec_and_test (&info
->ref_count
))
363 g_free (info
->signature
);
364 free_null_terminated_array (info
->annotations
, (GDestroyNotify
) g_dbus_annotation_info_unref
);
370 * g_dbus_interface_info_unref:
371 * @info: A #GDBusInterfaceInfo.
373 * If @info is statically allocated, does nothing. Otherwise decreases
374 * the reference count of @info. When its reference count drops to 0,
375 * the memory used is freed.
380 g_dbus_interface_info_unref (GDBusInterfaceInfo
*info
)
382 if (info
->ref_count
== -1)
384 if (g_atomic_int_dec_and_test (&info
->ref_count
))
387 free_null_terminated_array (info
->methods
, (GDestroyNotify
) g_dbus_method_info_unref
);
388 free_null_terminated_array (info
->signals
, (GDestroyNotify
) g_dbus_signal_info_unref
);
389 free_null_terminated_array (info
->properties
, (GDestroyNotify
) g_dbus_property_info_unref
);
390 free_null_terminated_array (info
->annotations
, (GDestroyNotify
) g_dbus_annotation_info_unref
);
396 * g_dbus_node_info_unref:
397 * @info: A #GDBusNodeInfo.
399 * If @info is statically allocated, does nothing. Otherwise decreases
400 * the reference count of @info. When its reference count drops to 0,
401 * the memory used is freed.
406 g_dbus_node_info_unref (GDBusNodeInfo
*info
)
408 if (info
->ref_count
== -1)
410 if (g_atomic_int_dec_and_test (&info
->ref_count
))
413 free_null_terminated_array (info
->interfaces
, (GDestroyNotify
) g_dbus_interface_info_unref
);
414 free_null_terminated_array (info
->nodes
, (GDestroyNotify
) g_dbus_node_info_unref
);
415 free_null_terminated_array (info
->annotations
, (GDestroyNotify
) g_dbus_annotation_info_unref
);
420 /* ---------------------------------------------------------------------------------------------------- */
423 g_dbus_annotation_info_set (ParseData
*data
,
424 GDBusAnnotationInfo
*info
,
427 GDBusAnnotationInfo
**embedded_annotations
)
432 info
->key
= g_strdup (key
);
435 info
->value
= g_strdup (value
);
437 if (embedded_annotations
!= NULL
)
438 info
->annotations
= embedded_annotations
;
442 g_dbus_arg_info_set (ParseData
*data
,
445 const gchar
*signature
,
446 GDBusAnnotationInfo
**annotations
)
450 /* name may be NULL - TODO: compute name? */
452 info
->name
= g_strdup (name
);
454 if (signature
!= NULL
)
455 info
->signature
= g_strdup (signature
);
457 if (annotations
!= NULL
)
458 info
->annotations
= annotations
;
462 g_dbus_method_info_set (ParseData
*data
,
463 GDBusMethodInfo
*info
,
465 GDBusArgInfo
**in_args
,
466 GDBusArgInfo
**out_args
,
467 GDBusAnnotationInfo
**annotations
)
472 info
->name
= g_strdup (name
);
475 info
->in_args
= in_args
;
477 if (out_args
!= NULL
)
478 info
->out_args
= out_args
;
480 if (annotations
!= NULL
)
481 info
->annotations
= annotations
;
485 g_dbus_signal_info_set (ParseData
*data
,
486 GDBusSignalInfo
*info
,
489 GDBusAnnotationInfo
**annotations
)
494 info
->name
= g_strdup (name
);
499 if (annotations
!= NULL
)
500 info
->annotations
= annotations
;
504 g_dbus_property_info_set (ParseData
*data
,
505 GDBusPropertyInfo
*info
,
507 const gchar
*signature
,
508 GDBusPropertyInfoFlags flags
,
509 GDBusAnnotationInfo
**annotations
)
514 info
->name
= g_strdup (name
);
516 if (flags
!= G_DBUS_PROPERTY_INFO_FLAGS_NONE
)
519 if (signature
!= NULL
)
520 info
->signature
= g_strdup (signature
);
522 if (annotations
!= NULL
)
523 info
->annotations
= annotations
;
527 g_dbus_interface_info_set (ParseData
*data
,
528 GDBusInterfaceInfo
*info
,
530 GDBusMethodInfo
**methods
,
531 GDBusSignalInfo
**signals
,
532 GDBusPropertyInfo
**properties
,
533 GDBusAnnotationInfo
**annotations
)
538 info
->name
= g_strdup (name
);
541 info
->methods
= methods
;
544 info
->signals
= signals
;
546 if (properties
!= NULL
)
547 info
->properties
= properties
;
549 if (annotations
!= NULL
)
550 info
->annotations
= annotations
;
554 g_dbus_node_info_set (ParseData
*data
,
557 GDBusInterfaceInfo
**interfaces
,
558 GDBusNodeInfo
**nodes
,
559 GDBusAnnotationInfo
**annotations
)
565 info
->path
= g_strdup (path
);
566 /* TODO: relative / absolute path snafu */
569 if (interfaces
!= NULL
)
570 info
->interfaces
= interfaces
;
575 if (annotations
!= NULL
)
576 info
->annotations
= annotations
;
579 /* ---------------------------------------------------------------------------------------------------- */
582 g_dbus_annotation_info_generate_xml (GDBusAnnotationInfo
*info
,
584 GString
*string_builder
)
588 g_string_append_printf (string_builder
, "%*s<annotation name=\"%s\" value=\"%s\"",
593 if (info
->annotations
== NULL
)
595 g_string_append (string_builder
, "/>\n");
599 g_string_append (string_builder
, ">\n");
601 for (n
= 0; info
->annotations
!= NULL
&& info
->annotations
[n
] != NULL
; n
++)
602 g_dbus_annotation_info_generate_xml (info
->annotations
[n
],
606 g_string_append_printf (string_builder
, "%*s</annotation>\n",
613 g_dbus_arg_info_generate_xml (GDBusArgInfo
*info
,
615 const gchar
*extra_attributes
,
616 GString
*string_builder
)
620 g_string_append_printf (string_builder
, "%*s<arg type=\"%s\"",
624 if (info
->name
!= NULL
)
625 g_string_append_printf (string_builder
, " name=\"%s\"", info
->name
);
627 if (extra_attributes
!= NULL
)
628 g_string_append_printf (string_builder
, " %s", extra_attributes
);
630 if (info
->annotations
== NULL
)
632 g_string_append (string_builder
, "/>\n");
636 g_string_append (string_builder
, ">\n");
638 for (n
= 0; info
->annotations
!= NULL
&& info
->annotations
[n
] != NULL
; n
++)
639 g_dbus_annotation_info_generate_xml (info
->annotations
[n
],
643 g_string_append_printf (string_builder
, "%*s</arg>\n", indent
, "");
649 g_dbus_method_info_generate_xml (GDBusMethodInfo
*info
,
651 GString
*string_builder
)
655 g_string_append_printf (string_builder
, "%*s<method name=\"%s\"",
659 if (info
->annotations
== NULL
&& info
->in_args
== NULL
&& info
->out_args
== NULL
)
661 g_string_append (string_builder
, "/>\n");
665 g_string_append (string_builder
, ">\n");
667 for (n
= 0; info
->annotations
!= NULL
&& info
->annotations
[n
] != NULL
; n
++)
668 g_dbus_annotation_info_generate_xml (info
->annotations
[n
],
672 for (n
= 0; info
->in_args
!= NULL
&& info
->in_args
[n
] != NULL
; n
++)
673 g_dbus_arg_info_generate_xml (info
->in_args
[n
],
678 for (n
= 0; info
->out_args
!= NULL
&& info
->out_args
[n
] != NULL
; n
++)
679 g_dbus_arg_info_generate_xml (info
->out_args
[n
],
684 g_string_append_printf (string_builder
, "%*s</method>\n", indent
, "");
689 g_dbus_signal_info_generate_xml (GDBusSignalInfo
*info
,
691 GString
*string_builder
)
695 g_string_append_printf (string_builder
, "%*s<signal name=\"%s\"",
699 if (info
->annotations
== NULL
&& info
->args
== NULL
)
701 g_string_append (string_builder
, "/>\n");
705 g_string_append (string_builder
, ">\n");
707 for (n
= 0; info
->annotations
!= NULL
&& info
->annotations
[n
] != NULL
; n
++)
708 g_dbus_annotation_info_generate_xml (info
->annotations
[n
],
712 for (n
= 0; info
->args
!= NULL
&& info
->args
[n
] != NULL
; n
++)
713 g_dbus_arg_info_generate_xml (info
->args
[n
],
718 g_string_append_printf (string_builder
, "%*s</signal>\n", indent
, "");
723 g_dbus_property_info_generate_xml (GDBusPropertyInfo
*info
,
725 GString
*string_builder
)
728 const gchar
*access_string
;
730 if ((info
->flags
& G_DBUS_PROPERTY_INFO_FLAGS_READABLE
) &&
731 (info
->flags
& G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE
))
733 access_string
= "readwrite";
735 else if (info
->flags
& G_DBUS_PROPERTY_INFO_FLAGS_READABLE
)
737 access_string
= "read";
739 else if (info
->flags
& G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE
)
741 access_string
= "write";
745 g_assert_not_reached ();
748 g_string_append_printf (string_builder
, "%*s<property type=\"%s\" name=\"%s\" access=\"%s\"",
754 if (info
->annotations
== NULL
)
756 g_string_append (string_builder
, "/>\n");
760 g_string_append (string_builder
, ">\n");
762 for (n
= 0; info
->annotations
!= NULL
&& info
->annotations
[n
] != NULL
; n
++)
763 g_dbus_annotation_info_generate_xml (info
->annotations
[n
],
767 g_string_append_printf (string_builder
, "%*s</property>\n", indent
, "");
773 * g_dbus_interface_info_generate_xml:
774 * @info: A #GDBusNodeInfo
775 * @indent: Indentation level.
776 * @string_builder: (out): A #GString to to append XML data to.
778 * Appends an XML representation of @info (and its children) to @string_builder.
780 * This function is typically used for generating introspection XML
781 * documents at run-time for handling the
782 * <literal>org.freedesktop.DBus.Introspectable.Introspect</literal>
788 g_dbus_interface_info_generate_xml (GDBusInterfaceInfo
*info
,
790 GString
*string_builder
)
794 g_string_append_printf (string_builder
, "%*s<interface name=\"%s\">\n",
798 for (n
= 0; info
->annotations
!= NULL
&& info
->annotations
[n
] != NULL
; n
++)
799 g_dbus_annotation_info_generate_xml (info
->annotations
[n
],
803 for (n
= 0; info
->methods
!= NULL
&& info
->methods
[n
] != NULL
; n
++)
804 g_dbus_method_info_generate_xml (info
->methods
[n
],
808 for (n
= 0; info
->signals
!= NULL
&& info
->signals
[n
] != NULL
; n
++)
809 g_dbus_signal_info_generate_xml (info
->signals
[n
],
813 for (n
= 0; info
->properties
!= NULL
&& info
->properties
[n
] != NULL
; n
++)
814 g_dbus_property_info_generate_xml (info
->properties
[n
],
818 g_string_append_printf (string_builder
, "%*s</interface>\n", indent
, "");
822 * g_dbus_node_info_generate_xml:
823 * @info: A #GDBusNodeInfo.
824 * @indent: Indentation level.
825 * @string_builder: (out): A #GString to to append XML data to.
827 * Appends an XML representation of @info (and its children) to @string_builder.
829 * This function is typically used for generating introspection XML documents at run-time for
830 * handling the <literal>org.freedesktop.DBus.Introspectable.Introspect</literal> method.
835 g_dbus_node_info_generate_xml (GDBusNodeInfo
*info
,
837 GString
*string_builder
)
841 g_string_append_printf (string_builder
, "%*s<node", indent
, "");
842 if (info
->path
!= NULL
)
843 g_string_append_printf (string_builder
, " name=\"%s\"", info
->path
);
845 if (info
->interfaces
== NULL
&& info
->nodes
== NULL
&& info
->annotations
== NULL
)
847 g_string_append (string_builder
, "/>\n");
851 g_string_append (string_builder
, ">\n");
853 for (n
= 0; info
->annotations
!= NULL
&& info
->annotations
[n
] != NULL
; n
++)
854 g_dbus_annotation_info_generate_xml (info
->annotations
[n
],
858 for (n
= 0; info
->interfaces
!= NULL
&& info
->interfaces
[n
] != NULL
; n
++)
859 g_dbus_interface_info_generate_xml (info
->interfaces
[n
],
863 for (n
= 0; info
->nodes
!= NULL
&& info
->nodes
[n
] != NULL
; n
++)
864 g_dbus_node_info_generate_xml (info
->nodes
[n
],
868 g_string_append_printf (string_builder
, "%*s</node>\n", indent
, "");
872 /* ---------------------------------------------------------------------------------------------------- */
874 static GDBusAnnotationInfo
**
875 parse_data_steal_annotations (ParseData
*data
,
876 guint
*out_num_elements
)
878 GDBusAnnotationInfo
**ret
;
879 if (out_num_elements
!= NULL
)
880 *out_num_elements
= data
->annotations
->len
;
881 if (data
->annotations
== NULL
)
885 g_ptr_array_add (data
->annotations
, NULL
);
886 ret
= (GDBusAnnotationInfo
**) g_ptr_array_free (data
->annotations
, FALSE
);
888 data
->annotations
= g_ptr_array_new ();
892 static GDBusArgInfo
**
893 parse_data_steal_args (ParseData
*data
,
894 guint
*out_num_elements
)
897 if (out_num_elements
!= NULL
)
898 *out_num_elements
= data
->args
->len
;
899 if (data
->args
== NULL
)
903 g_ptr_array_add (data
->args
, NULL
);
904 ret
= (GDBusArgInfo
**) g_ptr_array_free (data
->args
, FALSE
);
906 data
->args
= g_ptr_array_new ();
910 static GDBusArgInfo
**
911 parse_data_steal_out_args (ParseData
*data
,
912 guint
*out_num_elements
)
915 if (out_num_elements
!= NULL
)
916 *out_num_elements
= data
->out_args
->len
;
917 if (data
->out_args
== NULL
)
921 g_ptr_array_add (data
->out_args
, NULL
);
922 ret
= (GDBusArgInfo
**) g_ptr_array_free (data
->out_args
, FALSE
);
924 data
->out_args
= g_ptr_array_new ();
928 static GDBusMethodInfo
**
929 parse_data_steal_methods (ParseData
*data
,
930 guint
*out_num_elements
)
932 GDBusMethodInfo
**ret
;
933 if (out_num_elements
!= NULL
)
934 *out_num_elements
= data
->methods
->len
;
935 if (data
->methods
== NULL
)
939 g_ptr_array_add (data
->methods
, NULL
);
940 ret
= (GDBusMethodInfo
**) g_ptr_array_free (data
->methods
, FALSE
);
942 data
->methods
= g_ptr_array_new ();
946 static GDBusSignalInfo
**
947 parse_data_steal_signals (ParseData
*data
,
948 guint
*out_num_elements
)
950 GDBusSignalInfo
**ret
;
951 if (out_num_elements
!= NULL
)
952 *out_num_elements
= data
->signals
->len
;
953 if (data
->signals
== NULL
)
957 g_ptr_array_add (data
->signals
, NULL
);
958 ret
= (GDBusSignalInfo
**) g_ptr_array_free (data
->signals
, FALSE
);
960 data
->signals
= g_ptr_array_new ();
964 static GDBusPropertyInfo
**
965 parse_data_steal_properties (ParseData
*data
,
966 guint
*out_num_elements
)
968 GDBusPropertyInfo
**ret
;
969 if (out_num_elements
!= NULL
)
970 *out_num_elements
= data
->properties
->len
;
971 if (data
->properties
== NULL
)
975 g_ptr_array_add (data
->properties
, NULL
);
976 ret
= (GDBusPropertyInfo
**) g_ptr_array_free (data
->properties
, FALSE
);
978 data
->properties
= g_ptr_array_new ();
982 static GDBusInterfaceInfo
**
983 parse_data_steal_interfaces (ParseData
*data
,
984 guint
*out_num_elements
)
986 GDBusInterfaceInfo
**ret
;
987 if (out_num_elements
!= NULL
)
988 *out_num_elements
= data
->interfaces
->len
;
989 if (data
->interfaces
== NULL
)
993 g_ptr_array_add (data
->interfaces
, NULL
);
994 ret
= (GDBusInterfaceInfo
**) g_ptr_array_free (data
->interfaces
, FALSE
);
996 data
->interfaces
= g_ptr_array_new ();
1000 static GDBusNodeInfo
**
1001 parse_data_steal_nodes (ParseData
*data
,
1002 guint
*out_num_elements
)
1004 GDBusNodeInfo
**ret
;
1005 if (out_num_elements
!= NULL
)
1006 *out_num_elements
= data
->nodes
->len
;
1007 if (data
->nodes
== NULL
)
1011 g_ptr_array_add (data
->nodes
, NULL
);
1012 ret
= (GDBusNodeInfo
**) g_ptr_array_free (data
->nodes
, FALSE
);
1014 data
->nodes
= g_ptr_array_new ();
1018 /* ---------------------------------------------------------------------------------------------------- */
1021 parse_data_free_annotations (ParseData
*data
)
1023 if (data
->annotations
== NULL
)
1025 g_ptr_array_foreach (data
->annotations
, (GFunc
) g_dbus_annotation_info_unref
, NULL
);
1026 g_ptr_array_free (data
->annotations
, TRUE
);
1027 data
->annotations
= NULL
;
1031 parse_data_free_args (ParseData
*data
)
1033 if (data
->args
== NULL
)
1035 g_ptr_array_foreach (data
->args
, (GFunc
) g_dbus_arg_info_unref
, NULL
);
1036 g_ptr_array_free (data
->args
, TRUE
);
1041 parse_data_free_out_args (ParseData
*data
)
1043 if (data
->out_args
== NULL
)
1045 g_ptr_array_foreach (data
->out_args
, (GFunc
) g_dbus_arg_info_unref
, NULL
);
1046 g_ptr_array_free (data
->out_args
, TRUE
);
1047 data
->out_args
= NULL
;
1051 parse_data_free_methods (ParseData
*data
)
1053 if (data
->methods
== NULL
)
1055 g_ptr_array_foreach (data
->methods
, (GFunc
) g_dbus_method_info_unref
, NULL
);
1056 g_ptr_array_free (data
->methods
, TRUE
);
1057 data
->methods
= NULL
;
1061 parse_data_free_signals (ParseData
*data
)
1063 if (data
->signals
== NULL
)
1065 g_ptr_array_foreach (data
->signals
, (GFunc
) g_dbus_signal_info_unref
, NULL
);
1066 g_ptr_array_free (data
->signals
, TRUE
);
1067 data
->signals
= NULL
;
1071 parse_data_free_properties (ParseData
*data
)
1073 if (data
->properties
== NULL
)
1075 g_ptr_array_foreach (data
->properties
, (GFunc
) g_dbus_property_info_unref
, NULL
);
1076 g_ptr_array_free (data
->properties
, TRUE
);
1077 data
->properties
= NULL
;
1081 parse_data_free_interfaces (ParseData
*data
)
1083 if (data
->interfaces
== NULL
)
1085 g_ptr_array_foreach (data
->interfaces
, (GFunc
) g_dbus_interface_info_unref
, NULL
);
1086 g_ptr_array_free (data
->interfaces
, TRUE
);
1087 data
->interfaces
= NULL
;
1091 parse_data_free_nodes (ParseData
*data
)
1093 if (data
->nodes
== NULL
)
1095 g_ptr_array_foreach (data
->nodes
, (GFunc
) g_dbus_node_info_unref
, NULL
);
1096 g_ptr_array_free (data
->nodes
, TRUE
);
1100 /* ---------------------------------------------------------------------------------------------------- */
1102 static GDBusAnnotationInfo
*
1103 parse_data_get_annotation (ParseData
*data
,
1104 gboolean create_new
)
1107 g_ptr_array_add (data
->annotations
, g_new0 (GDBusAnnotationInfo
, 1));
1108 return data
->annotations
->pdata
[data
->annotations
->len
- 1];
1111 static GDBusArgInfo
*
1112 parse_data_get_arg (ParseData
*data
,
1113 gboolean create_new
)
1116 g_ptr_array_add (data
->args
, g_new0 (GDBusArgInfo
, 1));
1117 return data
->args
->pdata
[data
->args
->len
- 1];
1120 static GDBusArgInfo
*
1121 parse_data_get_out_arg (ParseData
*data
,
1122 gboolean create_new
)
1125 g_ptr_array_add (data
->out_args
, g_new0 (GDBusArgInfo
, 1));
1126 return data
->out_args
->pdata
[data
->out_args
->len
- 1];
1129 static GDBusMethodInfo
*
1130 parse_data_get_method (ParseData
*data
,
1131 gboolean create_new
)
1134 g_ptr_array_add (data
->methods
, g_new0 (GDBusMethodInfo
, 1));
1135 return data
->methods
->pdata
[data
->methods
->len
- 1];
1138 static GDBusSignalInfo
*
1139 parse_data_get_signal (ParseData
*data
,
1140 gboolean create_new
)
1143 g_ptr_array_add (data
->signals
, g_new0 (GDBusSignalInfo
, 1));
1144 return data
->signals
->pdata
[data
->signals
->len
- 1];
1147 static GDBusPropertyInfo
*
1148 parse_data_get_property (ParseData
*data
,
1149 gboolean create_new
)
1152 g_ptr_array_add (data
->properties
, g_new0 (GDBusPropertyInfo
, 1));
1153 return data
->properties
->pdata
[data
->properties
->len
- 1];
1156 static GDBusInterfaceInfo
*
1157 parse_data_get_interface (ParseData
*data
,
1158 gboolean create_new
)
1161 g_ptr_array_add (data
->interfaces
, g_new0 (GDBusInterfaceInfo
, 1));
1162 return data
->interfaces
->pdata
[data
->interfaces
->len
- 1];
1165 static GDBusNodeInfo
*
1166 parse_data_get_node (ParseData
*data
,
1167 gboolean create_new
)
1170 g_ptr_array_add (data
->nodes
, g_new0 (GDBusNodeInfo
, 1));
1171 return data
->nodes
->pdata
[data
->nodes
->len
- 1];
1174 /* ---------------------------------------------------------------------------------------------------- */
1177 parse_data_new (void)
1181 data
= g_new0 (ParseData
, 1);
1183 /* initialize arrays */
1184 parse_data_steal_annotations (data
, NULL
);
1185 parse_data_steal_args (data
, NULL
);
1186 parse_data_steal_out_args (data
, NULL
);
1187 parse_data_steal_methods (data
, NULL
);
1188 parse_data_steal_signals (data
, NULL
);
1189 parse_data_steal_properties (data
, NULL
);
1190 parse_data_steal_interfaces (data
, NULL
);
1191 parse_data_steal_nodes (data
, NULL
);
1197 parse_data_free (ParseData
*data
)
1201 /* free stack of annotation arrays */
1202 for (l
= data
->annotations_stack
; l
!= NULL
; l
= l
->next
)
1204 GPtrArray
*annotations
= l
->data
;
1205 g_ptr_array_foreach (annotations
, (GFunc
) g_dbus_annotation_info_unref
, NULL
);
1206 g_ptr_array_free (annotations
, TRUE
);
1208 g_slist_free (data
->annotations_stack
);
1210 /* free stack of interface arrays */
1211 for (l
= data
->interfaces_stack
; l
!= NULL
; l
= l
->next
)
1213 GPtrArray
*interfaces
= l
->data
;
1214 g_ptr_array_foreach (interfaces
, (GFunc
) g_dbus_interface_info_unref
, NULL
);
1215 g_ptr_array_free (interfaces
, TRUE
);
1217 g_slist_free (data
->interfaces_stack
);
1219 /* free stack of node arrays */
1220 for (l
= data
->nodes_stack
; l
!= NULL
; l
= l
->next
)
1222 GPtrArray
*nodes
= l
->data
;
1223 g_ptr_array_foreach (nodes
, (GFunc
) g_dbus_node_info_unref
, NULL
);
1224 g_ptr_array_free (nodes
, TRUE
);
1226 g_slist_free (data
->nodes_stack
);
1228 /* free arrays (data->annotations, data->interfaces and data->nodes have been freed above) */
1229 parse_data_free_args (data
);
1230 parse_data_free_out_args (data
);
1231 parse_data_free_methods (data
);
1232 parse_data_free_signals (data
);
1233 parse_data_free_properties (data
);
1234 parse_data_free_interfaces (data
);
1235 parse_data_free_annotations (data
);
1236 parse_data_free_nodes (data
);
1241 /* ---------------------------------------------------------------------------------------------------- */
1244 parser_start_element (GMarkupParseContext
*context
,
1245 const gchar
*element_name
,
1246 const gchar
**attribute_names
,
1247 const gchar
**attribute_values
,
1251 ParseData
*data
= user_data
;
1255 const gchar
*access
;
1256 const gchar
*direction
;
1265 stack
= (GSList
*) g_markup_parse_context_get_element_stack (context
);
1267 /* ---------------------------------------------------------------------------------------------------- */
1268 if (strcmp (element_name
, "node") == 0)
1270 if (!(g_slist_length (stack
) >= 1 || strcmp (stack
->next
->data
, "node") != 0))
1272 g_set_error_literal (error
,
1274 G_MARKUP_ERROR_INVALID_CONTENT
,
1275 "<node> elements can only be top-level or embedded in other <node> elements");
1279 if (!g_markup_collect_attributes (element_name
,
1283 G_MARKUP_COLLECT_STRING
| G_MARKUP_COLLECT_OPTIONAL
, "name", &name
,
1284 /* some hand-written introspection XML documents use this */
1285 G_MARKUP_COLLECT_STRING
| G_MARKUP_COLLECT_OPTIONAL
, "xmlns:doc", NULL
,
1286 G_MARKUP_COLLECT_INVALID
))
1289 g_dbus_node_info_set (data
,
1290 parse_data_get_node (data
, TRUE
),
1296 /* push the currently retrieved interfaces and nodes on the stack and prepare new arrays */
1297 data
->interfaces_stack
= g_slist_prepend (data
->interfaces_stack
, data
->interfaces
);
1298 data
->interfaces
= NULL
;
1299 parse_data_steal_interfaces (data
, NULL
);
1301 data
->nodes_stack
= g_slist_prepend (data
->nodes_stack
, data
->nodes
);
1303 parse_data_steal_nodes (data
, NULL
);
1306 /* ---------------------------------------------------------------------------------------------------- */
1307 else if (strcmp (element_name
, "interface") == 0)
1309 if (g_slist_length (stack
) < 2 || strcmp (stack
->next
->data
, "node") != 0)
1311 g_set_error_literal (error
,
1313 G_MARKUP_ERROR_INVALID_CONTENT
,
1314 "<interface> elements can only be embedded in <node> elements");
1318 if (!g_markup_collect_attributes (element_name
,
1322 G_MARKUP_COLLECT_STRING
, "name", &name
,
1323 /* seen in the wild */
1324 G_MARKUP_COLLECT_STRING
| G_MARKUP_COLLECT_OPTIONAL
, "version", NULL
,
1325 G_MARKUP_COLLECT_INVALID
))
1328 g_dbus_interface_info_set (data
,
1329 parse_data_get_interface (data
, TRUE
),
1337 /* ---------------------------------------------------------------------------------------------------- */
1338 else if (strcmp (element_name
, "method") == 0)
1340 if (g_slist_length (stack
) < 2 || strcmp (stack
->next
->data
, "interface") != 0)
1342 g_set_error_literal (error
,
1344 G_MARKUP_ERROR_INVALID_CONTENT
,
1345 "<method> elements can only be embedded in <interface> elements");
1349 if (!g_markup_collect_attributes (element_name
,
1353 G_MARKUP_COLLECT_STRING
, "name", &name
,
1354 /* seen in the wild */
1355 G_MARKUP_COLLECT_STRING
| G_MARKUP_COLLECT_OPTIONAL
, "version", NULL
,
1356 G_MARKUP_COLLECT_INVALID
))
1359 g_dbus_method_info_set (data
,
1360 parse_data_get_method (data
, TRUE
),
1369 /* ---------------------------------------------------------------------------------------------------- */
1370 else if (strcmp (element_name
, "signal") == 0)
1372 if (g_slist_length (stack
) < 2 || strcmp (stack
->next
->data
, "interface") != 0)
1374 g_set_error_literal (error
,
1376 G_MARKUP_ERROR_INVALID_CONTENT
,
1377 "<signal> elements can only be embedded in <interface> elements");
1381 if (!g_markup_collect_attributes (element_name
,
1385 G_MARKUP_COLLECT_STRING
, "name", &name
,
1386 G_MARKUP_COLLECT_INVALID
))
1389 g_dbus_signal_info_set (data
,
1390 parse_data_get_signal (data
, TRUE
),
1398 /* ---------------------------------------------------------------------------------------------------- */
1399 else if (strcmp (element_name
, "property") == 0)
1401 GDBusPropertyInfoFlags flags
;
1403 if (g_slist_length (stack
) < 2 || strcmp (stack
->next
->data
, "interface") != 0)
1405 g_set_error_literal (error
,
1407 G_MARKUP_ERROR_INVALID_CONTENT
,
1408 "<property> elements can only be embedded in <interface> elements");
1412 if (!g_markup_collect_attributes (element_name
,
1416 G_MARKUP_COLLECT_STRING
, "name", &name
,
1417 G_MARKUP_COLLECT_STRING
, "type", &type
,
1418 G_MARKUP_COLLECT_STRING
, "access", &access
,
1419 G_MARKUP_COLLECT_INVALID
))
1422 if (strcmp (access
, "read") == 0)
1423 flags
= G_DBUS_PROPERTY_INFO_FLAGS_READABLE
;
1424 else if (strcmp (access
, "write") == 0)
1425 flags
= G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE
;
1426 else if (strcmp (access
, "readwrite") == 0)
1427 flags
= G_DBUS_PROPERTY_INFO_FLAGS_READABLE
| G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE
;
1432 G_MARKUP_ERROR_INVALID_CONTENT
,
1433 "Unknown value '%s' of access attribute for element <property>",
1438 g_dbus_property_info_set (data
,
1439 parse_data_get_property (data
, TRUE
),
1446 /* ---------------------------------------------------------------------------------------------------- */
1447 else if (strcmp (element_name
, "arg") == 0)
1452 if (g_slist_length (stack
) < 2 ||
1453 (strcmp (stack
->next
->data
, "method") != 0 &&
1454 strcmp (stack
->next
->data
, "signal") != 0))
1456 g_set_error_literal (error
,
1458 G_MARKUP_ERROR_INVALID_CONTENT
,
1459 "<arg> elements can only be embedded in <method> or <signal> elements");
1463 if (!g_markup_collect_attributes (element_name
,
1467 G_MARKUP_COLLECT_STRING
| G_MARKUP_COLLECT_OPTIONAL
, "name", &name
,
1468 G_MARKUP_COLLECT_STRING
| G_MARKUP_COLLECT_OPTIONAL
, "direction", &direction
,
1469 G_MARKUP_COLLECT_STRING
, "type", &type
,
1470 G_MARKUP_COLLECT_INVALID
))
1473 if (strcmp (stack
->next
->data
, "method") == 0)
1477 if (direction
!= NULL
)
1479 if (strcmp (direction
, "in") == 0)
1481 else if (strcmp (direction
, "out") == 0)
1487 G_MARKUP_ERROR_INVALID_CONTENT
,
1488 "Unknown value '%s' of direction attribute",
1494 if (is_in
&& strcmp (stack
->next
->data
, "signal") == 0)
1496 g_set_error_literal (error
,
1498 G_MARKUP_ERROR_INVALID_CONTENT
,
1499 "Only direction 'out' is allowed for <arg> elements embedded in <signal>");
1504 name_to_use
= g_strdup_printf ("arg_%d", data
->num_args
);
1506 name_to_use
= g_strdup (name
);
1511 g_dbus_arg_info_set (data
,
1512 parse_data_get_arg (data
, TRUE
),
1516 data
->last_arg_was_in
= TRUE
;
1520 g_dbus_arg_info_set (data
,
1521 parse_data_get_out_arg (data
, TRUE
),
1525 data
->last_arg_was_in
= FALSE
;
1529 g_free (name_to_use
);
1531 /* ---------------------------------------------------------------------------------------------------- */
1532 else if (strcmp (element_name
, "annotation") == 0)
1534 if (g_slist_length (stack
) < 2 ||
1535 (strcmp (stack
->next
->data
, "node") != 0 &&
1536 strcmp (stack
->next
->data
, "interface") != 0 &&
1537 strcmp (stack
->next
->data
, "signal") != 0 &&
1538 strcmp (stack
->next
->data
, "method") != 0 &&
1539 strcmp (stack
->next
->data
, "property") != 0 &&
1540 strcmp (stack
->next
->data
, "arg") != 0 &&
1541 strcmp (stack
->next
->data
, "annotation") != 0))
1543 g_set_error_literal (error
,
1545 G_MARKUP_ERROR_INVALID_CONTENT
,
1546 "<annotation> elements can only be embedded in <node>, <interface>, <signal>, <method>, <property>, <arg> or <annotation> elements");
1550 if (!g_markup_collect_attributes (element_name
,
1554 G_MARKUP_COLLECT_STRING
, "name", &name
,
1555 G_MARKUP_COLLECT_STRING
, "value", &value
,
1556 G_MARKUP_COLLECT_INVALID
))
1559 g_dbus_annotation_info_set (data
,
1560 parse_data_get_annotation (data
, TRUE
),
1565 /* ---------------------------------------------------------------------------------------------------- */
1568 /* don't bail on unknown elements; just ignore them */
1570 /* ---------------------------------------------------------------------------------------------------- */
1572 /* push the currently retrieved annotations on the stack and prepare a new one */
1573 data
->annotations_stack
= g_slist_prepend (data
->annotations_stack
, data
->annotations
);
1574 data
->annotations
= NULL
;
1575 parse_data_steal_annotations (data
, NULL
);
1581 /* ---------------------------------------------------------------------------------------------------- */
1583 static GDBusAnnotationInfo
**
1584 steal_annotations (ParseData
*data
)
1586 return parse_data_steal_annotations (data
, NULL
);
1591 parser_end_element (GMarkupParseContext
*context
,
1592 const gchar
*element_name
,
1596 ParseData
*data
= user_data
;
1597 gboolean have_popped_annotations
;
1599 have_popped_annotations
= FALSE
;
1601 if (strcmp (element_name
, "node") == 0)
1604 guint num_interfaces
;
1605 GDBusNodeInfo
**nodes
;
1606 GDBusInterfaceInfo
**interfaces
;
1608 nodes
= parse_data_steal_nodes (data
, &num_nodes
);
1609 interfaces
= parse_data_steal_interfaces (data
, &num_interfaces
);
1611 /* destroy the nodes, interfaces for scope we're exiting and and pop the nodes, interfaces from the
1612 * scope we're reentering
1614 parse_data_free_interfaces (data
);
1615 data
->interfaces
= (GPtrArray
*) data
->interfaces_stack
->data
;
1616 data
->interfaces_stack
= g_slist_remove (data
->interfaces_stack
, data
->interfaces_stack
->data
);
1618 parse_data_free_nodes (data
);
1619 data
->nodes
= (GPtrArray
*) data
->nodes_stack
->data
;
1620 data
->nodes_stack
= g_slist_remove (data
->nodes_stack
, data
->nodes_stack
->data
);
1622 g_dbus_node_info_set (data
,
1623 parse_data_get_node (data
, FALSE
),
1627 steal_annotations (data
));
1630 else if (strcmp (element_name
, "interface") == 0)
1634 guint num_properties
;
1635 GDBusMethodInfo
**methods
;
1636 GDBusSignalInfo
**signals
;
1637 GDBusPropertyInfo
**properties
;
1639 methods
= parse_data_steal_methods (data
, &num_methods
);
1640 signals
= parse_data_steal_signals (data
, &num_signals
);
1641 properties
= parse_data_steal_properties (data
, &num_properties
);
1643 g_dbus_interface_info_set (data
,
1644 parse_data_get_interface (data
, FALSE
),
1649 steal_annotations (data
));
1652 else if (strcmp (element_name
, "method") == 0)
1656 GDBusArgInfo
**in_args
;
1657 GDBusArgInfo
**out_args
;
1659 in_args
= parse_data_steal_args (data
, &in_num_args
);
1660 out_args
= parse_data_steal_out_args (data
, &out_num_args
);
1662 g_dbus_method_info_set (data
,
1663 parse_data_get_method (data
, FALSE
),
1667 steal_annotations (data
));
1669 else if (strcmp (element_name
, "signal") == 0)
1672 GDBusArgInfo
**args
;
1674 args
= parse_data_steal_out_args (data
, &num_args
);
1676 g_dbus_signal_info_set (data
,
1677 parse_data_get_signal (data
, FALSE
),
1680 steal_annotations (data
));
1682 else if (strcmp (element_name
, "property") == 0)
1684 g_dbus_property_info_set (data
,
1685 parse_data_get_property (data
, FALSE
),
1688 G_DBUS_PROPERTY_INFO_FLAGS_NONE
,
1689 steal_annotations (data
));
1691 else if (strcmp (element_name
, "arg") == 0)
1693 g_dbus_arg_info_set (data
,
1694 data
->last_arg_was_in
? parse_data_get_arg (data
, FALSE
) : parse_data_get_out_arg (data
, FALSE
),
1697 steal_annotations (data
));
1699 else if (strcmp (element_name
, "annotation") == 0)
1701 GDBusAnnotationInfo
**embedded_annotations
;
1703 embedded_annotations
= steal_annotations (data
);
1705 /* destroy the annotations for scope we're exiting and and pop the annotations from the scope we're reentering */
1706 parse_data_free_annotations (data
);
1707 data
->annotations
= (GPtrArray
*) data
->annotations_stack
->data
;
1708 data
->annotations_stack
= g_slist_remove (data
->annotations_stack
, data
->annotations_stack
->data
);
1710 have_popped_annotations
= TRUE
;
1712 g_dbus_annotation_info_set (data
,
1713 parse_data_get_annotation (data
, FALSE
),
1716 embedded_annotations
);
1720 /* don't bail on unknown elements; just ignore them */
1723 if (!have_popped_annotations
)
1725 /* destroy the annotations for scope we're exiting and and pop the annotations from the scope we're reentering */
1726 parse_data_free_annotations (data
);
1727 data
->annotations
= (GPtrArray
*) data
->annotations_stack
->data
;
1728 data
->annotations_stack
= g_slist_remove (data
->annotations_stack
, data
->annotations_stack
->data
);
1732 /* ---------------------------------------------------------------------------------------------------- */
1735 parser_error (GMarkupParseContext
*context
,
1742 g_markup_parse_context_get_position (context
, &line_number
, &char_number
);
1744 g_prefix_error (&error
, "%d:%d: ",
1749 /* ---------------------------------------------------------------------------------------------------- */
1752 * g_dbus_node_info_new_for_xml:
1753 * @xml_data: Valid D-Bus introspection XML.
1754 * @error: Return location for error.
1756 * Parses @xml_data and returns a #GDBusNodeInfo representing the data.
1758 * The introspection XML must contain exactly one top-level
1759 * <tag class="starttag">node</tag> element.
1761 * Note that this routine is using a
1762 * <link linkend="glib-Simple-XML-Subset-Parser.description">GMarkup</link>-based
1763 * parser that only accepts a subset of valid XML documents.
1765 * Returns: A #GDBusNodeInfo structure or %NULL if @error is set. Free
1766 * with g_dbus_node_info_unref().
1771 g_dbus_node_info_new_for_xml (const gchar
*xml_data
,
1775 GMarkupParseContext
*context
;
1776 GMarkupParser
*parser
;
1779 GDBusNodeInfo
**ughret
;
1785 parser
= g_new0 (GMarkupParser
, 1);
1786 parser
->start_element
= parser_start_element
;
1787 parser
->end_element
= parser_end_element
;
1788 parser
->error
= parser_error
;
1790 data
= parse_data_new ();
1791 context
= g_markup_parse_context_new (parser
,
1794 (GDestroyNotify
) parse_data_free
);
1796 if (!g_markup_parse_context_parse (context
,
1802 if (!g_markup_parse_context_end_parse (context
, error
))
1805 ughret
= parse_data_steal_nodes (data
, &num_nodes
);
1813 G_MARKUP_ERROR_INVALID_CONTENT
,
1814 "Expected a single node in introspection XML, found %d",
1818 for (n
= 0; n
< num_nodes
; n
++)
1820 g_dbus_node_info_unref (ughret
[n
]);
1831 if (context
!= NULL
)
1832 g_markup_parse_context_free (context
);
1837 /* ---------------------------------------------------------------------------------------------------- */
1840 * g_dbus_annotation_info_lookup:
1841 * @annotations: (array zero-terminated=1) (allow-none): A %NULL-terminated array of annotations or %NULL.
1842 * @name: The name of the annotation to look up.
1844 * Looks up the value of an annotation.
1846 * The cost of this function is O(n) in number of annotations.
1848 * Returns: The value or %NULL if not found. Do not free, it is owned by @annotations.
1853 g_dbus_annotation_info_lookup (GDBusAnnotationInfo
**annotations
,
1860 for (n
= 0; annotations
!= NULL
&& annotations
[n
] != NULL
; n
++)
1862 if (g_strcmp0 (annotations
[n
]->key
, name
) == 0)
1864 ret
= annotations
[n
]->value
;
1873 /* ---------------------------------------------------------------------------------------------------- */
1875 G_LOCK_DEFINE_STATIC (info_cache_lock
);
1881 /* gchar* -> GDBusMethodInfo* */
1882 GHashTable
*method_name_to_data
;
1884 /* gchar* -> GDBusMethodInfo* */
1885 GHashTable
*signal_name_to_data
;
1887 /* gchar* -> GDBusMethodInfo* */
1888 GHashTable
*property_name_to_data
;
1892 info_cache_free (InfoCacheEntry
*cache
)
1894 g_assert (cache
->use_count
== 0);
1895 g_hash_table_unref (cache
->method_name_to_data
);
1896 g_hash_table_unref (cache
->signal_name_to_data
);
1897 g_hash_table_unref (cache
->property_name_to_data
);
1898 g_slice_free (InfoCacheEntry
, cache
);
1901 /* maps from GDBusInterfaceInfo* to InfoCacheEntry* */
1902 static GHashTable
*info_cache
= NULL
;
1904 /* ---------------------------------------------------------------------------------------------------- */
1907 * g_dbus_interface_info_lookup_method:
1908 * @info: A #GDBusInterfaceInfo.
1909 * @name: A D-Bus method name (typically in CamelCase)
1911 * Looks up information about a method.
1913 * The cost of this function is O(n) in number of methods unless
1914 * g_dbus_interface_info_cache_build() has been used on @info.
1916 * Returns: (transfer none): A #GDBusMethodInfo or %NULL if not found. Do not free, it is owned by @info.
1921 g_dbus_interface_info_lookup_method (GDBusInterfaceInfo
*info
,
1925 GDBusMethodInfo
*result
;
1927 G_LOCK (info_cache_lock
);
1928 if (G_LIKELY (info_cache
!= NULL
))
1930 InfoCacheEntry
*cache
;
1931 cache
= g_hash_table_lookup (info_cache
, info
);
1932 if (G_LIKELY (cache
!= NULL
))
1934 result
= g_hash_table_lookup (cache
->method_name_to_data
, name
);
1935 G_UNLOCK (info_cache_lock
);
1939 G_UNLOCK (info_cache_lock
);
1941 for (n
= 0; info
->methods
!= NULL
&& info
->methods
[n
] != NULL
; n
++)
1943 GDBusMethodInfo
*i
= info
->methods
[n
];
1945 if (g_strcmp0 (i
->name
, name
) == 0)
1958 /* ---------------------------------------------------------------------------------------------------- */
1961 * g_dbus_interface_info_lookup_signal:
1962 * @info: A #GDBusInterfaceInfo.
1963 * @name: A D-Bus signal name (typically in CamelCase)
1965 * Looks up information about a signal.
1967 * The cost of this function is O(n) in number of signals unless
1968 * g_dbus_interface_info_cache_build() has been used on @info.
1970 * Returns: (transfer none): A #GDBusSignalInfo or %NULL if not found. Do not free, it is owned by @info.
1975 g_dbus_interface_info_lookup_signal (GDBusInterfaceInfo
*info
,
1979 GDBusSignalInfo
*result
;
1981 G_LOCK (info_cache_lock
);
1982 if (G_LIKELY (info_cache
!= NULL
))
1984 InfoCacheEntry
*cache
;
1985 cache
= g_hash_table_lookup (info_cache
, info
);
1986 if (G_LIKELY (cache
!= NULL
))
1988 result
= g_hash_table_lookup (cache
->signal_name_to_data
, name
);
1989 G_UNLOCK (info_cache_lock
);
1993 G_UNLOCK (info_cache_lock
);
1995 for (n
= 0; info
->signals
!= NULL
&& info
->signals
[n
] != NULL
; n
++)
1997 GDBusSignalInfo
*i
= info
->signals
[n
];
1999 if (g_strcmp0 (i
->name
, name
) == 0)
2012 /* ---------------------------------------------------------------------------------------------------- */
2015 * g_dbus_interface_info_lookup_property:
2016 * @info: A #GDBusInterfaceInfo.
2017 * @name: A D-Bus property name (typically in CamelCase).
2019 * Looks up information about a property.
2021 * The cost of this function is O(n) in number of properties unless
2022 * g_dbus_interface_info_cache_build() has been used on @info.
2024 * Returns: (transfer none): A #GDBusPropertyInfo or %NULL if not found. Do not free, it is owned by @info.
2029 g_dbus_interface_info_lookup_property (GDBusInterfaceInfo
*info
,
2033 GDBusPropertyInfo
*result
;
2035 G_LOCK (info_cache_lock
);
2036 if (G_LIKELY (info_cache
!= NULL
))
2038 InfoCacheEntry
*cache
;
2039 cache
= g_hash_table_lookup (info_cache
, info
);
2040 if (G_LIKELY (cache
!= NULL
))
2042 result
= g_hash_table_lookup (cache
->property_name_to_data
, name
);
2043 G_UNLOCK (info_cache_lock
);
2047 G_UNLOCK (info_cache_lock
);
2049 for (n
= 0; info
->properties
!= NULL
&& info
->properties
[n
] != NULL
; n
++)
2051 GDBusPropertyInfo
*i
= info
->properties
[n
];
2053 if (g_strcmp0 (i
->name
, name
) == 0)
2066 /* ---------------------------------------------------------------------------------------------------- */
2069 * g_dbus_interface_info_cache_build:
2070 * @info: A #GDBusInterfaceInfo.
2072 * Builds a lookup-cache to speed up
2073 * g_dbus_interface_info_lookup_method(),
2074 * g_dbus_interface_info_lookup_signal() and
2075 * g_dbus_interface_info_lookup_property().
2077 * If this has already been called with @info, the existing cache is
2078 * used and its use count is increased.
2080 * Note that @info cannot be modified until
2081 * g_dbus_interface_info_cache_release() is called.
2086 g_dbus_interface_info_cache_build (GDBusInterfaceInfo
*info
)
2088 InfoCacheEntry
*cache
;
2091 G_LOCK (info_cache_lock
);
2092 if (info_cache
== NULL
)
2093 info_cache
= g_hash_table_new_full (g_direct_hash
, g_direct_equal
, NULL
, (GDestroyNotify
) info_cache_free
);
2094 cache
= g_hash_table_lookup (info_cache
, info
);
2097 cache
->use_count
+= 1;
2100 cache
= g_slice_new0 (InfoCacheEntry
);
2101 cache
->use_count
= 1;
2102 cache
->method_name_to_data
= g_hash_table_new (g_str_hash
, g_str_equal
);
2103 cache
->signal_name_to_data
= g_hash_table_new (g_str_hash
, g_str_equal
);
2104 cache
->property_name_to_data
= g_hash_table_new (g_str_hash
, g_str_equal
);
2105 for (n
= 0; info
->methods
!= NULL
&& info
->methods
[n
] != NULL
; n
++)
2106 g_hash_table_insert (cache
->method_name_to_data
, info
->methods
[n
]->name
, info
->methods
[n
]);
2107 for (n
= 0; info
->signals
!= NULL
&& info
->signals
[n
] != NULL
; n
++)
2108 g_hash_table_insert (cache
->signal_name_to_data
, info
->signals
[n
]->name
, info
->signals
[n
]);
2109 for (n
= 0; info
->properties
!= NULL
&& info
->properties
[n
] != NULL
; n
++)
2110 g_hash_table_insert (cache
->property_name_to_data
, info
->properties
[n
]->name
, info
->properties
[n
]);
2111 g_hash_table_insert (info_cache
, info
, cache
);
2113 G_UNLOCK (info_cache_lock
);
2117 * g_dbus_interface_info_cache_release:
2118 * @info: A GDBusInterfaceInfo
2120 * Decrements the usage count for the cache for @info built by
2121 * g_dbus_interface_info_cache_build() (if any) and frees the
2122 * resources used by the cache if the usage count drops to zero.
2127 g_dbus_interface_info_cache_release (GDBusInterfaceInfo
*info
)
2129 InfoCacheEntry
*cache
;
2131 G_LOCK (info_cache_lock
);
2132 if (G_UNLIKELY (info_cache
== NULL
))
2134 g_warning ("%s called for interface %s but there is no cache", info
->name
, G_STRFUNC
);
2138 cache
= g_hash_table_lookup (info_cache
, info
);
2139 if (G_UNLIKELY (cache
== NULL
))
2141 g_warning ("%s called for interface %s but there is no cache entry", info
->name
, G_STRFUNC
);
2144 cache
->use_count
-= 1;
2145 if (cache
->use_count
== 0)
2147 g_hash_table_remove (info_cache
, info
);
2148 /* could nuke info_cache itself if empty */
2151 G_UNLOCK (info_cache_lock
);
2155 /* ---------------------------------------------------------------------------------------------------- */
2158 * g_dbus_node_info_lookup_interface:
2159 * @info: A #GDBusNodeInfo.
2160 * @name: A D-Bus interface name.
2162 * Looks up information about an interface.
2164 * The cost of this function is O(n) in number of interfaces.
2166 * Returns: (transfer none): A #GDBusInterfaceInfo or %NULL if not found. Do not free, it is owned by @info.
2170 GDBusInterfaceInfo
*
2171 g_dbus_node_info_lookup_interface (GDBusNodeInfo
*info
,
2175 GDBusInterfaceInfo
*result
;
2177 for (n
= 0; info
->interfaces
!= NULL
&& info
->interfaces
[n
] != NULL
; n
++)
2179 GDBusInterfaceInfo
*i
= info
->interfaces
[n
];
2181 if (g_strcmp0 (i
->name
, name
) == 0)