Improve GSettings test coverage
[platform/upstream/glib.git] / gio / gtestdbus.c
1 /* GIO testing utilities
2  *
3  * Copyright (C) 2008-2010 Red Hat, Inc.
4  * Copyright (C) 2012 Collabora Ltd. <http://www.collabora.co.uk/>
5  *
6  * This library is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2 of the License, or (at your option) any later version.
10  *
11  * This library is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General
17  * Public License along with this library; if not, write to the
18  * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
19  * Boston, MA 02111-1307, USA.
20  *
21  * Authors: David Zeuthen <davidz@redhat.com>
22  *          Xavier Claessens <xavier.claessens@collabora.co.uk>
23  */
24
25 #include "config.h"
26
27 #include <stdlib.h>
28 #include <stdio.h>
29 #include <gstdio.h>
30 #ifdef HAVE_UNISTD_H
31 #include <unistd.h>
32 #endif
33 #ifdef G_OS_WIN32
34 #include <io.h>
35 #endif
36
37 #include <glib.h>
38
39 #include "gdbusconnection.h"
40 #include "gdbusprivate.h"
41 #include "gfile.h"
42 #include "gioenumtypes.h"
43 #include "gtestdbus.h"
44
45 #include "glibintl.h"
46
47 #ifdef G_OS_WIN32
48 #define _WIN32_WINNT 0x0500
49 #include <windows.h>
50 #endif
51
52 /* -------------------------------------------------------------------------- */
53 /* Utility: Wait until object has a single ref  */
54
55 typedef struct
56 {
57   GMainLoop *loop;
58   gboolean   timed_out;
59 } WeakNotifyData;
60
61 static gboolean
62 on_weak_notify_timeout (gpointer user_data)
63 {
64   WeakNotifyData *data = user_data;
65   data->timed_out = TRUE;
66   g_main_loop_quit (data->loop);
67   return FALSE;
68 }
69
70 static gboolean
71 unref_on_idle (gpointer object)
72 {
73   g_object_unref (object);
74   return FALSE;
75 }
76
77 gboolean
78 _g_object_unref_and_wait_weak_notify (gpointer object)
79 {
80   WeakNotifyData data;
81   guint timeout_id;
82
83   data.loop = g_main_loop_new (NULL, FALSE);
84   data.timed_out = FALSE;
85
86   g_object_weak_ref (object, (GWeakNotify) g_main_loop_quit, data.loop);
87
88   /* Drop the ref in an idle callback, this is to make sure the mainloop
89    * is already running when weak notify happens */
90   g_idle_add (unref_on_idle, object);
91
92   /* Make sure we don't block forever */
93   timeout_id = g_timeout_add (30 * 1000, on_weak_notify_timeout, &data);
94
95   g_main_loop_run (data.loop);
96
97   g_source_remove (timeout_id);
98
99   if (data.timed_out)
100     {
101       g_warning ("Weak notify timeout, object ref_count=%d\n",
102           G_OBJECT (object)->ref_count);
103     }
104
105   return data.timed_out;
106 }
107
108 /* -------------------------------------------------------------------------- */
109 /* Utilities to cleanup the mess in the case unit test process crash */
110
111 #ifdef G_OS_WIN32
112
113 /* This could be interesting to expose in public API */
114 static void
115 _g_test_watcher_add_pid (GPid pid)
116 {
117   static gsize started = 0;
118   HANDLE job;
119
120   if (g_once_init_enter (&started))
121     {
122       JOBOBJECT_EXTENDED_LIMIT_INFORMATION info;
123
124       job = CreateJobObjectW (NULL, NULL);
125       memset (&info, 0, sizeof (info));
126       info.BasicLimitInformation.LimitFlags = 0x2000 /* JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE */;
127
128       if (!SetInformationJobObject(job, JobObjectExtendedLimitInformation, &info, sizeof (info)))
129         g_warning ("Can't enable JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE: %s", g_win32_error_message (GetLastError()));
130
131       g_once_init_leave (&started,(gsize)job);
132     }
133
134   job = (HANDLE)started;
135
136   if (!AssignProcessToJobObject(job, pid))
137     g_warning ("Can't assign process to job: %s", g_win32_error_message (GetLastError()));
138 }
139
140 static void
141 _g_test_watcher_remove_pid (GPid pid)
142 {
143   /* No need to unassign the process from the job object as the process
144      will be killed anyway */
145 }
146
147 #else
148
149 #define ADD_PID_FORMAT "add pid %d\n"
150 #define REMOVE_PID_FORMAT "remove pid %d\n"
151
152 static void
153 watch_parent (gint fd)
154 {
155   GIOChannel *channel;
156   GPollFD fds[1];
157   GArray *pids_to_kill;
158
159   channel = g_io_channel_unix_new (fd);
160
161   fds[0].fd = fd;
162   fds[0].events = G_IO_HUP | G_IO_IN;
163   fds[0].revents = 0;
164
165   pids_to_kill = g_array_new (FALSE, FALSE, sizeof (guint));
166
167   do
168     {
169       gint num_events;
170       gchar *command = NULL;
171       guint pid;
172       guint n;
173       GError *error = NULL;
174
175       num_events = g_poll (fds, 1, -1);
176       if (num_events == 0)
177         continue;
178
179       if (fds[0].revents == G_IO_HUP)
180         {
181           /* Parent quit, cleanup the mess and exit */
182           for (n = 0; n < pids_to_kill->len; n++)
183             {
184               pid = g_array_index (pids_to_kill, guint, n);
185               g_print ("cleaning up pid %d\n", pid);
186               kill (pid, SIGTERM);
187             }
188
189           g_array_unref (pids_to_kill);
190           g_io_channel_shutdown (channel, FALSE, &error);
191           g_assert_no_error (error);
192           g_io_channel_unref (channel);
193
194           exit (0);
195         }
196
197       /* Read the command from the input */
198       g_io_channel_read_line (channel, &command, NULL, NULL, &error);
199       g_assert_no_error (error);
200
201       /* Check for known commands */
202       if (sscanf (command, ADD_PID_FORMAT, &pid) == 1)
203         {
204           g_array_append_val (pids_to_kill, pid);
205         }
206       else if (sscanf (command, REMOVE_PID_FORMAT, &pid) == 1)
207         {
208           for (n = 0; n < pids_to_kill->len; n++)
209             {
210               if (g_array_index (pids_to_kill, guint, n) == pid)
211                 {
212                   g_array_remove_index (pids_to_kill, n);
213                   pid = 0;
214                   break;
215                 }
216             }
217           if (pid != 0)
218             {
219               g_warning ("unknown pid %d to remove", pid);
220             }
221         }
222       else
223         {
224           g_warning ("unknown command from parent '%s'", command);
225         }
226
227       g_free (command);
228     }
229   while (TRUE);
230 }
231
232 static GIOChannel *
233 watcher_init (void)
234 {
235   static gsize started = 0;
236   static GIOChannel *channel = NULL;
237
238   if (g_once_init_enter (&started))
239     {
240       gint pipe_fds[2];
241
242       /* fork a child to clean up when we are killed */
243       if (pipe (pipe_fds) != 0)
244         {
245           g_warning ("pipe() failed: %m");
246           g_assert_not_reached ();
247         }
248
249       switch (fork ())
250         {
251         case -1:
252           g_warning ("fork() failed: %m");
253           g_assert_not_reached ();
254           break;
255
256         case 0:
257           /* child */
258           close (pipe_fds[1]);
259           watch_parent (pipe_fds[0]);
260           break;
261
262         default:
263           /* parent */
264           close (pipe_fds[0]);
265           channel = g_io_channel_unix_new (pipe_fds[1]);
266         }
267
268       g_once_init_leave (&started, 1);
269     }
270
271   return channel;
272 }
273
274 static void
275 watcher_send_command (const gchar *command)
276 {
277   GIOChannel *channel;
278   GError *error = NULL;
279
280   channel = watcher_init ();
281
282   g_io_channel_write_chars (channel, command, -1, NULL, &error);
283   g_assert_no_error (error);
284
285   g_io_channel_flush (channel, &error);
286   g_assert_no_error (error);
287 }
288
289 /* This could be interesting to expose in public API */
290 static void
291 _g_test_watcher_add_pid (GPid pid)
292 {
293   gchar *command;
294
295   command = g_strdup_printf (ADD_PID_FORMAT, (guint) pid);
296   watcher_send_command (command);
297   g_free (command);
298 }
299
300 static void
301 _g_test_watcher_remove_pid (GPid pid)
302 {
303   gchar *command;
304
305   command = g_strdup_printf (REMOVE_PID_FORMAT, (guint) pid);
306   watcher_send_command (command);
307   g_free (command);
308 }
309
310 #endif
311
312 /* -------------------------------------------------------------------------- */
313 /* GTestDBus object implementation */
314
315 /**
316  * SECTION:gtestdbus
317  * @short_description: D-Bus testing helper
318  * @include: gio/gio.h
319  *
320  * Helper to test D-Bus code wihtout messing up with user' session bus.
321  */
322
323 typedef struct _GTestDBusClass   GTestDBusClass;
324 typedef struct _GTestDBusPrivate GTestDBusPrivate;
325
326 /**
327  * GTestDBus:
328  *
329  * The #GTestDBus structure contains only private data and
330  * should only be accessed using the provided API.
331  *
332  * Since: 2.34
333  */
334 struct _GTestDBus {
335   GObject parent;
336
337   GTestDBusPrivate *priv;
338 };
339
340 struct _GTestDBusClass {
341   GObjectClass parent_class;
342 };
343
344 struct _GTestDBusPrivate
345 {
346   GTestDBusFlags flags;
347   GPtrArray *service_dirs;
348   GPid bus_pid;
349   gchar *bus_address;
350   gboolean up;
351 };
352
353 enum
354 {
355   PROP_0,
356   PROP_FLAGS,
357 };
358
359 G_DEFINE_TYPE (GTestDBus, g_test_dbus, G_TYPE_OBJECT)
360
361 static void
362 g_test_dbus_init (GTestDBus *self)
363 {
364   self->priv = G_TYPE_INSTANCE_GET_PRIVATE ((self), G_TYPE_TEST_DBUS,
365       GTestDBusPrivate);
366
367   self->priv->service_dirs = g_ptr_array_new_with_free_func (g_free);
368 }
369
370 static void
371 g_test_dbus_dispose (GObject *object)
372 {
373   GTestDBus *self = (GTestDBus *) object;
374
375   if (self->priv->up)
376     g_test_dbus_down (self);
377
378   G_OBJECT_CLASS (g_test_dbus_parent_class)->dispose (object);
379 }
380
381 static void
382 g_test_dbus_finalize (GObject *object)
383 {
384   GTestDBus *self = (GTestDBus *) object;
385
386   g_ptr_array_unref (self->priv->service_dirs);
387   g_free (self->priv->bus_address);
388
389   G_OBJECT_CLASS (g_test_dbus_parent_class)->finalize (object);
390 }
391
392 static void
393 g_test_dbus_get_property (GObject *object,
394     guint property_id,
395     GValue *value,
396     GParamSpec *pspec)
397 {
398   GTestDBus *self = (GTestDBus *) object;
399
400   switch (property_id)
401     {
402       case PROP_FLAGS:
403         g_value_set_flags (value, g_test_dbus_get_flags (self));
404         break;
405       default:
406         G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
407         break;
408     }
409 }
410
411 static void
412 g_test_dbus_set_property (GObject *object,
413     guint property_id,
414     const GValue *value,
415     GParamSpec *pspec)
416 {
417   GTestDBus *self = (GTestDBus *) object;
418
419   switch (property_id)
420     {
421       case PROP_FLAGS:
422         self->priv->flags = g_value_get_flags (value);
423         break;
424       default:
425         G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
426         break;
427     }
428 }
429
430 static void
431 g_test_dbus_class_init (GTestDBusClass *klass)
432 {
433   GObjectClass *object_class = G_OBJECT_CLASS (klass);
434
435   object_class->dispose = g_test_dbus_dispose;
436   object_class->finalize = g_test_dbus_finalize;
437   object_class->get_property = g_test_dbus_get_property;
438   object_class->set_property = g_test_dbus_set_property;
439
440   g_type_class_add_private (object_class, sizeof (GTestDBusPrivate));
441
442   /**
443    * GTestDBus:flags:
444    *
445    * #GTestDBusFlags specifying the behaviour of the dbus session
446    *
447    * Since: 2.34
448    */
449   g_object_class_install_property (object_class, PROP_FLAGS,
450     g_param_spec_flags ("flags",
451                         P_("dbus session flags"),
452                         P_("Flags specifying the behaviour of the dbus session"),
453                         G_TYPE_TEST_DBUS_FLAGS, G_TEST_DBUS_NONE,
454                         G_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY |
455                         G_PARAM_STATIC_STRINGS));
456
457 }
458
459 static gchar *
460 write_config_file (GTestDBus *self)
461 {
462   GString *contents;
463   gint fd;
464   guint i;
465   GError *error = NULL;
466   gchar *path = NULL;
467
468   fd = g_file_open_tmp ("g-test-dbus-XXXXXX", &path, &error);
469   g_assert_no_error (error);
470
471   contents = g_string_new (NULL);
472   g_string_append (contents,
473       "<busconfig>\n"
474       "  <type>session</type>\n"
475 #ifdef G_OS_WIN32
476       "  <listen>nonce-tcp:</listen>\n"
477 #else
478       "  <listen>unix:tmpdir=/tmp</listen>\n"
479 #endif
480                    );
481
482   for (i = 0; i < self->priv->service_dirs->len; i++)
483     {
484       const gchar *path = g_ptr_array_index (self->priv->service_dirs, i);
485
486       g_string_append_printf (contents,
487           "  <servicedir>%s</servicedir>\n", path);
488     }
489
490   g_string_append (contents,
491       "  <policy context=\"default\">\n"
492       "    <!-- Allow everything to be sent -->\n"
493       "    <allow send_destination=\"*\" eavesdrop=\"true\"/>\n"
494       "    <!-- Allow everything to be received -->\n"
495       "    <allow eavesdrop=\"true\"/>\n"
496       "    <!-- Allow anyone to own anything -->\n"
497       "    <allow own=\"*\"/>\n"
498       "  </policy>\n"
499       "</busconfig>\n");
500
501   g_file_set_contents (path, contents->str, contents->len, &error);
502   g_assert_no_error (error);
503
504   g_string_free (contents, TRUE);
505
506   close (fd);
507
508   return path;
509 }
510
511 static void
512 start_daemon (GTestDBus *self)
513 {
514   gchar *argv[] = {"dbus-daemon", "--print-address", "--config-file=foo", NULL};
515   gchar *config_path;
516   gchar *config_arg;
517   gint stdout_fd;
518   GIOChannel *channel;
519   gsize termpos;
520   GError *error = NULL;
521
522   if (g_getenv ("G_TEST_DBUS_DAEMON") != NULL)
523     argv[0] = (gchar *)g_getenv ("G_TEST_DBUS_DAEMON");
524
525   /* Write config file and set its path in argv */
526   config_path = write_config_file (self);
527   config_arg = g_strdup_printf ("--config-file=%s", config_path);
528   argv[2] = config_arg;
529
530   /* Spawn dbus-daemon */
531   g_spawn_async_with_pipes (NULL,
532                             argv,
533                             NULL,
534 #ifdef G_OS_WIN32
535                             /* We Need this to get the pid returned on win32 */
536                             G_SPAWN_DO_NOT_REAP_CHILD |
537 #endif
538                             G_SPAWN_SEARCH_PATH,
539                             NULL,
540                             NULL,
541                             &self->priv->bus_pid,
542                             NULL,
543                             &stdout_fd,
544                             NULL,
545                             &error);
546   g_assert_no_error (error);
547
548   _g_test_watcher_add_pid (self->priv->bus_pid);
549
550   /* Read bus address from daemon' stdout */
551   channel = g_io_channel_unix_new (stdout_fd);
552   g_io_channel_read_line (channel, &self->priv->bus_address, NULL,
553       &termpos, &error);
554   g_assert_no_error (error);
555   self->priv->bus_address[termpos] = '\0';
556
557   /* start dbus-monitor */
558   if (g_getenv ("G_DBUS_MONITOR") != NULL)
559     {
560       gchar *command;
561
562       command = g_strdup_printf ("dbus-monitor --address %s",
563           self->priv->bus_address);
564       g_spawn_command_line_async (command, NULL);
565       g_free (command);
566
567       g_usleep (500 * 1000);
568     }
569
570   /* Cleanup */
571   g_io_channel_shutdown (channel, FALSE, &error);
572   g_assert_no_error (error);
573   g_io_channel_unref (channel);
574
575   /* Don't use g_file_delete since it calls into gvfs */
576   if (g_unlink (config_path) != 0)
577     g_assert_not_reached ();
578
579   g_free (config_path);
580   g_free (config_arg);
581 }
582
583 static void
584 stop_daemon (GTestDBus *self)
585 {
586 #ifdef G_OS_WIN32
587   if (!TerminateProcess (self->priv->bus_pid, 0))
588     g_warning ("Can't terminate process: %s", g_win32_error_message (GetLastError()));
589 #else
590   kill (self->priv->bus_pid, SIGTERM);
591 #endif
592   _g_test_watcher_remove_pid (self->priv->bus_pid);
593   g_spawn_close_pid (self->priv->bus_pid);
594   self->priv->bus_pid = 0;
595
596   g_free (self->priv->bus_address);
597   self->priv->bus_address = NULL;
598 }
599
600 /**
601  * g_test_dbus_new:
602  * @flags: a #GTestDBusFlags
603  *
604  * Create a new #GTestDBus object.
605  *
606  * Returns: (transfer full): a new #GTestDBus.
607  */
608 GTestDBus *
609 g_test_dbus_new (GTestDBusFlags flags)
610 {
611   return g_object_new (G_TYPE_TEST_DBUS,
612       "flags", flags,
613       NULL);
614 }
615
616 /**
617  * g_test_dbus_get_flags:
618  * @self: a #GTestDBus
619  *
620  * Returns: the value of #GTestDBus:flags property
621  */
622 GTestDBusFlags
623 g_test_dbus_get_flags (GTestDBus *self)
624 {
625   g_return_val_if_fail (G_IS_TEST_DBUS (self), G_TEST_DBUS_NONE);
626
627   return self->priv->flags;
628 }
629
630 /**
631  * g_test_dbus_get_bus_address:
632  * @self: a #GTestDBus
633  *
634  * Get the address on which dbus-daemon is running. if g_test_dbus_up() has not
635  * been called yet, %NULL is returned. This can be used with
636  * g_dbus_connection_new_for_address()
637  *
638  * Returns: the address of the bus, or %NULL.
639  */
640 const gchar *
641 g_test_dbus_get_bus_address (GTestDBus *self)
642 {
643   g_return_val_if_fail (G_IS_TEST_DBUS (self), NULL);
644
645   return self->priv->bus_address;
646 }
647
648 /**
649  * g_test_dbus_add_service_dir:
650  * @self: a #GTestDBus
651  * @path: path to a directory containing .service files
652  *
653  * Add a path where dbus-daemon will lookup for .services files. This can't be
654  * called after g_test_dbus_up().
655  */
656 void
657 g_test_dbus_add_service_dir (GTestDBus *self,
658     const gchar *path)
659 {
660   g_return_if_fail (G_IS_TEST_DBUS (self));
661   g_return_if_fail (self->priv->bus_address == NULL);
662
663   g_ptr_array_add (self->priv->service_dirs, g_strdup (path));
664 }
665
666 /**
667  * g_test_dbus_up:
668  * @self: a #GTestDBus
669  *
670  * Start a dbus-daemon instance and set DBUS_SESSION_BUS_ADDRESS. After this
671  * call, it is safe for unit tests to start sending messages on the session bug.
672  *
673  * If this function is called from setup callback of g_test_add(),
674  * g_test_dbus_down() must be called in its teardown callback.
675  *
676  * If this function is called from unit test's main(), then g_test_dbus_down()
677  * must be called after g_test_run().
678  */
679 void
680 g_test_dbus_up (GTestDBus *self)
681 {
682   g_return_if_fail (G_IS_TEST_DBUS (self));
683   g_return_if_fail (self->priv->bus_address == NULL);
684   g_return_if_fail (!self->priv->up);
685
686   start_daemon (self);
687
688   g_setenv ("DBUS_SESSION_BUS_ADDRESS", self->priv->bus_address, TRUE);
689   self->priv->up = TRUE;
690 }
691
692
693 /**
694  * g_test_dbus_stop:
695  * @self: a #GTestDBus
696  *
697  * Stop the session bus started by g_test_dbus_up().
698  *
699  * Unlike g_test_dbus_down(), this won't verify the #GDBusConnection
700  * singleton returned by g_bus_get() or g_bus_get_sync() is destroyed. Unit
701  * tests wanting to verify behaviour after the session bus has been stopped
702  * can use this function but should still call g_test_dbus_down() when done.
703  */
704 void
705 g_test_dbus_stop (GTestDBus *self)
706 {
707   g_return_if_fail (G_IS_TEST_DBUS (self));
708   g_return_if_fail (self->priv->bus_address != NULL);
709
710   stop_daemon (self);
711 }
712
713 /**
714  * g_test_dbus_down:
715  * @self: a #GTestDBus
716  *
717  * Stop the session bus started by g_test_dbus_up().
718  *
719  * This will wait for the singleton returned by g_bus_get() or g_bus_get_sync()
720  * is destroyed. This is done to ensure that the next unit test won't get a
721  * leaked singleton from this test.
722  */
723 void
724 g_test_dbus_down (GTestDBus *self)
725 {
726   GDBusConnection *connection;
727
728   g_return_if_fail (G_IS_TEST_DBUS (self));
729   g_return_if_fail (self->priv->up);
730
731   connection = _g_bus_get_singleton_if_exists (G_BUS_TYPE_SESSION);
732   if (connection != NULL)
733     g_dbus_connection_set_exit_on_close (connection, FALSE);
734
735   if (self->priv->bus_address != NULL)
736     stop_daemon (self);
737
738   if (connection != NULL)
739     _g_object_unref_and_wait_weak_notify (connection);
740
741   g_unsetenv ("DBUS_SESSION_BUS_ADDRESS");
742   self->priv->up = FALSE;
743 }
744
745 /**
746  * g_test_dbus_unset:
747  *
748  * Unset DISPLAY and DBUS_SESSION_BUS_ADDRESS env variables to ensure the test
749  * won't use user's session bus.
750  *
751  * This is useful for unit tests that want to verify behaviour when no session
752  * bus is running. It is not necessary to call this if unit test already calls
753  * g_test_dbus_up() before acquiring the session bus.
754  */
755 void
756 g_test_dbus_unset (void)
757 {
758   g_unsetenv ("DISPLAY");
759   g_unsetenv ("DBUS_SESSION_BUS_ADDRESS");
760 }