Blame view

kernel/audit.h 11.1 KB
fe7752bab   David Woodhouse   [PATCH] Fix audit...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
  /* audit -- definition of audit_context structure and supporting types 
   *
   * Copyright 2003-2004 Red Hat, Inc.
   * Copyright 2005 Hewlett-Packard Development Company, L.P.
   * Copyright 2005 IBM Corporation
   *
   * 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
   */
  
  #include <linux/fs.h>
  #include <linux/audit.h>
9044e6bca   Al Viro   [PATCH] fix deadl...
24
  #include <linux/skbuff.h>
b24a30a73   Eric Paris   audit: fix event ...
25
  #include <uapi/linux/mqueue.h>
3f5be2da8   Richard Guy Briggs   audit: move audit...
26
  #include <linux/tty.h>
fe7752bab   David Woodhouse   [PATCH] Fix audit...
27

b24a30a73   Eric Paris   audit: fix event ...
28
29
30
31
  /* AUDIT_NAMES is the number of slots we reserve in the audit_context
   * for saving names from getname().  If we get more names we will allocate
   * a name dynamically and also add those to the list anchored by names_list. */
  #define AUDIT_NAMES	5
fe7752bab   David Woodhouse   [PATCH] Fix audit...
32
33
34
35
36
37
38
  /* At task start time, the audit_state is set in the audit_context using
     a per-task filter.  At syscall entry, the audit_state is augmented by
     the syscall filter. */
  enum audit_state {
  	AUDIT_DISABLED,		/* Do not create per-task audit_context.
  				 * No syscall-specific audit records can
  				 * be generated. */
fe7752bab   David Woodhouse   [PATCH] Fix audit...
39
  	AUDIT_BUILD_CONTEXT,	/* Create the per-task audit_context,
997f5b644   Eric Paris   audit: remove AUD...
40
  				 * and fill it in at syscall
fe7752bab   David Woodhouse   [PATCH] Fix audit...
41
42
43
44
45
46
47
48
49
50
51
  				 * entry time.  This makes a full
  				 * syscall record available if some
  				 * other part of the kernel decides it
  				 * should be recorded. */
  	AUDIT_RECORD_CONTEXT	/* Create the per-task audit_context,
  				 * always fill it in at syscall entry
  				 * time, and always write out the audit
  				 * record at syscall exit time.  */
  };
  
  /* Rule lists */
cfcad62c7   Eric Paris   audit: seperate a...
52
  struct audit_watch;
7f4929428   Richard Guy Briggs   audit: clean simp...
53
  struct audit_fsnotify_mark;
74c3cbe33   Al Viro   [PATCH] audit: wa...
54
55
  struct audit_tree;
  struct audit_chunk;
fe7752bab   David Woodhouse   [PATCH] Fix audit...
56
  struct audit_entry {
93315ed6d   Amy Griffis   [PATCH] audit str...
57
58
59
  	struct list_head	list;
  	struct rcu_head		rcu;
  	struct audit_krule	rule;
fe7752bab   David Woodhouse   [PATCH] Fix audit...
60
  };
b24a30a73   Eric Paris   audit: fix event ...
61
62
63
64
65
66
67
68
  struct audit_cap_data {
  	kernel_cap_t		permitted;
  	kernel_cap_t		inheritable;
  	union {
  		unsigned int	fE;		/* effective bit of file cap */
  		kernel_cap_t	effective;	/* effective set of process */
  	};
  };
55422d0bd   Paul Moore   audit: replace ge...
69
70
  /* When fs/namei.c:getname() is called, we store the pointer in name and bump
   * the refcnt in the associated filename struct.
b24a30a73   Eric Paris   audit: fix event ...
71
72
73
74
75
76
77
78
   *
   * Further, in fs/namei.c:path_lookup() we store the inode and device.
   */
  struct audit_names {
  	struct list_head	list;		/* audit_context->names_list */
  
  	struct filename		*name;
  	int			name_len;	/* number of chars to log */
79f6530cb   Jeff Layton   audit: fix mq_ope...
79
  	bool			hidden;		/* don't log this record */
b24a30a73   Eric Paris   audit: fix event ...
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
  
  	unsigned long		ino;
  	dev_t			dev;
  	umode_t			mode;
  	kuid_t			uid;
  	kgid_t			gid;
  	dev_t			rdev;
  	u32			osid;
  	struct audit_cap_data	fcap;
  	unsigned int		fcap_ver;
  	unsigned char		type;		/* record type */
  	/*
  	 * This was an allocated audit_names and not from the array of
  	 * names allocated in the task audit context.  Thus this name
  	 * should be freed on syscall exit.
  	 */
  	bool			should_free;
  };
3f1c82502   William Roberts   audit: Audit proc...
98
99
100
101
  struct audit_proctitle {
  	int	len;	/* length of the cmdline field. */
  	char	*value;	/* the cmdline field */
  };
b24a30a73   Eric Paris   audit: fix event ...
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
  /* The per-task audit context. */
  struct audit_context {
  	int		    dummy;	/* must be the first element */
  	int		    in_syscall;	/* 1 if task is in a syscall */
  	enum audit_state    state, current_state;
  	unsigned int	    serial;     /* serial number for record */
  	int		    major;      /* syscall number */
  	struct timespec	    ctime;      /* time of syscall entry */
  	unsigned long	    argv[4];    /* syscall arguments */
  	long		    return_code;/* syscall return code */
  	u64		    prio;
  	int		    return_valid; /* return code is valid */
  	/*
  	 * The names_list is the list of all audit_names collected during this
  	 * syscall.  The first AUDIT_NAMES entries in the names_list will
  	 * actually be from the preallocated_names array for performance
  	 * reasons.  Except during allocation they should never be referenced
  	 * through the preallocated_names array and should only be found/used
  	 * by running the names_list.
  	 */
  	struct audit_names  preallocated_names[AUDIT_NAMES];
  	int		    name_count; /* total records in names_list */
  	struct list_head    names_list;	/* struct audit_names->list anchor */
  	char		    *filterkey;	/* key for rule that triggered record */
  	struct path	    pwd;
  	struct audit_aux_data *aux;
  	struct audit_aux_data *aux_pids;
  	struct sockaddr_storage *sockaddr;
  	size_t sockaddr_len;
  				/* Save things to print about task_struct */
  	pid_t		    pid, ppid;
  	kuid_t		    uid, euid, suid, fsuid;
  	kgid_t		    gid, egid, sgid, fsgid;
  	unsigned long	    personality;
  	int		    arch;
  
  	pid_t		    target_pid;
  	kuid_t		    target_auid;
  	kuid_t		    target_uid;
  	unsigned int	    target_sessionid;
  	u32		    target_sid;
  	char		    target_comm[TASK_COMM_LEN];
  
  	struct audit_tree_refs *trees, *first_trees;
  	struct list_head killed_trees;
  	int tree_count;
  
  	int type;
  	union {
  		struct {
  			int nargs;
  			long args[6];
  		} socketcall;
  		struct {
  			kuid_t			uid;
  			kgid_t			gid;
  			umode_t			mode;
  			u32			osid;
  			int			has_perm;
  			uid_t			perm_uid;
  			gid_t			perm_gid;
  			umode_t			perm_mode;
  			unsigned long		qbytes;
  		} ipc;
  		struct {
  			mqd_t			mqdes;
  			struct mq_attr		mqstat;
  		} mq_getsetattr;
  		struct {
  			mqd_t			mqdes;
  			int			sigev_signo;
  		} mq_notify;
  		struct {
  			mqd_t			mqdes;
  			size_t			msg_len;
  			unsigned int		msg_prio;
  			struct timespec		abs_timeout;
  		} mq_sendrecv;
  		struct {
  			int			oflag;
  			umode_t			mode;
  			struct mq_attr		attr;
  		} mq_open;
  		struct {
  			pid_t			pid;
  			struct audit_cap_data	cap;
  		} capset;
  		struct {
  			int			fd;
  			int			flags;
  		} mmap;
d9cfea91e   Richard Guy Briggs   audit: move audit...
193
194
  		struct {
  			int			argc;
d9cfea91e   Richard Guy Briggs   audit: move audit...
195
  		} execve;
b24a30a73   Eric Paris   audit: fix event ...
196
197
  	};
  	int fds[2];
3f1c82502   William Roberts   audit: Audit proc...
198
  	struct audit_proctitle proctitle;
b24a30a73   Eric Paris   audit: fix event ...
199
  };
3e1d0bb62   Joe Perches   audit: Convert in...
200
  extern u32 audit_ever_enabled;
c782f242f   Harvey Harrison   [PATCH 1/2] audit...
201

b24a30a73   Eric Paris   audit: fix event ...
202
203
  extern void audit_copy_inode(struct audit_names *name,
  			     const struct dentry *dentry,
d6335d77a   Andreas Gruenbacher   security: Make in...
204
  			     struct inode *inode);
b24a30a73   Eric Paris   audit: fix event ...
205
206
  extern void audit_log_cap(struct audit_buffer *ab, char *prefix,
  			  kernel_cap_t *cap);
b24a30a73   Eric Paris   audit: fix event ...
207
208
209
  extern void audit_log_name(struct audit_context *context,
  			   struct audit_names *n, struct path *path,
  			   int record_num, int *call_panic);
c782f242f   Harvey Harrison   [PATCH 1/2] audit...
210

fe7752bab   David Woodhouse   [PATCH] Fix audit...
211
  extern int audit_pid;
fe7752bab   David Woodhouse   [PATCH] Fix audit...
212

f368c07d7   Amy Griffis   [PATCH] audit: pa...
213
214
215
216
217
218
219
  #define AUDIT_INODE_BUCKETS	32
  extern struct list_head audit_inode_hash[AUDIT_INODE_BUCKETS];
  
  static inline int audit_hash_ino(u32 ino)
  {
  	return (ino & (AUDIT_INODE_BUCKETS-1));
  }
e3d6b07b8   Jeff Layton   audit: optimize a...
220
221
  /* Indicates that audit should log the full pathname. */
  #define AUDIT_NAME_FULL -1
55669bfa1   Al Viro   [PATCH] audit: AU...
222
  extern int audit_match_class(int class, unsigned syscall);
f368c07d7   Amy Griffis   [PATCH] audit: pa...
223
  extern int audit_comparator(const u32 left, const u32 op, const u32 right);
ca57ec0f0   Eric W. Biederman   audit: Add typesp...
224
225
  extern int audit_uid_comparator(kuid_t left, u32 op, kuid_t right);
  extern int audit_gid_comparator(kgid_t left, u32 op, kgid_t right);
bfcec7087   Jeff Layton   audit: set the na...
226
  extern int parent_len(const char *path);
e3d6b07b8   Jeff Layton   audit: optimize a...
227
  extern int audit_compare_dname_path(const char *dname, const char *path, int plen);
f9441639e   Richard Guy Briggs   audit: fix netlin...
228
229
230
  extern struct sk_buff *audit_make_reply(__u32 portid, int seq, int type,
  					int done, int multi,
  					const void *payload, int size);
fe7752bab   David Woodhouse   [PATCH] Fix audit...
231
  extern void		    audit_panic(const char *message);
3dc7e3153   Darrel Goeddel   [PATCH] support f...
232

9044e6bca   Al Viro   [PATCH] fix deadl...
233
  struct audit_netlink_list {
f9441639e   Richard Guy Briggs   audit: fix netlin...
234
  	__u32 portid;
638a0fd2a   Eric W. Biederman   audit: Use struct...
235
  	struct net *net;
9044e6bca   Al Viro   [PATCH] fix deadl...
236
237
238
239
  	struct sk_buff_head q;
  };
  
  int audit_send_list(void *);
33faba7fa   Richard Guy Briggs   audit: listen in ...
240
241
242
  struct audit_net {
  	struct sock *nlsk;
  };
3dc7e3153   Darrel Goeddel   [PATCH] support f...
243
  extern int selinux_audit_rule_update(void);
e1396065e   Al Viro   [PATCH] collect s...
244

74c3cbe33   Al Viro   [PATCH] audit: wa...
245
  extern struct mutex audit_filter_mutex;
7f4929428   Richard Guy Briggs   audit: clean simp...
246
  extern int audit_del_rule(struct audit_entry *);
74c3cbe33   Al Viro   [PATCH] audit: wa...
247
  extern void audit_free_rule_rcu(struct rcu_head *);
c782f242f   Harvey Harrison   [PATCH 1/2] audit...
248
  extern struct list_head audit_filter_list[];
74c3cbe33   Al Viro   [PATCH] audit: wa...
249

939a67fc4   Eric Paris   Audit: split audi...
250
  extern struct audit_entry *audit_dupe_rule(struct audit_krule *old);
4766b199e   Davidlohr Bueso   audit: consolidat...
251
252
  extern void audit_log_d_path_exe(struct audit_buffer *ab,
  				 struct mm_struct *mm);
3f5be2da8   Richard Guy Briggs   audit: move audit...
253
254
  extern struct tty_struct *audit_get_tty(struct task_struct *tsk);
  extern void audit_put_tty(struct tty_struct *tty);
cfcad62c7   Eric Paris   audit: seperate a...
255
  /* audit watch functions */
939a67fc4   Eric Paris   Audit: split audi...
256
  #ifdef CONFIG_AUDIT_WATCH
cfcad62c7   Eric Paris   audit: seperate a...
257
258
259
  extern void audit_put_watch(struct audit_watch *watch);
  extern void audit_get_watch(struct audit_watch *watch);
  extern int audit_to_watch(struct audit_krule *krule, char *path, int len, u32 op);
ae7b8f410   Eric Paris   Audit: clean up t...
260
  extern int audit_add_watch(struct audit_krule *krule, struct list_head **list);
a05fb6cc5   Eric Paris   audit: do not get...
261
  extern void audit_remove_watch_rule(struct audit_krule *krule);
cfcad62c7   Eric Paris   audit: seperate a...
262
  extern char *audit_watch_path(struct audit_watch *watch);
ae7b8f410   Eric Paris   Audit: clean up t...
263
  extern int audit_watch_compare(struct audit_watch *watch, unsigned long ino, dev_t dev);
7f4929428   Richard Guy Briggs   audit: clean simp...
264
265
266
267
268
269
  
  extern struct audit_fsnotify_mark *audit_alloc_mark(struct audit_krule *krule, char *pathname, int len);
  extern char *audit_mark_path(struct audit_fsnotify_mark *mark);
  extern void audit_remove_mark(struct audit_fsnotify_mark *audit_mark);
  extern void audit_remove_mark_rule(struct audit_krule *krule);
  extern int audit_mark_compare(struct audit_fsnotify_mark *mark, unsigned long ino, dev_t dev);
34d99af52   Richard Guy Briggs   audit: implement ...
270
271
  extern int audit_dupe_exe(struct audit_krule *new, struct audit_krule *old);
  extern int audit_exe_compare(struct task_struct *tsk, struct audit_fsnotify_mark *mark);
7f4929428   Richard Guy Briggs   audit: clean simp...
272

939a67fc4   Eric Paris   Audit: split audi...
273
274
275
276
277
278
279
280
  #else
  #define audit_put_watch(w) {}
  #define audit_get_watch(w) {}
  #define audit_to_watch(k, p, l, o) (-EINVAL)
  #define audit_add_watch(k, l) (-EINVAL)
  #define audit_remove_watch_rule(k) BUG()
  #define audit_watch_path(w) ""
  #define audit_watch_compare(w, i, d) 0
7f4929428   Richard Guy Briggs   audit: clean simp...
281
282
283
284
285
  #define audit_alloc_mark(k, p, l) (ERR_PTR(-EINVAL))
  #define audit_mark_path(m) ""
  #define audit_remove_mark(m)
  #define audit_remove_mark_rule(k)
  #define audit_mark_compare(m, i, d) 0
34d99af52   Richard Guy Briggs   audit: implement ...
286
287
  #define audit_exe_compare(t, m) (-EINVAL)
  #define audit_dupe_exe(n, o) (-EINVAL)
939a67fc4   Eric Paris   Audit: split audi...
288
  #endif /* CONFIG_AUDIT_WATCH */
cfcad62c7   Eric Paris   audit: seperate a...
289

74c3cbe33   Al Viro   [PATCH] audit: wa...
290
291
292
  #ifdef CONFIG_AUDIT_TREE
  extern struct audit_chunk *audit_tree_lookup(const struct inode *);
  extern void audit_put_chunk(struct audit_chunk *);
6f1b5d7af   Yaowei Bai   audit: audit_tree...
293
  extern bool audit_tree_match(struct audit_chunk *, struct audit_tree *);
74c3cbe33   Al Viro   [PATCH] audit: wa...
294
295
296
297
298
  extern int audit_make_tree(struct audit_krule *, char *, u32);
  extern int audit_add_tree_rule(struct audit_krule *);
  extern int audit_remove_tree_rule(struct audit_krule *);
  extern void audit_trim_trees(void);
  extern int audit_tag_tree(char *old, char *new);
74c3cbe33   Al Viro   [PATCH] audit: wa...
299
300
  extern const char *audit_tree_path(struct audit_tree *);
  extern void audit_put_tree(struct audit_tree *);
916d75761   Al Viro   Fix rule eviction...
301
  extern void audit_kill_trees(struct list_head *);
74c3cbe33   Al Viro   [PATCH] audit: wa...
302
303
304
305
306
307
308
309
  #else
  #define audit_remove_tree_rule(rule) BUG()
  #define audit_add_tree_rule(rule) -EINVAL
  #define audit_make_tree(rule, str, op) -EINVAL
  #define audit_trim_trees() (void)0
  #define audit_put_tree(tree) (void)0
  #define audit_tag_tree(old, new) -EINVAL
  #define audit_tree_path(rule) ""	/* never called */
916d75761   Al Viro   Fix rule eviction...
310
  #define audit_kill_trees(list) BUG()
74c3cbe33   Al Viro   [PATCH] audit: wa...
311
312
313
  #endif
  
  extern char *audit_unpack_string(void **, size_t *, size_t);
c782f242f   Harvey Harrison   [PATCH 1/2] audit...
314
  extern pid_t audit_sig_pid;
cca080d9b   Eric W. Biederman   userns: Convert a...
315
  extern kuid_t audit_sig_uid;
c782f242f   Harvey Harrison   [PATCH 1/2] audit...
316
  extern u32 audit_sig_sid;
86b2efbe3   Richard Guy Briggs   audit: add fields...
317
  extern int audit_filter(int msgtype, unsigned int listtype);
e1396065e   Al Viro   [PATCH] collect s...
318
  #ifdef CONFIG_AUDITSYSCALL
e54dc2431   Amy Griffis   [PATCH] audit sig...
319
320
  extern int __audit_signal_info(int sig, struct task_struct *t);
  static inline int audit_signal_info(int sig, struct task_struct *t)
e1396065e   Al Viro   [PATCH] collect s...
321
  {
e54dc2431   Amy Griffis   [PATCH] audit sig...
322
323
324
325
  	if (unlikely((audit_pid && t->tgid == audit_pid) ||
  		     (audit_signals && !audit_dummy_context())))
  		return __audit_signal_info(sig, t);
  	return 0;
e1396065e   Al Viro   [PATCH] collect s...
326
  }
0590b9335   Al Viro   fixing audit rule...
327
  extern void audit_filter_inodes(struct task_struct *, struct audit_context *);
916d75761   Al Viro   Fix rule eviction...
328
  extern struct list_head *audit_killed_trees(void);
e1396065e   Al Viro   [PATCH] collect s...
329
  #else
e54dc2431   Amy Griffis   [PATCH] audit sig...
330
  #define audit_signal_info(s,t) AUDIT_DISABLED
f368c07d7   Amy Griffis   [PATCH] audit: pa...
331
  #define audit_filter_inodes(t,c) AUDIT_DISABLED
e1396065e   Al Viro   [PATCH] collect s...
332
  #endif
916d75761   Al Viro   Fix rule eviction...
333
334
  
  extern struct mutex audit_cmd_mutex;