mirror of
https://gitlab.freedesktop.org/dbus/dbus.git
synced 2026-01-07 15:50:21 +01:00
2b8c1b0813
Signed-off-by: Simon McVittie <smcv@collabora.com> Reviewed-by: Philip Withnall <withnall@endlessm.com> Bug: https://bugs.freedesktop.org/show_bug.cgi?id=107739
169 lines
11 KiB
C
169 lines
11 KiB
C
/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
|
|
/* bus.h message bus context object
|
|
*
|
|
* 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_BUS_H
|
|
#define BUS_BUS_H
|
|
|
|
#include <dbus/dbus.h>
|
|
#include <dbus/dbus-string.h>
|
|
#include <dbus/dbus-mainloop.h>
|
|
#include <dbus/dbus-pipe.h>
|
|
#include <dbus/dbus-sysdeps.h>
|
|
|
|
typedef struct BusActivation BusActivation;
|
|
typedef struct BusConnections BusConnections;
|
|
typedef struct BusContext BusContext;
|
|
typedef struct BusPolicy BusPolicy;
|
|
typedef struct BusClientPolicy BusClientPolicy;
|
|
typedef struct BusPolicyRule BusPolicyRule;
|
|
typedef struct BusRegistry BusRegistry;
|
|
typedef struct BusSELinuxID BusSELinuxID;
|
|
typedef struct BusAppArmorConfinement BusAppArmorConfinement;
|
|
typedef struct BusService BusService;
|
|
typedef struct BusOwner BusOwner;
|
|
typedef struct BusTransaction BusTransaction;
|
|
typedef struct BusMatchmaker BusMatchmaker;
|
|
typedef struct BusMatchRule BusMatchRule;
|
|
typedef struct BusActivationEntry BusActivationEntry;
|
|
typedef struct BusContainers BusContainers;
|
|
|
|
typedef struct
|
|
{
|
|
long max_incoming_bytes; /**< How many incoming message bytes for a single connection */
|
|
long max_incoming_unix_fds; /**< How many incoming message unix fds for a single connection */
|
|
long max_outgoing_bytes; /**< How many outgoing bytes can be queued for a single connection */
|
|
long max_outgoing_unix_fds; /**< How many outgoing unix fds can be queued for a single connection */
|
|
long max_message_size; /**< Max size of a single message in bytes */
|
|
long max_message_unix_fds; /**< Max number of unix fds of a single message*/
|
|
int activation_timeout; /**< How long to wait for an activation to time out */
|
|
int auth_timeout; /**< How long to wait for an authentication to time out */
|
|
int pending_fd_timeout; /**< How long to wait for a D-Bus message with a fd to time out */
|
|
int max_completed_connections; /**< Max number of authorized connections */
|
|
int max_incomplete_connections; /**< Max number of incomplete connections */
|
|
int max_connections_per_user; /**< Max number of connections auth'd as same user */
|
|
int max_pending_activations; /**< Max number of pending activations for the entire bus */
|
|
int max_services_per_connection; /**< Max number of owned services for a single connection */
|
|
int max_match_rules_per_connection; /**< Max number of match rules for a single connection */
|
|
int max_replies_per_connection; /**< Max number of replies that can be pending for each connection */
|
|
int reply_timeout; /**< How long to wait before timing out a reply */
|
|
int max_containers; /**< Max number of restricted servers for app-containers */
|
|
int max_containers_per_user; /**< Max number of restricted servers for app-containers, per user */
|
|
int max_connections_per_container; /**< Max number of connections per restricted server */
|
|
int max_container_metadata_bytes; /**< Max number of bytes of metadata per restricted server */
|
|
} BusLimits;
|
|
|
|
typedef enum
|
|
{
|
|
BUS_CONTEXT_FLAG_NONE = 0,
|
|
BUS_CONTEXT_FLAG_FORK_ALWAYS = (1 << 1),
|
|
BUS_CONTEXT_FLAG_FORK_NEVER = (1 << 2),
|
|
BUS_CONTEXT_FLAG_WRITE_PID_FILE = (1 << 3),
|
|
BUS_CONTEXT_FLAG_SYSTEMD_ACTIVATION = (1 << 4),
|
|
BUS_CONTEXT_FLAG_SYSLOG_ALWAYS = (1 << 5),
|
|
BUS_CONTEXT_FLAG_SYSLOG_NEVER = (1 << 6),
|
|
BUS_CONTEXT_FLAG_SYSLOG_ONLY = (1 << 7)
|
|
} BusContextFlags;
|
|
|
|
BusContext* bus_context_new (const DBusString *config_file,
|
|
BusContextFlags flags,
|
|
DBusPipe *print_addr_pipe,
|
|
DBusPipe *print_pid_pipe,
|
|
const DBusString *address,
|
|
DBusError *error);
|
|
dbus_bool_t bus_context_reload_config (BusContext *context,
|
|
DBusError *error);
|
|
void bus_context_shutdown (BusContext *context);
|
|
BusContext* bus_context_ref (BusContext *context);
|
|
void bus_context_unref (BusContext *context);
|
|
dbus_bool_t bus_context_get_id (BusContext *context,
|
|
DBusString *uuid);
|
|
const char* bus_context_get_type (BusContext *context);
|
|
const char* bus_context_get_address (BusContext *context);
|
|
const char* bus_context_get_servicehelper (BusContext *context);
|
|
dbus_bool_t bus_context_get_systemd_activation (BusContext *context);
|
|
BusRegistry* bus_context_get_registry (BusContext *context);
|
|
BusConnections* bus_context_get_connections (BusContext *context);
|
|
BusActivation* bus_context_get_activation (BusContext *context);
|
|
BusMatchmaker* bus_context_get_matchmaker (BusContext *context);
|
|
DBusLoop* bus_context_get_loop (BusContext *context);
|
|
dbus_bool_t bus_context_allow_unix_user (BusContext *context,
|
|
unsigned long uid);
|
|
dbus_bool_t bus_context_allow_windows_user (BusContext *context,
|
|
const char *windows_sid);
|
|
BusContainers *bus_context_get_containers (BusContext *context);
|
|
|
|
BusClientPolicy* bus_context_create_client_policy (BusContext *context,
|
|
DBusConnection *connection,
|
|
DBusError *error);
|
|
int bus_context_get_activation_timeout (BusContext *context);
|
|
int bus_context_get_auth_timeout (BusContext *context);
|
|
int bus_context_get_pending_fd_timeout (BusContext *context);
|
|
int bus_context_get_max_completed_connections (BusContext *context);
|
|
int bus_context_get_max_incomplete_connections (BusContext *context);
|
|
int bus_context_get_max_connections_per_user (BusContext *context);
|
|
int bus_context_get_max_pending_activations (BusContext *context);
|
|
int bus_context_get_max_services_per_connection (BusContext *context);
|
|
int bus_context_get_max_match_rules_per_connection (BusContext *context);
|
|
int bus_context_get_max_replies_per_connection (BusContext *context);
|
|
int bus_context_get_reply_timeout (BusContext *context);
|
|
int bus_context_get_max_containers (BusContext *context);
|
|
int bus_context_get_max_containers_per_user (BusContext *context);
|
|
int bus_context_get_max_container_metadata_bytes (BusContext *context);
|
|
int bus_context_get_max_connections_per_container (BusContext *context);
|
|
DBusRLimit * bus_context_get_initial_fd_limit (BusContext *context);
|
|
dbus_bool_t bus_context_get_using_syslog (BusContext *context);
|
|
void bus_context_log (BusContext *context,
|
|
DBusSystemLogSeverity severity,
|
|
const char *msg,
|
|
...) _DBUS_GNUC_PRINTF (3, 4);
|
|
void bus_context_log_literal (BusContext *context,
|
|
DBusSystemLogSeverity severity,
|
|
const char *msg);
|
|
void bus_context_log_and_set_error (BusContext *context,
|
|
DBusSystemLogSeverity severity,
|
|
DBusError *error,
|
|
const char *name,
|
|
const char *msg,
|
|
...) _DBUS_GNUC_PRINTF (5, 6);
|
|
dbus_bool_t bus_context_check_security_policy (BusContext *context,
|
|
BusTransaction *transaction,
|
|
DBusConnection *sender,
|
|
DBusConnection *addressed_recipient,
|
|
DBusConnection *proposed_recipient,
|
|
DBusMessage *message,
|
|
BusActivationEntry *activation_entry,
|
|
DBusError *error);
|
|
void bus_context_check_all_watches (BusContext *context);
|
|
dbus_bool_t bus_context_setup_server (BusContext *context,
|
|
DBusServer *server,
|
|
DBusError *error);
|
|
dbus_bool_t bus_context_add_incoming_connection (BusContext *context,
|
|
DBusConnection *new_connection);
|
|
|
|
#ifdef DBUS_ENABLE_EMBEDDED_TESTS
|
|
void bus_context_quiet_log_begin (BusContext *context);
|
|
void bus_context_quiet_log_end (BusContext *context);
|
|
dbus_bool_t bus_context_get_quiet_log (BusContext *context);
|
|
#endif
|
|
|
|
#endif /* BUS_BUS_H */
|