/* Integration tests for the eavesdrop=true|false keyword in DBusMatchRule * * Author: Cosimo Alfarano <cosimo.alfarano@collabora.co.uk> * Based on: tests/dbus-daemon.c by Simon McVittie * Copyright © 2010-2011 Nokia Corporation * * Permission is hereby granted, free of charge, to any person * obtaining a copy of this software and associated documentation files * (the "Software"), to deal in the Software without restriction, * including without limitation the rights to use, copy, modify, merge, * publish, distribute, sublicense, and/or sell copies of the Software, * and to permit persons to whom the Software is furnished to do so, * subject to the following conditions: * * The above copyright notice and this permission notice shall be * included in all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. */ #include <config.h> #include <glib.h> #include <dbus/dbus.h> #include <dbus/dbus-glib-lowlevel.h> #include <string.h> #ifdef DBUS_WIN # include <io.h> # include <windows.h> #else # include <signal.h> # include <unistd.h> #endif #define SENDER_NAME "test.eavesdrop.sender" #define SENDER_PATH "/test/eavesdrop/sender" #define SENDER_IFACE SENDER_NAME #define SENDER_SIGNAL_NAME "Signal" #define SENDER_STOPPER_NAME "Stopper" /* This rule is equivalent to the one added to a proxy connecting to * SENDER_NAME+SENDER_IFACE, plus restricting on signal name. * Being more restrictive, if the connection receives what we need, for sure * the original proxy rule will match it */ #define RECEIVER_RULE "sender='" SENDER_NAME "'," \ "interface='" SENDER_IFACE "'," \ "type='signal'," \ "member='" SENDER_SIGNAL_NAME "'" #define POLITELISTENER_RULE RECEIVER_RULE #define EAVESDROPPER_RULE RECEIVER_RULE ",eavesdrop=true" #define STOPPER_RULE "sender='" SENDER_NAME \ "',interface='" SENDER_IFACE "',type='signal',member='" SENDER_STOPPER_NAME "'" /* a connection received a signal to whom? */ typedef enum { NONE_YET = 0, TO_ME, TO_OTHER, BROADCAST, } SignalDst; typedef struct { DBusError e; GError *ge; GPid daemon_pid; /* eavedrop keyword tests */ DBusConnection *sender; DBusConnection *receiver; SignalDst receiver_dst; dbus_bool_t receiver_got_stopper; DBusConnection *eavesdropper; SignalDst eavesdropper_dst; dbus_bool_t eavesdropper_got_stopper; DBusConnection *politelistener; SignalDst politelistener_dst; dbus_bool_t politelistener_got_stopper; } Fixture; #define assert_no_error(e) _assert_no_error (e, __FILE__, __LINE__) static void _assert_no_error (const DBusError *e, const char *file, int line) { if (G_UNLIKELY (dbus_error_is_set (e))) g_error ("%s:%d: expected success but got error: %s: %s", file, line, e->name, e->message); } static gchar * spawn_dbus_daemon (gchar *binary, gchar *configuration, GPid *daemon_pid) { GError *error = NULL; GString *address; gint address_fd; gchar *argv[] = { binary, configuration, "--nofork", "--print-address=1", /* stdout */ NULL }; g_spawn_async_with_pipes (NULL, /* working directory */ argv, NULL, /* envp */ G_SPAWN_DO_NOT_REAP_CHILD | G_SPAWN_SEARCH_PATH, NULL, /* child_setup */ NULL, /* user data */ daemon_pid, NULL, /* child's stdin = /dev/null */ &address_fd, NULL, /* child's stderr = our stderr */ &error); g_assert_no_error (error); address = g_string_new (NULL); /* polling until the dbus-daemon writes out its address is a bit stupid, * but at least it's simple, unlike dbus-launch... in principle we could * use select() here, but life's too short */ while (1) { gssize bytes; gchar buf[4096]; gchar *newline; bytes = read (address_fd, buf, sizeof (buf)); if (bytes > 0) g_string_append_len (address, buf, bytes); newline = strchr (address->str, '\n'); if (newline != NULL) { g_string_truncate (address, newline - address->str); break; } g_usleep (G_USEC_PER_SEC / 10); } return g_string_free (address, FALSE); } static DBusConnection * connect_to_bus (const gchar *address) { DBusConnection *conn; DBusError error = DBUS_ERROR_INIT; dbus_bool_t ok; conn = dbus_connection_open_private (address, &error); assert_no_error (&error); g_assert (conn != NULL); ok = dbus_bus_register (conn, &error); assert_no_error (&error); g_assert (ok); g_assert (dbus_bus_get_unique_name (conn) != NULL); dbus_connection_setup_with_g_main (conn, NULL); return conn; } /* send a unicast signal to <self> to ensure that no other connection * listening is the actual recipient for the signal */ static DBusHandlerResult sender_send_unicast_to_sender (Fixture *f) { DBusMessage *signal; signal = dbus_message_new_signal (SENDER_PATH, SENDER_IFACE, SENDER_SIGNAL_NAME); dbus_message_set_destination (signal, dbus_bus_get_unique_name (f->sender)); if (signal == NULL) g_error ("OOM"); if (!dbus_connection_send (f->sender, signal, NULL)) g_error ("OOM"); dbus_message_unref (signal); return DBUS_HANDLER_RESULT_HANDLED; } /* send a unicast signal to <receiver>, making <politelistener> and * <eavesdropper> not a actual recipient for it */ static DBusHandlerResult sender_send_unicast_to_receiver (Fixture *f) { DBusMessage *signal; signal = dbus_message_new_signal (SENDER_PATH, SENDER_IFACE, SENDER_SIGNAL_NAME); dbus_message_set_destination (signal, dbus_bus_get_unique_name (f->receiver)); if (signal == NULL) g_error ("OOM"); if (!dbus_connection_send (f->sender, signal, NULL)) g_error ("OOM"); dbus_message_unref (signal); return DBUS_HANDLER_RESULT_HANDLED; } static DBusHandlerResult sender_send_broadcast (Fixture *f) { DBusMessage *signal; signal = dbus_message_new_signal (SENDER_PATH, SENDER_IFACE, SENDER_SIGNAL_NAME); dbus_message_set_destination (signal, NULL); if (signal == NULL) g_error ("OOM"); if (!dbus_connection_send (f->sender, signal, NULL)) g_error ("OOM"); dbus_message_unref (signal); return DBUS_HANDLER_RESULT_HANDLED; } /* Send special broadcast signal to indicate that the connections can "stop" * listening and check their results. * DBus does not re-order messages, so when the three connections have received * this signal, we are sure that any message sent before it has also been * dispatched. */ static DBusHandlerResult sender_send_stopper (Fixture *f) { DBusMessage *signal; signal = dbus_message_new_signal (SENDER_PATH, SENDER_IFACE, SENDER_STOPPER_NAME); dbus_message_set_destination (signal, NULL); if (signal == NULL) g_error ("OOM"); if (!dbus_connection_send (f->sender, signal, NULL)) g_error ("OOM"); dbus_message_unref (signal); return DBUS_HANDLER_RESULT_HANDLED; } /* Ignore NameAcquired, then depending on the signal received: * - updates f-><conn>_dst based on the destination of the message * - asserts that <conn> received the stop signal */ static DBusHandlerResult signal_filter (DBusConnection *connection, DBusMessage *message, void *user_data) { Fixture *f = user_data; SignalDst *dst = NULL; DBusConnection **conn; dbus_bool_t *got_stopper; if (0 == strcmp (dbus_message_get_member (message), "NameAcquired")) return DBUS_HANDLER_RESULT_NOT_YET_HANDLED; if (connection == f->receiver) { dst = &(f->receiver_dst); conn = &(f->receiver); got_stopper = &(f->receiver_got_stopper); } else if (connection == f->eavesdropper) { dst = &(f->eavesdropper_dst); conn = &(f->eavesdropper); got_stopper = &(f->eavesdropper_got_stopper); } else if (connection == f->politelistener) { dst = &(f->politelistener_dst); conn = &(f->politelistener); got_stopper = &(f->politelistener_got_stopper); } else { g_error ("connection not matching"); } if (0 == strcmp (dbus_message_get_member (message), SENDER_SIGNAL_NAME)) { if (dbus_message_get_destination (message) == NULL) *dst = BROADCAST; else if (0 == strcmp (dbus_message_get_destination (message), dbus_bus_get_unique_name (*conn))) *dst = TO_ME; else /* if (dbus_message_get_destination (message) != NULL) */ *dst = TO_OTHER; } else if (0 == strcmp (dbus_message_get_member (message), SENDER_STOPPER_NAME)) { *got_stopper = TRUE; } else { g_error ("got unknown member from message: %s", dbus_message_get_member (message)); } return DBUS_HANDLER_RESULT_NOT_YET_HANDLED; } static void add_receiver_filter (Fixture *f) { DBusError e = DBUS_ERROR_INIT; dbus_bus_add_match (f->receiver, RECEIVER_RULE, &e); assert_no_error (&e); dbus_bus_add_match (f->receiver, STOPPER_RULE, &e); assert_no_error (&e); if (!dbus_connection_add_filter (f->receiver, signal_filter, f, NULL)) g_error ("OOM"); } static void add_eavesdropper_filter (Fixture *f) { DBusError e = DBUS_ERROR_INIT; dbus_bus_add_match (f->eavesdropper, EAVESDROPPER_RULE, &e); assert_no_error (&e); dbus_bus_add_match (f->eavesdropper, STOPPER_RULE, &e); assert_no_error (&e); if (!dbus_connection_add_filter (f->eavesdropper, signal_filter, f, NULL)) g_error ("OOM"); } static void add_politelistener_filter (Fixture *f) { DBusError e = DBUS_ERROR_INIT; dbus_bus_add_match (f->politelistener, POLITELISTENER_RULE, &e); assert_no_error (&e); dbus_bus_add_match (f->politelistener, STOPPER_RULE, &e); assert_no_error (&e); if (!dbus_connection_add_filter (f->politelistener, signal_filter, f, NULL)) g_error ("OOM"); } static void setup (Fixture *f, gconstpointer context G_GNUC_UNUSED) { gchar *dbus_daemon; gchar *config; gchar *address; f->ge = NULL; dbus_error_init (&f->e); dbus_daemon = g_strdup (g_getenv ("DBUS_TEST_DAEMON")); if (dbus_daemon == NULL) dbus_daemon = g_strdup ("dbus-daemon"); if (g_getenv ("DBUS_TEST_SYSCONFDIR") != NULL) { config = g_strdup_printf ("--config-file=%s/dbus-1/session.conf", g_getenv ("DBUS_TEST_SYSCONFDIR")); } else if (g_getenv ("DBUS_TEST_DATA") != NULL) { config = g_strdup_printf ( "--config-file=%s/valid-config-files/session.conf", g_getenv ("DBUS_TEST_DATA")); } else { config = g_strdup ("--session"); } address = spawn_dbus_daemon (dbus_daemon, config, &f->daemon_pid); g_free (dbus_daemon); g_free (config); f->sender = connect_to_bus (address); dbus_bus_request_name (f->sender, SENDER_NAME, DBUS_NAME_FLAG_DO_NOT_QUEUE, &(f->e)); f->receiver = connect_to_bus (address); f->eavesdropper = connect_to_bus (address); f->politelistener = connect_to_bus (address); add_receiver_filter (f); add_politelistener_filter (f); add_eavesdropper_filter (f); g_free (address); } static void test_eavesdrop_broadcast (Fixture *f, gconstpointer context G_GNUC_UNUSED) { sender_send_broadcast (f); sender_send_stopper (f); while (!f->receiver_got_stopper || !f->politelistener_got_stopper || !f->eavesdropper_got_stopper) g_main_context_iteration (NULL, TRUE); /* all the three connection can receive a broadcast */ g_assert_cmpint (f->receiver_dst, ==, BROADCAST); g_assert_cmpint (f->politelistener_dst, ==, BROADCAST); g_assert_cmpint (f->eavesdropper_dst, ==, BROADCAST); } /* a way to say that none of the listening connection are destination of the * signal */ static void test_eavesdrop_unicast_to_sender (Fixture *f, gconstpointer context G_GNUC_UNUSED) { sender_send_unicast_to_sender (f); sender_send_stopper (f); while (!f->receiver_got_stopper || !f->politelistener_got_stopper || !f->eavesdropper_got_stopper) g_main_context_iteration (NULL, TRUE); /* not directed to it and not broadcasted, they cannot receive it */ g_assert_cmpint (f->receiver_dst, ==, NONE_YET); g_assert_cmpint (f->politelistener_dst, ==, NONE_YET); /* eavesdrop=true, it will receive the signal even though it's not directed * to it */ g_assert_cmpint (f->eavesdropper_dst, ==, TO_OTHER); } static void test_eavesdrop_unicast_to_receiver (Fixture *f, gconstpointer context G_GNUC_UNUSED) { sender_send_unicast_to_receiver (f); sender_send_stopper (f); while (!f->receiver_got_stopper || !f->politelistener_got_stopper || !f->eavesdropper_got_stopper) g_main_context_iteration (NULL, TRUE); /* direct to him */ g_assert_cmpint (f->receiver_dst, ==, TO_ME); /* not directed to it and not broadcasted, it cannot receive it */ g_assert_cmpint (f->politelistener_dst, ==, NONE_YET); /* eavesdrop=true, it will receive the signal even though it's not directed * to it */ g_assert_cmpint (f->eavesdropper_dst, ==, TO_OTHER); } static void teardown (Fixture *f, gconstpointer context G_GNUC_UNUSED) { dbus_error_free (&f->e); g_clear_error (&f->ge); if (f->sender != NULL) { dbus_connection_close (f->sender); dbus_connection_unref (f->sender); f->sender = NULL; } if (f->receiver != NULL) { dbus_connection_remove_filter (f->receiver, signal_filter, f); dbus_connection_close (f->receiver); dbus_connection_unref (f->receiver); f->receiver = NULL; } if (f->politelistener != NULL) { dbus_connection_remove_filter (f->politelistener, signal_filter, f); dbus_connection_close (f->politelistener); dbus_connection_unref (f->politelistener); f->politelistener = NULL; } if (f->eavesdropper != NULL) { dbus_connection_remove_filter (f->eavesdropper, signal_filter, f); dbus_connection_close (f->eavesdropper); dbus_connection_unref (f->eavesdropper); f->eavesdropper = NULL; } #ifdef DBUS_WIN TerminateProcess (f->daemon_pid, 1); #else kill (f->daemon_pid, SIGTERM); #endif g_spawn_close_pid (f->daemon_pid); } int main (int argc, char **argv) { g_test_init (&argc, &argv, NULL); g_test_bug_base ("https://bugs.freedesktop.org/show_bug.cgi?id="); g_test_add ("/eavedrop/match_keyword/broadcast", Fixture, NULL, setup, test_eavesdrop_broadcast, teardown); g_test_add ("/eavedrop/match_keyword/unicast_to_receiver", Fixture, NULL, setup, test_eavesdrop_unicast_to_receiver, teardown); g_test_add ("/eavedrop/match_keyword/unicast_to_sender", Fixture, NULL, setup, test_eavesdrop_unicast_to_sender, teardown); return g_test_run (); }