summaryrefslogtreecommitdiff
path: root/droute/droute.h
blob: 68c113d069e0a800e2ec5657f34756095dc3a2ac (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
/*
 * AT-SPI - Assistive Technology Service Provider Interface
 * (Gnome Accessibility Project; http://developer.gnome.org/projects/gap)
 *
 * Copyright 2008 Novell, Inc.
 * Copyright 2008 Codethink Ltd.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
 * Boston, MA 02110-1301, USA.
 */
#ifndef _DROUTE_H
#define _DROUTE_H

#include <dbus/dbus.h>
#include <glib.h>

#include <droute/droute-variant.h>


typedef DBusMessage *(*DRouteFunction)         (DBusConnection *, DBusMessage *, void *);
typedef dbus_bool_t  (*DRoutePropertyFunction) (DBusMessageIter *, void *);
typedef gchar *(*DRouteIntrospectChildrenFunction) (const char *, void *);

typedef void        *(*DRouteGetDatumFunction) (const char *, void *);

typedef struct _DRouteMethod DRouteMethod;
struct _DRouteMethod
{
    DRouteFunction func;
    const char *name;
};

typedef struct _DRouteProperty DRouteProperty;
struct _DRouteProperty
{
    DRoutePropertyFunction get;
    DRoutePropertyFunction set;
    const char *name;
};

/*---------------------------------------------------------------------------*/

typedef struct _DRouteContext DRouteContext;

typedef struct _DRoutePath    DRoutePath;

/*---------------------------------------------------------------------------*/

DRouteContext *
droute_new      ();

void
droute_free     (DRouteContext *cnx);

DRoutePath *
droute_add_one  (DRouteContext *cnx,
                 const char    *path,
                 const void    *data);

DRoutePath *
droute_add_many (DRouteContext *cnx,
                 const char    *path,
                 const void    *data,
                 DRouteIntrospectChildrenFunction introspect_children_cb,
                 void *introspect_children_data,
                 const DRouteGetDatumFunction get_datum);

void
droute_path_add_interface (DRoutePath *path,
                           const char *name,
                           const char *introspect,
                           const DRouteMethod   *methods,
                           const DRouteProperty *properties);

DBusMessage *
droute_not_yet_handled_error   (DBusMessage *message);

DBusMessage *
droute_invalid_arguments_error (DBusMessage *message);

DBusMessage *
droute_out_of_memory_error     (DBusMessage *message);

void
droute_path_register (DRoutePath *path, DBusConnection *bus);

void
droute_path_unregister (DRoutePath *path, DBusConnection *bus);

void
droute_context_register (DRouteContext *cnx, DBusConnection *bus);

void
droute_context_unregister (DRouteContext *cnx, DBusConnection *bus);

void
droute_intercept_dbus (DBusConnection *connection);

void
droute_unintercept_dbus (DBusConnection *connection);
#endif /* _DROUTE_H */