|  | /* audit.h -- Auditing support | 
|  | * | 
|  | * Copyright 2003-2004 Red Hat Inc., Durham, North Carolina. | 
|  | * All Rights Reserved. | 
|  | * | 
|  | * This program is free software; you can redistribute it and/or modify | 
|  | * it under the terms of the GNU General Public License as published by | 
|  | * the Free Software Foundation; either version 2 of the License, or | 
|  | * (at your option) any later version. | 
|  | * | 
|  | * This program is distributed in the hope that it will be useful, | 
|  | * but WITHOUT ANY WARRANTY; without even the implied warranty of | 
|  | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the | 
|  | * GNU General Public License for more details. | 
|  | * | 
|  | * You should have received a copy of the GNU General Public License | 
|  | * along with this program; if not, write to the Free Software | 
|  | * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA | 
|  | * | 
|  | * Written by Rickard E. (Rik) Faith <faith@redhat.com> | 
|  | * | 
|  | */ | 
|  |  | 
|  | #ifndef _LINUX_AUDIT_H_ | 
|  | #define _LINUX_AUDIT_H_ | 
|  |  | 
|  | #include <linux/sched.h> | 
|  | #include <linux/elf.h> | 
|  |  | 
|  | /* The netlink messages for the audit system is divided into blocks: | 
|  | * 1000 - 1099 are for commanding the audit system | 
|  | * 1100 - 1199 user space trusted application messages | 
|  | * 1200 - 1299 messages internal to the audit daemon | 
|  | * 1300 - 1399 audit event messages | 
|  | * 1400 - 1499 SE Linux use | 
|  | * 1500 - 1999 future use | 
|  | * 2000 is for otherwise unclassified kernel audit messages | 
|  | * | 
|  | * Messages from 1000-1199 are bi-directional. 1200-1299 are exclusively user | 
|  | * space. Anything over that is kernel --> user space communication. | 
|  | */ | 
|  | #define AUDIT_GET		1000	/* Get status */ | 
|  | #define AUDIT_SET		1001	/* Set status (enable/disable/auditd) */ | 
|  | #define AUDIT_LIST		1002	/* List syscall filtering rules */ | 
|  | #define AUDIT_ADD		1003	/* Add syscall filtering rule */ | 
|  | #define AUDIT_DEL		1004	/* Delete syscall filtering rule */ | 
|  | #define AUDIT_USER		1005	/* Message from userspace -- deprecated */ | 
|  | #define AUDIT_LOGIN		1006	/* Define the login id and information */ | 
|  | #define AUDIT_WATCH_INS		1007	/* Insert file/dir watch entry */ | 
|  | #define AUDIT_WATCH_REM		1008	/* Remove file/dir watch entry */ | 
|  | #define AUDIT_WATCH_LIST	1009	/* List all file/dir watches */ | 
|  | #define AUDIT_SIGNAL_INFO	1010	/* Get info about sender of signal to auditd */ | 
|  |  | 
|  | #define AUDIT_FIRST_USER_MSG	1100	/* Userspace messages mostly uninteresting to kernel */ | 
|  | #define AUDIT_USER_AVC		1107	/* We filter this differently */ | 
|  | #define AUDIT_LAST_USER_MSG	1199 | 
|  |  | 
|  | #define AUDIT_DAEMON_START      1200    /* Daemon startup record */ | 
|  | #define AUDIT_DAEMON_END        1201    /* Daemon normal stop record */ | 
|  | #define AUDIT_DAEMON_ABORT      1202    /* Daemon error stop record */ | 
|  | #define AUDIT_DAEMON_CONFIG     1203    /* Daemon config change */ | 
|  |  | 
|  | #define AUDIT_SYSCALL		1300	/* Syscall event */ | 
|  | #define AUDIT_FS_WATCH		1301	/* Filesystem watch event */ | 
|  | #define AUDIT_PATH		1302	/* Filename path information */ | 
|  | #define AUDIT_IPC		1303	/* IPC record */ | 
|  | #define AUDIT_SOCKETCALL	1304	/* sys_socketcall arguments */ | 
|  | #define AUDIT_CONFIG_CHANGE	1305	/* Audit system configuration change */ | 
|  | #define AUDIT_SOCKADDR		1306	/* sockaddr copied as syscall arg */ | 
|  | #define AUDIT_CWD		1307	/* Current working directory */ | 
|  |  | 
|  | #define AUDIT_AVC		1400	/* SE Linux avc denial or grant */ | 
|  | #define AUDIT_SELINUX_ERR	1401	/* Internal SE Linux Errors */ | 
|  | #define AUDIT_AVC_PATH		1402	/* dentry, vfsmount pair from avc */ | 
|  |  | 
|  | #define AUDIT_KERNEL		2000	/* Asynchronous audit record. NOT A REQUEST. */ | 
|  |  | 
|  | /* Rule flags */ | 
|  | #define AUDIT_FILTER_USER	0x00	/* Apply rule to user-generated messages */ | 
|  | #define AUDIT_FILTER_TASK	0x01	/* Apply rule at task creation (not syscall) */ | 
|  | #define AUDIT_FILTER_ENTRY	0x02	/* Apply rule at syscall entry */ | 
|  | #define AUDIT_FILTER_WATCH	0x03	/* Apply rule to file system watches */ | 
|  | #define AUDIT_FILTER_EXIT	0x04	/* Apply rule at syscall exit */ | 
|  |  | 
|  | #define AUDIT_NR_FILTERS	5 | 
|  |  | 
|  | #define AUDIT_FILTER_PREPEND	0x10	/* Prepend to front of list */ | 
|  |  | 
|  | /* Rule actions */ | 
|  | #define AUDIT_NEVER    0	/* Do not build context if rule matches */ | 
|  | #define AUDIT_POSSIBLE 1	/* Build context if rule matches  */ | 
|  | #define AUDIT_ALWAYS   2	/* Generate audit record if rule matches */ | 
|  |  | 
|  | /* Rule structure sizes -- if these change, different AUDIT_ADD and | 
|  | * AUDIT_LIST commands must be implemented. */ | 
|  | #define AUDIT_MAX_FIELDS   64 | 
|  | #define AUDIT_BITMASK_SIZE 64 | 
|  | #define AUDIT_WORD(nr) ((__u32)((nr)/32)) | 
|  | #define AUDIT_BIT(nr)  (1 << ((nr) - AUDIT_WORD(nr)*32)) | 
|  |  | 
|  | /* Rule fields */ | 
|  | /* These are useful when checking the | 
|  | * task structure at task creation time | 
|  | * (AUDIT_PER_TASK).  */ | 
|  | #define AUDIT_PID	0 | 
|  | #define AUDIT_UID	1 | 
|  | #define AUDIT_EUID	2 | 
|  | #define AUDIT_SUID	3 | 
|  | #define AUDIT_FSUID	4 | 
|  | #define AUDIT_GID	5 | 
|  | #define AUDIT_EGID	6 | 
|  | #define AUDIT_SGID	7 | 
|  | #define AUDIT_FSGID	8 | 
|  | #define AUDIT_LOGINUID	9 | 
|  | #define AUDIT_PERS	10 | 
|  | #define AUDIT_ARCH	11 | 
|  |  | 
|  | /* These are ONLY useful when checking | 
|  | * at syscall exit time (AUDIT_AT_EXIT). */ | 
|  | #define AUDIT_DEVMAJOR	100 | 
|  | #define AUDIT_DEVMINOR	101 | 
|  | #define AUDIT_INODE	102 | 
|  | #define AUDIT_EXIT	103 | 
|  | #define AUDIT_SUCCESS   104	/* exit >= 0; value ignored */ | 
|  |  | 
|  | #define AUDIT_ARG0      200 | 
|  | #define AUDIT_ARG1      (AUDIT_ARG0+1) | 
|  | #define AUDIT_ARG2      (AUDIT_ARG0+2) | 
|  | #define AUDIT_ARG3      (AUDIT_ARG0+3) | 
|  |  | 
|  | #define AUDIT_NEGATE    0x80000000 | 
|  |  | 
|  |  | 
|  | /* Status symbols */ | 
|  | /* Mask values */ | 
|  | #define AUDIT_STATUS_ENABLED		0x0001 | 
|  | #define AUDIT_STATUS_FAILURE		0x0002 | 
|  | #define AUDIT_STATUS_PID		0x0004 | 
|  | #define AUDIT_STATUS_RATE_LIMIT		0x0008 | 
|  | #define AUDIT_STATUS_BACKLOG_LIMIT	0x0010 | 
|  | /* Failure-to-log actions */ | 
|  | #define AUDIT_FAIL_SILENT	0 | 
|  | #define AUDIT_FAIL_PRINTK	1 | 
|  | #define AUDIT_FAIL_PANIC	2 | 
|  |  | 
|  | /* distinguish syscall tables */ | 
|  | #define __AUDIT_ARCH_64BIT 0x80000000 | 
|  | #define __AUDIT_ARCH_LE	   0x40000000 | 
|  | #define AUDIT_ARCH_ALPHA	(EM_ALPHA|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE) | 
|  | #define AUDIT_ARCH_ARM		(EM_ARM|__AUDIT_ARCH_LE) | 
|  | #define AUDIT_ARCH_ARMEB	(EM_ARM) | 
|  | #define AUDIT_ARCH_CRIS		(EM_CRIS|__AUDIT_ARCH_LE) | 
|  | #define AUDIT_ARCH_FRV		(EM_FRV) | 
|  | #define AUDIT_ARCH_H8300	(EM_H8_300) | 
|  | #define AUDIT_ARCH_I386		(EM_386|__AUDIT_ARCH_LE) | 
|  | #define AUDIT_ARCH_IA64		(EM_IA_64|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE) | 
|  | #define AUDIT_ARCH_M32R		(EM_M32R) | 
|  | #define AUDIT_ARCH_M68K		(EM_68K) | 
|  | #define AUDIT_ARCH_MIPS		(EM_MIPS) | 
|  | #define AUDIT_ARCH_MIPSEL	(EM_MIPS|__AUDIT_ARCH_LE) | 
|  | #define AUDIT_ARCH_MIPS64	(EM_MIPS|__AUDIT_ARCH_64BIT) | 
|  | #define AUDIT_ARCH_MIPSEL64	(EM_MIPS|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE) | 
|  | #define AUDIT_ARCH_PARISC	(EM_PARISC) | 
|  | #define AUDIT_ARCH_PARISC64	(EM_PARISC|__AUDIT_ARCH_64BIT) | 
|  | #define AUDIT_ARCH_PPC		(EM_PPC) | 
|  | #define AUDIT_ARCH_PPC64	(EM_PPC64|__AUDIT_ARCH_64BIT) | 
|  | #define AUDIT_ARCH_S390		(EM_S390) | 
|  | #define AUDIT_ARCH_S390X	(EM_S390|__AUDIT_ARCH_64BIT) | 
|  | #define AUDIT_ARCH_SH		(EM_SH) | 
|  | #define AUDIT_ARCH_SHEL		(EM_SH|__AUDIT_ARCH_LE) | 
|  | #define AUDIT_ARCH_SH64		(EM_SH|__AUDIT_ARCH_64BIT) | 
|  | #define AUDIT_ARCH_SHEL64	(EM_SH|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE) | 
|  | #define AUDIT_ARCH_SPARC	(EM_SPARC) | 
|  | #define AUDIT_ARCH_SPARC64	(EM_SPARCV9|__AUDIT_ARCH_64BIT) | 
|  | #define AUDIT_ARCH_V850		(EM_V850|__AUDIT_ARCH_LE) | 
|  | #define AUDIT_ARCH_X86_64	(EM_X86_64|__AUDIT_ARCH_64BIT|__AUDIT_ARCH_LE) | 
|  |  | 
|  | struct audit_status { | 
|  | __u32		mask;		/* Bit mask for valid entries */ | 
|  | __u32		enabled;	/* 1 = enabled, 0 = disabled */ | 
|  | __u32		failure;	/* Failure-to-log action */ | 
|  | __u32		pid;		/* pid of auditd process */ | 
|  | __u32		rate_limit;	/* messages rate limit (per second) */ | 
|  | __u32		backlog_limit;	/* waiting messages limit */ | 
|  | __u32		lost;		/* messages lost */ | 
|  | __u32		backlog;	/* messages waiting in queue */ | 
|  | }; | 
|  |  | 
|  | struct audit_rule {		/* for AUDIT_LIST, AUDIT_ADD, and AUDIT_DEL */ | 
|  | __u32		flags;	/* AUDIT_PER_{TASK,CALL}, AUDIT_PREPEND */ | 
|  | __u32		action;	/* AUDIT_NEVER, AUDIT_POSSIBLE, AUDIT_ALWAYS */ | 
|  | __u32		field_count; | 
|  | __u32		mask[AUDIT_BITMASK_SIZE]; | 
|  | __u32		fields[AUDIT_MAX_FIELDS]; | 
|  | __u32		values[AUDIT_MAX_FIELDS]; | 
|  | }; | 
|  |  | 
|  | #ifdef __KERNEL__ | 
|  |  | 
|  | struct audit_sig_info { | 
|  | uid_t		uid; | 
|  | pid_t		pid; | 
|  | }; | 
|  |  | 
|  | struct audit_buffer; | 
|  | struct audit_context; | 
|  | struct inode; | 
|  | struct netlink_skb_parms; | 
|  |  | 
|  | #define AUDITSC_INVALID 0 | 
|  | #define AUDITSC_SUCCESS 1 | 
|  | #define AUDITSC_FAILURE 2 | 
|  | #define AUDITSC_RESULT(x) ( ((long)(x))<0?AUDITSC_FAILURE:AUDITSC_SUCCESS ) | 
|  | #ifdef CONFIG_AUDITSYSCALL | 
|  | /* These are defined in auditsc.c */ | 
|  | /* Public API */ | 
|  | extern int  audit_alloc(struct task_struct *task); | 
|  | extern void audit_free(struct task_struct *task); | 
|  | extern void audit_syscall_entry(struct task_struct *task, int arch, | 
|  | int major, unsigned long a0, unsigned long a1, | 
|  | unsigned long a2, unsigned long a3); | 
|  | extern void audit_syscall_exit(struct task_struct *task, int failed, long return_code); | 
|  | extern void audit_getname(const char *name); | 
|  | extern void audit_putname(const char *name); | 
|  | extern void audit_inode(const char *name, const struct inode *inode, unsigned flags); | 
|  |  | 
|  | /* Private API (for audit.c only) */ | 
|  | extern int  audit_receive_filter(int type, int pid, int uid, int seq, | 
|  | void *data, uid_t loginuid); | 
|  | extern unsigned int audit_serial(void); | 
|  | extern void auditsc_get_stamp(struct audit_context *ctx, | 
|  | struct timespec *t, unsigned int *serial); | 
|  | extern int  audit_set_loginuid(struct task_struct *task, uid_t loginuid); | 
|  | extern uid_t audit_get_loginuid(struct audit_context *ctx); | 
|  | extern int audit_ipc_perms(unsigned long qbytes, uid_t uid, gid_t gid, mode_t mode); | 
|  | extern int audit_socketcall(int nargs, unsigned long *args); | 
|  | extern int audit_sockaddr(int len, void *addr); | 
|  | extern int audit_avc_path(struct dentry *dentry, struct vfsmount *mnt); | 
|  | extern void audit_signal_info(int sig, struct task_struct *t); | 
|  | extern int audit_filter_user(struct netlink_skb_parms *cb, int type); | 
|  | #else | 
|  | #define audit_alloc(t) ({ 0; }) | 
|  | #define audit_free(t) do { ; } while (0) | 
|  | #define audit_syscall_entry(t,ta,a,b,c,d,e) do { ; } while (0) | 
|  | #define audit_syscall_exit(t,f,r) do { ; } while (0) | 
|  | #define audit_getname(n) do { ; } while (0) | 
|  | #define audit_putname(n) do { ; } while (0) | 
|  | #define audit_inode(n,i,f) do { ; } while (0) | 
|  | #define audit_receive_filter(t,p,u,s,d,l) ({ -EOPNOTSUPP; }) | 
|  | #define auditsc_get_stamp(c,t,s) do { BUG(); } while (0) | 
|  | #define audit_get_loginuid(c) ({ -1; }) | 
|  | #define audit_ipc_perms(q,u,g,m) ({ 0; }) | 
|  | #define audit_socketcall(n,a) ({ 0; }) | 
|  | #define audit_sockaddr(len, addr) ({ 0; }) | 
|  | #define audit_avc_path(dentry, mnt) ({ 0; }) | 
|  | #define audit_signal_info(s,t) do { ; } while (0) | 
|  | #define audit_filter_user(cb,t) ({ 1; }) | 
|  | #endif | 
|  |  | 
|  | #ifdef CONFIG_AUDIT | 
|  | /* These are defined in audit.c */ | 
|  | /* Public API */ | 
|  | extern void		    audit_log(struct audit_context *ctx, gfp_t gfp_mask, | 
|  | int type, const char *fmt, ...) | 
|  | __attribute__((format(printf,4,5))); | 
|  |  | 
|  | extern struct audit_buffer *audit_log_start(struct audit_context *ctx, gfp_t gfp_mask, int type); | 
|  | extern void		    audit_log_format(struct audit_buffer *ab, | 
|  | const char *fmt, ...) | 
|  | __attribute__((format(printf,2,3))); | 
|  | extern void		    audit_log_end(struct audit_buffer *ab); | 
|  | extern void		    audit_log_hex(struct audit_buffer *ab, | 
|  | const unsigned char *buf, | 
|  | size_t len); | 
|  | extern void		    audit_log_untrustedstring(struct audit_buffer *ab, | 
|  | const char *string); | 
|  | extern void		    audit_log_d_path(struct audit_buffer *ab, | 
|  | const char *prefix, | 
|  | struct dentry *dentry, | 
|  | struct vfsmount *vfsmnt); | 
|  | /* Private API (for auditsc.c only) */ | 
|  | extern void		    audit_send_reply(int pid, int seq, int type, | 
|  | int done, int multi, | 
|  | void *payload, int size); | 
|  | extern void		    audit_log_lost(const char *message); | 
|  | extern struct semaphore audit_netlink_sem; | 
|  | #else | 
|  | #define audit_log(c,g,t,f,...) do { ; } while (0) | 
|  | #define audit_log_start(c,g,t) ({ NULL; }) | 
|  | #define audit_log_vformat(b,f,a) do { ; } while (0) | 
|  | #define audit_log_format(b,f,...) do { ; } while (0) | 
|  | #define audit_log_end(b) do { ; } while (0) | 
|  | #define audit_log_hex(a,b,l) do { ; } while (0) | 
|  | #define audit_log_untrustedstring(a,s) do { ; } while (0) | 
|  | #define audit_log_d_path(b,p,d,v) do { ; } while (0) | 
|  | #endif | 
|  | #endif | 
|  | #endif |