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, see <http://www.gnu.org/licenses/>.
18 * Author: David Zeuthen <davidz@redhat.com>
29 #include "gdbusaddress.h"
30 #include "gdbusutils.h"
31 #include "gdbusconnection.h"
32 #include "gdbusserver.h"
33 #include "gioenumtypes.h"
34 #include "gdbusprivate.h"
35 #include "gdbusauthobserver.h"
36 #include "ginitable.h"
37 #include "gsocketservice.h"
38 #include "gthreadedsocketservice.h"
39 #include "gresolver.h"
40 #include "glib/gstdio.h"
41 #include "ginetaddress.h"
42 #include "ginetsocketaddress.h"
43 #include "ginputstream.h"
44 #include "giostream.h"
54 #include "gunixsocketaddress.h"
61 * @short_description: Helper for accepting connections
64 * #GDBusServer is a helper for listening to and accepting D-Bus
65 * connections. This can be used to create a new D-Bus server, allowing two
66 * peers to use the D-Bus protocol for their own specialized communication.
67 * A server instance provided in this way will not perform message routing or
68 * implement the org.freedesktop.DBus interface.
70 * To just export an object on a well-known name on a message bus, such as the
71 * session or system bus, you should instead use g_bus_own_name().
73 * An example of peer-to-peer communication with G-DBus can be found
74 * in [gdbus-example-peer.c](https://git.gnome.org/browse/glib/tree/gio/tests/gdbus-example-peer.c).
80 * The #GDBusServer structure contains only private data and
81 * should only be accessed using the provided API.
88 GObject parent_instance;
90 GDBusServerFlags flags;
97 gchar *client_address;
99 GSocketListener *listener;
100 gboolean is_using_listener;
101 gulong run_signal_handler_id;
103 /* The result of g_main_context_ref_thread_default() when the object
104 * was created (the GObject _init() function) - this is used for delivery
105 * of the :new-connection GObject signal.
107 GMainContext *main_context_at_construction;
111 GDBusAuthObserver *authentication_observer;
114 typedef struct _GDBusServerClass GDBusServerClass;
118 * @new_connection: Signal class handler for the #GDBusServer::new-connection signal.
120 * Class structure for #GDBusServer.
124 struct _GDBusServerClass
127 GObjectClass parent_class;
131 gboolean (*new_connection) (GDBusServer *server,
132 GDBusConnection *connection);
143 PROP_AUTHENTICATION_OBSERVER,
148 NEW_CONNECTION_SIGNAL,
152 static guint _signals[LAST_SIGNAL] = {0};
154 static void initable_iface_init (GInitableIface *initable_iface);
156 G_DEFINE_TYPE_WITH_CODE (GDBusServer, g_dbus_server, G_TYPE_OBJECT,
157 G_IMPLEMENT_INTERFACE (G_TYPE_INITABLE, initable_iface_init)
161 g_dbus_server_finalize (GObject *object)
163 GDBusServer *server = G_DBUS_SERVER (object);
165 if (server->authentication_observer != NULL)
166 g_object_unref (server->authentication_observer);
168 if (server->run_signal_handler_id > 0)
169 g_signal_handler_disconnect (server->listener, server->run_signal_handler_id);
171 if (server->listener != NULL)
172 g_object_unref (server->listener);
174 g_free (server->address);
175 g_free (server->guid);
176 g_free (server->client_address);
177 if (server->nonce != NULL)
179 memset (server->nonce, '\0', 16);
180 g_free (server->nonce);
182 /* we could unlink the nonce file but I don't
183 * think it's really worth the effort/risk
185 g_free (server->nonce_file);
187 g_main_context_unref (server->main_context_at_construction);
189 G_OBJECT_CLASS (g_dbus_server_parent_class)->finalize (object);
193 g_dbus_server_get_property (GObject *object,
198 GDBusServer *server = G_DBUS_SERVER (object);
203 g_value_set_flags (value, server->flags);
207 g_value_set_string (value, server->guid);
211 g_value_set_string (value, server->address);
214 case PROP_CLIENT_ADDRESS:
215 g_value_set_string (value, server->client_address);
219 g_value_set_boolean (value, server->active);
222 case PROP_AUTHENTICATION_OBSERVER:
223 g_value_set_object (value, server->authentication_observer);
227 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
233 g_dbus_server_set_property (GObject *object,
238 GDBusServer *server = G_DBUS_SERVER (object);
243 server->flags = g_value_get_flags (value);
247 server->guid = g_value_dup_string (value);
251 server->address = g_value_dup_string (value);
254 case PROP_AUTHENTICATION_OBSERVER:
255 server->authentication_observer = g_value_dup_object (value);
259 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
265 g_dbus_server_class_init (GDBusServerClass *klass)
267 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
269 gobject_class->finalize = g_dbus_server_finalize;
270 gobject_class->set_property = g_dbus_server_set_property;
271 gobject_class->get_property = g_dbus_server_get_property;
276 * Flags from the #GDBusServerFlags enumeration.
280 g_object_class_install_property (gobject_class,
282 g_param_spec_flags ("flags",
284 P_("Flags for the server"),
285 G_TYPE_DBUS_SERVER_FLAGS,
286 G_DBUS_SERVER_FLAGS_NONE,
289 G_PARAM_CONSTRUCT_ONLY |
290 G_PARAM_STATIC_NAME |
291 G_PARAM_STATIC_BLURB |
292 G_PARAM_STATIC_NICK));
297 * The guid of the server.
301 g_object_class_install_property (gobject_class,
303 g_param_spec_string ("guid",
305 P_("The guid of the server"),
309 G_PARAM_CONSTRUCT_ONLY |
310 G_PARAM_STATIC_NAME |
311 G_PARAM_STATIC_BLURB |
312 G_PARAM_STATIC_NICK));
315 * GDBusServer:address:
317 * The D-Bus address to listen on.
321 g_object_class_install_property (gobject_class,
323 g_param_spec_string ("address",
325 P_("The address to listen on"),
329 G_PARAM_CONSTRUCT_ONLY |
330 G_PARAM_STATIC_NAME |
331 G_PARAM_STATIC_BLURB |
332 G_PARAM_STATIC_NICK));
335 * GDBusServer:client-address:
337 * The D-Bus address that clients can use.
341 g_object_class_install_property (gobject_class,
343 g_param_spec_string ("client-address",
344 P_("Client Address"),
345 P_("The address clients can use"),
348 G_PARAM_STATIC_NAME |
349 G_PARAM_STATIC_BLURB |
350 G_PARAM_STATIC_NICK));
353 * GDBusServer:active:
355 * Whether the server is currently active.
359 g_object_class_install_property (gobject_class,
361 g_param_spec_boolean ("active",
363 P_("Whether the server is currently active"),
366 G_PARAM_STATIC_NAME |
367 G_PARAM_STATIC_BLURB |
368 G_PARAM_STATIC_NICK));
371 * GDBusServer:authentication-observer:
373 * A #GDBusAuthObserver object to assist in the authentication process or %NULL.
377 g_object_class_install_property (gobject_class,
378 PROP_AUTHENTICATION_OBSERVER,
379 g_param_spec_object ("authentication-observer",
380 P_("Authentication Observer"),
381 P_("Object used to assist in the authentication process"),
382 G_TYPE_DBUS_AUTH_OBSERVER,
385 G_PARAM_CONSTRUCT_ONLY |
386 G_PARAM_STATIC_NAME |
387 G_PARAM_STATIC_BLURB |
388 G_PARAM_STATIC_NICK));
391 * GDBusServer::new-connection:
392 * @server: The #GDBusServer emitting the signal.
393 * @connection: A #GDBusConnection for the new connection.
395 * Emitted when a new authenticated connection has been made. Use
396 * g_dbus_connection_get_peer_credentials() to figure out what
397 * identity (if any), was authenticated.
399 * If you want to accept the connection, take a reference to the
400 * @connection object and return %TRUE. When you are done with the
401 * connection call g_dbus_connection_close() and give up your
402 * reference. Note that the other peer may disconnect at any time -
403 * a typical thing to do when accepting a connection is to listen to
404 * the #GDBusConnection::closed signal.
406 * If #GDBusServer:flags contains %G_DBUS_SERVER_FLAGS_RUN_IN_THREAD
407 * then the signal is emitted in a new thread dedicated to the
408 * connection. Otherwise the signal is emitted in the
409 * [thread-default main context][g-main-context-push-thread-default]
410 * of the thread that @server was constructed in.
412 * You are guaranteed that signal handlers for this signal runs
413 * before incoming messages on @connection are processed. This means
414 * that it's suitable to call g_dbus_connection_register_object() or
415 * similar from the signal handler.
417 * Returns: %TRUE to claim @connection, %FALSE to let other handlers
422 _signals[NEW_CONNECTION_SIGNAL] = g_signal_new (I_("new-connection"),
425 G_STRUCT_OFFSET (GDBusServerClass, new_connection),
426 g_signal_accumulator_true_handled,
427 NULL, /* accu_data */
431 G_TYPE_DBUS_CONNECTION);
435 g_dbus_server_init (GDBusServer *server)
437 server->main_context_at_construction = g_main_context_ref_thread_default ();
441 on_run (GSocketService *service,
442 GSocketConnection *socket_connection,
443 GObject *source_object,
447 * g_dbus_server_new_sync:
448 * @address: A D-Bus address.
449 * @flags: Flags from the #GDBusServerFlags enumeration.
450 * @guid: A D-Bus GUID.
451 * @observer: (nullable): A #GDBusAuthObserver or %NULL.
452 * @cancellable: (nullable): A #GCancellable or %NULL.
453 * @error: Return location for server or %NULL.
455 * Creates a new D-Bus server that listens on the first address in
456 * @address that works.
458 * Once constructed, you can use g_dbus_server_get_client_address() to
459 * get a D-Bus address string that clients can use to connect.
461 * Connect to the #GDBusServer::new-connection signal to handle
462 * incoming connections.
464 * The returned #GDBusServer isn't active - you have to start it with
465 * g_dbus_server_start().
467 * #GDBusServer is used in this [example][gdbus-peer-to-peer].
469 * This is a synchronous failable constructor. See
470 * g_dbus_server_new() for the asynchronous version.
472 * Returns: A #GDBusServer or %NULL if @error is set. Free with
478 g_dbus_server_new_sync (const gchar *address,
479 GDBusServerFlags flags,
481 GDBusAuthObserver *observer,
482 GCancellable *cancellable,
487 g_return_val_if_fail (address != NULL, NULL);
488 g_return_val_if_fail (g_dbus_is_guid (guid), NULL);
489 g_return_val_if_fail (error == NULL || *error == NULL, NULL);
491 server = g_initable_new (G_TYPE_DBUS_SERVER,
497 "authentication-observer", observer,
504 * g_dbus_server_get_client_address:
505 * @server: A #GDBusServer.
508 * [D-Bus address](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses)
509 * string that can be used by clients to connect to @server.
511 * Returns: A D-Bus address string. Do not free, the string is owned
517 g_dbus_server_get_client_address (GDBusServer *server)
519 g_return_val_if_fail (G_IS_DBUS_SERVER (server), NULL);
520 return server->client_address;
524 * g_dbus_server_get_guid:
525 * @server: A #GDBusServer.
527 * Gets the GUID for @server.
529 * Returns: A D-Bus GUID. Do not free this string, it is owned by @server.
534 g_dbus_server_get_guid (GDBusServer *server)
536 g_return_val_if_fail (G_IS_DBUS_SERVER (server), NULL);
541 * g_dbus_server_get_flags:
542 * @server: A #GDBusServer.
544 * Gets the flags for @server.
546 * Returns: A set of flags from the #GDBusServerFlags enumeration.
551 g_dbus_server_get_flags (GDBusServer *server)
553 g_return_val_if_fail (G_IS_DBUS_SERVER (server), G_DBUS_SERVER_FLAGS_NONE);
554 return server->flags;
558 * g_dbus_server_is_active:
559 * @server: A #GDBusServer.
561 * Gets whether @server is active.
563 * Returns: %TRUE if server is active, %FALSE otherwise.
568 g_dbus_server_is_active (GDBusServer *server)
570 g_return_val_if_fail (G_IS_DBUS_SERVER (server), G_DBUS_SERVER_FLAGS_NONE);
571 return server->active;
575 * g_dbus_server_start:
576 * @server: A #GDBusServer.
583 g_dbus_server_start (GDBusServer *server)
585 g_return_if_fail (G_IS_DBUS_SERVER (server));
588 /* Right now we don't have any transport not using the listener... */
589 g_assert (server->is_using_listener);
590 g_socket_service_start (G_SOCKET_SERVICE (server->listener));
591 server->active = TRUE;
592 g_object_notify (G_OBJECT (server), "active");
596 * g_dbus_server_stop:
597 * @server: A #GDBusServer.
604 g_dbus_server_stop (GDBusServer *server)
606 g_return_if_fail (G_IS_DBUS_SERVER (server));
609 /* Right now we don't have any transport not using the listener... */
610 g_assert (server->is_using_listener);
611 g_assert (server->run_signal_handler_id > 0);
612 g_signal_handler_disconnect (server->listener, server->run_signal_handler_id);
613 server->run_signal_handler_id = 0;
614 g_socket_service_stop (G_SOCKET_SERVICE (server->listener));
615 server->active = FALSE;
616 g_object_notify (G_OBJECT (server), "active");
619 /* ---------------------------------------------------------------------------------------------------- */
627 ret = g_random_int_range (0, 60);
637 /* note that address_entry has already been validated => exactly one of path, tmpdir or abstract keys are set */
639 try_unix (GDBusServer *server,
640 const gchar *address_entry,
641 GHashTable *key_value_pairs,
647 const gchar *abstract;
648 GSocketAddress *address;
653 path = g_hash_table_lookup (key_value_pairs, "path");
654 tmpdir = g_hash_table_lookup (key_value_pairs, "tmpdir");
655 abstract = g_hash_table_lookup (key_value_pairs, "abstract");
659 address = g_unix_socket_address_new (path);
661 else if (tmpdir != NULL)
668 s = g_string_new (tmpdir);
669 g_string_append (s, "/dbus-");
670 for (n = 0; n < 8; n++)
671 g_string_append_c (s, random_ascii ());
673 /* prefer abstract namespace if available */
674 if (g_unix_socket_address_abstract_names_supported ())
675 address = g_unix_socket_address_new_with_type (s->str,
677 G_UNIX_SOCKET_ADDRESS_ABSTRACT);
679 address = g_unix_socket_address_new (s->str);
680 g_string_free (s, TRUE);
683 if (!g_socket_listener_add_address (server->listener,
685 G_SOCKET_TYPE_STREAM,
686 G_SOCKET_PROTOCOL_DEFAULT,
687 NULL, /* source_object */
688 NULL, /* effective_address */
691 if (local_error->domain == G_IO_ERROR && local_error->code == G_IO_ERROR_ADDRESS_IN_USE)
693 g_error_free (local_error);
696 g_propagate_error (error, local_error);
702 else if (abstract != NULL)
704 if (!g_unix_socket_address_abstract_names_supported ())
706 g_set_error_literal (error,
708 G_IO_ERROR_NOT_SUPPORTED,
709 _("Abstract name space not supported"));
712 address = g_unix_socket_address_new_with_type (abstract,
714 G_UNIX_SOCKET_ADDRESS_ABSTRACT);
718 g_assert_not_reached ();
721 if (!g_socket_listener_add_address (server->listener,
723 G_SOCKET_TYPE_STREAM,
724 G_SOCKET_PROTOCOL_DEFAULT,
725 NULL, /* source_object */
726 NULL, /* effective_address */
736 /* Fill out client_address if the connection attempt worked */
739 server->is_using_listener = TRUE;
741 switch (g_unix_socket_address_get_address_type (G_UNIX_SOCKET_ADDRESS (address)))
743 case G_UNIX_SOCKET_ADDRESS_ABSTRACT:
744 server->client_address = g_strdup_printf ("unix:abstract=%s",
745 g_unix_socket_address_get_path (G_UNIX_SOCKET_ADDRESS (address)));
748 case G_UNIX_SOCKET_ADDRESS_PATH:
749 server->client_address = g_strdup_printf ("unix:path=%s",
750 g_unix_socket_address_get_path (G_UNIX_SOCKET_ADDRESS (address)));
754 g_assert_not_reached ();
758 g_object_unref (address);
764 /* ---------------------------------------------------------------------------------------------------- */
766 /* note that address_entry has already been validated =>
767 * both host and port (guaranteed to be a number in [0, 65535]) are set (family is optional)
770 try_tcp (GDBusServer *server,
771 const gchar *address_entry,
772 GHashTable *key_value_pairs,
781 GList *resolved_addresses;
786 resolved_addresses = NULL;
788 host = g_hash_table_lookup (key_value_pairs, "host");
789 port = g_hash_table_lookup (key_value_pairs, "port");
790 /* family = g_hash_table_lookup (key_value_pairs, "family"); */
791 if (g_hash_table_lookup (key_value_pairs, "noncefile") != NULL)
793 g_set_error_literal (error,
795 G_IO_ERROR_INVALID_ARGUMENT,
796 _("Cannot specify nonce file when creating a server"));
804 port_num = strtol (port, NULL, 10);
806 resolver = g_resolver_get_default ();
807 resolved_addresses = g_resolver_lookup_by_name (resolver,
811 if (resolved_addresses == NULL)
814 /* TODO: handle family */
815 for (l = resolved_addresses; l != NULL; l = l->next)
817 GInetAddress *address = G_INET_ADDRESS (l->data);
818 GSocketAddress *socket_address;
819 GSocketAddress *effective_address;
821 socket_address = g_inet_socket_address_new (address, port_num);
822 if (!g_socket_listener_add_address (server->listener,
824 G_SOCKET_TYPE_STREAM,
825 G_SOCKET_PROTOCOL_TCP,
826 NULL, /* GObject *source_object */
830 g_object_unref (socket_address);
834 /* make sure we allocate the same port number for other listeners */
835 port_num = g_inet_socket_address_get_port (G_INET_SOCKET_ADDRESS (effective_address));
837 g_object_unref (effective_address);
838 g_object_unref (socket_address);
846 gsize bytes_remaining;
849 server->nonce = g_new0 (guchar, 16);
850 for (n = 0; n < 16; n++)
851 server->nonce[n] = g_random_int_range (0, 256);
852 fd = g_file_open_tmp ("gdbus-nonce-file-XXXXXX",
857 g_socket_listener_close (server->listener);
862 bytes_remaining = 16;
863 while (bytes_remaining > 0)
866 ret = write (fd, server->nonce + bytes_written, bytes_remaining);
873 g_io_error_from_errno (errno),
874 _("Error writing nonce file at ā%sā: %s"),
879 bytes_written += ret;
880 bytes_remaining -= ret;
882 if (!g_close (fd, error))
884 file_escaped = g_uri_escape_string (server->nonce_file, "/\\", FALSE);
885 server->client_address = g_strdup_printf ("nonce-tcp:host=%s,port=%d,noncefile=%s",
889 g_free (file_escaped);
893 server->client_address = g_strdup_printf ("tcp:host=%s,port=%d", host, port_num);
895 server->is_using_listener = TRUE;
899 g_list_free_full (resolved_addresses, g_object_unref);
901 g_object_unref (resolver);
905 /* ---------------------------------------------------------------------------------------------------- */
910 GDBusConnection *connection;
914 emit_idle_data_free (EmitIdleData *data)
916 g_object_unref (data->server);
917 g_object_unref (data->connection);
922 emit_new_connection_in_idle (gpointer user_data)
924 EmitIdleData *data = user_data;
928 g_signal_emit (data->server,
929 _signals[NEW_CONNECTION_SIGNAL],
935 g_dbus_connection_start_message_processing (data->connection);
936 g_object_unref (data->connection);
941 /* Called in new thread */
943 on_run (GSocketService *service,
944 GSocketConnection *socket_connection,
945 GObject *source_object,
948 GDBusServer *server = G_DBUS_SERVER (user_data);
949 GDBusConnection *connection;
950 GDBusConnectionFlags connection_flags;
952 if (server->nonce != NULL)
957 if (!g_input_stream_read_all (g_io_stream_get_input_stream (G_IO_STREAM (socket_connection)),
961 NULL, /* GCancellable */
965 if (bytes_read != 16)
968 if (memcmp (buf, server->nonce, 16) != 0)
973 G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER |
974 G_DBUS_CONNECTION_FLAGS_DELAY_MESSAGE_PROCESSING;
975 if (server->flags & G_DBUS_SERVER_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS)
976 connection_flags |= G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS;
978 connection = g_dbus_connection_new_sync (G_IO_STREAM (socket_connection),
981 server->authentication_observer,
982 NULL, /* GCancellable */
984 if (connection == NULL)
987 if (server->flags & G_DBUS_SERVER_FLAGS_RUN_IN_THREAD)
992 g_signal_emit (server,
993 _signals[NEW_CONNECTION_SIGNAL],
998 g_dbus_connection_start_message_processing (connection);
999 g_object_unref (connection);
1003 GSource *idle_source;
1006 data = g_new0 (EmitIdleData, 1);
1007 data->server = g_object_ref (server);
1008 data->connection = g_object_ref (connection);
1010 idle_source = g_idle_source_new ();
1011 g_source_set_priority (idle_source, G_PRIORITY_DEFAULT);
1012 g_source_set_callback (idle_source,
1013 emit_new_connection_in_idle,
1015 (GDestroyNotify) emit_idle_data_free);
1016 g_source_set_name (idle_source, "[gio] emit_new_connection_in_idle");
1017 g_source_attach (idle_source, server->main_context_at_construction);
1018 g_source_unref (idle_source);
1026 initable_init (GInitable *initable,
1027 GCancellable *cancellable,
1030 GDBusServer *server = G_DBUS_SERVER (initable);
1040 if (!g_dbus_is_guid (server->guid))
1042 g_set_error (&last_error,
1044 G_IO_ERROR_INVALID_ARGUMENT,
1045 _("The string ā%sā is not a valid D-Bus GUID"),
1050 server->listener = G_SOCKET_LISTENER (g_threaded_socket_service_new (-1));
1052 addr_array = g_strsplit (server->address, ";", 0);
1054 for (n = 0; addr_array != NULL && addr_array[n] != NULL; n++)
1056 const gchar *address_entry = addr_array[n];
1057 GHashTable *key_value_pairs;
1058 gchar *transport_name;
1062 if (g_dbus_is_supported_address (address_entry,
1064 _g_dbus_address_parse_entry (address_entry,
1074 else if (g_strcmp0 (transport_name, "unix") == 0)
1075 ret = try_unix (server, address_entry, key_value_pairs, &this_error);
1077 else if (g_strcmp0 (transport_name, "tcp") == 0)
1078 ret = try_tcp (server, address_entry, key_value_pairs, FALSE, &this_error);
1079 else if (g_strcmp0 (transport_name, "nonce-tcp") == 0)
1080 ret = try_tcp (server, address_entry, key_value_pairs, TRUE, &this_error);
1082 g_set_error (&this_error,
1084 G_IO_ERROR_INVALID_ARGUMENT,
1085 _("Cannot listen on unsupported transport ā%sā"),
1088 g_free (transport_name);
1089 if (key_value_pairs != NULL)
1090 g_hash_table_unref (key_value_pairs);
1094 g_assert (this_error == NULL);
1099 if (this_error != NULL)
1101 if (last_error != NULL)
1102 g_error_free (last_error);
1103 last_error = this_error;
1109 g_strfreev (addr_array);
1113 if (last_error != NULL)
1114 g_error_free (last_error);
1116 /* Right now we don't have any transport not using the listener... */
1117 g_assert (server->is_using_listener);
1118 server->run_signal_handler_id = g_signal_connect (G_SOCKET_SERVICE (server->listener),
1120 G_CALLBACK (on_run),
1125 g_assert (last_error != NULL);
1126 g_propagate_error (error, last_error);
1133 initable_iface_init (GInitableIface *initable_iface)
1135 initable_iface->init = initable_init;
1138 /* ---------------------------------------------------------------------------------------------------- */