1 /*****************************************************************************
2 * dbus.h : D-Bus control interface
3 *****************************************************************************
4 * Copyright (C) 2006 Rafaël Carré
7 * Author: Rafaël Carré <funman at videolanorg>
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
22 *****************************************************************************/
24 /* DBUS IDENTIFIERS */
26 #define VLC_DBUS_SERVICE "org.videolan.vlc"
27 #define VLC_DBUS_INTERFACE "org.videolan.vlc"
28 #define VLC_DBUS_OBJECT_PATH "/org/videolan/vlc"
32 #define DBUS_METHOD( method_function ) \
33 static DBusHandlerResult method_function \
34 ( DBusConnection *p_conn, DBusMessage *p_from, void *p_this )
36 #define DBUS_SIGNAL( signal_function ) \
37 static DBusHandlerResult signal_function \
38 ( DBusConnection *p_conn, void *p_data )
41 DBusMessage* p_msg = dbus_message_new_method_return( p_from ); \
42 if( !p_msg ) return DBUS_HANDLER_RESULT_NEED_MEMORY; \
43 dbus_uint32_t i_serial = 0
46 if( !dbus_connection_send( p_conn, p_msg, &i_serial ) ) \
47 return DBUS_HANDLER_RESULT_NEED_MEMORY; \
48 dbus_connection_flush( p_conn ); \
49 dbus_message_unref( p_msg ); \
50 return DBUS_HANDLER_RESULT_HANDLED
52 #define SIGNAL_INIT( signal ) \
53 DBusMessage *p_msg = dbus_message_new_signal( VLC_DBUS_OBJECT_PATH, \
54 VLC_DBUS_INTERFACE, signal ); \
55 if( !p_msg ) return DBUS_HANDLER_RESULT_NEED_MEMORY; \
56 dbus_uint32_t i_serial = 0
59 if( !dbus_connection_send( p_conn, p_msg, &i_serial ) ) \
60 return DBUS_HANDLER_RESULT_NEED_MEMORY; \
61 dbus_message_unref( p_msg ); \
62 dbus_connection_flush( p_conn ); \
63 return DBUS_HANDLER_RESULT_HANDLED
65 #define OUT_ARGUMENTS \
66 DBusMessageIter args; \
67 dbus_message_iter_init_append( p_msg, &args )
69 #define DBUS_ADD( dbus_type, value ) \
70 if( !dbus_message_iter_append_basic( &args, dbus_type, value ) ) \
71 return DBUS_HANDLER_RESULT_NEED_MEMORY
73 #define ADD_STRING( s ) DBUS_ADD( DBUS_TYPE_STRING, s )
74 #define ADD_BOOL( b ) DBUS_ADD( DBUS_TYPE_BOOLEAN, b )
75 #define ADD_UINT32( i ) DBUS_ADD( DBUS_TYPE_UINT32, i )
77 /* XML data to answer org.freedesktop.DBus.Introspectable.Introspect requests */
79 const char* psz_introspection_xml_data =
80 "<!DOCTYPE node PUBLIC \"-//freedesktop//DTD D-BUS Object Introspection 1.0//EN\"\n"
81 "\"http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd\">\n"
83 " <interface name=\"org.freedesktop.DBus.Introspectable\">\n"
84 " <method name=\"Introspect\">\n"
85 " <arg name=\"data\" direction=\"out\" type=\"s\"/>\n"
88 " <interface name=\"org.videolan.vlc\">\n"
89 " <method name=\"GetPlayStatus\">\n"
90 " <arg type=\"s\" direction=\"out\" />\n"
92 " <method name=\"GetPlayingItem\">\n"
93 " <arg type=\"s\" direction=\"out\" />\n"
95 " <method name=\"TogglePause\">\n"
96 " <arg type=\"s\" direction=\"out\" />\n"
98 " <method name=\"AddMRL\">\n"
99 " <arg type=\"s\" direction=\"in\" />\n"
100 " <arg type=\"b\" direction=\"in\" />\n"
102 " <method name=\"Nothing\">\n"
104 " <method name=\"Quit\">\n"
106 " <method name=\"Prev\">\n"
108 " <method name=\"Next\">\n"
110 " <method name=\"Stop\">\n"
116 /* Handling of messages received onn VLC_DBUS_OBJECT_PATH */
117 DBUS_METHOD( handle_messages ); /* handler function */
119 /* vtable passed to dbus_connection_register_object_path() */
120 static DBusObjectPathVTable vlc_dbus_vtable = {
121 NULL, /* Called when vtable is unregistered or its connection is freed*/
122 handle_messages, /* handler function */