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
28
29
30
31
32
33
34
35
36
37
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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
|
/**
* @file
* Defines the public interface for searching and iterating over avrules.
*
* @author Kevin Carr kcarr@tresys.com
* @author Jeremy A. Mowery jmowery@tresys.com
* @author Jason Tang jtang@tresys.com
*
* Copyright (C) 2006-2007 Tresys Technology, LLC
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/
#ifndef QPOL_AVRULE_QUERY_H
#define QPOL_AVRULE_QUERY_H
#ifdef __cplusplus
extern "C"
{
#endif
#include <qpol/policy.h>
#include <qpol/class_perm_query.h>
#include <qpol/cond_query.h>
#include <qpol/type_query.h>
typedef struct qpol_avrule qpol_avrule_t;
/* rule type defines (values copied from "sepol/policydb/policydb.h") */
#define QPOL_RULE_ALLOW 1
#define QPOL_RULE_NEVERALLOW 128
#define QPOL_RULE_AUDITALLOW 2
/* dontaudit is actually stored as auditdeny so that value is used here */
#define QPOL_RULE_DONTAUDIT 4
/**
* Get an iterator over all av rules in a policy of a rule type in
* rule_type_mask. It is an error to call this function if rules are
* not loaded. Likewise, it is an error if neverallows are requested
* but they were not loaded.
* @param policy Policy from which to get the av rules.
* @param rule_type_mask Bitwise or'ed set of QPOL_RULE_* values.
* It is an error to specify any of QPOL_RULE_TYPE_* in the mask.
* @param iter Iterator over items of type qpol_avrule_t returned.
* The caller is responsible for calling qpol_iterator_destroy()
* to free memory used by this iterator.
* It is important to note that this iterator is only valid as long as
* the policy is unmodifed.
* @returm 0 on success and < 0 on failure; if the call fails,
* errno will be set and *iter will be NULL.
*/
extern int qpol_policy_get_avrule_iter(const qpol_policy_t * policy, uint32_t rule_type_mask, qpol_iterator_t ** iter);
/**
* Get the source type from an av rule.
* @param policy Policy from which the rule comes.
* @param rule The rule from which to get the source type.
* @param source Pointer in which to store the source type.
* The caller should not free this pointer.
* @returm 0 on success and < 0 on failure; if the call fails,
* errno will be set and *source will be NULL.
*/
extern int qpol_avrule_get_source_type(const qpol_policy_t * policy, const qpol_avrule_t * rule,
const qpol_type_t ** source);
/**
* Get the target type from an av rule.
* @param policy Policy from which the rule comes.
* @param rule The rule from which to get the target type.
* @param target Pointer in which to store the target type.
* The caller should not free this pointer.
* @returm 0 on success and < 0 on failure; if the call fails,
* errno will be set and *target will be NULL.
*/
extern int qpol_avrule_get_target_type(const qpol_policy_t * policy, const qpol_avrule_t * rule,
const qpol_type_t ** target);
/**
* Get the object class from an av rule.
* @param policy Policy from which the rule comes.
* @param rule The rule from which to get the object class.
* @param obj_class Pointer in which to store the object class.
* The caller should not free this pointer.
* @returm 0 on success and < 0 on failure; if the call fails,
* errno will be set and *obj_class will be NULL.
*/
extern int qpol_avrule_get_object_class(const qpol_policy_t * policy, const qpol_avrule_t * rule,
const qpol_class_t ** obj_class);
/**
* Get an iterator over the permissions in an av rule.
* @param policy Policy from which the rule comes.
* @param rule The rule from which to get the permissions.
* @param perms Iterator over items of type char* returned.
* The caller is responsible for calling qpol_iterator_destroy()
* to free memory used by this iterator. The caller <b>should call</b>
* <b>free() on the strings returned by qpol_iterator_get_item().</b>
* It is important to note that this iterator is only valid as long as
* the policy is unmodifed.
* @returm 0 on success and < 0 on failure; if the call fails,
* errno will be set and *perms will be NULL.
*/
extern int qpol_avrule_get_perm_iter(const qpol_policy_t * policy, const qpol_avrule_t * rule, qpol_iterator_t ** perms);
/**
* Get the rule type value for an av rule.
* @param policy Policy from which the rule comes.
* @param rule The rule from which to get the rule type.
* @param rule_type Integer in which to store the rule type value.
* The value will be one of the QPOL_RULE_* values above.
* @returm 0 on success and < 0 on failure; if the call fails,
* errno will be set and *rule_type will be 0.
*/
extern int qpol_avrule_get_rule_type(const qpol_policy_t * policy, const qpol_avrule_t * rule, uint32_t * rule_type);
/**
* Get the conditional from which an av rule comes. If the rule
* is not a conditional rule *cond is set to NULL.
* @param policy Policy from which the rule comes.
* @param rule The rule from which to get the conditional.
* @param cond The conditional returned. (NULL if rule is not conditional)
* @return 0 on success and < 0 on failure; if the call fails,
* errno will be set and *cond will be NULL. If the rule is not conditional
* *cond is set to NULL and the function is considered successful.
*/
extern int qpol_avrule_get_cond(const qpol_policy_t * policy, const qpol_avrule_t * rule, const qpol_cond_t ** cond);
/**
* Determine if a rule is enabled. Unconditional rules are always enabled.
* @param policy Policy from which the rule comes.
* @param rule The rule to check.
* @param is_enabled Integer in which to store the result: set to 1 if enabled
* and 0 otherwise.
* @return 0 on success and < 0 on failure; if the call fails,
* errno will be set and *is_enabled will be 0.
*/
extern int qpol_avrule_get_is_enabled(const qpol_policy_t * policy, const qpol_avrule_t * rule, uint32_t * is_enabled);
/**
* Get the list (true or false) in which a conditional rule is. It is
* an error to call this function for an unconditional rule.
* @param policy Policy from which the rule comes.
* @param rule The rule to check.
* @param which_list Integer in which to store the result: set to 1 if
* rule is in the true list or 0 if in the false list.
* @return 0 on success and < 0 on failure; if the call fails,
* errno will be set and *which_list will be 0.
*/
extern int qpol_avrule_get_which_list(const qpol_policy_t * policy, const qpol_avrule_t * rule, uint32_t * which_list);
#ifdef __cplusplus
}
#endif
#endif
|
