mirror of
https://gitlab.freedesktop.org/dbus/dbus.git
synced 2026-01-01 09:20:11 +01:00
7389460247
This makes it clearer that the only possible error is out-of-memory, so its use in ListQueuedOwners() is not leaking information to callers that might not be allowed to know the difference between "doesn't exist" and "exists but you are not allowed to know that". Signed-off-by: Simon McVittie <smcv@collabora.com> Reviewed-by: Philip Withnall <withnall@endlessm.com> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=105656
93 lines
5.5 KiB
C
93 lines
5.5 KiB
C
/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
|
|
/* services.h Service management
|
|
*
|
|
* Copyright (C) 2003 Red Hat, Inc.
|
|
*
|
|
* Licensed under the Academic Free License version 2.1
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program 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 General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
*
|
|
*/
|
|
|
|
#ifndef BUS_SERVICES_H
|
|
#define BUS_SERVICES_H
|
|
|
|
#include <dbus/dbus.h>
|
|
#include <dbus/dbus-string.h>
|
|
#include <dbus/dbus-hash.h>
|
|
#include "connection.h"
|
|
#include "bus.h"
|
|
|
|
typedef void (* BusServiceForeachFunction) (BusService *service,
|
|
void *data);
|
|
|
|
BusRegistry* bus_registry_new (BusContext *context);
|
|
BusRegistry* bus_registry_ref (BusRegistry *registry);
|
|
void bus_registry_unref (BusRegistry *registry);
|
|
BusService* bus_registry_lookup (BusRegistry *registry,
|
|
const DBusString *service_name);
|
|
BusService* bus_registry_ensure (BusRegistry *registry,
|
|
const DBusString *service_name,
|
|
DBusConnection *owner_connection_if_created,
|
|
dbus_uint32_t flags,
|
|
BusTransaction *transaction,
|
|
DBusError *error);
|
|
void bus_registry_foreach (BusRegistry *registry,
|
|
BusServiceForeachFunction function,
|
|
void *data);
|
|
dbus_bool_t bus_registry_list_services (BusRegistry *registry,
|
|
char ***listp,
|
|
int *array_len);
|
|
dbus_bool_t bus_registry_acquire_service (BusRegistry *registry,
|
|
DBusConnection *connection,
|
|
const DBusString *service_name,
|
|
dbus_uint32_t flags,
|
|
dbus_uint32_t *result,
|
|
BusTransaction *transaction,
|
|
DBusError *error);
|
|
dbus_bool_t bus_registry_release_service (BusRegistry *registry,
|
|
DBusConnection *connection,
|
|
const DBusString *service_name,
|
|
dbus_uint32_t *result,
|
|
BusTransaction *transaction,
|
|
DBusError *error);
|
|
dbus_bool_t bus_registry_set_service_context_table (BusRegistry *registry,
|
|
DBusHashTable *table);
|
|
|
|
BusService* bus_service_ref (BusService *service);
|
|
void bus_service_unref (BusService *service);
|
|
dbus_bool_t bus_service_add_owner (BusService *service,
|
|
DBusConnection *connection,
|
|
dbus_uint32_t flags,
|
|
BusTransaction *transaction,
|
|
DBusError *error);
|
|
dbus_bool_t bus_service_swap_owner (BusService *service,
|
|
DBusConnection *connection,
|
|
BusTransaction *transaction,
|
|
DBusError *error);
|
|
dbus_bool_t bus_service_remove_owner (BusService *service,
|
|
DBusConnection *connection,
|
|
BusTransaction *transaction,
|
|
DBusError *error);
|
|
dbus_bool_t bus_service_has_owner (BusService *service,
|
|
DBusConnection *connection);
|
|
BusOwner* bus_service_get_primary_owner (BusService *service);
|
|
dbus_bool_t bus_service_get_allow_replacement (BusService *service);
|
|
const char* bus_service_get_name (BusService *service);
|
|
dbus_bool_t bus_service_list_queued_owners (BusService *service,
|
|
DBusList **return_list);
|
|
|
|
DBusConnection* bus_service_get_primary_owners_connection (BusService *service);
|
|
#endif /* BUS_SERVICES_H */
|