[PATCH] audit inode patch
[linux-2.6.git] / include / linux / selinux.h
1 /*
2  * SELinux services exported to the rest of the kernel.
3  *
4  * Author: James Morris <jmorris@redhat.com>
5  *
6  * Copyright (C) 2005 Red Hat, Inc., James Morris <jmorris@redhat.com>
7  * Copyright (C) 2006 Trusted Computer Solutions, Inc. <dgoeddel@trustedcs.com>
8  *
9  * This program is free software; you can redistribute it and/or modify
10  * it under the terms of the GNU General Public License version 2,
11  * as published by the Free Software Foundation.
12  */
13 #ifndef _LINUX_SELINUX_H
14 #define _LINUX_SELINUX_H
15
16 struct selinux_audit_rule;
17 struct audit_context;
18 struct inode;
19
20 #ifdef CONFIG_SECURITY_SELINUX
21
22 /**
23  *      selinux_audit_rule_init - alloc/init an selinux audit rule structure.
24  *      @field: the field this rule refers to
25  *      @op: the operater the rule uses
26  *      @rulestr: the text "target" of the rule
27  *      @rule: pointer to the new rule structure returned via this
28  *
29  *      Returns 0 if successful, -errno if not.  On success, the rule structure
30  *      will be allocated internally.  The caller must free this structure with
31  *      selinux_audit_rule_free() after use.
32  */
33 int selinux_audit_rule_init(u32 field, u32 op, char *rulestr,
34                             struct selinux_audit_rule **rule);
35
36 /**
37  *      selinux_audit_rule_free - free an selinux audit rule structure.
38  *      @rule: pointer to the audit rule to be freed
39  *
40  *      This will free all memory associated with the given rule.
41  *      If @rule is NULL, no operation is performed.
42  */
43 void selinux_audit_rule_free(struct selinux_audit_rule *rule);
44
45 /**
46  *      selinux_audit_rule_match - determine if a context ID matches a rule.
47  *      @ctxid: the context ID to check
48  *      @field: the field this rule refers to
49  *      @op: the operater the rule uses
50  *      @rule: pointer to the audit rule to check against
51  *      @actx: the audit context (can be NULL) associated with the check
52  *
53  *      Returns 1 if the context id matches the rule, 0 if it does not, and
54  *      -errno on failure.
55  */
56 int selinux_audit_rule_match(u32 ctxid, u32 field, u32 op,
57                              struct selinux_audit_rule *rule,
58                              struct audit_context *actx);
59
60 /**
61  *      selinux_audit_set_callback - set the callback for policy reloads.
62  *      @callback: the function to call when the policy is reloaded
63  *
64  *      This sets the function callback function that will update the rules
65  *      upon policy reloads.  This callback should rebuild all existing rules
66  *      using selinux_audit_rule_init().
67  */
68 void selinux_audit_set_callback(int (*callback)(void));
69
70 /**
71  *      selinux_task_ctxid - determine a context ID for a process.
72  *      @tsk: the task object
73  *      @ctxid: ID value returned via this
74  *
75  *      On return, ctxid will contain an ID for the context.  This value
76  *      should only be used opaquely.
77  */
78 void selinux_task_ctxid(struct task_struct *tsk, u32 *ctxid);
79
80 /**
81  *     selinux_ctxid_to_string - map a security context ID to a string
82  *     @ctxid: security context ID to be converted.
83  *     @ctx: address of context string to be returned
84  *     @ctxlen: length of returned context string.
85  *
86  *     Returns 0 if successful, -errno if not.  On success, the context
87  *     string will be allocated internally, and the caller must call
88  *     kfree() on it after use.
89  */
90 int selinux_ctxid_to_string(u32 ctxid, char **ctx, u32 *ctxlen);
91
92 /**
93  *     selinux_get_inode_sid - get the inode's security context ID
94  *     @inode: inode structure to get the sid from.
95  *     @sid: pointer to security context ID to be filled in.
96  *
97  *     Returns nothing
98  */
99 void selinux_get_inode_sid(const struct inode *inode, u32 *sid);
100
101 #else
102
103 static inline int selinux_audit_rule_init(u32 field, u32 op,
104                                           char *rulestr,
105                                           struct selinux_audit_rule **rule)
106 {
107         return -ENOTSUPP;
108 }
109
110 static inline void selinux_audit_rule_free(struct selinux_audit_rule *rule)
111 {
112         return;
113 }
114
115 static inline int selinux_audit_rule_match(u32 ctxid, u32 field, u32 op,
116                                            struct selinux_audit_rule *rule,
117                                            struct audit_context *actx)
118 {
119         return 0;
120 }
121
122 static inline void selinux_audit_set_callback(int (*callback)(void))
123 {
124         return;
125 }
126
127 static inline void selinux_task_ctxid(struct task_struct *tsk, u32 *ctxid)
128 {
129         *ctxid = 0;
130 }
131
132 static inline int selinux_ctxid_to_string(u32 ctxid, char **ctx, u32 *ctxlen)
133 {
134        *ctx = NULL;
135        *ctxlen = 0;
136        return 0;
137 }
138
139 static inline void selinux_get_inode_sid(const struct inode *inode, u32 *sid)
140 {
141         *sid = 0;
142 }
143
144 #endif  /* CONFIG_SECURITY_SELINUX */
145
146 #endif /* _LINUX_SELINUX_H */