1 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */ 2 /* bus.h message bus context object 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_BUS_H 25 #define BUS_BUS_H 26 27 #include <dbus/dbus.h> 28 #include <dbus/dbus-string.h> 29 #include <dbus/dbus-mainloop.h> 30 #include <dbus/dbus-pipe.h> 31 #include <dbus/dbus-sysdeps.h> 32 33 typedef struct BusActivation BusActivation; 34 typedef struct BusConnections BusConnections; 35 typedef struct BusContext BusContext; 36 typedef struct BusPolicy BusPolicy; 37 typedef struct BusClientPolicy BusClientPolicy; 38 typedef struct BusPolicyRule BusPolicyRule; 39 typedef struct BusRegistry BusRegistry; 40 typedef struct BusSELinuxID BusSELinuxID; 41 typedef struct BusAppArmorConfinement BusAppArmorConfinement; 42 typedef struct BusService BusService; 43 typedef struct BusOwner BusOwner; 44 typedef struct BusTransaction BusTransaction; 45 typedef struct BusMatchmaker BusMatchmaker; 46 typedef struct BusMatchRule BusMatchRule; 47 typedef struct BusActivationEntry BusActivationEntry; 48 49 typedef struct 50 { 51 long max_incoming_bytes; /**< How many incoming message bytes for a single connection */ 52 long max_incoming_unix_fds; /**< How many incoming message unix fds for a single connection */ 53 long max_outgoing_bytes; /**< How many outgoing bytes can be queued for a single connection */ 54 long max_outgoing_unix_fds; /**< How many outgoing unix fds can be queued for a single connection */ 55 long max_message_size; /**< Max size of a single message in bytes */ 56 long max_message_unix_fds; /**< Max number of unix fds of a single message*/ 57 int activation_timeout; /**< How long to wait for an activation to time out */ 58 int auth_timeout; /**< How long to wait for an authentication to time out */ 59 int pending_fd_timeout; /**< How long to wait for a D-Bus message with a fd to time out */ 60 int max_completed_connections; /**< Max number of authorized connections */ 61 int max_incomplete_connections; /**< Max number of incomplete connections */ 62 int max_connections_per_user; /**< Max number of connections auth'd as same user */ 63 int max_pending_activations; /**< Max number of pending activations for the entire bus */ 64 int max_services_per_connection; /**< Max number of owned services for a single connection */ 65 int max_match_rules_per_connection; /**< Max number of match rules for a single connection */ 66 int max_replies_per_connection; /**< Max number of replies that can be pending for each connection */ 67 int reply_timeout; /**< How long to wait before timing out a reply */ 68 } BusLimits; 69 70 typedef enum 71 { 72 BUS_CONTEXT_FLAG_NONE = 0, 73 BUS_CONTEXT_FLAG_FORK_ALWAYS = (1 << 1), 74 BUS_CONTEXT_FLAG_FORK_NEVER = (1 << 2), 75 BUS_CONTEXT_FLAG_WRITE_PID_FILE = (1 << 3), 76 BUS_CONTEXT_FLAG_SYSTEMD_ACTIVATION = (1 << 4), 77 BUS_CONTEXT_FLAG_SYSLOG_ALWAYS = (1 << 5), 78 BUS_CONTEXT_FLAG_SYSLOG_NEVER = (1 << 6), 79 BUS_CONTEXT_FLAG_SYSLOG_ONLY = (1 << 7) 80 } BusContextFlags; 81 82 BusContext* bus_context_new (const DBusString *config_file, 83 BusContextFlags flags, 84 DBusPipe *print_addr_pipe, 85 DBusPipe *print_pid_pipe, 86 const DBusString *address, 87 DBusError *error); 88 dbus_bool_t bus_context_reload_config (BusContext *context, 89 DBusError *error); 90 void bus_context_shutdown (BusContext *context); 91 BusContext* bus_context_ref (BusContext *context); 92 void bus_context_unref (BusContext *context); 93 dbus_bool_t bus_context_get_id (BusContext *context, 94 DBusString *uuid); 95 const char* bus_context_get_type (BusContext *context); 96 const char* bus_context_get_address (BusContext *context); 97 const char* bus_context_get_servicehelper (BusContext *context); 98 dbus_bool_t bus_context_get_systemd_activation (BusContext *context); 99 BusRegistry* bus_context_get_registry (BusContext *context); 100 BusConnections* bus_context_get_connections (BusContext *context); 101 BusActivation* bus_context_get_activation (BusContext *context); 102 BusMatchmaker* bus_context_get_matchmaker (BusContext *context); 103 DBusLoop* bus_context_get_loop (BusContext *context); 104 dbus_bool_t bus_context_allow_unix_user (BusContext *context, 105 unsigned long uid); 106 dbus_bool_t bus_context_allow_windows_user (BusContext *context, 107 const char *windows_sid); 108 BusPolicy* bus_context_get_policy (BusContext *context); 109 110 BusClientPolicy* bus_context_create_client_policy (BusContext *context, 111 DBusConnection *connection, 112 DBusError *error); 113 int bus_context_get_activation_timeout (BusContext *context); 114 int bus_context_get_auth_timeout (BusContext *context); 115 int bus_context_get_pending_fd_timeout (BusContext *context); 116 int bus_context_get_max_completed_connections (BusContext *context); 117 int bus_context_get_max_incomplete_connections (BusContext *context); 118 int bus_context_get_max_connections_per_user (BusContext *context); 119 int bus_context_get_max_pending_activations (BusContext *context); 120 int bus_context_get_max_services_per_connection (BusContext *context); 121 int bus_context_get_max_match_rules_per_connection (BusContext *context); 122 int bus_context_get_max_replies_per_connection (BusContext *context); 123 int bus_context_get_reply_timeout (BusContext *context); 124 DBusRLimit * bus_context_get_initial_fd_limit (BusContext *context); 125 dbus_bool_t bus_context_get_using_syslog (BusContext *context); 126 void bus_context_log (BusContext *context, 127 DBusSystemLogSeverity severity, 128 const char *msg, 129 ...) _DBUS_GNUC_PRINTF (3, 4); 130 void bus_context_log_literal (BusContext *context, 131 DBusSystemLogSeverity severity, 132 const char *msg); 133 void bus_context_log_and_set_error (BusContext *context, 134 DBusSystemLogSeverity severity, 135 DBusError *error, 136 const char *name, 137 const char *msg, 138 ...) _DBUS_GNUC_PRINTF (5, 6); 139 dbus_bool_t bus_context_check_security_policy (BusContext *context, 140 BusTransaction *transaction, 141 DBusConnection *sender, 142 DBusConnection *addressed_recipient, 143 DBusConnection *proposed_recipient, 144 DBusMessage *message, 145 BusActivationEntry *activation_entry, 146 DBusError *error); 147 void bus_context_check_all_watches (BusContext *context); 148 149 #endif /* BUS_BUS_H */ 150