Commit | Line | Data |
---|---|---|
85c8721f | 1 | /* audit.h -- Auditing support |
1da177e4 LT |
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 | ||
2fd6f58b | 27 | #include <linux/sched.h> |
28 | #include <linux/elf.h> | |
29 | ||
1da177e4 | 30 | /* Request and reply types */ |
c2f0c7c3 SG |
31 | #define AUDIT_GET 1000 /* Get status */ |
32 | #define AUDIT_SET 1001 /* Set status (enable/disable/auditd) */ | |
33 | #define AUDIT_LIST 1002 /* List filtering rules */ | |
34 | #define AUDIT_ADD 1003 /* Add filtering rule */ | |
35 | #define AUDIT_DEL 1004 /* Delete filtering rule */ | |
36 | #define AUDIT_USER 1005 /* Send a message from user-space */ | |
37 | #define AUDIT_LOGIN 1006 /* Define the login id and information */ | |
38 | #define AUDIT_SIGNAL_INFO 1010 /* Get information about sender of signal*/ | |
39 | ||
40 | #define AUDIT_KERNEL 2000 /* Asynchronous audit record. NOT A REQUEST. */ | |
1da177e4 LT |
41 | |
42 | /* Rule flags */ | |
43 | #define AUDIT_PER_TASK 0x01 /* Apply rule at task creation (not syscall) */ | |
44 | #define AUDIT_AT_ENTRY 0x02 /* Apply rule at syscall entry */ | |
45 | #define AUDIT_AT_EXIT 0x04 /* Apply rule at syscall exit */ | |
46 | #define AUDIT_PREPEND 0x10 /* Prepend to front of list */ | |
47 | ||
48 | /* Rule actions */ | |
49 | #define AUDIT_NEVER 0 /* Do not build context if rule matches */ | |
50 | #define AUDIT_POSSIBLE 1 /* Build context if rule matches */ | |
51 | #define AUDIT_ALWAYS 2 /* Generate audit record if rule matches */ | |
52 | ||
53 | /* Rule structure sizes -- if these change, different AUDIT_ADD and | |
54 | * AUDIT_LIST commands must be implemented. */ | |
55 | #define AUDIT_MAX_FIELDS 64 | |
56 | #define AUDIT_BITMASK_SIZE 64 | |
57 | #define AUDIT_WORD(nr) ((__u32)((nr)/32)) | |
58 | #define AUDIT_BIT(nr) (1 << ((nr) - AUDIT_WORD(nr)*32)) | |
59 | ||
60 | /* Rule fields */ | |
61 | /* These are useful when checking the | |
62 | * task structure at task creation time | |
63 | * (AUDIT_PER_TASK). */ | |
64 | #define AUDIT_PID 0 | |
65 | #define AUDIT_UID 1 | |
66 | #define AUDIT_EUID 2 | |
67 | #define AUDIT_SUID 3 | |
68 | #define AUDIT_FSUID 4 | |
69 | #define AUDIT_GID 5 | |
70 | #define AUDIT_EGID 6 | |
71 | #define AUDIT_SGID 7 | |
72 | #define AUDIT_FSGID 8 | |
73 | #define AUDIT_LOGINUID 9 | |
74 | #define AUDIT_PERS 10 | |
2fd6f58b | 75 | #define AUDIT_ARCH 11 |
1da177e4 LT |
76 | |
77 | /* These are ONLY useful when checking | |
78 | * at syscall exit time (AUDIT_AT_EXIT). */ | |
79 | #define AUDIT_DEVMAJOR 100 | |
80 | #define AUDIT_DEVMINOR 101 | |
81 | #define AUDIT_INODE 102 | |
82 | #define AUDIT_EXIT 103 | |
83 | #define AUDIT_SUCCESS 104 /* exit >= 0; value ignored */ | |
84 | ||
85 | #define AUDIT_ARG0 200 | |
86 | #define AUDIT_ARG1 (AUDIT_ARG0+1) | |
87 | #define AUDIT_ARG2 (AUDIT_ARG0+2) | |
88 | #define AUDIT_ARG3 (AUDIT_ARG0+3) | |
89 | ||
90 | #define AUDIT_NEGATE 0x80000000 | |
91 | ||
92 | ||
93 | /* Status symbols */ | |
94 | /* Mask values */ | |
95 | #define AUDIT_STATUS_ENABLED 0x0001 | |
96 | #define AUDIT_STATUS_FAILURE 0x0002 | |
97 | #define AUDIT_STATUS_PID 0x0004 | |
98 | #define AUDIT_STATUS_RATE_LIMIT 0x0008 | |
99 | #define AUDIT_STATUS_BACKLOG_LIMIT 0x0010 | |
100 | /* Failure-to-log actions */ | |
101 | #define AUDIT_FAIL_SILENT 0 | |
102 | #define AUDIT_FAIL_PRINTK 1 | |
103 | #define AUDIT_FAIL_PANIC 2 | |
104 | ||
2fd6f58b | 105 | /* distinguish syscall tables */ |
106 | #define __AUDIT_ARCH_64BIT 0x80000000 | |
107 | #define __AUDIT_ARCH_LE 0x40000000 | |
108 | #define AUDIT_ARCH_ALPHA (EM_ALPHA|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE) | |
109 | #define AUDIT_ARCH_ARM (EM_ARM|__AUDIT_ARCH_LE) | |
110 | #define AUDIT_ARCH_ARMEB (EM_ARM) | |
111 | #define AUDIT_ARCH_CRIS (EM_CRIS|__AUDIT_ARCH_LE) | |
112 | #define AUDIT_ARCH_FRV (EM_FRV) | |
113 | #define AUDIT_ARCH_H8300 (EM_H8_300) | |
114 | #define AUDIT_ARCH_I386 (EM_386|__AUDIT_ARCH_LE) | |
115 | #define AUDIT_ARCH_IA64 (EM_IA_64|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE) | |
116 | #define AUDIT_ARCH_M32R (EM_M32R) | |
117 | #define AUDIT_ARCH_M68K (EM_68K) | |
118 | #define AUDIT_ARCH_MIPS (EM_MIPS) | |
119 | #define AUDIT_ARCH_MIPSEL (EM_MIPS|__AUDIT_ARCH_LE) | |
120 | #define AUDIT_ARCH_MIPS64 (EM_MIPS|__AUDIT_ARCH_64BIT) | |
121 | #define AUDIT_ARCH_MIPSEL64 (EM_MIPS|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE) | |
122 | #define AUDIT_ARCH_PARISC (EM_PARISC) | |
123 | #define AUDIT_ARCH_PARISC64 (EM_PARISC|__AUDIT_ARCH_64BIT) | |
124 | #define AUDIT_ARCH_PPC (EM_PPC) | |
125 | #define AUDIT_ARCH_PPC64 (EM_PPC64|__AUDIT_ARCH_64BIT) | |
126 | #define AUDIT_ARCH_S390 (EM_S390) | |
127 | #define AUDIT_ARCH_S390X (EM_S390|__AUDIT_ARCH_64BIT) | |
128 | #define AUDIT_ARCH_SH (EM_SH) | |
129 | #define AUDIT_ARCH_SHEL (EM_SH|__AUDIT_ARCH_LE) | |
130 | #define AUDIT_ARCH_SH64 (EM_SH|__AUDIT_ARCH_64BIT) | |
131 | #define AUDIT_ARCH_SHEL64 (EM_SH|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE) | |
132 | #define AUDIT_ARCH_SPARC (EM_SPARC) | |
133 | #define AUDIT_ARCH_SPARC64 (EM_SPARC64|__AUDIT_ARCH_64BIT) | |
134 | #define AUDIT_ARCH_V850 (EM_V850|__AUDIT_ARCH_LE) | |
135 | #define AUDIT_ARCH_X86_64 (EM_X86_64|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE) | |
136 | ||
1da177e4 LT |
137 | #ifndef __KERNEL__ |
138 | struct audit_message { | |
139 | struct nlmsghdr nlh; | |
140 | char data[1200]; | |
141 | }; | |
142 | #endif | |
143 | ||
144 | struct audit_status { | |
145 | __u32 mask; /* Bit mask for valid entries */ | |
146 | __u32 enabled; /* 1 = enabled, 0 = disbaled */ | |
147 | __u32 failure; /* Failure-to-log action */ | |
148 | __u32 pid; /* pid of auditd process */ | |
149 | __u32 rate_limit; /* messages rate limit (per second) */ | |
150 | __u32 backlog_limit; /* waiting messages limit */ | |
151 | __u32 lost; /* messages lost */ | |
152 | __u32 backlog; /* messages waiting in queue */ | |
153 | }; | |
154 | ||
155 | struct audit_rule { /* for AUDIT_LIST, AUDIT_ADD, and AUDIT_DEL */ | |
156 | __u32 flags; /* AUDIT_PER_{TASK,CALL}, AUDIT_PREPEND */ | |
157 | __u32 action; /* AUDIT_NEVER, AUDIT_POSSIBLE, AUDIT_ALWAYS */ | |
158 | __u32 field_count; | |
159 | __u32 mask[AUDIT_BITMASK_SIZE]; | |
160 | __u32 fields[AUDIT_MAX_FIELDS]; | |
161 | __u32 values[AUDIT_MAX_FIELDS]; | |
162 | }; | |
163 | ||
164 | #ifdef __KERNEL__ | |
165 | ||
c2f0c7c3 SG |
166 | struct audit_sig_info { |
167 | uid_t uid; | |
168 | pid_t pid; | |
169 | }; | |
170 | ||
1da177e4 LT |
171 | struct audit_buffer; |
172 | struct audit_context; | |
173 | struct inode; | |
174 | ||
2fd6f58b | 175 | #define AUDITSC_INVALID 0 |
176 | #define AUDITSC_SUCCESS 1 | |
177 | #define AUDITSC_FAILURE 2 | |
178 | #define AUDITSC_RESULT(x) ( ((long)(x))<0?AUDITSC_FAILURE:AUDITSC_SUCCESS ) | |
1da177e4 LT |
179 | #ifdef CONFIG_AUDITSYSCALL |
180 | /* These are defined in auditsc.c */ | |
181 | /* Public API */ | |
182 | extern int audit_alloc(struct task_struct *task); | |
183 | extern void audit_free(struct task_struct *task); | |
2fd6f58b | 184 | extern void audit_syscall_entry(struct task_struct *task, int arch, |
1da177e4 LT |
185 | int major, unsigned long a0, unsigned long a1, |
186 | unsigned long a2, unsigned long a3); | |
2fd6f58b | 187 | extern void audit_syscall_exit(struct task_struct *task, int failed, long return_code); |
1da177e4 LT |
188 | extern void audit_getname(const char *name); |
189 | extern void audit_putname(const char *name); | |
190 | extern void audit_inode(const char *name, const struct inode *inode); | |
191 | ||
192 | /* Private API (for audit.c only) */ | |
193 | extern int audit_receive_filter(int type, int pid, int uid, int seq, | |
c94c257c | 194 | void *data, uid_t loginuid); |
197c69c6 | 195 | extern int audit_get_stamp(struct audit_context *ctx, |
d812ddbb | 196 | struct timespec *t, unsigned int *serial); |
456be6cd | 197 | extern int audit_set_loginuid(struct task_struct *task, uid_t loginuid); |
1da177e4 LT |
198 | extern uid_t audit_get_loginuid(struct audit_context *ctx); |
199 | extern int audit_ipc_perms(unsigned long qbytes, uid_t uid, gid_t gid, mode_t mode); | |
c2f0c7c3 | 200 | extern void audit_signal_info(int sig, struct task_struct *t); |
1da177e4 LT |
201 | #else |
202 | #define audit_alloc(t) ({ 0; }) | |
203 | #define audit_free(t) do { ; } while (0) | |
2fd6f58b | 204 | #define audit_syscall_entry(t,ta,a,b,c,d,e) do { ; } while (0) |
205 | #define audit_syscall_exit(t,f,r) do { ; } while (0) | |
1da177e4 LT |
206 | #define audit_getname(n) do { ; } while (0) |
207 | #define audit_putname(n) do { ; } while (0) | |
208 | #define audit_inode(n,i) do { ; } while (0) | |
197c69c6 CW |
209 | #define audit_receive_filter(t,p,u,s,d,l) ({ -EOPNOTSUPP; }) |
210 | #define audit_get_stamp(c,t,s) ({ 0; }) | |
1da177e4 LT |
211 | #define audit_get_loginuid(c) ({ -1; }) |
212 | #define audit_ipc_perms(q,u,g,m) ({ 0; }) | |
c2f0c7c3 | 213 | #define audit_signal_info(s,t) do { ; } while (0) |
1da177e4 LT |
214 | #endif |
215 | ||
216 | #ifdef CONFIG_AUDIT | |
217 | /* These are defined in audit.c */ | |
218 | /* Public API */ | |
c1b773d8 CW |
219 | #define audit_log(ctx, fmt, args...) \ |
220 | audit_log_type(ctx, AUDIT_KERNEL, 0, fmt, ##args) | |
221 | extern void audit_log_type(struct audit_context *ctx, int type, | |
222 | int pid, const char *fmt, ...) | |
223 | __attribute__((format(printf,4,5))); | |
1da177e4 | 224 | |
c1b773d8 CW |
225 | extern struct audit_buffer *audit_log_start(struct audit_context *ctx, int type, |
226 | int pid); | |
1da177e4 LT |
227 | extern void audit_log_format(struct audit_buffer *ab, |
228 | const char *fmt, ...) | |
229 | __attribute__((format(printf,2,3))); | |
230 | extern void audit_log_end(struct audit_buffer *ab); | |
83c7d091 | 231 | extern void audit_log_hex(struct audit_buffer *ab, |
232 | const unsigned char *buf, | |
233 | size_t len); | |
234 | extern void audit_log_untrustedstring(struct audit_buffer *ab, | |
235 | const char *string); | |
1da177e4 LT |
236 | extern void audit_log_d_path(struct audit_buffer *ab, |
237 | const char *prefix, | |
238 | struct dentry *dentry, | |
239 | struct vfsmount *vfsmnt); | |
1da177e4 LT |
240 | /* Private API (for auditsc.c only) */ |
241 | extern void audit_send_reply(int pid, int seq, int type, | |
242 | int done, int multi, | |
243 | void *payload, int size); | |
244 | extern void audit_log_lost(const char *message); | |
245 | #else | |
c1b773d8 CW |
246 | #define audit_log(c,f,...) do { ; } while (0) |
247 | #define audit_log_type(c,t,p,f,...) do { ; } while (0) | |
248 | #define audit_log_start(c,t,p) ({ NULL; }) | |
1da177e4 LT |
249 | #define audit_log_vformat(b,f,a) do { ; } while (0) |
250 | #define audit_log_format(b,f,...) do { ; } while (0) | |
251 | #define audit_log_end(b) do { ; } while (0) | |
83c7d091 | 252 | #define audit_log_hex(a,b,l) do { ; } while (0) |
253 | #define audit_log_untrustedstring(a,s) do { ; } while (0) | |
1da177e4 LT |
254 | #define audit_log_d_path(b,p,d,v) do { ; } while (0) |
255 | #endif | |
256 | #endif | |
257 | #endif |