blob: 056dd9faa4946934d274b5b62daeaaed2b12e857 [file] [log] [blame]
Emeric Vigier2f625822012-08-06 11:09:52 -04001/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
2/* services.h Service management
3 *
4 * Copyright (C) 2003 Red Hat, Inc.
5 *
6 * Licensed under the Academic Free License version 2.1
7 *
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21 *
22 */
23
24#ifndef BUS_SERVICES_H
25#define BUS_SERVICES_H
26
27#include <dbus/dbus.h>
28#include <dbus/dbus-string.h>
29#include <dbus/dbus-hash.h>
30#include "connection.h"
31#include "bus.h"
32
33typedef void (* BusServiceForeachFunction) (BusService *service,
34 void *data);
35
36BusRegistry* bus_registry_new (BusContext *context);
37BusRegistry* bus_registry_ref (BusRegistry *registry);
38void bus_registry_unref (BusRegistry *registry);
39BusService* bus_registry_lookup (BusRegistry *registry,
40 const DBusString *service_name);
41BusService* bus_registry_ensure (BusRegistry *registry,
42 const DBusString *service_name,
43 DBusConnection *owner_connection_if_created,
44 dbus_uint32_t flags,
45 BusTransaction *transaction,
46 DBusError *error);
47void bus_registry_foreach (BusRegistry *registry,
48 BusServiceForeachFunction function,
49 void *data);
50dbus_bool_t bus_registry_list_services (BusRegistry *registry,
51 char ***listp,
52 int *array_len);
53dbus_bool_t bus_registry_acquire_service (BusRegistry *registry,
54 DBusConnection *connection,
55 const DBusString *service_name,
56 dbus_uint32_t flags,
57 dbus_uint32_t *result,
58 BusTransaction *transaction,
59 DBusError *error);
60dbus_bool_t bus_registry_release_service (BusRegistry *registry,
61 DBusConnection *connection,
62 const DBusString *service_name,
63 dbus_uint32_t *result,
64 BusTransaction *transaction,
65 DBusError *error);
66dbus_bool_t bus_registry_set_service_context_table (BusRegistry *registry,
67 DBusHashTable *table);
68
69BusService* bus_service_ref (BusService *service);
70void bus_service_unref (BusService *service);
71dbus_bool_t bus_service_add_owner (BusService *service,
72 DBusConnection *connection,
73 dbus_uint32_t flags,
74 BusTransaction *transaction,
75 DBusError *error);
76dbus_bool_t bus_service_swap_owner (BusService *service,
77 DBusConnection *connection,
78 BusTransaction *transaction,
79 DBusError *error);
80dbus_bool_t bus_service_remove_owner (BusService *service,
81 DBusConnection *connection,
82 BusTransaction *transaction,
83 DBusError *error);
84dbus_bool_t bus_service_has_owner (BusService *service,
85 DBusConnection *connection);
86BusOwner* bus_service_get_primary_owner (BusService *service);
87dbus_bool_t bus_service_get_allow_replacement (BusService *service);
88const char* bus_service_get_name (BusService *service);
89dbus_bool_t bus_service_list_queued_owners (BusService *service,
90 DBusList **return_list,
91 DBusError *error);
92
93DBusConnection* bus_service_get_primary_owners_connection (BusService *service);
94#endif /* BUS_SERVICES_H */