]>
Commit | Line | Data |
---|---|---|
1a59d1b8 | 1 | /* SPDX-License-Identifier: GPL-2.0-or-later */ |
6ddb5680 | 2 | /* audit -- definition of audit_context structure and supporting types |
fe7752ba DW |
3 | * |
4 | * Copyright 2003-2004 Red Hat, Inc. | |
5 | * Copyright 2005 Hewlett-Packard Development Company, L.P. | |
6 | * Copyright 2005 IBM Corporation | |
fe7752ba DW |
7 | */ |
8 | ||
d97e9938 M |
9 | #ifndef _KERNEL_AUDIT_H_ |
10 | #define _KERNEL_AUDIT_H_ | |
11 | ||
fe7752ba DW |
12 | #include <linux/fs.h> |
13 | #include <linux/audit.h> | |
9044e6bc | 14 | #include <linux/skbuff.h> |
36fd78ba | 15 | #include <linux/security.h> |
b24a30a7 | 16 | #include <uapi/linux/mqueue.h> |
3f5be2da | 17 | #include <linux/tty.h> |
fe7752ba | 18 | |
b24a30a7 EP |
19 | /* AUDIT_NAMES is the number of slots we reserve in the audit_context |
20 | * for saving names from getname(). If we get more names we will allocate | |
21 | * a name dynamically and also add those to the list anchored by names_list. */ | |
22 | #define AUDIT_NAMES 5 | |
23 | ||
fe7752ba DW |
24 | /* At task start time, the audit_state is set in the audit_context using |
25 | a per-task filter. At syscall entry, the audit_state is augmented by | |
26 | the syscall filter. */ | |
27 | enum audit_state { | |
619ed58a | 28 | AUDIT_STATE_DISABLED, /* Do not create per-task audit_context. |
fe7752ba DW |
29 | * No syscall-specific audit records can |
30 | * be generated. */ | |
619ed58a | 31 | AUDIT_STATE_BUILD, /* Create the per-task audit_context, |
997f5b64 | 32 | * and fill it in at syscall |
fe7752ba DW |
33 | * entry time. This makes a full |
34 | * syscall record available if some | |
35 | * other part of the kernel decides it | |
36 | * should be recorded. */ | |
619ed58a | 37 | AUDIT_STATE_RECORD /* Create the per-task audit_context, |
fe7752ba DW |
38 | * always fill it in at syscall entry |
39 | * time, and always write out the audit | |
40 | * record at syscall exit time. */ | |
41 | }; | |
42 | ||
43 | /* Rule lists */ | |
cfcad62c | 44 | struct audit_watch; |
7f492942 | 45 | struct audit_fsnotify_mark; |
74c3cbe3 AV |
46 | struct audit_tree; |
47 | struct audit_chunk; | |
48 | ||
fe7752ba | 49 | struct audit_entry { |
93315ed6 AG |
50 | struct list_head list; |
51 | struct rcu_head rcu; | |
52 | struct audit_krule rule; | |
fe7752ba DW |
53 | }; |
54 | ||
b24a30a7 EP |
55 | struct audit_cap_data { |
56 | kernel_cap_t permitted; | |
57 | kernel_cap_t inheritable; | |
58 | union { | |
59 | unsigned int fE; /* effective bit of file cap */ | |
60 | kernel_cap_t effective; /* effective set of process */ | |
61 | }; | |
7786f6b6 | 62 | kernel_cap_t ambient; |
2fec30e2 | 63 | kuid_t rootid; |
b24a30a7 EP |
64 | }; |
65 | ||
55422d0b PM |
66 | /* When fs/namei.c:getname() is called, we store the pointer in name and bump |
67 | * the refcnt in the associated filename struct. | |
b24a30a7 EP |
68 | * |
69 | * Further, in fs/namei.c:path_lookup() we store the inode and device. | |
70 | */ | |
71 | struct audit_names { | |
72 | struct list_head list; /* audit_context->names_list */ | |
73 | ||
74 | struct filename *name; | |
75 | int name_len; /* number of chars to log */ | |
79f6530c | 76 | bool hidden; /* don't log this record */ |
b24a30a7 EP |
77 | |
78 | unsigned long ino; | |
79 | dev_t dev; | |
80 | umode_t mode; | |
81 | kuid_t uid; | |
82 | kgid_t gid; | |
83 | dev_t rdev; | |
558fd844 | 84 | struct lsmblob oblob; |
b24a30a7 EP |
85 | struct audit_cap_data fcap; |
86 | unsigned int fcap_ver; | |
87 | unsigned char type; /* record type */ | |
88 | /* | |
89 | * This was an allocated audit_names and not from the array of | |
90 | * names allocated in the task audit context. Thus this name | |
91 | * should be freed on syscall exit. | |
92 | */ | |
93 | bool should_free; | |
94 | }; | |
95 | ||
3f1c8250 WR |
96 | struct audit_proctitle { |
97 | int len; /* length of the cmdline field. */ | |
98 | char *value; /* the cmdline field */ | |
99 | }; | |
100 | ||
b24a30a7 EP |
101 | /* The per-task audit context. */ |
102 | struct audit_context { | |
103 | int dummy; /* must be the first element */ | |
104 | int in_syscall; /* 1 if task is in a syscall */ | |
105 | enum audit_state state, current_state; | |
106 | unsigned int serial; /* serial number for record */ | |
107 | int major; /* syscall number */ | |
2115bb25 | 108 | struct timespec64 ctime; /* time of syscall entry */ |
b24a30a7 EP |
109 | unsigned long argv[4]; /* syscall arguments */ |
110 | long return_code;/* syscall return code */ | |
111 | u64 prio; | |
112 | int return_valid; /* return code is valid */ | |
113 | /* | |
114 | * The names_list is the list of all audit_names collected during this | |
115 | * syscall. The first AUDIT_NAMES entries in the names_list will | |
116 | * actually be from the preallocated_names array for performance | |
117 | * reasons. Except during allocation they should never be referenced | |
118 | * through the preallocated_names array and should only be found/used | |
119 | * by running the names_list. | |
120 | */ | |
121 | struct audit_names preallocated_names[AUDIT_NAMES]; | |
122 | int name_count; /* total records in names_list */ | |
123 | struct list_head names_list; /* struct audit_names->list anchor */ | |
124 | char *filterkey; /* key for rule that triggered record */ | |
125 | struct path pwd; | |
126 | struct audit_aux_data *aux; | |
127 | struct audit_aux_data *aux_pids; | |
128 | struct sockaddr_storage *sockaddr; | |
129 | size_t sockaddr_len; | |
130 | /* Save things to print about task_struct */ | |
131 | pid_t pid, ppid; | |
132 | kuid_t uid, euid, suid, fsuid; | |
133 | kgid_t gid, egid, sgid, fsgid; | |
134 | unsigned long personality; | |
135 | int arch; | |
136 | ||
137 | pid_t target_pid; | |
138 | kuid_t target_auid; | |
139 | kuid_t target_uid; | |
140 | unsigned int target_sessionid; | |
36fd78ba | 141 | struct lsmblob target_lsm; |
b24a30a7 EP |
142 | char target_comm[TASK_COMM_LEN]; |
143 | ||
144 | struct audit_tree_refs *trees, *first_trees; | |
145 | struct list_head killed_trees; | |
146 | int tree_count; | |
147 | ||
148 | int type; | |
149 | union { | |
150 | struct { | |
151 | int nargs; | |
152 | long args[6]; | |
153 | } socketcall; | |
154 | struct { | |
155 | kuid_t uid; | |
156 | kgid_t gid; | |
157 | umode_t mode; | |
558fd844 | 158 | struct lsmblob oblob; |
b24a30a7 EP |
159 | int has_perm; |
160 | uid_t perm_uid; | |
161 | gid_t perm_gid; | |
162 | umode_t perm_mode; | |
163 | unsigned long qbytes; | |
164 | } ipc; | |
165 | struct { | |
166 | mqd_t mqdes; | |
167 | struct mq_attr mqstat; | |
168 | } mq_getsetattr; | |
169 | struct { | |
170 | mqd_t mqdes; | |
171 | int sigev_signo; | |
172 | } mq_notify; | |
173 | struct { | |
174 | mqd_t mqdes; | |
175 | size_t msg_len; | |
176 | unsigned int msg_prio; | |
b9047726 | 177 | struct timespec64 abs_timeout; |
b24a30a7 EP |
178 | } mq_sendrecv; |
179 | struct { | |
180 | int oflag; | |
181 | umode_t mode; | |
182 | struct mq_attr attr; | |
183 | } mq_open; | |
184 | struct { | |
185 | pid_t pid; | |
186 | struct audit_cap_data cap; | |
187 | } capset; | |
188 | struct { | |
189 | int fd; | |
190 | int flags; | |
191 | } mmap; | |
d9cfea91 RGB |
192 | struct { |
193 | int argc; | |
d9cfea91 | 194 | } execve; |
ca86cad7 RGB |
195 | struct { |
196 | char *name; | |
197 | } module; | |
dc4607d9 RGB |
198 | struct { |
199 | struct audit_ntp_data ntp_data; | |
200 | struct timespec64 tk_injoffset; | |
201 | } time; | |
b24a30a7 EP |
202 | }; |
203 | int fds[2]; | |
3f1c8250 | 204 | struct audit_proctitle proctitle; |
b24a30a7 EP |
205 | }; |
206 | ||
b3b4fdf6 | 207 | extern bool audit_ever_enabled; |
c782f242 | 208 | |
0fe3c7fc RGB |
209 | extern void audit_log_session_info(struct audit_buffer *ab); |
210 | ||
b6c7c115 | 211 | extern int auditd_test_task(struct task_struct *task); |
fe7752ba | 212 | |
f368c07d AG |
213 | #define AUDIT_INODE_BUCKETS 32 |
214 | extern struct list_head audit_inode_hash[AUDIT_INODE_BUCKETS]; | |
215 | ||
216 | static inline int audit_hash_ino(u32 ino) | |
217 | { | |
218 | return (ino & (AUDIT_INODE_BUCKETS-1)); | |
219 | } | |
220 | ||
e3d6b07b JL |
221 | /* Indicates that audit should log the full pathname. */ |
222 | #define AUDIT_NAME_FULL -1 | |
223 | ||
55669bfa | 224 | extern int audit_match_class(int class, unsigned syscall); |
f368c07d | 225 | extern int audit_comparator(const u32 left, const u32 op, const u32 right); |
ca57ec0f EB |
226 | extern int audit_uid_comparator(kuid_t left, u32 op, kuid_t right); |
227 | extern int audit_gid_comparator(kgid_t left, u32 op, kgid_t right); | |
bfcec708 | 228 | extern int parent_len(const char *path); |
795d673a | 229 | extern int audit_compare_dname_path(const struct qstr *dname, const char *path, int plen); |
45a0642b | 230 | extern struct sk_buff *audit_make_reply(int seq, int type, int done, int multi, |
f9441639 | 231 | const void *payload, int size); |
fe7752ba | 232 | extern void audit_panic(const char *message); |
3dc7e315 | 233 | |
9044e6bc | 234 | struct audit_netlink_list { |
f9441639 | 235 | __u32 portid; |
638a0fd2 | 236 | struct net *net; |
9044e6bc AV |
237 | struct sk_buff_head q; |
238 | }; | |
239 | ||
3054d067 | 240 | int audit_send_list_thread(void *_dest); |
9044e6bc | 241 | |
3dc7e315 | 242 | extern int selinux_audit_rule_update(void); |
e1396065 | 243 | |
74c3cbe3 | 244 | extern struct mutex audit_filter_mutex; |
e4c1a0d1 DR |
245 | extern int audit_del_rule(struct audit_entry *entry); |
246 | extern void audit_free_rule_rcu(struct rcu_head *head); | |
c782f242 | 247 | extern struct list_head audit_filter_list[]; |
74c3cbe3 | 248 | |
939a67fc EP |
249 | extern struct audit_entry *audit_dupe_rule(struct audit_krule *old); |
250 | ||
4766b199 DB |
251 | extern void audit_log_d_path_exe(struct audit_buffer *ab, |
252 | struct mm_struct *mm); | |
253 | ||
2a1fe215 | 254 | extern struct tty_struct *audit_get_tty(void); |
3f5be2da RGB |
255 | extern void audit_put_tty(struct tty_struct *tty); |
256 | ||
05c7a9cb | 257 | /* audit watch/mark/tree functions */ |
c8fc5d49 | 258 | #ifdef CONFIG_AUDITSYSCALL |
cd108b5c RGB |
259 | extern unsigned int audit_serial(void); |
260 | extern int auditsc_get_stamp(struct audit_context *ctx, | |
261 | struct timespec64 *t, unsigned int *serial); | |
262 | ||
cfcad62c EP |
263 | extern void audit_put_watch(struct audit_watch *watch); |
264 | extern void audit_get_watch(struct audit_watch *watch); | |
05c7a9cb RGB |
265 | extern int audit_to_watch(struct audit_krule *krule, char *path, int len, |
266 | u32 op); | |
ae7b8f41 | 267 | extern int audit_add_watch(struct audit_krule *krule, struct list_head **list); |
a05fb6cc | 268 | extern void audit_remove_watch_rule(struct audit_krule *krule); |
cfcad62c | 269 | extern char *audit_watch_path(struct audit_watch *watch); |
05c7a9cb RGB |
270 | extern int audit_watch_compare(struct audit_watch *watch, unsigned long ino, |
271 | dev_t dev); | |
7f492942 | 272 | |
05c7a9cb RGB |
273 | extern struct audit_fsnotify_mark *audit_alloc_mark(struct audit_krule *krule, |
274 | char *pathname, int len); | |
7f492942 RGB |
275 | extern char *audit_mark_path(struct audit_fsnotify_mark *mark); |
276 | extern void audit_remove_mark(struct audit_fsnotify_mark *audit_mark); | |
277 | extern void audit_remove_mark_rule(struct audit_krule *krule); | |
05c7a9cb RGB |
278 | extern int audit_mark_compare(struct audit_fsnotify_mark *mark, |
279 | unsigned long ino, dev_t dev); | |
34d99af5 | 280 | extern int audit_dupe_exe(struct audit_krule *new, struct audit_krule *old); |
05c7a9cb RGB |
281 | extern int audit_exe_compare(struct task_struct *tsk, |
282 | struct audit_fsnotify_mark *mark); | |
7f492942 | 283 | |
05c7a9cb RGB |
284 | extern struct audit_chunk *audit_tree_lookup(const struct inode *inode); |
285 | extern void audit_put_chunk(struct audit_chunk *chunk); | |
286 | extern bool audit_tree_match(struct audit_chunk *chunk, | |
287 | struct audit_tree *tree); | |
288 | extern int audit_make_tree(struct audit_krule *rule, char *pathname, u32 op); | |
289 | extern int audit_add_tree_rule(struct audit_krule *rule); | |
290 | extern int audit_remove_tree_rule(struct audit_krule *rule); | |
291 | extern void audit_trim_trees(void); | |
292 | extern int audit_tag_tree(char *old, char *new); | |
293 | extern const char *audit_tree_path(struct audit_tree *tree); | |
294 | extern void audit_put_tree(struct audit_tree *tree); | |
295 | extern void audit_kill_trees(struct audit_context *context); | |
296 | ||
b48345aa | 297 | extern int audit_signal_info_syscall(struct task_struct *t); |
05c7a9cb RGB |
298 | extern void audit_filter_inodes(struct task_struct *tsk, |
299 | struct audit_context *ctx); | |
300 | extern struct list_head *audit_killed_trees(void); | |
301 | #else /* CONFIG_AUDITSYSCALL */ | |
cd108b5c | 302 | #define auditsc_get_stamp(c, t, s) 0 |
d4ceb1d6 AB |
303 | #define audit_put_watch(w) do { } while (0) |
304 | #define audit_get_watch(w) do { } while (0) | |
939a67fc EP |
305 | #define audit_to_watch(k, p, l, o) (-EINVAL) |
306 | #define audit_add_watch(k, l) (-EINVAL) | |
307 | #define audit_remove_watch_rule(k) BUG() | |
308 | #define audit_watch_path(w) "" | |
309 | #define audit_watch_compare(w, i, d) 0 | |
310 | ||
7f492942 RGB |
311 | #define audit_alloc_mark(k, p, l) (ERR_PTR(-EINVAL)) |
312 | #define audit_mark_path(m) "" | |
d4ceb1d6 AB |
313 | #define audit_remove_mark(m) do { } while (0) |
314 | #define audit_remove_mark_rule(k) do { } while (0) | |
7f492942 | 315 | #define audit_mark_compare(m, i, d) 0 |
34d99af5 RGB |
316 | #define audit_exe_compare(t, m) (-EINVAL) |
317 | #define audit_dupe_exe(n, o) (-EINVAL) | |
cfcad62c | 318 | |
74c3cbe3 AV |
319 | #define audit_remove_tree_rule(rule) BUG() |
320 | #define audit_add_tree_rule(rule) -EINVAL | |
321 | #define audit_make_tree(rule, str, op) -EINVAL | |
d4ceb1d6 AB |
322 | #define audit_trim_trees() do { } while (0) |
323 | #define audit_put_tree(tree) do { } while (0) | |
74c3cbe3 AV |
324 | #define audit_tag_tree(old, new) -EINVAL |
325 | #define audit_tree_path(rule) "" /* never called */ | |
9e36a5d4 | 326 | #define audit_kill_trees(context) BUG() |
05c7a9cb | 327 | |
b48345aa RGB |
328 | static inline int audit_signal_info_syscall(struct task_struct *t) |
329 | { | |
330 | return 0; | |
331 | } | |
332 | ||
619ed58a | 333 | #define audit_filter_inodes(t, c) AUDIT_STATE_DISABLED |
05c7a9cb | 334 | #endif /* CONFIG_AUDITSYSCALL */ |
74c3cbe3 | 335 | |
e4c1a0d1 | 336 | extern char *audit_unpack_string(void **bufp, size_t *remain, size_t len); |
74c3cbe3 | 337 | |
36fd78ba CS |
338 | extern struct lsmblob audit_sig_lsm; |
339 | ||
86b2efbe RGB |
340 | extern int audit_filter(int msgtype, unsigned int listtype); |
341 | ||
ce423631 PM |
342 | extern void audit_ctl_lock(void); |
343 | extern void audit_ctl_unlock(void); | |
d97e9938 M |
344 | |
345 | #endif |