---

---

---

001: /* audit.h -- Auditing support
002:  *
003:  * Copyright 2003-2004 Red Hat Inc., Durham, North Carolina.
004:  * All Rights Reserved.
005:  *
006:  * This program is free software; you can redistribute it and/or modify
007:  * it under the terms of the GNU General Public License as published by
008:  * the Free Software Foundation; either version 2 of the License, or
009:  * (at your option) any later version.
010:  *
011:  * This program is distributed in the hope that it will be useful,
012:  * but WITHOUT ANY WARRANTY; without even the implied warranty of
013:  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
014:  * GNU General Public License for more details.
015:  *
016:  * You should have received a copy of the GNU General Public License
017:  * along with this program; if not, write to the Free Software
018:  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
019:  *
020:  * Written by Rickard E. (Rik) Faith <faith@redhat.com>
021:  *
022:  */
023: 
024: #ifndef _LINUX_AUDIT_H_
025: #define _LINUX_AUDIT_H_
026: 
027: #include <linux/types.h>
028: #include <linux/elf-em.h>
029: 
030: /* The netlink messages for the audit system is divided into blocks:
031:  * 1000 - 1099 are for commanding the audit system
032:  * 1100 - 1199 user space trusted application messages
033:  * 1200 - 1299 messages internal to the audit daemon
034:  * 1300 - 1399 audit event messages
035:  * 1400 - 1499 SE Linux use
036:  * 1500 - 1599 kernel LSPP events
037:  * 1600 - 1699 kernel crypto events
038:  * 1700 - 1799 kernel anomaly records
039:  * 1800 - 1899 kernel integrity events
040:  * 1900 - 1999 future kernel use
041:  * 2000 is for otherwise unclassified kernel audit messages (legacy)
042:  * 2001 - 2099 unused (kernel)
043:  * 2100 - 2199 user space anomaly records
044:  * 2200 - 2299 user space actions taken in response to anomalies
045:  * 2300 - 2399 user space generated LSPP events
046:  * 2400 - 2499 user space crypto events
047:  * 2500 - 2999 future user space (maybe integrity labels and related events)
048:  *
049:  * Messages from 1000-1199 are bi-directional. 1200-1299 & 2100 - 2999 are
050:  * exclusively user space. 1300-2099 is kernel --> user space 
051:  * communication.
052:  */
053: #define AUDIT_GET               1000    /* Get status */
054: #define AUDIT_SET               1001    /* Set status (enable/disable/auditd) */
055: #define AUDIT_LIST              1002    /* List syscall rules -- deprecated */
056: #define AUDIT_ADD               1003    /* Add syscall rule -- deprecated */
057: #define AUDIT_DEL               1004    /* Delete syscall rule -- deprecated */
058: #define AUDIT_USER              1005    /* Message from userspace -- deprecated */
059: #define AUDIT_LOGIN             1006    /* Define the login id and information */
060: #define AUDIT_WATCH_INS         1007    /* Insert file/dir watch entry */
061: #define AUDIT_WATCH_REM         1008    /* Remove file/dir watch entry */
062: #define AUDIT_WATCH_LIST        1009    /* List all file/dir watches */
063: #define AUDIT_SIGNAL_INFO       1010    /* Get info about sender of signal to auditd */
064: #define AUDIT_ADD_RULE          1011    /* Add syscall filtering rule */
065: #define AUDIT_DEL_RULE          1012    /* Delete syscall filtering rule */
066: #define AUDIT_LIST_RULES        1013    /* List syscall filtering rules */
067: #define AUDIT_TRIM              1014    /* Trim junk from watched tree */
068: #define AUDIT_MAKE_EQUIV        1015    /* Append to watched tree */
069: #define AUDIT_TTY_GET           1016    /* Get TTY auditing status */
070: #define AUDIT_TTY_SET           1017    /* Set TTY auditing status */
071: 
072: #define AUDIT_FIRST_USER_MSG    1100    /* Userspace messages mostly uninteresting to kernel */
073: #define AUDIT_USER_AVC          1107    /* We filter this differently */
074: #define AUDIT_USER_TTY          1124    /* Non-ICANON TTY input meaning */
075: #define AUDIT_LAST_USER_MSG     1199
076: #define AUDIT_FIRST_USER_MSG2   2100    /* More user space messages */
077: #define AUDIT_LAST_USER_MSG2    2999
078:  
079: #define AUDIT_DAEMON_START      1200    /* Daemon startup record */
080: #define AUDIT_DAEMON_END        1201    /* Daemon normal stop record */
081: #define AUDIT_DAEMON_ABORT      1202    /* Daemon error stop record */
082: #define AUDIT_DAEMON_CONFIG     1203    /* Daemon config change */
083: 
084: #define AUDIT_SYSCALL           1300    /* Syscall event */
085: /* #define AUDIT_FS_WATCH       1301     * Deprecated */
086: #define AUDIT_PATH              1302    /* Filename path information */
087: #define AUDIT_IPC               1303    /* IPC record */
088: #define AUDIT_SOCKETCALL        1304    /* sys_socketcall arguments */
089: #define AUDIT_CONFIG_CHANGE     1305    /* Audit system configuration change */
090: #define AUDIT_SOCKADDR          1306    /* sockaddr copied as syscall arg */
091: #define AUDIT_CWD               1307    /* Current working directory */
092: #define AUDIT_EXECVE            1309    /* execve arguments */
093: #define AUDIT_IPC_SET_PERM      1311    /* IPC new permissions record type */
094: #define AUDIT_MQ_OPEN           1312    /* POSIX MQ open record type */
095: #define AUDIT_MQ_SENDRECV       1313    /* POSIX MQ send/receive record type */
096: #define AUDIT_MQ_NOTIFY         1314    /* POSIX MQ notify record type */
097: #define AUDIT_MQ_GETSETATTR     1315    /* POSIX MQ get/set attribute record type */
098: #define AUDIT_KERNEL_OTHER      1316    /* For use by 3rd party modules */
099: #define AUDIT_FD_PAIR           1317    /* audit record for pipe/socketpair */
100: #define AUDIT_OBJ_PID           1318    /* ptrace target */
101: #define AUDIT_TTY               1319    /* Input on an administrative TTY */
102: #define AUDIT_EOE               1320    /* End of multi-record event */
103: #define AUDIT_BPRM_FCAPS        1321    /* Information about fcaps increasing perms */
104: #define AUDIT_CAPSET            1322    /* Record showing argument to sys_capset */
105: #define AUDIT_MMAP              1323    /* Record showing descriptor and flags in mmap */
106: #define AUDIT_NETFILTER_PKT     1324    /* Packets traversing netfilter chains */
107: #define AUDIT_NETFILTER_CFG     1325    /* Netfilter chain modifications */
108: 
109: #define AUDIT_AVC               1400    /* SE Linux avc denial or grant */
110: #define AUDIT_SELINUX_ERR       1401    /* Internal SE Linux Errors */
111: #define AUDIT_AVC_PATH          1402    /* dentry, vfsmount pair from avc */
112: #define AUDIT_MAC_POLICY_LOAD   1403    /* Policy file load */
113: #define AUDIT_MAC_STATUS        1404    /* Changed enforcing,permissive,off */
114: #define AUDIT_MAC_CONFIG_CHANGE 1405    /* Changes to booleans */
115: #define AUDIT_MAC_UNLBL_ALLOW   1406    /* NetLabel: allow unlabeled traffic */
116: #define AUDIT_MAC_CIPSOV4_ADD   1407    /* NetLabel: add CIPSOv4 DOI entry */
117: #define AUDIT_MAC_CIPSOV4_DEL   1408    /* NetLabel: del CIPSOv4 DOI entry */
118: #define AUDIT_MAC_MAP_ADD       1409    /* NetLabel: add LSM domain mapping */
119: #define AUDIT_MAC_MAP_DEL       1410    /* NetLabel: del LSM domain mapping */
120: #define AUDIT_MAC_IPSEC_ADDSA   1411    /* Not used */
121: #define AUDIT_MAC_IPSEC_DELSA   1412    /* Not used  */
122: #define AUDIT_MAC_IPSEC_ADDSPD  1413    /* Not used */
123: #define AUDIT_MAC_IPSEC_DELSPD  1414    /* Not used */
124: #define AUDIT_MAC_IPSEC_EVENT   1415    /* Audit an IPSec event */
125: #define AUDIT_MAC_UNLBL_STCADD  1416    /* NetLabel: add a static label */
126: #define AUDIT_MAC_UNLBL_STCDEL  1417    /* NetLabel: del a static label */
127: 
128: #define AUDIT_FIRST_KERN_ANOM_MSG   1700
129: #define AUDIT_LAST_KERN_ANOM_MSG    1799
130: #define AUDIT_ANOM_PROMISCUOUS      1700 /* Device changed promiscuous mode */
131: #define AUDIT_ANOM_ABEND            1701 /* Process ended abnormally */
132: #define AUDIT_INTEGRITY_DATA        1800 /* Data integrity verification */
133: #define AUDIT_INTEGRITY_METADATA    1801 /* Metadata integrity verification */
134: #define AUDIT_INTEGRITY_STATUS      1802 /* Integrity enable status */
135: #define AUDIT_INTEGRITY_HASH        1803 /* Integrity HASH type */
136: #define AUDIT_INTEGRITY_PCR         1804 /* PCR invalidation msgs */
137: #define AUDIT_INTEGRITY_RULE        1805 /* policy rule */
138: 
139: #define AUDIT_KERNEL            2000    /* Asynchronous audit record. NOT A REQUEST. */
140: 
141: /* Rule flags */
142: #define AUDIT_FILTER_USER       0x00    /* Apply rule to user-generated messages */
143: #define AUDIT_FILTER_TASK       0x01    /* Apply rule at task creation (not syscall) */
144: #define AUDIT_FILTER_ENTRY      0x02    /* Apply rule at syscall entry */
145: #define AUDIT_FILTER_WATCH      0x03    /* Apply rule to file system watches */
146: #define AUDIT_FILTER_EXIT       0x04    /* Apply rule at syscall exit */
147: #define AUDIT_FILTER_TYPE       0x05    /* Apply rule at audit_log_start */
148: 
149: #define AUDIT_NR_FILTERS        6
150: 
151: #define AUDIT_FILTER_PREPEND    0x10    /* Prepend to front of list */
152: 
153: /* Rule actions */
154: #define AUDIT_NEVER    0        /* Do not build context if rule matches */
155: #define AUDIT_POSSIBLE 1        /* Build context if rule matches  */
156: #define AUDIT_ALWAYS   2        /* Generate audit record if rule matches */
157: 
158: /* Rule structure sizes -- if these change, different AUDIT_ADD and
159:  * AUDIT_LIST commands must be implemented. */
160: #define AUDIT_MAX_FIELDS   64
161: #define AUDIT_MAX_KEY_LEN  256
162: #define AUDIT_BITMASK_SIZE 64
163: #define AUDIT_WORD(nr) ((__u32)((nr)/32))
164: #define AUDIT_BIT(nr)  (1 << ((nr) - AUDIT_WORD(nr)*32))
165: 
166: #define AUDIT_SYSCALL_CLASSES 16
167: #define AUDIT_CLASS_DIR_WRITE 0
168: #define AUDIT_CLASS_DIR_WRITE_32 1
169: #define AUDIT_CLASS_CHATTR 2
170: #define AUDIT_CLASS_CHATTR_32 3
171: #define AUDIT_CLASS_READ 4
172: #define AUDIT_CLASS_READ_32 5
173: #define AUDIT_CLASS_WRITE 6
174: #define AUDIT_CLASS_WRITE_32 7
175: #define AUDIT_CLASS_SIGNAL 8
176: #define AUDIT_CLASS_SIGNAL_32 9
177: 
178: /* This bitmask is used to validate user input.  It represents all bits that
179:  * are currently used in an audit field constant understood by the kernel.
180:  * If you are adding a new #define AUDIT_<whatever>, please ensure that
181:  * AUDIT_UNUSED_BITS is updated if need be. */
182: #define AUDIT_UNUSED_BITS       0x07FFFC00
183: 
184: 
185: /* Rule fields */
186:                                 /* These are useful when checking the
187:                                  * task structure at task creation time
188:                                  * (AUDIT_PER_TASK).  */
189: #define AUDIT_PID       0
190: #define AUDIT_UID       1
191: #define AUDIT_EUID      2
192: #define AUDIT_SUID      3
193: #define AUDIT_FSUID     4
194: #define AUDIT_GID       5
195: #define AUDIT_EGID      6
196: #define AUDIT_SGID      7
197: #define AUDIT_FSGID     8
198: #define AUDIT_LOGINUID  9
199: #define AUDIT_PERS      10
200: #define AUDIT_ARCH      11
201: #define AUDIT_MSGTYPE   12
202: #define AUDIT_SUBJ_USER 13      /* security label user */
203: #define AUDIT_SUBJ_ROLE 14      /* security label role */
204: #define AUDIT_SUBJ_TYPE 15      /* security label type */
205: #define AUDIT_SUBJ_SEN  16      /* security label sensitivity label */
206: #define AUDIT_SUBJ_CLR  17      /* security label clearance label */
207: #define AUDIT_PPID      18
208: #define AUDIT_OBJ_USER  19
209: #define AUDIT_OBJ_ROLE  20
210: #define AUDIT_OBJ_TYPE  21
211: #define AUDIT_OBJ_LEV_LOW       22
212: #define AUDIT_OBJ_LEV_HIGH      23
213: 
214:                                 /* These are ONLY useful when checking
215:                                  * at syscall exit time (AUDIT_AT_EXIT). */
216: #define AUDIT_DEVMAJOR  100
217: #define AUDIT_DEVMINOR  101
218: #define AUDIT_INODE     102
219: #define AUDIT_EXIT      103
220: #define AUDIT_SUCCESS   104     /* exit >= 0; value ignored */
221: #define AUDIT_WATCH     105
222: #define AUDIT_PERM      106
223: #define AUDIT_DIR       107
224: #define AUDIT_FILETYPE  108
225: 
226: #define AUDIT_ARG0      200
227: #define AUDIT_ARG1      (AUDIT_ARG0+1)
228: #define AUDIT_ARG2      (AUDIT_ARG0+2)
229: #define AUDIT_ARG3      (AUDIT_ARG0+3)
230: 
231: #define AUDIT_FILTERKEY 210
232: 
233: #define AUDIT_NEGATE                    0x80000000
234: 
235: /* These are the supported operators.
236:  *      4  2  1  8
237:  *      =  >  <  ?
238:  *      ----------
239:  *      0  0  0  0      00      nonsense
240:  *      0  0  0  1      08      &  bit mask
241:  *      0  0  1  0      10      <
242:  *      0  1  0  0      20      >
243:  *      0  1  1  0      30      !=
244:  *      1  0  0  0      40      =
245:  *      1  0  0  1      48      &=  bit test
246:  *      1  0  1  0      50      <=
247:  *      1  1  0  0      60      >=
248:  *      1  1  1  1      78      all operators
249:  */
250: #define AUDIT_BIT_MASK                  0x08000000
251: #define AUDIT_LESS_THAN                 0x10000000
252: #define AUDIT_GREATER_THAN              0x20000000
253: #define AUDIT_NOT_EQUAL                 0x30000000
254: #define AUDIT_EQUAL                     0x40000000
255: #define AUDIT_BIT_TEST                  (AUDIT_BIT_MASK|AUDIT_EQUAL)
256: #define AUDIT_LESS_THAN_OR_EQUAL        (AUDIT_LESS_THAN|AUDIT_EQUAL)
257: #define AUDIT_GREATER_THAN_OR_EQUAL     (AUDIT_GREATER_THAN|AUDIT_EQUAL)
258: #define AUDIT_OPERATORS                 (AUDIT_EQUAL|AUDIT_NOT_EQUAL|AUDIT_BIT_MASK)
259: 
260: enum {
261:         Audit_equal,
262:         Audit_not_equal,
263:         Audit_bitmask,
264:         Audit_bittest,
265:         Audit_lt,
266:         Audit_gt,
267:         Audit_le,
268:         Audit_ge,
269:         Audit_bad
270: };
271: 
272: /* Status symbols */
273:                                 /* Mask values */
274: #define AUDIT_STATUS_ENABLED            0x0001
275: #define AUDIT_STATUS_FAILURE            0x0002
276: #define AUDIT_STATUS_PID                0x0004
277: #define AUDIT_STATUS_RATE_LIMIT         0x0008
278: #define AUDIT_STATUS_BACKLOG_LIMIT      0x0010
279:                                 /* Failure-to-log actions */
280: #define AUDIT_FAIL_SILENT       0
281: #define AUDIT_FAIL_PRINTK       1
282: #define AUDIT_FAIL_PANIC        2
283: 
284: /* distinguish syscall tables */
285: #define __AUDIT_ARCH_64BIT 0x80000000
286: #define __AUDIT_ARCH_LE    0x40000000
287: #define AUDIT_ARCH_ALPHA        (EM_ALPHA|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE)
288: #define AUDIT_ARCH_ARM          (EM_ARM|__AUDIT_ARCH_LE)
289: #define AUDIT_ARCH_ARMEB        (EM_ARM)
290: #define AUDIT_ARCH_CRIS         (EM_CRIS|__AUDIT_ARCH_LE)
291: #define AUDIT_ARCH_FRV          (EM_FRV)
292: #define AUDIT_ARCH_H8300        (EM_H8_300)
293: #define AUDIT_ARCH_I386         (EM_386|__AUDIT_ARCH_LE)
294: #define AUDIT_ARCH_IA64         (EM_IA_64|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE)
295: #define AUDIT_ARCH_M32R         (EM_M32R)
296: #define AUDIT_ARCH_M68K         (EM_68K)
297: #define AUDIT_ARCH_MIPS         (EM_MIPS)
298: #define AUDIT_ARCH_MIPSEL       (EM_MIPS|__AUDIT_ARCH_LE)
299: #define AUDIT_ARCH_MIPS64       (EM_MIPS|__AUDIT_ARCH_64BIT)
300: #define AUDIT_ARCH_MIPSEL64     (EM_MIPS|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE)
301: #define AUDIT_ARCH_PARISC       (EM_PARISC)
302: #define AUDIT_ARCH_PARISC64     (EM_PARISC|__AUDIT_ARCH_64BIT)
303: #define AUDIT_ARCH_PPC          (EM_PPC)
304: #define AUDIT_ARCH_PPC64        (EM_PPC64|__AUDIT_ARCH_64BIT)
305: #define AUDIT_ARCH_S390         (EM_S390)
306: #define AUDIT_ARCH_S390X        (EM_S390|__AUDIT_ARCH_64BIT)
307: #define AUDIT_ARCH_SH           (EM_SH)
308: #define AUDIT_ARCH_SHEL         (EM_SH|__AUDIT_ARCH_LE)
309: #define AUDIT_ARCH_SH64         (EM_SH|__AUDIT_ARCH_64BIT)
310: #define AUDIT_ARCH_SHEL64       (EM_SH|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE)
311: #define AUDIT_ARCH_SPARC        (EM_SPARC)
312: #define AUDIT_ARCH_SPARC64      (EM_SPARCV9|__AUDIT_ARCH_64BIT)
313: #define AUDIT_ARCH_X86_64       (EM_X86_64|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE)
314: 
315: #define AUDIT_PERM_EXEC         1
316: #define AUDIT_PERM_WRITE        2
317: #define AUDIT_PERM_READ         4
318: #define AUDIT_PERM_ATTR         8
319: 
320: struct audit_status {
321:         __u32           mask;           /* Bit mask for valid entries */
322:         __u32           enabled;        /* 1 = enabled, 0 = disabled */
323:         __u32           failure;        /* Failure-to-log action */
324:         __u32           pid;            /* pid of auditd process */
325:         __u32           rate_limit;     /* messages rate limit (per second) */
326:         __u32           backlog_limit;  /* waiting messages limit */
327:         __u32           lost;           /* messages lost */
328:         __u32           backlog;        /* messages waiting in queue */
329: };
330: 
331: struct audit_tty_status {
332:         __u32           enabled; /* 1 = enabled, 0 = disabled */
333: };
334: 
335: /* audit_rule_data supports filter rules with both integer and string
336:  * fields.  It corresponds with AUDIT_ADD_RULE, AUDIT_DEL_RULE and
337:  * AUDIT_LIST_RULES requests.
338:  */
339: struct audit_rule_data {
340:         __u32           flags;  /* AUDIT_PER_{TASK,CALL}, AUDIT_PREPEND */
341:         __u32           action; /* AUDIT_NEVER, AUDIT_POSSIBLE, AUDIT_ALWAYS */
342:         __u32           field_count;
343:         __u32           mask[AUDIT_BITMASK_SIZE]; /* syscall(s) affected */
344:         __u32           fields[AUDIT_MAX_FIELDS];
345:         __u32           values[AUDIT_MAX_FIELDS];
346:         __u32           fieldflags[AUDIT_MAX_FIELDS];
347:         __u32           buflen; /* total length of string fields */
348:         char            buf[0]; /* string fields buffer */
349: };
350: 
351: /* audit_rule is supported to maintain backward compatibility with
352:  * userspace.  It supports integer fields only and corresponds to
353:  * AUDIT_ADD, AUDIT_DEL and AUDIT_LIST requests.
354:  */
355: struct audit_rule {             /* for AUDIT_LIST, AUDIT_ADD, and AUDIT_DEL */
356:         __u32           flags;  /* AUDIT_PER_{TASK,CALL}, AUDIT_PREPEND */
357:         __u32           action; /* AUDIT_NEVER, AUDIT_POSSIBLE, AUDIT_ALWAYS */
358:         __u32           field_count;
359:         __u32           mask[AUDIT_BITMASK_SIZE];
360:         __u32           fields[AUDIT_MAX_FIELDS];
361:         __u32           values[AUDIT_MAX_FIELDS];
362: };
363: 
364: #endif
365: 

---

---

---