1 /* audit.h -- Auditing support
2  *
3  * Copyright 2003-2004 Red Hat Inc., Durham, North Carolina.
4  * All Rights Reserved.
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software
18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
19  *
20  * Written by Rickard E. (Rik) Faith <faith@redhat.com>
21  *
22  */
23 
24 #ifndef _LINUX_AUDIT_H_
25 #define _LINUX_AUDIT_H_
26 
27 #include <linux/types.h>
28 #include <linux/elf-em.h>
29 #include <linux/ptrace.h>
30 
31 /* The netlink messages for the audit system is divided into blocks:
32  * 1000 - 1099 are for commanding the audit system
33  * 1100 - 1199 user space trusted application messages
34  * 1200 - 1299 messages internal to the audit daemon
35  * 1300 - 1399 audit event messages
36  * 1400 - 1499 SE Linux use
37  * 1500 - 1599 kernel LSPP events
38  * 1600 - 1699 kernel crypto events
39  * 1700 - 1799 kernel anomaly records
40  * 1800 - 1899 kernel integrity events
41  * 1900 - 1999 future kernel use
42  * 2000 is for otherwise unclassified kernel audit messages (legacy)
43  * 2001 - 2099 unused (kernel)
44  * 2100 - 2199 user space anomaly records
45  * 2200 - 2299 user space actions taken in response to anomalies
46  * 2300 - 2399 user space generated LSPP events
47  * 2400 - 2499 user space crypto events
48  * 2500 - 2999 future user space (maybe integrity labels and related events)
49  *
50  * Messages from 1000-1199 are bi-directional. 1200-1299 & 2100 - 2999 are
51  * exclusively user space. 1300-2099 is kernel --> user space
52  * communication.
53  */
54 #define AUDIT_GET		1000	/* Get status */
55 #define AUDIT_SET		1001	/* Set status (enable/disable/auditd) */
56 #define AUDIT_LIST		1002	/* List syscall rules -- deprecated */
57 #define AUDIT_ADD		1003	/* Add syscall rule -- deprecated */
58 #define AUDIT_DEL		1004	/* Delete syscall rule -- deprecated */
59 #define AUDIT_USER		1005	/* Message from userspace -- deprecated */
60 #define AUDIT_LOGIN		1006	/* Define the login id and information */
61 #define AUDIT_WATCH_INS		1007	/* Insert file/dir watch entry */
62 #define AUDIT_WATCH_REM		1008	/* Remove file/dir watch entry */
63 #define AUDIT_WATCH_LIST	1009	/* List all file/dir watches */
64 #define AUDIT_SIGNAL_INFO	1010	/* Get info about sender of signal to auditd */
65 #define AUDIT_ADD_RULE		1011	/* Add syscall filtering rule */
66 #define AUDIT_DEL_RULE		1012	/* Delete syscall filtering rule */
67 #define AUDIT_LIST_RULES	1013	/* List syscall filtering rules */
68 #define AUDIT_TRIM		1014	/* Trim junk from watched tree */
69 #define AUDIT_MAKE_EQUIV	1015	/* Append to watched tree */
70 #define AUDIT_TTY_GET		1016	/* Get TTY auditing status */
71 #define AUDIT_TTY_SET		1017	/* Set TTY auditing status */
72 
73 #define AUDIT_FIRST_USER_MSG	1100	/* Userspace messages mostly uninteresting to kernel */
74 #define AUDIT_USER_AVC		1107	/* We filter this differently */
75 #define AUDIT_USER_TTY		1124	/* Non-ICANON TTY input meaning */
76 #define AUDIT_LAST_USER_MSG	1199
77 #define AUDIT_FIRST_USER_MSG2	2100	/* More user space messages */
78 #define AUDIT_LAST_USER_MSG2	2999
79 
80 #define AUDIT_DAEMON_START      1200    /* Daemon startup record */
81 #define AUDIT_DAEMON_END        1201    /* Daemon normal stop record */
82 #define AUDIT_DAEMON_ABORT      1202    /* Daemon error stop record */
83 #define AUDIT_DAEMON_CONFIG     1203    /* Daemon config change */
84 
85 #define AUDIT_SYSCALL		1300	/* Syscall event */
86 /* #define AUDIT_FS_WATCH	1301	 * Deprecated */
87 #define AUDIT_PATH		1302	/* Filename path information */
88 #define AUDIT_IPC		1303	/* IPC record */
89 #define AUDIT_SOCKETCALL	1304	/* sys_socketcall arguments */
90 #define AUDIT_CONFIG_CHANGE	1305	/* Audit system configuration change */
91 #define AUDIT_SOCKADDR		1306	/* sockaddr copied as syscall arg */
92 #define AUDIT_CWD		1307	/* Current working directory */
93 #define AUDIT_EXECVE		1309	/* execve arguments */
94 #define AUDIT_IPC_SET_PERM	1311	/* IPC new permissions record type */
95 #define AUDIT_MQ_OPEN		1312	/* POSIX MQ open record type */
96 #define AUDIT_MQ_SENDRECV	1313	/* POSIX MQ send/receive record type */
97 #define AUDIT_MQ_NOTIFY		1314	/* POSIX MQ notify record type */
98 #define AUDIT_MQ_GETSETATTR	1315	/* POSIX MQ get/set attribute record type */
99 #define AUDIT_KERNEL_OTHER	1316	/* For use by 3rd party modules */
100 #define AUDIT_FD_PAIR		1317    /* audit record for pipe/socketpair */
101 #define AUDIT_OBJ_PID		1318	/* ptrace target */
102 #define AUDIT_TTY		1319	/* Input on an administrative TTY */
103 #define AUDIT_EOE		1320	/* End of multi-record event */
104 #define AUDIT_BPRM_FCAPS	1321	/* Information about fcaps increasing perms */
105 #define AUDIT_CAPSET		1322	/* Record showing argument to sys_capset */
106 #define AUDIT_MMAP		1323	/* Record showing descriptor and flags in mmap */
107 #define AUDIT_NETFILTER_PKT	1324	/* Packets traversing netfilter chains */
108 #define AUDIT_NETFILTER_CFG	1325	/* Netfilter chain modifications */
109 
110 #define AUDIT_AVC		1400	/* SE Linux avc denial or grant */
111 #define AUDIT_SELINUX_ERR	1401	/* Internal SE Linux Errors */
112 #define AUDIT_AVC_PATH		1402	/* dentry, vfsmount pair from avc */
113 #define AUDIT_MAC_POLICY_LOAD	1403	/* Policy file load */
114 #define AUDIT_MAC_STATUS	1404	/* Changed enforcing,permissive,off */
115 #define AUDIT_MAC_CONFIG_CHANGE	1405	/* Changes to booleans */
116 #define AUDIT_MAC_UNLBL_ALLOW	1406	/* NetLabel: allow unlabeled traffic */
117 #define AUDIT_MAC_CIPSOV4_ADD	1407	/* NetLabel: add CIPSOv4 DOI entry */
118 #define AUDIT_MAC_CIPSOV4_DEL	1408	/* NetLabel: del CIPSOv4 DOI entry */
119 #define AUDIT_MAC_MAP_ADD	1409	/* NetLabel: add LSM domain mapping */
120 #define AUDIT_MAC_MAP_DEL	1410	/* NetLabel: del LSM domain mapping */
121 #define AUDIT_MAC_IPSEC_ADDSA	1411	/* Not used */
122 #define AUDIT_MAC_IPSEC_DELSA	1412	/* Not used  */
123 #define AUDIT_MAC_IPSEC_ADDSPD	1413	/* Not used */
124 #define AUDIT_MAC_IPSEC_DELSPD	1414	/* Not used */
125 #define AUDIT_MAC_IPSEC_EVENT	1415	/* Audit an IPSec event */
126 #define AUDIT_MAC_UNLBL_STCADD	1416	/* NetLabel: add a static label */
127 #define AUDIT_MAC_UNLBL_STCDEL	1417	/* NetLabel: del a static label */
128 
129 #define AUDIT_FIRST_KERN_ANOM_MSG   1700
130 #define AUDIT_LAST_KERN_ANOM_MSG    1799
131 #define AUDIT_ANOM_PROMISCUOUS      1700 /* Device changed promiscuous mode */
132 #define AUDIT_ANOM_ABEND            1701 /* Process ended abnormally */
133 #define AUDIT_INTEGRITY_DATA	    1800 /* Data integrity verification */
134 #define AUDIT_INTEGRITY_METADATA    1801 /* Metadata integrity verification */
135 #define AUDIT_INTEGRITY_STATUS	    1802 /* Integrity enable status */
136 #define AUDIT_INTEGRITY_HASH	    1803 /* Integrity HASH type */
137 #define AUDIT_INTEGRITY_PCR	    1804 /* PCR invalidation msgs */
138 #define AUDIT_INTEGRITY_RULE	    1805 /* policy rule */
139 
140 #define AUDIT_KERNEL		2000	/* Asynchronous audit record. NOT A REQUEST. */
141 
142 /* Rule flags */
143 #define AUDIT_FILTER_USER	0x00	/* Apply rule to user-generated messages */
144 #define AUDIT_FILTER_TASK	0x01	/* Apply rule at task creation (not syscall) */
145 #define AUDIT_FILTER_ENTRY	0x02	/* Apply rule at syscall entry */
146 #define AUDIT_FILTER_WATCH	0x03	/* Apply rule to file system watches */
147 #define AUDIT_FILTER_EXIT	0x04	/* Apply rule at syscall exit */
148 #define AUDIT_FILTER_TYPE	0x05	/* Apply rule at audit_log_start */
149 
150 #define AUDIT_NR_FILTERS	6
151 
152 #define AUDIT_FILTER_PREPEND	0x10	/* Prepend to front of list */
153 
154 /* Rule actions */
155 #define AUDIT_NEVER    0	/* Do not build context if rule matches */
156 #define AUDIT_POSSIBLE 1	/* Build context if rule matches  */
157 #define AUDIT_ALWAYS   2	/* Generate audit record if rule matches */
158 
159 /* Rule structure sizes -- if these change, different AUDIT_ADD and
160  * AUDIT_LIST commands must be implemented. */
161 #define AUDIT_MAX_FIELDS   64
162 #define AUDIT_MAX_KEY_LEN  256
163 #define AUDIT_BITMASK_SIZE 64
164 #define AUDIT_WORD(nr) ((__u32)((nr)/32))
165 #define AUDIT_BIT(nr)  (1 << ((nr) - AUDIT_WORD(nr)*32))
166 
167 #define AUDIT_SYSCALL_CLASSES 16
168 #define AUDIT_CLASS_DIR_WRITE 0
169 #define AUDIT_CLASS_DIR_WRITE_32 1
170 #define AUDIT_CLASS_CHATTR 2
171 #define AUDIT_CLASS_CHATTR_32 3
172 #define AUDIT_CLASS_READ 4
173 #define AUDIT_CLASS_READ_32 5
174 #define AUDIT_CLASS_WRITE 6
175 #define AUDIT_CLASS_WRITE_32 7
176 #define AUDIT_CLASS_SIGNAL 8
177 #define AUDIT_CLASS_SIGNAL_32 9
178 
179 /* This bitmask is used to validate user input.  It represents all bits that
180  * are currently used in an audit field constant understood by the kernel.
181  * If you are adding a new #define AUDIT_<whatever>, please ensure that
182  * AUDIT_UNUSED_BITS is updated if need be. */
183 #define AUDIT_UNUSED_BITS	0x07FFFC00
184 
185 /* AUDIT_FIELD_COMPARE rule list */
186 #define AUDIT_COMPARE_UID_TO_OBJ_UID	1
187 #define AUDIT_COMPARE_GID_TO_OBJ_GID	2
188 #define AUDIT_COMPARE_EUID_TO_OBJ_UID	3
189 #define AUDIT_COMPARE_EGID_TO_OBJ_GID	4
190 #define AUDIT_COMPARE_AUID_TO_OBJ_UID	5
191 #define AUDIT_COMPARE_SUID_TO_OBJ_UID	6
192 #define AUDIT_COMPARE_SGID_TO_OBJ_GID	7
193 #define AUDIT_COMPARE_FSUID_TO_OBJ_UID	8
194 #define AUDIT_COMPARE_FSGID_TO_OBJ_GID	9
195 
196 #define AUDIT_COMPARE_UID_TO_AUID	10
197 #define AUDIT_COMPARE_UID_TO_EUID	11
198 #define AUDIT_COMPARE_UID_TO_FSUID	12
199 #define AUDIT_COMPARE_UID_TO_SUID	13
200 
201 #define AUDIT_COMPARE_AUID_TO_FSUID	14
202 #define AUDIT_COMPARE_AUID_TO_SUID	15
203 #define AUDIT_COMPARE_AUID_TO_EUID	16
204 
205 #define AUDIT_COMPARE_EUID_TO_SUID	17
206 #define AUDIT_COMPARE_EUID_TO_FSUID	18
207 
208 #define AUDIT_COMPARE_SUID_TO_FSUID	19
209 
210 #define AUDIT_COMPARE_GID_TO_EGID	20
211 #define AUDIT_COMPARE_GID_TO_FSGID	21
212 #define AUDIT_COMPARE_GID_TO_SGID	22
213 
214 #define AUDIT_COMPARE_EGID_TO_FSGID	23
215 #define AUDIT_COMPARE_EGID_TO_SGID	24
216 #define AUDIT_COMPARE_SGID_TO_FSGID	25
217 
218 #define AUDIT_MAX_FIELD_COMPARE		AUDIT_COMPARE_SGID_TO_FSGID
219 
220 /* Rule fields */
221 				/* These are useful when checking the
222 				 * task structure at task creation time
223 				 * (AUDIT_PER_TASK).  */
224 #define AUDIT_PID	0
225 #define AUDIT_UID	1
226 #define AUDIT_EUID	2
227 #define AUDIT_SUID	3
228 #define AUDIT_FSUID	4
229 #define AUDIT_GID	5
230 #define AUDIT_EGID	6
231 #define AUDIT_SGID	7
232 #define AUDIT_FSGID	8
233 #define AUDIT_LOGINUID	9
234 #define AUDIT_PERS	10
235 #define AUDIT_ARCH	11
236 #define AUDIT_MSGTYPE	12
237 #define AUDIT_SUBJ_USER	13	/* security label user */
238 #define AUDIT_SUBJ_ROLE	14	/* security label role */
239 #define AUDIT_SUBJ_TYPE	15	/* security label type */
240 #define AUDIT_SUBJ_SEN	16	/* security label sensitivity label */
241 #define AUDIT_SUBJ_CLR	17	/* security label clearance label */
242 #define AUDIT_PPID	18
243 #define AUDIT_OBJ_USER	19
244 #define AUDIT_OBJ_ROLE	20
245 #define AUDIT_OBJ_TYPE	21
246 #define AUDIT_OBJ_LEV_LOW	22
247 #define AUDIT_OBJ_LEV_HIGH	23
248 
249 				/* These are ONLY useful when checking
250 				 * at syscall exit time (AUDIT_AT_EXIT). */
251 #define AUDIT_DEVMAJOR	100
252 #define AUDIT_DEVMINOR	101
253 #define AUDIT_INODE	102
254 #define AUDIT_EXIT	103
255 #define AUDIT_SUCCESS   104	/* exit >= 0; value ignored */
256 #define AUDIT_WATCH	105
257 #define AUDIT_PERM	106
258 #define AUDIT_DIR	107
259 #define AUDIT_FILETYPE	108
260 #define AUDIT_OBJ_UID	109
261 #define AUDIT_OBJ_GID	110
262 #define AUDIT_FIELD_COMPARE	111
263 
264 #define AUDIT_ARG0      200
265 #define AUDIT_ARG1      (AUDIT_ARG0+1)
266 #define AUDIT_ARG2      (AUDIT_ARG0+2)
267 #define AUDIT_ARG3      (AUDIT_ARG0+3)
268 
269 #define AUDIT_FILTERKEY	210
270 
271 #define AUDIT_NEGATE			0x80000000
272 
273 /* These are the supported operators.
274  *	4  2  1  8
275  *	=  >  <  ?
276  *	----------
277  *	0  0  0	 0	00	nonsense
278  *	0  0  0	 1	08	&  bit mask
279  *	0  0  1	 0	10	<
280  *	0  1  0	 0	20	>
281  *	0  1  1	 0	30	!=
282  *	1  0  0	 0	40	=
283  *	1  0  0	 1	48	&=  bit test
284  *	1  0  1	 0	50	<=
285  *	1  1  0	 0	60	>=
286  *	1  1  1	 1	78	all operators
287  */
288 #define AUDIT_BIT_MASK			0x08000000
289 #define AUDIT_LESS_THAN			0x10000000
290 #define AUDIT_GREATER_THAN		0x20000000
291 #define AUDIT_NOT_EQUAL			0x30000000
292 #define AUDIT_EQUAL			0x40000000
293 #define AUDIT_BIT_TEST			(AUDIT_BIT_MASK|AUDIT_EQUAL)
294 #define AUDIT_LESS_THAN_OR_EQUAL	(AUDIT_LESS_THAN|AUDIT_EQUAL)
295 #define AUDIT_GREATER_THAN_OR_EQUAL	(AUDIT_GREATER_THAN|AUDIT_EQUAL)
296 #define AUDIT_OPERATORS			(AUDIT_EQUAL|AUDIT_NOT_EQUAL|AUDIT_BIT_MASK)
297 
298 enum {
299 	Audit_equal,
300 	Audit_not_equal,
301 	Audit_bitmask,
302 	Audit_bittest,
303 	Audit_lt,
304 	Audit_gt,
305 	Audit_le,
306 	Audit_ge,
307 	Audit_bad
308 };
309 
310 /* Status symbols */
311 				/* Mask values */
312 #define AUDIT_STATUS_ENABLED		0x0001
313 #define AUDIT_STATUS_FAILURE		0x0002
314 #define AUDIT_STATUS_PID		0x0004
315 #define AUDIT_STATUS_RATE_LIMIT		0x0008
316 #define AUDIT_STATUS_BACKLOG_LIMIT	0x0010
317 				/* Failure-to-log actions */
318 #define AUDIT_FAIL_SILENT	0
319 #define AUDIT_FAIL_PRINTK	1
320 #define AUDIT_FAIL_PANIC	2
321 
322 /* distinguish syscall tables */
323 #define __AUDIT_ARCH_64BIT 0x80000000
324 #define __AUDIT_ARCH_LE	   0x40000000
325 #define AUDIT_ARCH_ALPHA	(EM_ALPHA|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE)
326 #define AUDIT_ARCH_ARM		(EM_ARM|__AUDIT_ARCH_LE)
327 #define AUDIT_ARCH_ARMEB	(EM_ARM)
328 #define AUDIT_ARCH_CRIS		(EM_CRIS|__AUDIT_ARCH_LE)
329 #define AUDIT_ARCH_FRV		(EM_FRV)
330 #define AUDIT_ARCH_H8300	(EM_H8_300)
331 #define AUDIT_ARCH_I386		(EM_386|__AUDIT_ARCH_LE)
332 #define AUDIT_ARCH_IA64		(EM_IA_64|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE)
333 #define AUDIT_ARCH_M32R		(EM_M32R)
334 #define AUDIT_ARCH_M68K		(EM_68K)
335 #define AUDIT_ARCH_MIPS		(EM_MIPS)
336 #define AUDIT_ARCH_MIPSEL	(EM_MIPS|__AUDIT_ARCH_LE)
337 #define AUDIT_ARCH_MIPS64	(EM_MIPS|__AUDIT_ARCH_64BIT)
338 #define AUDIT_ARCH_MIPSEL64	(EM_MIPS|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE)
339 #define AUDIT_ARCH_PARISC	(EM_PARISC)
340 #define AUDIT_ARCH_PARISC64	(EM_PARISC|__AUDIT_ARCH_64BIT)
341 #define AUDIT_ARCH_PPC		(EM_PPC)
342 #define AUDIT_ARCH_PPC64	(EM_PPC64|__AUDIT_ARCH_64BIT)
343 #define AUDIT_ARCH_S390		(EM_S390)
344 #define AUDIT_ARCH_S390X	(EM_S390|__AUDIT_ARCH_64BIT)
345 #define AUDIT_ARCH_SH		(EM_SH)
346 #define AUDIT_ARCH_SHEL		(EM_SH|__AUDIT_ARCH_LE)
347 #define AUDIT_ARCH_SH64		(EM_SH|__AUDIT_ARCH_64BIT)
348 #define AUDIT_ARCH_SHEL64	(EM_SH|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE)
349 #define AUDIT_ARCH_SPARC	(EM_SPARC)
350 #define AUDIT_ARCH_SPARC64	(EM_SPARCV9|__AUDIT_ARCH_64BIT)
351 #define AUDIT_ARCH_X86_64	(EM_X86_64|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE)
352 
353 #define AUDIT_PERM_EXEC		1
354 #define AUDIT_PERM_WRITE	2
355 #define AUDIT_PERM_READ		4
356 #define AUDIT_PERM_ATTR		8
357 
358 struct audit_status {
359 	__u32		mask;		/* Bit mask for valid entries */
360 	__u32		enabled;	/* 1 = enabled, 0 = disabled */
361 	__u32		failure;	/* Failure-to-log action */
362 	__u32		pid;		/* pid of auditd process */
363 	__u32		rate_limit;	/* messages rate limit (per second) */
364 	__u32		backlog_limit;	/* waiting messages limit */
365 	__u32		lost;		/* messages lost */
366 	__u32		backlog;	/* messages waiting in queue */
367 };
368 
369 struct audit_tty_status {
370 	__u32		enabled; /* 1 = enabled, 0 = disabled */
371 };
372 
373 /* audit_rule_data supports filter rules with both integer and string
374  * fields.  It corresponds with AUDIT_ADD_RULE, AUDIT_DEL_RULE and
375  * AUDIT_LIST_RULES requests.
376  */
377 struct audit_rule_data {
378 	__u32		flags;	/* AUDIT_PER_{TASK,CALL}, AUDIT_PREPEND */
379 	__u32		action;	/* AUDIT_NEVER, AUDIT_POSSIBLE, AUDIT_ALWAYS */
380 	__u32		field_count;
381 	__u32		mask[AUDIT_BITMASK_SIZE]; /* syscall(s) affected */
382 	__u32		fields[AUDIT_MAX_FIELDS];
383 	__u32		values[AUDIT_MAX_FIELDS];
384 	__u32		fieldflags[AUDIT_MAX_FIELDS];
385 	__u32		buflen;	/* total length of string fields */
386 	char		buf[0];	/* string fields buffer */
387 };
388 
389 /* audit_rule is supported to maintain backward compatibility with
390  * userspace.  It supports integer fields only and corresponds to
391  * AUDIT_ADD, AUDIT_DEL and AUDIT_LIST requests.
392  */
393 struct audit_rule {		/* for AUDIT_LIST, AUDIT_ADD, and AUDIT_DEL */
394 	__u32		flags;	/* AUDIT_PER_{TASK,CALL}, AUDIT_PREPEND */
395 	__u32		action;	/* AUDIT_NEVER, AUDIT_POSSIBLE, AUDIT_ALWAYS */
396 	__u32		field_count;
397 	__u32		mask[AUDIT_BITMASK_SIZE];
398 	__u32		fields[AUDIT_MAX_FIELDS];
399 	__u32		values[AUDIT_MAX_FIELDS];
400 };
401 
402 #ifdef __KERNEL__
403 #include <linux/sched.h>
404 
405 struct audit_sig_info {
406 	uid_t		uid;
407 	pid_t		pid;
408 	char		ctx[0];
409 };
410 
411 struct audit_buffer;
412 struct audit_context;
413 struct inode;
414 struct netlink_skb_parms;
415 struct path;
416 struct linux_binprm;
417 struct mq_attr;
418 struct mqstat;
419 struct audit_watch;
420 struct audit_tree;
421 
422 struct audit_krule {
423 	int			vers_ops;
424 	u32			flags;
425 	u32			listnr;
426 	u32			action;
427 	u32			mask[AUDIT_BITMASK_SIZE];
428 	u32			buflen; /* for data alloc on list rules */
429 	u32			field_count;
430 	char			*filterkey; /* ties events to rules */
431 	struct audit_field	*fields;
432 	struct audit_field	*arch_f; /* quick access to arch field */
433 	struct audit_field	*inode_f; /* quick access to an inode field */
434 	struct audit_watch	*watch;	/* associated watch */
435 	struct audit_tree	*tree;	/* associated watched tree */
436 	struct list_head	rlist;	/* entry in audit_{watch,tree}.rules list */
437 	struct list_head	list;	/* for AUDIT_LIST* purposes only */
438 	u64			prio;
439 };
440 
441 struct audit_field {
442 	u32				type;
443 	u32				val;
444 	u32				op;
445 	char				*lsm_str;
446 	void				*lsm_rule;
447 };
448 
449 extern int __init audit_register_class(int class, unsigned *list);
450 extern int audit_classify_syscall(int abi, unsigned syscall);
451 extern int audit_classify_arch(int arch);
452 #ifdef CONFIG_AUDITSYSCALL
453 /* These are defined in auditsc.c */
454 				/* Public API */
455 extern int  audit_alloc(struct task_struct *task);
456 extern void __audit_free(struct task_struct *task);
457 extern void __audit_syscall_entry(int arch,
458 				  int major, unsigned long a0, unsigned long a1,
459 				  unsigned long a2, unsigned long a3);
460 extern void __audit_syscall_exit(int ret_success, long ret_value);
461 extern void __audit_getname(const char *name);
462 extern void audit_putname(const char *name);
463 extern void __audit_inode(const char *name, const struct dentry *dentry);
464 extern void __audit_inode_child(const struct dentry *dentry,
465 				const struct inode *parent);
466 extern void __audit_seccomp(unsigned long syscall);
467 extern void __audit_ptrace(struct task_struct *t);
468 
audit_dummy_context(void)469 static inline int audit_dummy_context(void)
470 {
471 	void *p = current->audit_context;
472 	return !p || *(int *)p;
473 }
audit_free(struct task_struct * task)474 static inline void audit_free(struct task_struct *task)
475 {
476 	if (unlikely(task->audit_context))
477 		__audit_free(task);
478 }
audit_syscall_entry(int arch,int major,unsigned long a0,unsigned long a1,unsigned long a2,unsigned long a3)479 static inline void audit_syscall_entry(int arch, int major, unsigned long a0,
480 				       unsigned long a1, unsigned long a2,
481 				       unsigned long a3)
482 {
483 	if (unlikely(current->audit_context))
484 		__audit_syscall_entry(arch, major, a0, a1, a2, a3);
485 }
audit_syscall_exit(void * pt_regs)486 static inline void audit_syscall_exit(void *pt_regs)
487 {
488 	if (unlikely(current->audit_context)) {
489 		int success = is_syscall_success(pt_regs);
490 		long return_code = regs_return_value(pt_regs);
491 
492 		__audit_syscall_exit(success, return_code);
493 	}
494 }
audit_getname(const char * name)495 static inline void audit_getname(const char *name)
496 {
497 	if (unlikely(!audit_dummy_context()))
498 		__audit_getname(name);
499 }
audit_inode(const char * name,const struct dentry * dentry)500 static inline void audit_inode(const char *name, const struct dentry *dentry) {
501 	if (unlikely(!audit_dummy_context()))
502 		__audit_inode(name, dentry);
503 }
audit_inode_child(const struct dentry * dentry,const struct inode * parent)504 static inline void audit_inode_child(const struct dentry *dentry,
505 				     const struct inode *parent) {
506 	if (unlikely(!audit_dummy_context()))
507 		__audit_inode_child(dentry, parent);
508 }
509 void audit_core_dumps(long signr);
510 
audit_seccomp(unsigned long syscall)511 static inline void audit_seccomp(unsigned long syscall)
512 {
513 	if (unlikely(!audit_dummy_context()))
514 		__audit_seccomp(syscall);
515 }
516 
audit_ptrace(struct task_struct * t)517 static inline void audit_ptrace(struct task_struct *t)
518 {
519 	if (unlikely(!audit_dummy_context()))
520 		__audit_ptrace(t);
521 }
522 
523 				/* Private API (for audit.c only) */
524 extern unsigned int audit_serial(void);
525 extern int auditsc_get_stamp(struct audit_context *ctx,
526 			      struct timespec *t, unsigned int *serial);
527 extern int  audit_set_loginuid(uid_t loginuid);
528 #define audit_get_loginuid(t) ((t)->loginuid)
529 #define audit_get_sessionid(t) ((t)->sessionid)
530 extern void audit_log_task_context(struct audit_buffer *ab);
531 extern void __audit_ipc_obj(struct kern_ipc_perm *ipcp);
532 extern void __audit_ipc_set_perm(unsigned long qbytes, uid_t uid, gid_t gid, umode_t mode);
533 extern int __audit_bprm(struct linux_binprm *bprm);
534 extern void __audit_socketcall(int nargs, unsigned long *args);
535 extern int __audit_sockaddr(int len, void *addr);
536 extern void __audit_fd_pair(int fd1, int fd2);
537 extern void __audit_mq_open(int oflag, umode_t mode, struct mq_attr *attr);
538 extern void __audit_mq_sendrecv(mqd_t mqdes, size_t msg_len, unsigned int msg_prio, const struct timespec *abs_timeout);
539 extern void __audit_mq_notify(mqd_t mqdes, const struct sigevent *notification);
540 extern void __audit_mq_getsetattr(mqd_t mqdes, struct mq_attr *mqstat);
541 extern int __audit_log_bprm_fcaps(struct linux_binprm *bprm,
542 				  const struct cred *new,
543 				  const struct cred *old);
544 extern void __audit_log_capset(pid_t pid, const struct cred *new, const struct cred *old);
545 extern void __audit_mmap_fd(int fd, int flags);
546 
audit_ipc_obj(struct kern_ipc_perm * ipcp)547 static inline void audit_ipc_obj(struct kern_ipc_perm *ipcp)
548 {
549 	if (unlikely(!audit_dummy_context()))
550 		__audit_ipc_obj(ipcp);
551 }
audit_fd_pair(int fd1,int fd2)552 static inline void audit_fd_pair(int fd1, int fd2)
553 {
554 	if (unlikely(!audit_dummy_context()))
555 		__audit_fd_pair(fd1, fd2);
556 }
audit_ipc_set_perm(unsigned long qbytes,uid_t uid,gid_t gid,umode_t mode)557 static inline void audit_ipc_set_perm(unsigned long qbytes, uid_t uid, gid_t gid, umode_t mode)
558 {
559 	if (unlikely(!audit_dummy_context()))
560 		__audit_ipc_set_perm(qbytes, uid, gid, mode);
561 }
audit_bprm(struct linux_binprm * bprm)562 static inline int audit_bprm(struct linux_binprm *bprm)
563 {
564 	if (unlikely(!audit_dummy_context()))
565 		return __audit_bprm(bprm);
566 	return 0;
567 }
audit_socketcall(int nargs,unsigned long * args)568 static inline void audit_socketcall(int nargs, unsigned long *args)
569 {
570 	if (unlikely(!audit_dummy_context()))
571 		__audit_socketcall(nargs, args);
572 }
audit_sockaddr(int len,void * addr)573 static inline int audit_sockaddr(int len, void *addr)
574 {
575 	if (unlikely(!audit_dummy_context()))
576 		return __audit_sockaddr(len, addr);
577 	return 0;
578 }
audit_mq_open(int oflag,umode_t mode,struct mq_attr * attr)579 static inline void audit_mq_open(int oflag, umode_t mode, struct mq_attr *attr)
580 {
581 	if (unlikely(!audit_dummy_context()))
582 		__audit_mq_open(oflag, mode, attr);
583 }
audit_mq_sendrecv(mqd_t mqdes,size_t msg_len,unsigned int msg_prio,const struct timespec * abs_timeout)584 static inline void audit_mq_sendrecv(mqd_t mqdes, size_t msg_len, unsigned int msg_prio, const struct timespec *abs_timeout)
585 {
586 	if (unlikely(!audit_dummy_context()))
587 		__audit_mq_sendrecv(mqdes, msg_len, msg_prio, abs_timeout);
588 }
audit_mq_notify(mqd_t mqdes,const struct sigevent * notification)589 static inline void audit_mq_notify(mqd_t mqdes, const struct sigevent *notification)
590 {
591 	if (unlikely(!audit_dummy_context()))
592 		__audit_mq_notify(mqdes, notification);
593 }
audit_mq_getsetattr(mqd_t mqdes,struct mq_attr * mqstat)594 static inline void audit_mq_getsetattr(mqd_t mqdes, struct mq_attr *mqstat)
595 {
596 	if (unlikely(!audit_dummy_context()))
597 		__audit_mq_getsetattr(mqdes, mqstat);
598 }
599 
audit_log_bprm_fcaps(struct linux_binprm * bprm,const struct cred * new,const struct cred * old)600 static inline int audit_log_bprm_fcaps(struct linux_binprm *bprm,
601 				       const struct cred *new,
602 				       const struct cred *old)
603 {
604 	if (unlikely(!audit_dummy_context()))
605 		return __audit_log_bprm_fcaps(bprm, new, old);
606 	return 0;
607 }
608 
audit_log_capset(pid_t pid,const struct cred * new,const struct cred * old)609 static inline void audit_log_capset(pid_t pid, const struct cred *new,
610 				   const struct cred *old)
611 {
612 	if (unlikely(!audit_dummy_context()))
613 		__audit_log_capset(pid, new, old);
614 }
615 
audit_mmap_fd(int fd,int flags)616 static inline void audit_mmap_fd(int fd, int flags)
617 {
618 	if (unlikely(!audit_dummy_context()))
619 		__audit_mmap_fd(fd, flags);
620 }
621 
622 extern int audit_n_rules;
623 extern int audit_signals;
624 #else /* CONFIG_AUDITSYSCALL */
625 #define audit_alloc(t) ({ 0; })
626 #define audit_free(t) do { ; } while (0)
627 #define audit_syscall_entry(ta,a,b,c,d,e) do { ; } while (0)
628 #define audit_syscall_exit(r) do { ; } while (0)
629 #define audit_dummy_context() 1
630 #define audit_getname(n) do { ; } while (0)
631 #define audit_putname(n) do { ; } while (0)
632 #define __audit_inode(n,d) do { ; } while (0)
633 #define __audit_inode_child(i,p) do { ; } while (0)
634 #define audit_inode(n,d) do { (void)(d); } while (0)
635 #define audit_inode_child(i,p) do { ; } while (0)
636 #define audit_core_dumps(i) do { ; } while (0)
637 #define audit_seccomp(i) do { ; } while (0)
638 #define auditsc_get_stamp(c,t,s) (0)
639 #define audit_get_loginuid(t) (-1)
640 #define audit_get_sessionid(t) (-1)
641 #define audit_log_task_context(b) do { ; } while (0)
642 #define audit_ipc_obj(i) ((void)0)
643 #define audit_ipc_set_perm(q,u,g,m) ((void)0)
644 #define audit_bprm(p) ({ 0; })
645 #define audit_socketcall(n,a) ((void)0)
646 #define audit_fd_pair(n,a) ((void)0)
647 #define audit_sockaddr(len, addr) ({ 0; })
648 #define audit_mq_open(o,m,a) ((void)0)
649 #define audit_mq_sendrecv(d,l,p,t) ((void)0)
650 #define audit_mq_notify(d,n) ((void)0)
651 #define audit_mq_getsetattr(d,s) ((void)0)
652 #define audit_log_bprm_fcaps(b, ncr, ocr) ({ 0; })
653 #define audit_log_capset(pid, ncr, ocr) ((void)0)
654 #define audit_mmap_fd(fd, flags) ((void)0)
655 #define audit_ptrace(t) ((void)0)
656 #define audit_n_rules 0
657 #define audit_signals 0
658 #endif /* CONFIG_AUDITSYSCALL */
659 
660 #ifdef CONFIG_AUDIT
661 /* These are defined in audit.c */
662 				/* Public API */
663 extern __printf(4, 5)
664 void audit_log(struct audit_context *ctx, gfp_t gfp_mask, int type,
665 	       const char *fmt, ...);
666 
667 extern struct audit_buffer *audit_log_start(struct audit_context *ctx, gfp_t gfp_mask, int type);
668 extern __printf(2, 3)
669 void audit_log_format(struct audit_buffer *ab, const char *fmt, ...);
670 extern void		    audit_log_end(struct audit_buffer *ab);
671 extern int		    audit_string_contains_control(const char *string,
672 							  size_t len);
673 extern void		    audit_log_n_hex(struct audit_buffer *ab,
674 					  const unsigned char *buf,
675 					  size_t len);
676 extern void		    audit_log_n_string(struct audit_buffer *ab,
677 					       const char *buf,
678 					       size_t n);
679 #define audit_log_string(a,b) audit_log_n_string(a, b, strlen(b));
680 extern void		    audit_log_n_untrustedstring(struct audit_buffer *ab,
681 							const char *string,
682 							size_t n);
683 extern void		    audit_log_untrustedstring(struct audit_buffer *ab,
684 						      const char *string);
685 extern void		    audit_log_d_path(struct audit_buffer *ab,
686 					     const char *prefix,
687 					     const struct path *path);
688 extern void		    audit_log_key(struct audit_buffer *ab,
689 					  char *key);
690 extern void		    audit_log_lost(const char *message);
691 #ifdef CONFIG_SECURITY
692 extern void 		    audit_log_secctx(struct audit_buffer *ab, u32 secid);
693 #else
694 #define audit_log_secctx(b,s) do { ; } while (0)
695 #endif
696 
697 extern int		    audit_update_lsm_rules(void);
698 
699 				/* Private API (for audit.c only) */
700 extern int audit_filter_user(struct netlink_skb_parms *cb);
701 extern int audit_filter_type(int type);
702 extern int  audit_receive_filter(int type, int pid, int uid, int seq,
703 				void *data, size_t datasz, uid_t loginuid,
704 				u32 sessionid, u32 sid);
705 extern int audit_enabled;
706 #else
707 #define audit_log(c,g,t,f,...) do { ; } while (0)
708 #define audit_log_start(c,g,t) ({ NULL; })
709 #define audit_log_vformat(b,f,a) do { ; } while (0)
710 #define audit_log_format(b,f,...) do { ; } while (0)
711 #define audit_log_end(b) do { ; } while (0)
712 #define audit_log_n_hex(a,b,l) do { ; } while (0)
713 #define audit_log_n_string(a,c,l) do { ; } while (0)
714 #define audit_log_string(a,c) do { ; } while (0)
715 #define audit_log_n_untrustedstring(a,n,s) do { ; } while (0)
716 #define audit_log_untrustedstring(a,s) do { ; } while (0)
717 #define audit_log_d_path(b, p, d) do { ; } while (0)
718 #define audit_log_key(b, k) do { ; } while (0)
719 #define audit_log_secctx(b,s) do { ; } while (0)
720 #define audit_enabled 0
721 #endif
722 #endif
723 #endif
724