1 /*
2  * AppArmor security module
3  *
4  * This file contains AppArmor auditing function definitions.
5  *
6  * Copyright (C) 1998-2008 Novell/SUSE
7  * Copyright 2009-2010 Canonical Ltd.
8  *
9  * This program is free software; you can redistribute it and/or
10  * modify it under the terms of the GNU General Public License as
11  * published by the Free Software Foundation, version 2 of the
12  * License.
13  */
14 
15 #ifndef __AA_AUDIT_H
16 #define __AA_AUDIT_H
17 
18 #include <linux/audit.h>
19 #include <linux/fs.h>
20 #include <linux/lsm_audit.h>
21 #include <linux/sched.h>
22 #include <linux/slab.h>
23 
24 #include "file.h"
25 #include "label.h"
26 
27 extern const char *const audit_mode_names[];
28 #define AUDIT_MAX_INDEX 5
29 enum audit_mode {
30 	AUDIT_NORMAL,		/* follow normal auditing of accesses */
31 	AUDIT_QUIET_DENIED,	/* quiet all denied access messages */
32 	AUDIT_QUIET,		/* quiet all messages */
33 	AUDIT_NOQUIET,		/* do not quiet audit messages */
34 	AUDIT_ALL		/* audit all accesses */
35 };
36 
37 enum audit_type {
38 	AUDIT_APPARMOR_AUDIT,
39 	AUDIT_APPARMOR_ALLOWED,
40 	AUDIT_APPARMOR_DENIED,
41 	AUDIT_APPARMOR_HINT,
42 	AUDIT_APPARMOR_STATUS,
43 	AUDIT_APPARMOR_ERROR,
44 	AUDIT_APPARMOR_KILL,
45 	AUDIT_APPARMOR_AUTO
46 };
47 
48 #define OP_NULL NULL
49 
50 #define OP_SYSCTL "sysctl"
51 #define OP_CAPABLE "capable"
52 
53 #define OP_UNLINK "unlink"
54 #define OP_MKDIR "mkdir"
55 #define OP_RMDIR "rmdir"
56 #define OP_MKNOD "mknod"
57 #define OP_TRUNC "truncate"
58 #define OP_LINK "link"
59 #define OP_SYMLINK "symlink"
60 #define OP_RENAME_SRC "rename_src"
61 #define OP_RENAME_DEST "rename_dest"
62 #define OP_CHMOD "chmod"
63 #define OP_CHOWN "chown"
64 #define OP_GETATTR "getattr"
65 #define OP_OPEN "open"
66 
67 #define OP_FRECEIVE "file_receive"
68 #define OP_FPERM "file_perm"
69 #define OP_FLOCK "file_lock"
70 #define OP_FMMAP "file_mmap"
71 #define OP_FMPROT "file_mprotect"
72 #define OP_INHERIT "file_inherit"
73 
74 #define OP_PIVOTROOT "pivotroot"
75 #define OP_MOUNT "mount"
76 #define OP_UMOUNT "umount"
77 
78 #define OP_CREATE "create"
79 #define OP_POST_CREATE "post_create"
80 #define OP_BIND "bind"
81 #define OP_CONNECT "connect"
82 #define OP_LISTEN "listen"
83 #define OP_ACCEPT "accept"
84 #define OP_SENDMSG "sendmsg"
85 #define OP_RECVMSG "recvmsg"
86 #define OP_GETSOCKNAME "getsockname"
87 #define OP_GETPEERNAME "getpeername"
88 #define OP_GETSOCKOPT "getsockopt"
89 #define OP_SETSOCKOPT "setsockopt"
90 #define OP_SHUTDOWN "socket_shutdown"
91 
92 #define OP_PTRACE "ptrace"
93 #define OP_SIGNAL "signal"
94 
95 #define OP_EXEC "exec"
96 
97 #define OP_CHANGE_HAT "change_hat"
98 #define OP_CHANGE_PROFILE "change_profile"
99 #define OP_CHANGE_ONEXEC "change_onexec"
100 #define OP_STACK "stack"
101 #define OP_STACK_ONEXEC "stack_onexec"
102 
103 #define OP_SETPROCATTR "setprocattr"
104 #define OP_SETRLIMIT "setrlimit"
105 
106 #define OP_PROF_REPL "profile_replace"
107 #define OP_PROF_LOAD "profile_load"
108 #define OP_PROF_RM "profile_remove"
109 
110 
111 struct apparmor_audit_data {
112 	int error;
113 	int type;
114 	const char *op;
115 	struct aa_label *label;
116 	const char *name;
117 	const char *info;
118 	u32 request;
119 	u32 denied;
120 	union {
121 		/* these entries require a custom callback fn */
122 		struct {
123 			struct aa_label *peer;
124 			struct {
125 				const char *target;
126 				kuid_t ouid;
127 			} fs;
128 		};
129 		struct {
130 			struct aa_profile *profile;
131 			const char *ns;
132 			long pos;
133 		} iface;
134 		int signal;
135 		struct {
136 			int rlim;
137 			unsigned long max;
138 		} rlim;
139 		struct {
140 			const char *src_name;
141 			const char *type;
142 			const char *trans;
143 			const char *data;
144 			unsigned long flags;
145 		} mnt;
146 	};
147 };
148 
149 /* macros for dealing with  apparmor_audit_data structure */
150 #define aad(SA) ((SA)->apparmor_audit_data)
151 #define DEFINE_AUDIT_DATA(NAME, T, X)					\
152 	/* TODO: cleanup audit init so we don't need _aad = {0,} */	\
153 	struct apparmor_audit_data NAME ## _aad = { .op = (X), };	\
154 	struct common_audit_data NAME =					\
155 	{								\
156 	.type = (T),							\
157 	.u.tsk = NULL,							\
158 	};								\
159 	NAME.apparmor_audit_data = &(NAME ## _aad)
160 
161 void aa_audit_msg(int type, struct common_audit_data *sa,
162 		  void (*cb) (struct audit_buffer *, void *));
163 int aa_audit(int type, struct aa_profile *profile, struct common_audit_data *sa,
164 	     void (*cb) (struct audit_buffer *, void *));
165 
166 #define aa_audit_error(ERROR, SA, CB)				\
167 ({								\
168 	aad((SA))->error = (ERROR);				\
169 	aa_audit_msg(AUDIT_APPARMOR_ERROR, (SA), (CB));		\
170 	aad((SA))->error;					\
171 })
172 
173 
174 static inline int complain_error(int error)
175 {
176 	if (error == -EPERM || error == -EACCES)
177 		return 0;
178 	return error;
179 }
180 
181 #endif /* __AA_AUDIT_H */
182