blob: 8c2cc4c0252640f7c4d5705b25d845417db65d19 [file] [log] [blame]
Darrel Goeddel376bd9c2006-02-24 15:44:05 -06001/*
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>
Steve Grubbe7c34972006-04-03 09:08:13 -04008 * Copyright (C) 2006 IBM Corporation, Timothy R. Chavez <tinytim@us.ibm.com>
Darrel Goeddel376bd9c2006-02-24 15:44:05 -06009 *
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License version 2,
12 * as published by the Free Software Foundation.
13 */
14#ifndef _LINUX_SELINUX_H
15#define _LINUX_SELINUX_H
16
17struct selinux_audit_rule;
18struct audit_context;
Steve Grubb1b50eed2006-04-03 14:06:13 -040019struct inode;
Steve Grubb9c7aa6a2006-03-31 15:22:49 -050020struct kern_ipc_perm;
Darrel Goeddel376bd9c2006-02-24 15:44:05 -060021
22#ifdef CONFIG_SECURITY_SELINUX
23
24/**
25 * selinux_audit_rule_init - alloc/init an selinux audit rule structure.
26 * @field: the field this rule refers to
27 * @op: the operater the rule uses
28 * @rulestr: the text "target" of the rule
29 * @rule: pointer to the new rule structure returned via this
30 *
31 * Returns 0 if successful, -errno if not. On success, the rule structure
32 * will be allocated internally. The caller must free this structure with
33 * selinux_audit_rule_free() after use.
34 */
35int selinux_audit_rule_init(u32 field, u32 op, char *rulestr,
36 struct selinux_audit_rule **rule);
37
38/**
39 * selinux_audit_rule_free - free an selinux audit rule structure.
40 * @rule: pointer to the audit rule to be freed
41 *
42 * This will free all memory associated with the given rule.
43 * If @rule is NULL, no operation is performed.
44 */
45void selinux_audit_rule_free(struct selinux_audit_rule *rule);
46
47/**
48 * selinux_audit_rule_match - determine if a context ID matches a rule.
Stephen Smalley9a2f44f2006-09-25 23:31:58 -070049 * @sid: the context ID to check
Darrel Goeddel376bd9c2006-02-24 15:44:05 -060050 * @field: the field this rule refers to
51 * @op: the operater the rule uses
52 * @rule: pointer to the audit rule to check against
53 * @actx: the audit context (can be NULL) associated with the check
54 *
55 * Returns 1 if the context id matches the rule, 0 if it does not, and
56 * -errno on failure.
57 */
Stephen Smalley9a2f44f2006-09-25 23:31:58 -070058int selinux_audit_rule_match(u32 sid, u32 field, u32 op,
Darrel Goeddel376bd9c2006-02-24 15:44:05 -060059 struct selinux_audit_rule *rule,
60 struct audit_context *actx);
61
62/**
63 * selinux_audit_set_callback - set the callback for policy reloads.
64 * @callback: the function to call when the policy is reloaded
65 *
66 * This sets the function callback function that will update the rules
67 * upon policy reloads. This callback should rebuild all existing rules
68 * using selinux_audit_rule_init().
69 */
70void selinux_audit_set_callback(int (*callback)(void));
71
72/**
Stephen Smalley1a70cd42006-09-25 23:31:57 -070073 * selinux_sid_to_string - map a security context ID to a string
74 * @sid: security context ID to be converted.
Steve Grubb1b50eed2006-04-03 14:06:13 -040075 * @ctx: address of context string to be returned
76 * @ctxlen: length of returned context string.
77 *
78 * Returns 0 if successful, -errno if not. On success, the context
79 * string will be allocated internally, and the caller must call
80 * kfree() on it after use.
81 */
Stephen Smalley1a70cd42006-09-25 23:31:57 -070082int selinux_sid_to_string(u32 sid, char **ctx, u32 *ctxlen);
Steve Grubb1b50eed2006-04-03 14:06:13 -040083
84/**
85 * selinux_get_inode_sid - get the inode's security context ID
86 * @inode: inode structure to get the sid from.
87 * @sid: pointer to security context ID to be filled in.
88 *
89 * Returns nothing
90 */
91void selinux_get_inode_sid(const struct inode *inode, u32 *sid);
92
Steve Grubb9c7aa6a2006-03-31 15:22:49 -050093/**
94 * selinux_get_ipc_sid - get the ipc security context ID
95 * @ipcp: ipc structure to get the sid from.
96 * @sid: pointer to security context ID to be filled in.
97 *
98 * Returns nothing
99 */
100void selinux_get_ipc_sid(const struct kern_ipc_perm *ipcp, u32 *sid);
101
Steve Grubbe7c34972006-04-03 09:08:13 -0400102/**
103 * selinux_get_task_sid - return the SID of task
104 * @tsk: the task whose SID will be returned
105 * @sid: pointer to security context ID to be filled in.
106 *
107 * Returns nothing
108 */
109void selinux_get_task_sid(struct task_struct *tsk, u32 *sid);
110
James Morrisc749b292006-06-09 00:28:25 -0700111/**
112 * selinux_string_to_sid - map a security context string to a security ID
113 * @str: the security context string to be mapped
114 * @sid: ID value returned via this.
115 *
116 * Returns 0 if successful, with the SID stored in sid. A value
117 * of zero for sid indicates no SID could be determined (but no error
118 * occurred).
119 */
120int selinux_string_to_sid(char *str, u32 *sid);
121
122/**
Paul Moored621d352008-01-29 08:43:36 -0500123 * selinux_secmark_relabel_packet_permission - secmark permission check
124 * @sid: SECMARK ID value to be applied to network packet
James Morrisc749b292006-06-09 00:28:25 -0700125 *
Paul Moored621d352008-01-29 08:43:36 -0500126 * Returns 0 if the current task is allowed to set the SECMARK label of
127 * packets with the supplied security ID. Note that it is implicit that
128 * the packet is always being relabeled from the default unlabeled value,
129 * and that the access control decision is made in the AVC.
James Morrisc749b292006-06-09 00:28:25 -0700130 */
Paul Moored621d352008-01-29 08:43:36 -0500131int selinux_secmark_relabel_packet_permission(u32 sid);
Steve Grubbe7c34972006-04-03 09:08:13 -0400132
Paul Moored621d352008-01-29 08:43:36 -0500133/**
134 * selinux_secmark_refcount_inc - increments the secmark use counter
135 *
136 * SELinux keeps track of the current SECMARK targets in use so it knows
137 * when to apply SECMARK label access checks to network packets. This
138 * function incements this reference count to indicate that a new SECMARK
139 * target has been configured.
140 */
141void selinux_secmark_refcount_inc(void);
142
143/**
144 * selinux_secmark_refcount_dec - decrements the secmark use counter
145 *
146 * SELinux keeps track of the current SECMARK targets in use so it knows
147 * when to apply SECMARK label access checks to network packets. This
148 * function decements this reference count to indicate that one of the
149 * existing SECMARK targets has been removed/flushed.
150 */
151void selinux_secmark_refcount_dec(void);
Darrel Goeddel376bd9c2006-02-24 15:44:05 -0600152#else
153
154static inline int selinux_audit_rule_init(u32 field, u32 op,
155 char *rulestr,
156 struct selinux_audit_rule **rule)
157{
Eric Parisec418782007-11-16 16:35:56 -0500158 return -EOPNOTSUPP;
Darrel Goeddel376bd9c2006-02-24 15:44:05 -0600159}
160
161static inline void selinux_audit_rule_free(struct selinux_audit_rule *rule)
162{
163 return;
164}
165
Stephen Smalley9a2f44f2006-09-25 23:31:58 -0700166static inline int selinux_audit_rule_match(u32 sid, u32 field, u32 op,
Darrel Goeddel376bd9c2006-02-24 15:44:05 -0600167 struct selinux_audit_rule *rule,
168 struct audit_context *actx)
169{
170 return 0;
171}
172
173static inline void selinux_audit_set_callback(int (*callback)(void))
174{
175 return;
176}
177
Stephen Smalley1a70cd42006-09-25 23:31:57 -0700178static inline int selinux_sid_to_string(u32 sid, char **ctx, u32 *ctxlen)
Steve Grubb1b50eed2006-04-03 14:06:13 -0400179{
180 *ctx = NULL;
181 *ctxlen = 0;
182 return 0;
183}
184
185static inline void selinux_get_inode_sid(const struct inode *inode, u32 *sid)
186{
187 *sid = 0;
188}
189
Steve Grubb9c7aa6a2006-03-31 15:22:49 -0500190static inline void selinux_get_ipc_sid(const struct kern_ipc_perm *ipcp, u32 *sid)
191{
192 *sid = 0;
193}
194
Steve Grubbe7c34972006-04-03 09:08:13 -0400195static inline void selinux_get_task_sid(struct task_struct *tsk, u32 *sid)
196{
197 *sid = 0;
198}
199
James Morrisc749b292006-06-09 00:28:25 -0700200static inline int selinux_string_to_sid(const char *str, u32 *sid)
201{
202 *sid = 0;
203 return 0;
204}
205
Paul Moored621d352008-01-29 08:43:36 -0500206static inline int selinux_secmark_relabel_packet_permission(u32 sid)
James Morrisc749b292006-06-09 00:28:25 -0700207{
208 return 0;
209}
210
Paul Moored621d352008-01-29 08:43:36 -0500211static inline void selinux_secmark_refcount_inc(void)
212{
213 return;
214}
215
216static inline void selinux_secmark_refcount_dec(void)
217{
218 return;
219}
220
Darrel Goeddel376bd9c2006-02-24 15:44:05 -0600221#endif /* CONFIG_SECURITY_SELINUX */
222
223#endif /* _LINUX_SELINUX_H */