1: /* -*- mode: C; c-file-style: "gnu" -*- */
    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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
   21:  *
   22:  */
   23: 
   24: #ifndef BUS_BUS_H
   25: #define BUS_BUS_H
   26: 
   27: #include <config.h>
   28: 
   29: #include <dbus/dbus.h>
   30: #include <dbus/dbus-string.h>
   31: #include <dbus/dbus-mainloop.h>
   32: #include <dbus/dbus-userdb.h>
   33: 
   34: typedef struct BusActivation    BusActivation;
   35: typedef struct BusConnections   BusConnections;
   36: typedef struct BusContext       BusContext;
   37: typedef struct BusPolicy        BusPolicy;
   38: typedef struct BusClientPolicy  BusClientPolicy;
   39: typedef struct BusPolicyRule    BusPolicyRule;
   40: typedef struct BusRegistry      BusRegistry;
   41: typedef struct BusSELinuxID     BusSELinuxID;
   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: 
   48: typedef struct
   49: {
   50:   long max_incoming_bytes;          /**< How many incoming message bytes for a single connection */
   51:   long max_outgoing_bytes;          /**< How many outgoing bytes can be queued for a single connection */
   52:   long max_message_size;            /**< Max size of a single message in bytes */
   53:   int activation_timeout;           /**< How long to wait for an activation to time out */
   54:   int auth_timeout;                 /**< How long to wait for an authentication to time out */
   55:   int max_completed_connections;    /**< Max number of authorized connections */
   56:   int max_incomplete_connections;   /**< Max number of incomplete connections */
   57:   int max_connections_per_user;     /**< Max number of connections auth'd as same user */
   58:   int max_pending_activations;      /**< Max number of pending activations for the entire bus */
   59:   int max_services_per_connection;  /**< Max number of owned services for a single connection */
   60:   int max_match_rules_per_connection; /**< Max number of match rules for a single connection */
   61:   int max_replies_per_connection;     /**< Max number of replies that can be pending for each connection */
   62:   int reply_timeout;                  /**< How long to wait before timing out a reply */
   63: } BusLimits;
   64: 
   65: typedef enum
   66: {
   67:   FORK_FOLLOW_CONFIG_FILE,
   68:   FORK_ALWAYS,
   69:   FORK_NEVER
   70: } ForceForkSetting;
   71: 
   72: BusContext*       bus_context_new                                (const DBusString *config_file,
   73:                                                                   ForceForkSetting  force_fork,
   74:                                                                   int               print_addr_fd,
   75:                                                                   int               print_pid_fd,
   76:                                                                   DBusError        *error);
   77: dbus_bool_t       bus_context_reload_config                      (BusContext       *context,
   78:                                                                   DBusError        *error);
   79: void              bus_context_shutdown                           (BusContext       *context);
   80: BusContext*       bus_context_ref                                (BusContext       *context);
   81: void              bus_context_unref                              (BusContext       *context);
   82: const char*       bus_context_get_type                           (BusContext       *context);
   83: const char*       bus_context_get_address                        (BusContext       *context);
   84: BusRegistry*      bus_context_get_registry                       (BusContext       *context);
   85: BusConnections*   bus_context_get_connections                    (BusContext       *context);
   86: BusActivation*    bus_context_get_activation                     (BusContext       *context);
   87: BusMatchmaker*    bus_context_get_matchmaker                     (BusContext       *context);
   88: DBusLoop*         bus_context_get_loop                           (BusContext       *context);
   89: DBusUserDatabase* bus_context_get_user_database                  (BusContext       *context);
   90: 
   91: dbus_bool_t       bus_context_allow_user                         (BusContext       *context,
   92:                                                                   unsigned long     uid);
   93: BusPolicy*        bus_context_get_policy                         (BusContext       *context);
   94: 
   95: BusClientPolicy*  bus_context_create_client_policy               (BusContext       *context,
   96:                                                                   DBusConnection   *connection,
   97:                                                                   DBusError        *error);
   98: int               bus_context_get_activation_timeout             (BusContext       *context);
   99: int               bus_context_get_auth_timeout                   (BusContext       *context);
  100: int               bus_context_get_max_completed_connections      (BusContext       *context);
  101: int               bus_context_get_max_incomplete_connections     (BusContext       *context);
  102: int               bus_context_get_max_connections_per_user       (BusContext       *context);
  103: int               bus_context_get_max_pending_activations        (BusContext       *context);
  104: int               bus_context_get_max_services_per_connection    (BusContext       *context);
  105: int               bus_context_get_max_match_rules_per_connection (BusContext       *context);
  106: int               bus_context_get_max_replies_per_connection     (BusContext       *context);
  107: int               bus_context_get_reply_timeout                  (BusContext       *context);
  108: dbus_bool_t       bus_context_check_security_policy              (BusContext       *context,
  109:                                                                   BusTransaction   *transaction,
  110:                                                                   DBusConnection   *sender,
  111:                                                                   DBusConnection   *addressed_recipient,
  112:                                                                   DBusConnection   *proposed_recipient,
  113:                                                                   DBusMessage      *message,
  114:                                                                   DBusError        *error);
  115: 
  116: #endif /* BUS_BUS_H */