xref: /linux-6.15/include/linux/audit.h (revision e8fa600e)
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 	u32				op;
446 	char				*lsm_str;
447 	void				*lsm_rule;
448 };
449 
450 extern int __init audit_register_class(int class, unsigned *list);
451 extern int audit_classify_syscall(int abi, unsigned syscall);
452 extern int audit_classify_arch(int arch);
453 #ifdef CONFIG_AUDITSYSCALL
454 /* These are defined in auditsc.c */
455 				/* Public API */
456 extern int  audit_alloc(struct task_struct *task);
457 extern void __audit_free(struct task_struct *task);
458 extern void __audit_syscall_entry(int arch,
459 				  int major, unsigned long a0, unsigned long a1,
460 				  unsigned long a2, unsigned long a3);
461 extern void __audit_syscall_exit(int ret_success, long ret_value);
462 extern void __audit_getname(const char *name);
463 extern void audit_putname(const char *name);
464 extern void __audit_inode(const char *name, const struct dentry *dentry);
465 extern void __audit_inode_child(const struct dentry *dentry,
466 				const struct inode *parent);
467 extern void __audit_seccomp(unsigned long syscall, long signr, int code);
468 extern void __audit_ptrace(struct task_struct *t);
469 
470 static inline int audit_dummy_context(void)
471 {
472 	void *p = current->audit_context;
473 	return !p || *(int *)p;
474 }
475 static inline void audit_free(struct task_struct *task)
476 {
477 	if (unlikely(task->audit_context))
478 		__audit_free(task);
479 }
480 static inline void audit_syscall_entry(int arch, int major, unsigned long a0,
481 				       unsigned long a1, unsigned long a2,
482 				       unsigned long a3)
483 {
484 	if (unlikely(!audit_dummy_context()))
485 		__audit_syscall_entry(arch, major, a0, a1, a2, a3);
486 }
487 static inline void audit_syscall_exit(void *pt_regs)
488 {
489 	if (unlikely(current->audit_context)) {
490 		int success = is_syscall_success(pt_regs);
491 		int return_code = regs_return_value(pt_regs);
492 
493 		__audit_syscall_exit(success, return_code);
494 	}
495 }
496 static inline void audit_getname(const char *name)
497 {
498 	if (unlikely(!audit_dummy_context()))
499 		__audit_getname(name);
500 }
501 static inline void audit_inode(const char *name, const struct dentry *dentry) {
502 	if (unlikely(!audit_dummy_context()))
503 		__audit_inode(name, dentry);
504 }
505 static inline void audit_inode_child(const struct dentry *dentry,
506 				     const struct inode *parent) {
507 	if (unlikely(!audit_dummy_context()))
508 		__audit_inode_child(dentry, parent);
509 }
510 void audit_core_dumps(long signr);
511 
512 static inline void audit_seccomp(unsigned long syscall, long signr, int code)
513 {
514 	if (unlikely(!audit_dummy_context()))
515 		__audit_seccomp(syscall, signr, code);
516 }
517 
518 static inline void audit_ptrace(struct task_struct *t)
519 {
520 	if (unlikely(!audit_dummy_context()))
521 		__audit_ptrace(t);
522 }
523 
524 				/* Private API (for audit.c only) */
525 extern unsigned int audit_serial(void);
526 extern int auditsc_get_stamp(struct audit_context *ctx,
527 			      struct timespec *t, unsigned int *serial);
528 extern int  audit_set_loginuid(uid_t loginuid);
529 #define audit_get_loginuid(t) ((t)->loginuid)
530 #define audit_get_sessionid(t) ((t)->sessionid)
531 extern void audit_log_task_context(struct audit_buffer *ab);
532 extern void __audit_ipc_obj(struct kern_ipc_perm *ipcp);
533 extern void __audit_ipc_set_perm(unsigned long qbytes, uid_t uid, gid_t gid, umode_t mode);
534 extern int __audit_bprm(struct linux_binprm *bprm);
535 extern void __audit_socketcall(int nargs, unsigned long *args);
536 extern int __audit_sockaddr(int len, void *addr);
537 extern void __audit_fd_pair(int fd1, int fd2);
538 extern void __audit_mq_open(int oflag, umode_t mode, struct mq_attr *attr);
539 extern void __audit_mq_sendrecv(mqd_t mqdes, size_t msg_len, unsigned int msg_prio, const struct timespec *abs_timeout);
540 extern void __audit_mq_notify(mqd_t mqdes, const struct sigevent *notification);
541 extern void __audit_mq_getsetattr(mqd_t mqdes, struct mq_attr *mqstat);
542 extern int __audit_log_bprm_fcaps(struct linux_binprm *bprm,
543 				  const struct cred *new,
544 				  const struct cred *old);
545 extern void __audit_log_capset(pid_t pid, const struct cred *new, const struct cred *old);
546 extern void __audit_mmap_fd(int fd, int flags);
547 
548 static inline void audit_ipc_obj(struct kern_ipc_perm *ipcp)
549 {
550 	if (unlikely(!audit_dummy_context()))
551 		__audit_ipc_obj(ipcp);
552 }
553 static inline void audit_fd_pair(int fd1, int fd2)
554 {
555 	if (unlikely(!audit_dummy_context()))
556 		__audit_fd_pair(fd1, fd2);
557 }
558 static inline void audit_ipc_set_perm(unsigned long qbytes, uid_t uid, gid_t gid, umode_t mode)
559 {
560 	if (unlikely(!audit_dummy_context()))
561 		__audit_ipc_set_perm(qbytes, uid, gid, mode);
562 }
563 static inline int audit_bprm(struct linux_binprm *bprm)
564 {
565 	if (unlikely(!audit_dummy_context()))
566 		return __audit_bprm(bprm);
567 	return 0;
568 }
569 static inline void audit_socketcall(int nargs, unsigned long *args)
570 {
571 	if (unlikely(!audit_dummy_context()))
572 		__audit_socketcall(nargs, args);
573 }
574 static inline int audit_sockaddr(int len, void *addr)
575 {
576 	if (unlikely(!audit_dummy_context()))
577 		return __audit_sockaddr(len, addr);
578 	return 0;
579 }
580 static inline void audit_mq_open(int oflag, umode_t mode, struct mq_attr *attr)
581 {
582 	if (unlikely(!audit_dummy_context()))
583 		__audit_mq_open(oflag, mode, attr);
584 }
585 static inline void audit_mq_sendrecv(mqd_t mqdes, size_t msg_len, unsigned int msg_prio, const struct timespec *abs_timeout)
586 {
587 	if (unlikely(!audit_dummy_context()))
588 		__audit_mq_sendrecv(mqdes, msg_len, msg_prio, abs_timeout);
589 }
590 static inline void audit_mq_notify(mqd_t mqdes, const struct sigevent *notification)
591 {
592 	if (unlikely(!audit_dummy_context()))
593 		__audit_mq_notify(mqdes, notification);
594 }
595 static inline void audit_mq_getsetattr(mqd_t mqdes, struct mq_attr *mqstat)
596 {
597 	if (unlikely(!audit_dummy_context()))
598 		__audit_mq_getsetattr(mqdes, mqstat);
599 }
600 
601 static inline int audit_log_bprm_fcaps(struct linux_binprm *bprm,
602 				       const struct cred *new,
603 				       const struct cred *old)
604 {
605 	if (unlikely(!audit_dummy_context()))
606 		return __audit_log_bprm_fcaps(bprm, new, old);
607 	return 0;
608 }
609 
610 static inline void audit_log_capset(pid_t pid, const struct cred *new,
611 				   const struct cred *old)
612 {
613 	if (unlikely(!audit_dummy_context()))
614 		__audit_log_capset(pid, new, old);
615 }
616 
617 static inline void audit_mmap_fd(int fd, int flags)
618 {
619 	if (unlikely(!audit_dummy_context()))
620 		__audit_mmap_fd(fd, flags);
621 }
622 
623 extern int audit_n_rules;
624 extern int audit_signals;
625 #else /* CONFIG_AUDITSYSCALL */
626 #define audit_alloc(t) ({ 0; })
627 #define audit_free(t) do { ; } while (0)
628 #define audit_syscall_entry(ta,a,b,c,d,e) do { ; } while (0)
629 #define audit_syscall_exit(r) do { ; } while (0)
630 #define audit_dummy_context() 1
631 #define audit_getname(n) do { ; } while (0)
632 #define audit_putname(n) do { ; } while (0)
633 #define __audit_inode(n,d) do { ; } while (0)
634 #define __audit_inode_child(i,p) do { ; } while (0)
635 #define audit_inode(n,d) do { (void)(d); } while (0)
636 #define audit_inode_child(i,p) do { ; } while (0)
637 #define audit_core_dumps(i) do { ; } while (0)
638 #define audit_seccomp(i,s,c) do { ; } while (0)
639 #define auditsc_get_stamp(c,t,s) (0)
640 #define audit_get_loginuid(t) (-1)
641 #define audit_get_sessionid(t) (-1)
642 #define audit_log_task_context(b) do { ; } while (0)
643 #define audit_ipc_obj(i) ((void)0)
644 #define audit_ipc_set_perm(q,u,g,m) ((void)0)
645 #define audit_bprm(p) ({ 0; })
646 #define audit_socketcall(n,a) ((void)0)
647 #define audit_fd_pair(n,a) ((void)0)
648 #define audit_sockaddr(len, addr) ({ 0; })
649 #define audit_mq_open(o,m,a) ((void)0)
650 #define audit_mq_sendrecv(d,l,p,t) ((void)0)
651 #define audit_mq_notify(d,n) ((void)0)
652 #define audit_mq_getsetattr(d,s) ((void)0)
653 #define audit_log_bprm_fcaps(b, ncr, ocr) ({ 0; })
654 #define audit_log_capset(pid, ncr, ocr) ((void)0)
655 #define audit_mmap_fd(fd, flags) ((void)0)
656 #define audit_ptrace(t) ((void)0)
657 #define audit_n_rules 0
658 #define audit_signals 0
659 #endif /* CONFIG_AUDITSYSCALL */
660 
661 #ifdef CONFIG_AUDIT
662 /* These are defined in audit.c */
663 				/* Public API */
664 extern __printf(4, 5)
665 void audit_log(struct audit_context *ctx, gfp_t gfp_mask, int type,
666 	       const char *fmt, ...);
667 
668 extern struct audit_buffer *audit_log_start(struct audit_context *ctx, gfp_t gfp_mask, int type);
669 extern __printf(2, 3)
670 void audit_log_format(struct audit_buffer *ab, const char *fmt, ...);
671 extern void		    audit_log_end(struct audit_buffer *ab);
672 extern int		    audit_string_contains_control(const char *string,
673 							  size_t len);
674 extern void		    audit_log_n_hex(struct audit_buffer *ab,
675 					  const unsigned char *buf,
676 					  size_t len);
677 extern void		    audit_log_n_string(struct audit_buffer *ab,
678 					       const char *buf,
679 					       size_t n);
680 #define audit_log_string(a,b) audit_log_n_string(a, b, strlen(b));
681 extern void		    audit_log_n_untrustedstring(struct audit_buffer *ab,
682 							const char *string,
683 							size_t n);
684 extern void		    audit_log_untrustedstring(struct audit_buffer *ab,
685 						      const char *string);
686 extern void		    audit_log_d_path(struct audit_buffer *ab,
687 					     const char *prefix,
688 					     const struct path *path);
689 extern void		    audit_log_key(struct audit_buffer *ab,
690 					  char *key);
691 extern void		    audit_log_link_denied(const char *operation,
692 						  struct path *link);
693 extern void		    audit_log_lost(const char *message);
694 #ifdef CONFIG_SECURITY
695 extern void 		    audit_log_secctx(struct audit_buffer *ab, u32 secid);
696 #else
697 #define audit_log_secctx(b,s) do { ; } while (0)
698 #endif
699 
700 extern int		    audit_update_lsm_rules(void);
701 
702 				/* Private API (for audit.c only) */
703 extern int audit_filter_user(struct netlink_skb_parms *cb);
704 extern int audit_filter_type(int type);
705 extern int  audit_receive_filter(int type, int pid, int uid, int seq,
706 				void *data, size_t datasz, uid_t loginuid,
707 				u32 sessionid, u32 sid);
708 extern int audit_enabled;
709 #else
710 #define audit_log(c,g,t,f,...) do { ; } while (0)
711 #define audit_log_start(c,g,t) ({ NULL; })
712 #define audit_log_vformat(b,f,a) do { ; } while (0)
713 #define audit_log_format(b,f,...) do { ; } while (0)
714 #define audit_log_end(b) do { ; } while (0)
715 #define audit_log_n_hex(a,b,l) do { ; } while (0)
716 #define audit_log_n_string(a,c,l) do { ; } while (0)
717 #define audit_log_string(a,c) do { ; } while (0)
718 #define audit_log_n_untrustedstring(a,n,s) do { ; } while (0)
719 #define audit_log_untrustedstring(a,s) do { ; } while (0)
720 #define audit_log_d_path(b, p, d) do { ; } while (0)
721 #define audit_log_key(b, k) do { ; } while (0)
722 #define audit_log_link_denied(o, l) do { ; } while (0)
723 #define audit_log_secctx(b,s) do { ; } while (0)
724 #define audit_enabled 0
725 #endif
726 #endif
727 #endif
728