policy.h 3.22 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27
/* -*- mode: C; c-file-style: "gnu" -*- */
/* policy.h  Policies for what a connection can do
 *
 * Copyright (C) 2003  Red Hat, Inc.
 *
 * Licensed under the Academic Free License version 1.2
 * 
 * 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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 */

#ifndef BUS_POLICY_H
#define BUS_POLICY_H

#include <dbus/dbus.h>
28
#include <dbus/dbus-string.h>
29 30 31 32
#include "bus.h"

typedef enum
{
33 34
  BUS_POLICY_RULE_SEND,
  BUS_POLICY_RULE_RECEIVE,
35 36 37
  BUS_POLICY_RULE_OWN,
  BUS_POLICY_RULE_USER,
  BUS_POLICY_RULE_GROUP
38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69
} BusPolicyRuleType;

struct BusPolicyRule
{
  int refcount;
  
  BusPolicyRuleType type;

  unsigned int allow : 1; /**< #TRUE if this allows, #FALSE if it denies */
  
  union
  {
    struct
    {
      /* either can be NULL meaning "any" */
      char *message_name;
      char *destination;
    } send;

    struct
    {
      /* either can be NULL meaning "any" */
      char *message_name;
      char *origin;
    } receive;

    struct
    {
      /* can be NULL meaning "any" */
      char *service_name;
    } own;

70 71 72 73 74 75 76 77 78 79 80 81
    struct
    {
      char *user;
      unsigned long uid;
    } user;

    struct
    {
      char *group;
      unsigned long gid;
    } group;
    
82 83 84 85 86 87 88 89 90
  } d;
};

BusPolicyRule* bus_policy_rule_new   (BusPolicyRuleType type,
                                      dbus_bool_t       allow);
void           bus_policy_rule_ref   (BusPolicyRule    *rule);
void           bus_policy_rule_unref (BusPolicyRule    *rule);

BusPolicy*  bus_policy_new               (void);
91 92 93 94 95 96 97 98 99 100 101 102 103
void        bus_policy_ref               (BusPolicy        *policy);
void        bus_policy_unref             (BusPolicy        *policy);
dbus_bool_t bus_policy_check_can_send    (BusPolicy        *policy,
                                          BusRegistry      *registry,
                                          DBusConnection   *receiver,
                                          DBusMessage      *message);
dbus_bool_t bus_policy_check_can_receive (BusPolicy        *policy,
                                          BusRegistry      *registry,
                                          DBusConnection   *sender,
                                          DBusMessage      *message);
dbus_bool_t bus_policy_check_can_own     (BusPolicy        *policy,
                                          DBusConnection   *connection,
                                          const DBusString *service_name);
104 105 106
dbus_bool_t bus_policy_append_rule       (BusPolicy        *policy,
                                          BusPolicyRule    *rule);
void        bus_policy_optimize          (BusPolicy        *policy);
107 108

#endif /* BUS_POLICY_H */