1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/os/ossrv/ofdbus/dbus/bus/policy.h Fri Jun 15 03:10:57 2012 +0200
1.3 @@ -0,0 +1,164 @@
1.4 +/* -*- mode: C; c-file-style: "gnu" -*- */
1.5 +/* policy.h Bus security policy
1.6 + *
1.7 + * Copyright (C) 2003 Red Hat, Inc.
1.8 + * Portion Copyright © 2008 Nokia Corporation and/or its subsidiary(-ies). All rights reserved.
1.9 + * Licensed under the Academic Free License version 2.1
1.10 + *
1.11 + * This program is free software; you can redistribute it and/or modify
1.12 + * it under the terms of the GNU General Public License as published by
1.13 + * the Free Software Foundation; either version 2 of the License, or
1.14 + * (at your option) any later version.
1.15 + *
1.16 + * This program is distributed in the hope that it will be useful,
1.17 + * but WITHOUT ANY WARRANTY; without even the implied warranty of
1.18 + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1.19 + * GNU General Public License for more details.
1.20 + *
1.21 + * You should have received a copy of the GNU General Public License
1.22 + * along with this program; if not, write to the Free Software
1.23 + * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
1.24 + *
1.25 + */
1.26 +
1.27 +#ifndef BUS_POLICY_H
1.28 +#define BUS_POLICY_H
1.29 +
1.30 +#include <dbus/dbus.h>
1.31 +#ifndef __SYMBIAN32__
1.32 +#include <dbus/dbus-string.h>
1.33 +#include <dbus/dbus-list.h>
1.34 +#include <dbus/dbus-sysdeps.h>
1.35 +#else
1.36 +#include "dbus-string.h"
1.37 +#include "dbus-list.h"
1.38 +#include "dbus-sysdeps.h"
1.39 +#endif //__SYMBIAN32__
1.40 +#include "bus.h"
1.41 +
1.42 +typedef enum
1.43 +{
1.44 + BUS_POLICY_RULE_SEND,
1.45 + BUS_POLICY_RULE_RECEIVE,
1.46 + BUS_POLICY_RULE_OWN,
1.47 + BUS_POLICY_RULE_USER,
1.48 + BUS_POLICY_RULE_GROUP
1.49 +} BusPolicyRuleType;
1.50 +
1.51 +/** determines whether the rule affects a connection, or some global item */
1.52 +#define BUS_POLICY_RULE_IS_PER_CLIENT(rule) (!((rule)->type == BUS_POLICY_RULE_USER || \
1.53 + (rule)->type == BUS_POLICY_RULE_GROUP))
1.54 +
1.55 +struct BusPolicyRule
1.56 +{
1.57 + int refcount;
1.58 +
1.59 + BusPolicyRuleType type;
1.60 +
1.61 + unsigned int allow : 1; /**< #TRUE if this allows, #FALSE if it denies */
1.62 +
1.63 + union
1.64 + {
1.65 + struct
1.66 + {
1.67 + /* message type can be DBUS_MESSAGE_TYPE_INVALID meaning "any" */
1.68 + int message_type;
1.69 + /* any of these can be NULL meaning "any" */
1.70 + char *path;
1.71 + char *interface;
1.72 + char *member;
1.73 + char *error;
1.74 + char *destination;
1.75 + unsigned int requested_reply : 1;
1.76 + } send;
1.77 +
1.78 + struct
1.79 + {
1.80 + /* message type can be DBUS_MESSAGE_TYPE_INVALID meaning "any" */
1.81 + int message_type;
1.82 + /* any of these can be NULL meaning "any" */
1.83 + char *path;
1.84 + char *interface;
1.85 + char *member;
1.86 + char *error;
1.87 + char *origin;
1.88 + unsigned int eavesdrop : 1;
1.89 + unsigned int requested_reply : 1;
1.90 + } receive;
1.91 +
1.92 + struct
1.93 + {
1.94 + /* can be NULL meaning "any" */
1.95 + char *service_name;
1.96 + } own;
1.97 +
1.98 + struct
1.99 + {
1.100 + /* can be DBUS_UID_UNSET meaning "any" */
1.101 + dbus_uid_t uid;
1.102 + } user;
1.103 +
1.104 + struct
1.105 + {
1.106 + /* can be DBUS_GID_UNSET meaning "any" */
1.107 + dbus_gid_t gid;
1.108 + } group;
1.109 +
1.110 + } d;
1.111 +};
1.112 +
1.113 +BusPolicyRule* bus_policy_rule_new (BusPolicyRuleType type,
1.114 + dbus_bool_t allow);
1.115 +BusPolicyRule* bus_policy_rule_ref (BusPolicyRule *rule);
1.116 +void bus_policy_rule_unref (BusPolicyRule *rule);
1.117 +
1.118 +BusPolicy* bus_policy_new (void);
1.119 +BusPolicy* bus_policy_ref (BusPolicy *policy);
1.120 +void bus_policy_unref (BusPolicy *policy);
1.121 +BusClientPolicy* bus_policy_create_client_policy (BusPolicy *policy,
1.122 + DBusConnection *connection,
1.123 + DBusError *error);
1.124 +dbus_bool_t bus_policy_allow_user (BusPolicy *policy,
1.125 + DBusUserDatabase *user_database,
1.126 + unsigned long uid);
1.127 +dbus_bool_t bus_policy_append_default_rule (BusPolicy *policy,
1.128 + BusPolicyRule *rule);
1.129 +dbus_bool_t bus_policy_append_mandatory_rule (BusPolicy *policy,
1.130 + BusPolicyRule *rule);
1.131 +dbus_bool_t bus_policy_append_user_rule (BusPolicy *policy,
1.132 + dbus_uid_t uid,
1.133 + BusPolicyRule *rule);
1.134 +dbus_bool_t bus_policy_append_group_rule (BusPolicy *policy,
1.135 + dbus_gid_t gid,
1.136 + BusPolicyRule *rule);
1.137 +dbus_bool_t bus_policy_append_console_rule (BusPolicy *policy,
1.138 + dbus_bool_t at_console,
1.139 + BusPolicyRule *rule);
1.140 +
1.141 +dbus_bool_t bus_policy_merge (BusPolicy *policy,
1.142 + BusPolicy *to_absorb);
1.143 +
1.144 +BusClientPolicy* bus_client_policy_new (void);
1.145 +BusClientPolicy* bus_client_policy_ref (BusClientPolicy *policy);
1.146 +void bus_client_policy_unref (BusClientPolicy *policy);
1.147 +dbus_bool_t bus_client_policy_check_can_send (BusClientPolicy *policy,
1.148 + BusRegistry *registry,
1.149 + dbus_bool_t requested_reply,
1.150 + DBusConnection *receiver,
1.151 + DBusMessage *message);
1.152 +dbus_bool_t bus_client_policy_check_can_receive (BusClientPolicy *policy,
1.153 + BusRegistry *registry,
1.154 + dbus_bool_t requested_reply,
1.155 + DBusConnection *sender,
1.156 + DBusConnection *addressed_recipient,
1.157 + DBusConnection *proposed_recipient,
1.158 + DBusMessage *message);
1.159 +dbus_bool_t bus_client_policy_check_can_own (BusClientPolicy *policy,
1.160 + DBusConnection *connection,
1.161 + const DBusString *service_name);
1.162 +dbus_bool_t bus_client_policy_append_rule (BusClientPolicy *policy,
1.163 + BusPolicyRule *rule);
1.164 +void bus_client_policy_optimize (BusClientPolicy *policy);
1.165 +
1.166 +
1.167 +#endif /* BUS_POLICY_H */