xref: /linux-6.15/include/linux/audit.h (revision b6bf56c6)
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 <[email protected]>
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_ANOM_LINK		    1702 /* Suspicious use of file links */
134 #define AUDIT_INTEGRITY_DATA	    1800 /* Data integrity verification */
135 #define AUDIT_INTEGRITY_METADATA    1801 /* Metadata integrity verification */
136 #define AUDIT_INTEGRITY_STATUS	    1802 /* Integrity enable status */
137 #define AUDIT_INTEGRITY_HASH	    1803 /* Integrity HASH type */
138 #define AUDIT_INTEGRITY_PCR	    1804 /* PCR invalidation msgs */
139 #define AUDIT_INTEGRITY_RULE	    1805 /* policy rule */
140 
141 #define AUDIT_KERNEL		2000	/* Asynchronous audit record. NOT A REQUEST. */
142 
143 /* Rule flags */
144 #define AUDIT_FILTER_USER	0x00	/* Apply rule to user-generated messages */
145 #define AUDIT_FILTER_TASK	0x01	/* Apply rule at task creation (not syscall) */
146 #define AUDIT_FILTER_ENTRY	0x02	/* Apply rule at syscall entry */
147 #define AUDIT_FILTER_WATCH	0x03	/* Apply rule to file system watches */
148 #define AUDIT_FILTER_EXIT	0x04	/* Apply rule at syscall exit */
149 #define AUDIT_FILTER_TYPE	0x05	/* Apply rule at audit_log_start */
150 
151 #define AUDIT_NR_FILTERS	6
152 
153 #define AUDIT_FILTER_PREPEND	0x10	/* Prepend to front of list */
154 
155 /* Rule actions */
156 #define AUDIT_NEVER    0	/* Do not build context if rule matches */
157 #define AUDIT_POSSIBLE 1	/* Build context if rule matches  */
158 #define AUDIT_ALWAYS   2	/* Generate audit record if rule matches */
159 
160 /* Rule structure sizes -- if these change, different AUDIT_ADD and
161  * AUDIT_LIST commands must be implemented. */
162 #define AUDIT_MAX_FIELDS   64
163 #define AUDIT_MAX_KEY_LEN  256
164 #define AUDIT_BITMASK_SIZE 64
165 #define AUDIT_WORD(nr) ((__u32)((nr)/32))
166 #define AUDIT_BIT(nr)  (1 << ((nr) - AUDIT_WORD(nr)*32))
167 
168 #define AUDIT_SYSCALL_CLASSES 16
169 #define AUDIT_CLASS_DIR_WRITE 0
170 #define AUDIT_CLASS_DIR_WRITE_32 1
171 #define AUDIT_CLASS_CHATTR 2
172 #define AUDIT_CLASS_CHATTR_32 3
173 #define AUDIT_CLASS_READ 4
174 #define AUDIT_CLASS_READ_32 5
175 #define AUDIT_CLASS_WRITE 6
176 #define AUDIT_CLASS_WRITE_32 7
177 #define AUDIT_CLASS_SIGNAL 8
178 #define AUDIT_CLASS_SIGNAL_32 9
179 
180 /* This bitmask is used to validate user input.  It represents all bits that
181  * are currently used in an audit field constant understood by the kernel.
182  * If you are adding a new #define AUDIT_<whatever>, please ensure that
183  * AUDIT_UNUSED_BITS is updated if need be. */
184 #define AUDIT_UNUSED_BITS	0x07FFFC00
185 
186 /* AUDIT_FIELD_COMPARE rule list */
187 #define AUDIT_COMPARE_UID_TO_OBJ_UID	1
188 #define AUDIT_COMPARE_GID_TO_OBJ_GID	2
189 #define AUDIT_COMPARE_EUID_TO_OBJ_UID	3
190 #define AUDIT_COMPARE_EGID_TO_OBJ_GID	4
191 #define AUDIT_COMPARE_AUID_TO_OBJ_UID	5
192 #define AUDIT_COMPARE_SUID_TO_OBJ_UID	6
193 #define AUDIT_COMPARE_SGID_TO_OBJ_GID	7
194 #define AUDIT_COMPARE_FSUID_TO_OBJ_UID	8
195 #define AUDIT_COMPARE_FSGID_TO_OBJ_GID	9
196 
197 #define AUDIT_COMPARE_UID_TO_AUID	10
198 #define AUDIT_COMPARE_UID_TO_EUID	11
199 #define AUDIT_COMPARE_UID_TO_FSUID	12
200 #define AUDIT_COMPARE_UID_TO_SUID	13
201 
202 #define AUDIT_COMPARE_AUID_TO_FSUID	14
203 #define AUDIT_COMPARE_AUID_TO_SUID	15
204 #define AUDIT_COMPARE_AUID_TO_EUID	16
205 
206 #define AUDIT_COMPARE_EUID_TO_SUID	17
207 #define AUDIT_COMPARE_EUID_TO_FSUID	18
208 
209 #define AUDIT_COMPARE_SUID_TO_FSUID	19
210 
211 #define AUDIT_COMPARE_GID_TO_EGID	20
212 #define AUDIT_COMPARE_GID_TO_FSGID	21
213 #define AUDIT_COMPARE_GID_TO_SGID	22
214 
215 #define AUDIT_COMPARE_EGID_TO_FSGID	23
216 #define AUDIT_COMPARE_EGID_TO_SGID	24
217 #define AUDIT_COMPARE_SGID_TO_FSGID	25
218 
219 #define AUDIT_MAX_FIELD_COMPARE		AUDIT_COMPARE_SGID_TO_FSGID
220 
221 /* Rule fields */
222 				/* These are useful when checking the
223 				 * task structure at task creation time
224 				 * (AUDIT_PER_TASK).  */
225 #define AUDIT_PID	0
226 #define AUDIT_UID	1
227 #define AUDIT_EUID	2
228 #define AUDIT_SUID	3
229 #define AUDIT_FSUID	4
230 #define AUDIT_GID	5
231 #define AUDIT_EGID	6
232 #define AUDIT_SGID	7
233 #define AUDIT_FSGID	8
234 #define AUDIT_LOGINUID	9
235 #define AUDIT_PERS	10
236 #define AUDIT_ARCH	11
237 #define AUDIT_MSGTYPE	12
238 #define AUDIT_SUBJ_USER	13	/* security label user */
239 #define AUDIT_SUBJ_ROLE	14	/* security label role */
240 #define AUDIT_SUBJ_TYPE	15	/* security label type */
241 #define AUDIT_SUBJ_SEN	16	/* security label sensitivity label */
242 #define AUDIT_SUBJ_CLR	17	/* security label clearance label */
243 #define AUDIT_PPID	18
244 #define AUDIT_OBJ_USER	19
245 #define AUDIT_OBJ_ROLE	20
246 #define AUDIT_OBJ_TYPE	21
247 #define AUDIT_OBJ_LEV_LOW	22
248 #define AUDIT_OBJ_LEV_HIGH	23
249 
250 				/* These are ONLY useful when checking
251 				 * at syscall exit time (AUDIT_AT_EXIT). */
252 #define AUDIT_DEVMAJOR	100
253 #define AUDIT_DEVMINOR	101
254 #define AUDIT_INODE	102
255 #define AUDIT_EXIT	103
256 #define AUDIT_SUCCESS   104	/* exit >= 0; value ignored */
257 #define AUDIT_WATCH	105
258 #define AUDIT_PERM	106
259 #define AUDIT_DIR	107
260 #define AUDIT_FILETYPE	108
261 #define AUDIT_OBJ_UID	109
262 #define AUDIT_OBJ_GID	110
263 #define AUDIT_FIELD_COMPARE	111
264 
265 #define AUDIT_ARG0      200
266 #define AUDIT_ARG1      (AUDIT_ARG0+1)
267 #define AUDIT_ARG2      (AUDIT_ARG0+2)
268 #define AUDIT_ARG3      (AUDIT_ARG0+3)
269 
270 #define AUDIT_FILTERKEY	210
271 
272 #define AUDIT_NEGATE			0x80000000
273 
274 /* These are the supported operators.
275  *	4  2  1  8
276  *	=  >  <  ?
277  *	----------
278  *	0  0  0	 0	00	nonsense
279  *	0  0  0	 1	08	&  bit mask
280  *	0  0  1	 0	10	<
281  *	0  1  0	 0	20	>
282  *	0  1  1	 0	30	!=
283  *	1  0  0	 0	40	=
284  *	1  0  0	 1	48	&=  bit test
285  *	1  0  1	 0	50	<=
286  *	1  1  0	 0	60	>=
287  *	1  1  1	 1	78	all operators
288  */
289 #define AUDIT_BIT_MASK			0x08000000
290 #define AUDIT_LESS_THAN			0x10000000
291 #define AUDIT_GREATER_THAN		0x20000000
292 #define AUDIT_NOT_EQUAL			0x30000000
293 #define AUDIT_EQUAL			0x40000000
294 #define AUDIT_BIT_TEST			(AUDIT_BIT_MASK|AUDIT_EQUAL)
295 #define AUDIT_LESS_THAN_OR_EQUAL	(AUDIT_LESS_THAN|AUDIT_EQUAL)
296 #define AUDIT_GREATER_THAN_OR_EQUAL	(AUDIT_GREATER_THAN|AUDIT_EQUAL)
297 #define AUDIT_OPERATORS			(AUDIT_EQUAL|AUDIT_NOT_EQUAL|AUDIT_BIT_MASK)
298 
299 enum {
300 	Audit_equal,
301 	Audit_not_equal,
302 	Audit_bitmask,
303 	Audit_bittest,
304 	Audit_lt,
305 	Audit_gt,
306 	Audit_le,
307 	Audit_ge,
308 	Audit_bad
309 };
310 
311 /* Status symbols */
312 				/* Mask values */
313 #define AUDIT_STATUS_ENABLED		0x0001
314 #define AUDIT_STATUS_FAILURE		0x0002
315 #define AUDIT_STATUS_PID		0x0004
316 #define AUDIT_STATUS_RATE_LIMIT		0x0008
317 #define AUDIT_STATUS_BACKLOG_LIMIT	0x0010
318 				/* Failure-to-log actions */
319 #define AUDIT_FAIL_SILENT	0
320 #define AUDIT_FAIL_PRINTK	1
321 #define AUDIT_FAIL_PANIC	2
322 
323 /* distinguish syscall tables */
324 #define __AUDIT_ARCH_64BIT 0x80000000
325 #define __AUDIT_ARCH_LE	   0x40000000
326 #define AUDIT_ARCH_ALPHA	(EM_ALPHA|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE)
327 #define AUDIT_ARCH_ARM		(EM_ARM|__AUDIT_ARCH_LE)
328 #define AUDIT_ARCH_ARMEB	(EM_ARM)
329 #define AUDIT_ARCH_CRIS		(EM_CRIS|__AUDIT_ARCH_LE)
330 #define AUDIT_ARCH_FRV		(EM_FRV)
331 #define AUDIT_ARCH_H8300	(EM_H8_300)
332 #define AUDIT_ARCH_I386		(EM_386|__AUDIT_ARCH_LE)
333 #define AUDIT_ARCH_IA64		(EM_IA_64|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE)
334 #define AUDIT_ARCH_M32R		(EM_M32R)
335 #define AUDIT_ARCH_M68K		(EM_68K)
336 #define AUDIT_ARCH_MIPS		(EM_MIPS)
337 #define AUDIT_ARCH_MIPSEL	(EM_MIPS|__AUDIT_ARCH_LE)
338 #define AUDIT_ARCH_MIPS64	(EM_MIPS|__AUDIT_ARCH_64BIT)
339 #define AUDIT_ARCH_MIPSEL64	(EM_MIPS|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE)
340 #define AUDIT_ARCH_PARISC	(EM_PARISC)
341 #define AUDIT_ARCH_PARISC64	(EM_PARISC|__AUDIT_ARCH_64BIT)
342 #define AUDIT_ARCH_PPC		(EM_PPC)
343 #define AUDIT_ARCH_PPC64	(EM_PPC64|__AUDIT_ARCH_64BIT)
344 #define AUDIT_ARCH_S390		(EM_S390)
345 #define AUDIT_ARCH_S390X	(EM_S390|__AUDIT_ARCH_64BIT)
346 #define AUDIT_ARCH_SH		(EM_SH)
347 #define AUDIT_ARCH_SHEL		(EM_SH|__AUDIT_ARCH_LE)
348 #define AUDIT_ARCH_SH64		(EM_SH|__AUDIT_ARCH_64BIT)
349 #define AUDIT_ARCH_SHEL64	(EM_SH|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE)
350 #define AUDIT_ARCH_SPARC	(EM_SPARC)
351 #define AUDIT_ARCH_SPARC64	(EM_SPARCV9|__AUDIT_ARCH_64BIT)
352 #define AUDIT_ARCH_X86_64	(EM_X86_64|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE)
353 
354 #define AUDIT_PERM_EXEC		1
355 #define AUDIT_PERM_WRITE	2
356 #define AUDIT_PERM_READ		4
357 #define AUDIT_PERM_ATTR		8
358 
359 struct audit_status {
360 	__u32		mask;		/* Bit mask for valid entries */
361 	__u32		enabled;	/* 1 = enabled, 0 = disabled */
362 	__u32		failure;	/* Failure-to-log action */
363 	__u32		pid;		/* pid of auditd process */
364 	__u32		rate_limit;	/* messages rate limit (per second) */
365 	__u32		backlog_limit;	/* waiting messages limit */
366 	__u32		lost;		/* messages lost */
367 	__u32		backlog;	/* messages waiting in queue */
368 };
369 
370 struct audit_tty_status {
371 	__u32		enabled; /* 1 = enabled, 0 = disabled */
372 };
373 
374 /* audit_rule_data supports filter rules with both integer and string
375  * fields.  It corresponds with AUDIT_ADD_RULE, AUDIT_DEL_RULE and
376  * AUDIT_LIST_RULES requests.
377  */
378 struct audit_rule_data {
379 	__u32		flags;	/* AUDIT_PER_{TASK,CALL}, AUDIT_PREPEND */
380 	__u32		action;	/* AUDIT_NEVER, AUDIT_POSSIBLE, AUDIT_ALWAYS */
381 	__u32		field_count;
382 	__u32		mask[AUDIT_BITMASK_SIZE]; /* syscall(s) affected */
383 	__u32		fields[AUDIT_MAX_FIELDS];
384 	__u32		values[AUDIT_MAX_FIELDS];
385 	__u32		fieldflags[AUDIT_MAX_FIELDS];
386 	__u32		buflen;	/* total length of string fields */
387 	char		buf[0];	/* string fields buffer */
388 };
389 
390 /* audit_rule is supported to maintain backward compatibility with
391  * userspace.  It supports integer fields only and corresponds to
392  * AUDIT_ADD, AUDIT_DEL and AUDIT_LIST requests.
393  */
394 struct audit_rule {		/* for AUDIT_LIST, AUDIT_ADD, and AUDIT_DEL */
395 	__u32		flags;	/* AUDIT_PER_{TASK,CALL}, AUDIT_PREPEND */
396 	__u32		action;	/* AUDIT_NEVER, AUDIT_POSSIBLE, AUDIT_ALWAYS */
397 	__u32		field_count;
398 	__u32		mask[AUDIT_BITMASK_SIZE];
399 	__u32		fields[AUDIT_MAX_FIELDS];
400 	__u32		values[AUDIT_MAX_FIELDS];
401 };
402 
403 #ifdef __KERNEL__
404 #include <linux/sched.h>
405 
406 struct audit_sig_info {
407 	uid_t		uid;
408 	pid_t		pid;
409 	char		ctx[0];
410 };
411 
412 struct audit_buffer;
413 struct audit_context;
414 struct inode;
415 struct netlink_skb_parms;
416 struct path;
417 struct linux_binprm;
418 struct mq_attr;
419 struct mqstat;
420 struct audit_watch;
421 struct audit_tree;
422 
423 struct audit_krule {
424 	int			vers_ops;
425 	u32			flags;
426 	u32			listnr;
427 	u32			action;
428 	u32			mask[AUDIT_BITMASK_SIZE];
429 	u32			buflen; /* for data alloc on list rules */
430 	u32			field_count;
431 	char			*filterkey; /* ties events to rules */
432 	struct audit_field	*fields;
433 	struct audit_field	*arch_f; /* quick access to arch field */
434 	struct audit_field	*inode_f; /* quick access to an inode field */
435 	struct audit_watch	*watch;	/* associated watch */
436 	struct audit_tree	*tree;	/* associated watched tree */
437 	struct list_head	rlist;	/* entry in audit_{watch,tree}.rules list */
438 	struct list_head	list;	/* for AUDIT_LIST* purposes only */
439 	u64			prio;
440 };
441 
442 struct audit_field {
443 	u32				type;
444 	u32				val;
445 	kuid_t				uid;
446 	kgid_t				gid;
447 	u32				op;
448 	char				*lsm_str;
449 	void				*lsm_rule;
450 };
451 
452 extern int __init audit_register_class(int class, unsigned *list);
453 extern int audit_classify_syscall(int abi, unsigned syscall);
454 extern int audit_classify_arch(int arch);
455 #ifdef CONFIG_AUDITSYSCALL
456 /* These are defined in auditsc.c */
457 				/* Public API */
458 extern int  audit_alloc(struct task_struct *task);
459 extern void __audit_free(struct task_struct *task);
460 extern void __audit_syscall_entry(int arch,
461 				  int major, unsigned long a0, unsigned long a1,
462 				  unsigned long a2, unsigned long a3);
463 extern void __audit_syscall_exit(int ret_success, long ret_value);
464 extern void __audit_getname(const char *name);
465 extern void audit_putname(const char *name);
466 extern void __audit_inode(const char *name, const struct dentry *dentry);
467 extern void __audit_inode_child(const struct dentry *dentry,
468 				const struct inode *parent);
469 extern void __audit_seccomp(unsigned long syscall, long signr, int code);
470 extern void __audit_ptrace(struct task_struct *t);
471 
472 static inline int audit_dummy_context(void)
473 {
474 	void *p = current->audit_context;
475 	return !p || *(int *)p;
476 }
477 static inline void audit_free(struct task_struct *task)
478 {
479 	if (unlikely(task->audit_context))
480 		__audit_free(task);
481 }
482 static inline void audit_syscall_entry(int arch, int major, unsigned long a0,
483 				       unsigned long a1, unsigned long a2,
484 				       unsigned long a3)
485 {
486 	if (unlikely(!audit_dummy_context()))
487 		__audit_syscall_entry(arch, major, a0, a1, a2, a3);
488 }
489 static inline void audit_syscall_exit(void *pt_regs)
490 {
491 	if (unlikely(current->audit_context)) {
492 		int success = is_syscall_success(pt_regs);
493 		int return_code = regs_return_value(pt_regs);
494 
495 		__audit_syscall_exit(success, return_code);
496 	}
497 }
498 static inline void audit_getname(const char *name)
499 {
500 	if (unlikely(!audit_dummy_context()))
501 		__audit_getname(name);
502 }
503 static inline void audit_inode(const char *name, const struct dentry *dentry) {
504 	if (unlikely(!audit_dummy_context()))
505 		__audit_inode(name, dentry);
506 }
507 static inline void audit_inode_child(const struct dentry *dentry,
508 				     const struct inode *parent) {
509 	if (unlikely(!audit_dummy_context()))
510 		__audit_inode_child(dentry, parent);
511 }
512 void audit_core_dumps(long signr);
513 
514 static inline void audit_seccomp(unsigned long syscall, long signr, int code)
515 {
516 	if (unlikely(!audit_dummy_context()))
517 		__audit_seccomp(syscall, signr, code);
518 }
519 
520 static inline void audit_ptrace(struct task_struct *t)
521 {
522 	if (unlikely(!audit_dummy_context()))
523 		__audit_ptrace(t);
524 }
525 
526 				/* Private API (for audit.c only) */
527 extern unsigned int audit_serial(void);
528 extern int auditsc_get_stamp(struct audit_context *ctx,
529 			      struct timespec *t, unsigned int *serial);
530 extern int audit_set_loginuid(kuid_t loginuid);
531 
532 static inline kuid_t audit_get_loginuid(struct task_struct *tsk)
533 {
534 	return tsk->loginuid;
535 }
536 
537 static inline int audit_get_sessionid(struct task_struct *tsk)
538 {
539 	return tsk->sessionid;
540 }
541 
542 extern void audit_log_task_context(struct audit_buffer *ab);
543 extern void audit_log_task_info(struct audit_buffer *ab, struct task_struct *tsk);
544 extern void __audit_ipc_obj(struct kern_ipc_perm *ipcp);
545 extern void __audit_ipc_set_perm(unsigned long qbytes, uid_t uid, gid_t gid, umode_t mode);
546 extern int __audit_bprm(struct linux_binprm *bprm);
547 extern void __audit_socketcall(int nargs, unsigned long *args);
548 extern int __audit_sockaddr(int len, void *addr);
549 extern void __audit_fd_pair(int fd1, int fd2);
550 extern void __audit_mq_open(int oflag, umode_t mode, struct mq_attr *attr);
551 extern void __audit_mq_sendrecv(mqd_t mqdes, size_t msg_len, unsigned int msg_prio, const struct timespec *abs_timeout);
552 extern void __audit_mq_notify(mqd_t mqdes, const struct sigevent *notification);
553 extern void __audit_mq_getsetattr(mqd_t mqdes, struct mq_attr *mqstat);
554 extern int __audit_log_bprm_fcaps(struct linux_binprm *bprm,
555 				  const struct cred *new,
556 				  const struct cred *old);
557 extern void __audit_log_capset(pid_t pid, const struct cred *new, const struct cred *old);
558 extern void __audit_mmap_fd(int fd, int flags);
559 
560 static inline void audit_ipc_obj(struct kern_ipc_perm *ipcp)
561 {
562 	if (unlikely(!audit_dummy_context()))
563 		__audit_ipc_obj(ipcp);
564 }
565 static inline void audit_fd_pair(int fd1, int fd2)
566 {
567 	if (unlikely(!audit_dummy_context()))
568 		__audit_fd_pair(fd1, fd2);
569 }
570 static inline void audit_ipc_set_perm(unsigned long qbytes, uid_t uid, gid_t gid, umode_t mode)
571 {
572 	if (unlikely(!audit_dummy_context()))
573 		__audit_ipc_set_perm(qbytes, uid, gid, mode);
574 }
575 static inline int audit_bprm(struct linux_binprm *bprm)
576 {
577 	if (unlikely(!audit_dummy_context()))
578 		return __audit_bprm(bprm);
579 	return 0;
580 }
581 static inline void audit_socketcall(int nargs, unsigned long *args)
582 {
583 	if (unlikely(!audit_dummy_context()))
584 		__audit_socketcall(nargs, args);
585 }
586 static inline int audit_sockaddr(int len, void *addr)
587 {
588 	if (unlikely(!audit_dummy_context()))
589 		return __audit_sockaddr(len, addr);
590 	return 0;
591 }
592 static inline void audit_mq_open(int oflag, umode_t mode, struct mq_attr *attr)
593 {
594 	if (unlikely(!audit_dummy_context()))
595 		__audit_mq_open(oflag, mode, attr);
596 }
597 static inline void audit_mq_sendrecv(mqd_t mqdes, size_t msg_len, unsigned int msg_prio, const struct timespec *abs_timeout)
598 {
599 	if (unlikely(!audit_dummy_context()))
600 		__audit_mq_sendrecv(mqdes, msg_len, msg_prio, abs_timeout);
601 }
602 static inline void audit_mq_notify(mqd_t mqdes, const struct sigevent *notification)
603 {
604 	if (unlikely(!audit_dummy_context()))
605 		__audit_mq_notify(mqdes, notification);
606 }
607 static inline void audit_mq_getsetattr(mqd_t mqdes, struct mq_attr *mqstat)
608 {
609 	if (unlikely(!audit_dummy_context()))
610 		__audit_mq_getsetattr(mqdes, mqstat);
611 }
612 
613 static inline int audit_log_bprm_fcaps(struct linux_binprm *bprm,
614 				       const struct cred *new,
615 				       const struct cred *old)
616 {
617 	if (unlikely(!audit_dummy_context()))
618 		return __audit_log_bprm_fcaps(bprm, new, old);
619 	return 0;
620 }
621 
622 static inline void audit_log_capset(pid_t pid, const struct cred *new,
623 				   const struct cred *old)
624 {
625 	if (unlikely(!audit_dummy_context()))
626 		__audit_log_capset(pid, new, old);
627 }
628 
629 static inline void audit_mmap_fd(int fd, int flags)
630 {
631 	if (unlikely(!audit_dummy_context()))
632 		__audit_mmap_fd(fd, flags);
633 }
634 
635 extern int audit_n_rules;
636 extern int audit_signals;
637 #else /* CONFIG_AUDITSYSCALL */
638 static inline int audit_alloc(struct task_struct *task)
639 {
640 	return 0;
641 }
642 static inline void audit_free(struct task_struct *task)
643 { }
644 static inline void audit_syscall_entry(int arch, int major, unsigned long a0,
645 				       unsigned long a1, unsigned long a2,
646 				       unsigned long a3)
647 { }
648 static inline void audit_syscall_exit(void *pt_regs)
649 { }
650 static inline int audit_dummy_context(void)
651 {
652 	return 1;
653 }
654 static inline void audit_getname(const char *name)
655 { }
656 static inline void audit_putname(const char *name)
657 { }
658 static inline void __audit_inode(const char *name, const struct dentry *dentry)
659 { }
660 static inline void __audit_inode_child(const struct dentry *dentry,
661 					const struct inode *parent)
662 { }
663 static inline void audit_inode(const char *name, const struct dentry *dentry)
664 { }
665 static inline void audit_inode_child(const struct dentry *dentry,
666 				     const struct inode *parent)
667 { }
668 static inline void audit_core_dumps(long signr)
669 { }
670 static inline void __audit_seccomp(unsigned long syscall, long signr, int code)
671 { }
672 static inline void audit_seccomp(unsigned long syscall, long signr, int code)
673 { }
674 static inline int auditsc_get_stamp(struct audit_context *ctx,
675 			      struct timespec *t, unsigned int *serial)
676 {
677 	return 0;
678 }
679 static inline kuid_t audit_get_loginuid(struct task_struct *tsk)
680 {
681 	return INVALID_UID;
682 }
683 static inline int audit_get_sessionid(struct task_struct *tsk)
684 {
685 	return -1;
686 }
687 static inline void audit_log_task_context(struct audit_buffer *ab)
688 { }
689 static inline void audit_log_task_info(struct audit_buffer *ab,
690 				       struct task_struct *tsk)
691 { }
692 static inline void audit_ipc_obj(struct kern_ipc_perm *ipcp)
693 { }
694 static inline void audit_ipc_set_perm(unsigned long qbytes, uid_t uid,
695 					gid_t gid, umode_t mode)
696 { }
697 static inline int audit_bprm(struct linux_binprm *bprm)
698 {
699 	return 0;
700 }
701 static inline void audit_socketcall(int nargs, unsigned long *args)
702 { }
703 static inline void audit_fd_pair(int fd1, int fd2)
704 { }
705 static inline int audit_sockaddr(int len, void *addr)
706 {
707 	return 0;
708 }
709 static inline void audit_mq_open(int oflag, umode_t mode, struct mq_attr *attr)
710 { }
711 static inline void audit_mq_sendrecv(mqd_t mqdes, size_t msg_len,
712 				     unsigned int msg_prio,
713 				     const struct timespec *abs_timeout)
714 { }
715 static inline void audit_mq_notify(mqd_t mqdes,
716 				   const struct sigevent *notification)
717 { }
718 static inline void audit_mq_getsetattr(mqd_t mqdes, struct mq_attr *mqstat)
719 { }
720 static inline int audit_log_bprm_fcaps(struct linux_binprm *bprm,
721 				       const struct cred *new,
722 				       const struct cred *old)
723 {
724 	return 0;
725 }
726 static inline void audit_log_capset(pid_t pid, const struct cred *new,
727 				   const struct cred *old)
728 { }
729 static inline void audit_mmap_fd(int fd, int flags)
730 { }
731 static inline void audit_ptrace(struct task_struct *t)
732 { }
733 #define audit_n_rules 0
734 #define audit_signals 0
735 #endif /* CONFIG_AUDITSYSCALL */
736 
737 #ifdef CONFIG_AUDIT
738 /* These are defined in audit.c */
739 				/* Public API */
740 extern __printf(4, 5)
741 void audit_log(struct audit_context *ctx, gfp_t gfp_mask, int type,
742 	       const char *fmt, ...);
743 
744 extern struct audit_buffer *audit_log_start(struct audit_context *ctx, gfp_t gfp_mask, int type);
745 extern __printf(2, 3)
746 void audit_log_format(struct audit_buffer *ab, const char *fmt, ...);
747 extern void		    audit_log_end(struct audit_buffer *ab);
748 extern int		    audit_string_contains_control(const char *string,
749 							  size_t len);
750 extern void		    audit_log_n_hex(struct audit_buffer *ab,
751 					  const unsigned char *buf,
752 					  size_t len);
753 extern void		    audit_log_n_string(struct audit_buffer *ab,
754 					       const char *buf,
755 					       size_t n);
756 extern void		    audit_log_n_untrustedstring(struct audit_buffer *ab,
757 							const char *string,
758 							size_t n);
759 extern void		    audit_log_untrustedstring(struct audit_buffer *ab,
760 						      const char *string);
761 extern void		    audit_log_d_path(struct audit_buffer *ab,
762 					     const char *prefix,
763 					     const struct path *path);
764 extern void		    audit_log_key(struct audit_buffer *ab,
765 					  char *key);
766 extern void		    audit_log_link_denied(const char *operation,
767 						  struct path *link);
768 extern void		    audit_log_lost(const char *message);
769 #ifdef CONFIG_SECURITY
770 extern void 		    audit_log_secctx(struct audit_buffer *ab, u32 secid);
771 #else
772 static inline void	    audit_log_secctx(struct audit_buffer *ab, u32 secid)
773 { }
774 #endif
775 
776 extern int		    audit_update_lsm_rules(void);
777 
778 				/* Private API (for audit.c only) */
779 extern int audit_filter_user(void);
780 extern int audit_filter_type(int type);
781 extern int  audit_receive_filter(int type, int pid, int seq,
782 				void *data, size_t datasz, kuid_t loginuid,
783 				u32 sessionid, u32 sid);
784 extern int audit_enabled;
785 #else /* CONFIG_AUDIT */
786 static inline __printf(4, 5)
787 void audit_log(struct audit_context *ctx, gfp_t gfp_mask, int type,
788 	       const char *fmt, ...)
789 { }
790 static inline struct audit_buffer *audit_log_start(struct audit_context *ctx,
791 						   gfp_t gfp_mask, int type)
792 {
793 	return NULL;
794 }
795 static inline __printf(2, 3)
796 void audit_log_format(struct audit_buffer *ab, const char *fmt, ...)
797 { }
798 static inline void audit_log_end(struct audit_buffer *ab)
799 { }
800 static inline void audit_log_n_hex(struct audit_buffer *ab,
801 				   const unsigned char *buf, size_t len)
802 { }
803 static inline void audit_log_n_string(struct audit_buffer *ab,
804 				      const char *buf, size_t n)
805 { }
806 static inline void  audit_log_n_untrustedstring(struct audit_buffer *ab,
807 						const char *string, size_t n)
808 { }
809 static inline void audit_log_untrustedstring(struct audit_buffer *ab,
810 					     const char *string)
811 { }
812 static inline void audit_log_d_path(struct audit_buffer *ab,
813 				    const char *prefix,
814 				    const struct path *path)
815 { }
816 static inline void audit_log_key(struct audit_buffer *ab, char *key)
817 { }
818 static inline void audit_log_link_denied(const char *string,
819 					 const struct path *link)
820 { }
821 static inline void audit_log_secctx(struct audit_buffer *ab, u32 secid)
822 { }
823 #define audit_enabled 0
824 #endif /* CONFIG_AUDIT */
825 static inline void audit_log_string(struct audit_buffer *ab, const char *buf)
826 {
827 	audit_log_n_string(ab, buf, strlen(buf));
828 }
829 
830 #endif
831 #endif
832