1 /* SPDX-License-Identifier: GPL-2.0-or-later * !! 1 /* audit -- definition of audit_context structure and supporting types 2 /* audit -- definition of audit_context struct << 3 * 2 * 4 * Copyright 2003-2004 Red Hat, Inc. 3 * Copyright 2003-2004 Red Hat, Inc. 5 * Copyright 2005 Hewlett-Packard Development 4 * Copyright 2005 Hewlett-Packard Development Company, L.P. 6 * Copyright 2005 IBM Corporation 5 * Copyright 2005 IBM Corporation >> 6 * >> 7 * This program is free software; you can redistribute it and/or modify >> 8 * it under the terms of the GNU General Public License as published by >> 9 * the Free Software Foundation; either version 2 of the License, or >> 10 * (at your option) any later version. >> 11 * >> 12 * This program is distributed in the hope that it will be useful, >> 13 * but WITHOUT ANY WARRANTY; without even the implied warranty of >> 14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the >> 15 * GNU General Public License for more details. >> 16 * >> 17 * You should have received a copy of the GNU General Public License >> 18 * along with this program; if not, write to the Free Software >> 19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 7 */ 20 */ 8 21 9 #ifndef _KERNEL_AUDIT_H_ << 10 #define _KERNEL_AUDIT_H_ << 11 << 12 #include <linux/fs.h> 22 #include <linux/fs.h> 13 #include <linux/audit.h> 23 #include <linux/audit.h> 14 #include <linux/skbuff.h> 24 #include <linux/skbuff.h> 15 #include <uapi/linux/mqueue.h> 25 #include <uapi/linux/mqueue.h> 16 #include <linux/tty.h> 26 #include <linux/tty.h> 17 #include <uapi/linux/openat2.h> // struct open << 18 27 19 /* AUDIT_NAMES is the number of slots we reser 28 /* AUDIT_NAMES is the number of slots we reserve in the audit_context 20 * for saving names from getname(). If we get 29 * for saving names from getname(). If we get more names we will allocate 21 * a name dynamically and also add those to th 30 * a name dynamically and also add those to the list anchored by names_list. */ 22 #define AUDIT_NAMES 5 31 #define AUDIT_NAMES 5 23 32 24 /* At task start time, the audit_state is set 33 /* At task start time, the audit_state is set in the audit_context using 25 a per-task filter. At syscall entry, the a 34 a per-task filter. At syscall entry, the audit_state is augmented by 26 the syscall filter. */ 35 the syscall filter. */ 27 enum audit_state { 36 enum audit_state { 28 AUDIT_STATE_DISABLED, /* Do not crea !! 37 AUDIT_DISABLED, /* Do not create per-task audit_context. 29 * No syscall- 38 * No syscall-specific audit records can 30 * be generate 39 * be generated. */ 31 AUDIT_STATE_BUILD, /* Create the !! 40 AUDIT_BUILD_CONTEXT, /* Create the per-task audit_context, 32 * and fill it 41 * and fill it in at syscall 33 * entry time. 42 * entry time. This makes a full 34 * syscall rec 43 * syscall record available if some 35 * other part 44 * other part of the kernel decides it 36 * should be r 45 * should be recorded. */ 37 AUDIT_STATE_RECORD /* Create the !! 46 AUDIT_RECORD_CONTEXT /* Create the per-task audit_context, 38 * always fill 47 * always fill it in at syscall entry 39 * time, and a 48 * time, and always write out the audit 40 * record at s 49 * record at syscall exit time. */ 41 }; 50 }; 42 51 43 /* Rule lists */ 52 /* Rule lists */ 44 struct audit_watch; 53 struct audit_watch; 45 struct audit_fsnotify_mark; 54 struct audit_fsnotify_mark; 46 struct audit_tree; 55 struct audit_tree; 47 struct audit_chunk; 56 struct audit_chunk; 48 57 49 struct audit_entry { 58 struct audit_entry { 50 struct list_head list; 59 struct list_head list; 51 struct rcu_head rcu; 60 struct rcu_head rcu; 52 struct audit_krule rule; 61 struct audit_krule rule; 53 }; 62 }; 54 63 55 struct audit_cap_data { 64 struct audit_cap_data { 56 kernel_cap_t permitted; 65 kernel_cap_t permitted; 57 kernel_cap_t inheritable; 66 kernel_cap_t inheritable; 58 union { 67 union { 59 unsigned int fE; 68 unsigned int fE; /* effective bit of file cap */ 60 kernel_cap_t effective; 69 kernel_cap_t effective; /* effective set of process */ 61 }; 70 }; 62 kernel_cap_t ambient; 71 kernel_cap_t ambient; 63 kuid_t rootid; << 64 }; 72 }; 65 73 66 /* When fs/namei.c:getname() is called, we sto 74 /* When fs/namei.c:getname() is called, we store the pointer in name and bump 67 * the refcnt in the associated filename struc 75 * the refcnt in the associated filename struct. 68 * 76 * 69 * Further, in fs/namei.c:path_lookup() we sto 77 * Further, in fs/namei.c:path_lookup() we store the inode and device. 70 */ 78 */ 71 struct audit_names { 79 struct audit_names { 72 struct list_head list; 80 struct list_head list; /* audit_context->names_list */ 73 81 74 struct filename *name; 82 struct filename *name; 75 int name_len; 83 int name_len; /* number of chars to log */ 76 bool hidden; 84 bool hidden; /* don't log this record */ 77 85 78 unsigned long ino; 86 unsigned long ino; 79 dev_t dev; 87 dev_t dev; 80 umode_t mode; 88 umode_t mode; 81 kuid_t uid; 89 kuid_t uid; 82 kgid_t gid; 90 kgid_t gid; 83 dev_t rdev; 91 dev_t rdev; 84 u32 osid; 92 u32 osid; 85 struct audit_cap_data fcap; 93 struct audit_cap_data fcap; 86 unsigned int fcap_ver; 94 unsigned int fcap_ver; 87 unsigned char type; 95 unsigned char type; /* record type */ 88 /* 96 /* 89 * This was an allocated audit_names a 97 * This was an allocated audit_names and not from the array of 90 * names allocated in the task audit c 98 * names allocated in the task audit context. Thus this name 91 * should be freed on syscall exit. 99 * should be freed on syscall exit. 92 */ 100 */ 93 bool should_free; 101 bool should_free; 94 }; 102 }; 95 103 96 struct audit_proctitle { 104 struct audit_proctitle { 97 int len; /* length of the cmdli 105 int len; /* length of the cmdline field. */ 98 char *value; /* the cmdline field * 106 char *value; /* the cmdline field */ 99 }; 107 }; 100 108 101 /* The per-task audit context. */ 109 /* The per-task audit context. */ 102 struct audit_context { 110 struct audit_context { 103 int dummy; /* mus 111 int dummy; /* must be the first element */ 104 enum { !! 112 int in_syscall; /* 1 if task is in a syscall */ 105 AUDIT_CTX_UNUSED, /* aud << 106 AUDIT_CTX_SYSCALL, /* in << 107 AUDIT_CTX_URING, /* in << 108 } context; << 109 enum audit_state state, current_sta 113 enum audit_state state, current_state; 110 unsigned int serial; /* ser 114 unsigned int serial; /* serial number for record */ 111 int major; /* sys 115 int major; /* syscall number */ 112 int uring_op; /* uri << 113 struct timespec64 ctime; /* tim 116 struct timespec64 ctime; /* time of syscall entry */ 114 unsigned long argv[4]; /* sys 117 unsigned long argv[4]; /* syscall arguments */ 115 long return_code;/* sys 118 long return_code;/* syscall return code */ 116 u64 prio; 119 u64 prio; 117 int return_valid; /* r 120 int return_valid; /* return code is valid */ 118 /* 121 /* 119 * The names_list is the list of all a 122 * The names_list is the list of all audit_names collected during this 120 * syscall. The first AUDIT_NAMES ent 123 * syscall. The first AUDIT_NAMES entries in the names_list will 121 * actually be from the preallocated_n 124 * actually be from the preallocated_names array for performance 122 * reasons. Except during allocation 125 * reasons. Except during allocation they should never be referenced 123 * through the preallocated_names arra 126 * through the preallocated_names array and should only be found/used 124 * by running the names_list. 127 * by running the names_list. 125 */ 128 */ 126 struct audit_names preallocated_names 129 struct audit_names preallocated_names[AUDIT_NAMES]; 127 int name_count; /* tot 130 int name_count; /* total records in names_list */ 128 struct list_head names_list; /* str 131 struct list_head names_list; /* struct audit_names->list anchor */ 129 char *filterkey; /* key 132 char *filterkey; /* key for rule that triggered record */ 130 struct path pwd; 133 struct path pwd; 131 struct audit_aux_data *aux; 134 struct audit_aux_data *aux; 132 struct audit_aux_data *aux_pids; 135 struct audit_aux_data *aux_pids; 133 struct sockaddr_storage *sockaddr; 136 struct sockaddr_storage *sockaddr; 134 size_t sockaddr_len; 137 size_t sockaddr_len; 135 /* Save things 138 /* Save things to print about task_struct */ 136 pid_t ppid; !! 139 pid_t pid, ppid; 137 kuid_t uid, euid, suid, f 140 kuid_t uid, euid, suid, fsuid; 138 kgid_t gid, egid, sgid, f 141 kgid_t gid, egid, sgid, fsgid; 139 unsigned long personality; 142 unsigned long personality; 140 int arch; 143 int arch; 141 144 142 pid_t target_pid; 145 pid_t target_pid; 143 kuid_t target_auid; 146 kuid_t target_auid; 144 kuid_t target_uid; 147 kuid_t target_uid; 145 unsigned int target_sessionid; 148 unsigned int target_sessionid; 146 u32 target_sid; 149 u32 target_sid; 147 char target_comm[TASK_C 150 char target_comm[TASK_COMM_LEN]; 148 151 149 struct audit_tree_refs *trees, *first_ 152 struct audit_tree_refs *trees, *first_trees; 150 struct list_head killed_trees; 153 struct list_head killed_trees; 151 int tree_count; 154 int tree_count; 152 155 153 int type; 156 int type; 154 union { 157 union { 155 struct { 158 struct { 156 int nargs; 159 int nargs; 157 long args[6]; 160 long args[6]; 158 } socketcall; 161 } socketcall; 159 struct { 162 struct { 160 kuid_t 163 kuid_t uid; 161 kgid_t 164 kgid_t gid; 162 umode_t 165 umode_t mode; 163 u32 166 u32 osid; 164 int 167 int has_perm; 165 uid_t 168 uid_t perm_uid; 166 gid_t 169 gid_t perm_gid; 167 umode_t 170 umode_t perm_mode; 168 unsigned long 171 unsigned long qbytes; 169 } ipc; 172 } ipc; 170 struct { 173 struct { 171 mqd_t 174 mqd_t mqdes; 172 struct mq_attr 175 struct mq_attr mqstat; 173 } mq_getsetattr; 176 } mq_getsetattr; 174 struct { 177 struct { 175 mqd_t 178 mqd_t mqdes; 176 int 179 int sigev_signo; 177 } mq_notify; 180 } mq_notify; 178 struct { 181 struct { 179 mqd_t 182 mqd_t mqdes; 180 size_t 183 size_t msg_len; 181 unsigned int 184 unsigned int msg_prio; 182 struct timespec64 185 struct timespec64 abs_timeout; 183 } mq_sendrecv; 186 } mq_sendrecv; 184 struct { 187 struct { 185 int 188 int oflag; 186 umode_t 189 umode_t mode; 187 struct mq_attr 190 struct mq_attr attr; 188 } mq_open; 191 } mq_open; 189 struct { 192 struct { 190 pid_t 193 pid_t pid; 191 struct audit_cap_data 194 struct audit_cap_data cap; 192 } capset; 195 } capset; 193 struct { 196 struct { 194 int 197 int fd; 195 int 198 int flags; 196 } mmap; 199 } mmap; 197 struct open_how openat2; << 198 struct { 200 struct { 199 int 201 int argc; 200 } execve; 202 } execve; 201 struct { 203 struct { 202 char 204 char *name; 203 } module; 205 } module; 204 struct { << 205 struct audit_ntp_data << 206 struct timespec64 << 207 } time; << 208 }; 206 }; 209 int fds[2]; 207 int fds[2]; 210 struct audit_proctitle proctitle; 208 struct audit_proctitle proctitle; 211 }; 209 }; 212 210 213 extern bool audit_ever_enabled; 211 extern bool audit_ever_enabled; 214 212 215 extern void audit_log_session_info(struct audi !! 213 extern void audit_copy_inode(struct audit_names *name, >> 214 const struct dentry *dentry, >> 215 struct inode *inode); >> 216 extern void audit_log_cap(struct audit_buffer *ab, char *prefix, >> 217 kernel_cap_t *cap); >> 218 extern void audit_log_name(struct audit_context *context, >> 219 struct audit_names *n, const struct path *path, >> 220 int record_num, int *call_panic); 216 221 217 extern int auditd_test_task(struct task_struct 222 extern int auditd_test_task(struct task_struct *task); 218 223 219 #define AUDIT_INODE_BUCKETS 32 224 #define AUDIT_INODE_BUCKETS 32 220 extern struct list_head audit_inode_hash[AUDIT 225 extern struct list_head audit_inode_hash[AUDIT_INODE_BUCKETS]; 221 226 222 static inline int audit_hash_ino(u32 ino) 227 static inline int audit_hash_ino(u32 ino) 223 { 228 { 224 return (ino & (AUDIT_INODE_BUCKETS-1)) 229 return (ino & (AUDIT_INODE_BUCKETS-1)); 225 } 230 } 226 231 227 /* Indicates that audit should log the full pa 232 /* Indicates that audit should log the full pathname. */ 228 #define AUDIT_NAME_FULL -1 233 #define AUDIT_NAME_FULL -1 229 234 230 extern int audit_match_class(int class, unsign 235 extern int audit_match_class(int class, unsigned syscall); 231 extern int audit_comparator(const u32 left, co 236 extern int audit_comparator(const u32 left, const u32 op, const u32 right); 232 extern int audit_uid_comparator(kuid_t left, u 237 extern int audit_uid_comparator(kuid_t left, u32 op, kuid_t right); 233 extern int audit_gid_comparator(kgid_t left, u 238 extern int audit_gid_comparator(kgid_t left, u32 op, kgid_t right); 234 extern int parent_len(const char *path); 239 extern int parent_len(const char *path); 235 extern int audit_compare_dname_path(const stru !! 240 extern int audit_compare_dname_path(const char *dname, const char *path, int plen); 236 extern struct sk_buff *audit_make_reply(int se 241 extern struct sk_buff *audit_make_reply(int seq, int type, int done, int multi, 237 const 242 const void *payload, int size); 238 extern void audit_panic(const 243 extern void audit_panic(const char *message); 239 244 240 struct audit_netlink_list { 245 struct audit_netlink_list { 241 __u32 portid; 246 __u32 portid; 242 struct net *net; 247 struct net *net; 243 struct sk_buff_head q; 248 struct sk_buff_head q; 244 }; 249 }; 245 250 246 int audit_send_list_thread(void *_dest); !! 251 int audit_send_list(void *_dest); >> 252 >> 253 extern int selinux_audit_rule_update(void); 247 254 248 extern struct mutex audit_filter_mutex; 255 extern struct mutex audit_filter_mutex; 249 extern int audit_del_rule(struct audit_entry * 256 extern int audit_del_rule(struct audit_entry *entry); 250 extern void audit_free_rule_rcu(struct rcu_hea 257 extern void audit_free_rule_rcu(struct rcu_head *head); 251 extern struct list_head audit_filter_list[]; 258 extern struct list_head audit_filter_list[]; 252 259 253 extern struct audit_entry *audit_dupe_rule(str 260 extern struct audit_entry *audit_dupe_rule(struct audit_krule *old); 254 261 255 extern void audit_log_d_path_exe(struct audit_ 262 extern void audit_log_d_path_exe(struct audit_buffer *ab, 256 struct mm_str 263 struct mm_struct *mm); 257 264 258 extern struct tty_struct *audit_get_tty(void); !! 265 extern struct tty_struct *audit_get_tty(struct task_struct *tsk); 259 extern void audit_put_tty(struct tty_struct *t 266 extern void audit_put_tty(struct tty_struct *tty); 260 267 261 /* audit watch/mark/tree functions */ !! 268 /* audit watch functions */ 262 extern unsigned int audit_serial(void); !! 269 #ifdef CONFIG_AUDIT_WATCH 263 #ifdef CONFIG_AUDITSYSCALL << 264 extern int auditsc_get_stamp(struct audit_cont << 265 struct timespec6 << 266 << 267 extern void audit_put_watch(struct audit_watch 270 extern void audit_put_watch(struct audit_watch *watch); 268 extern void audit_get_watch(struct audit_watch 271 extern void audit_get_watch(struct audit_watch *watch); 269 extern int audit_to_watch(struct audit_krule * !! 272 extern int audit_to_watch(struct audit_krule *krule, char *path, int len, u32 op); 270 u32 op); << 271 extern int audit_add_watch(struct audit_krule 273 extern int audit_add_watch(struct audit_krule *krule, struct list_head **list); 272 extern void audit_remove_watch_rule(struct aud 274 extern void audit_remove_watch_rule(struct audit_krule *krule); 273 extern char *audit_watch_path(struct audit_wat 275 extern char *audit_watch_path(struct audit_watch *watch); 274 extern int audit_watch_compare(struct audit_wa !! 276 extern int audit_watch_compare(struct audit_watch *watch, unsigned long ino, dev_t dev); 275 dev_t dev); << 276 277 277 extern struct audit_fsnotify_mark *audit_alloc !! 278 extern struct audit_fsnotify_mark *audit_alloc_mark(struct audit_krule *krule, char *pathname, int len); 278 << 279 extern char *audit_mark_path(struct audit_fsno 279 extern char *audit_mark_path(struct audit_fsnotify_mark *mark); 280 extern void audit_remove_mark(struct audit_fsn 280 extern void audit_remove_mark(struct audit_fsnotify_mark *audit_mark); 281 extern void audit_remove_mark_rule(struct audi 281 extern void audit_remove_mark_rule(struct audit_krule *krule); 282 extern int audit_mark_compare(struct audit_fsn !! 282 extern int audit_mark_compare(struct audit_fsnotify_mark *mark, unsigned long ino, dev_t dev); 283 unsigned long in << 284 extern int audit_dupe_exe(struct audit_krule * 283 extern int audit_dupe_exe(struct audit_krule *new, struct audit_krule *old); 285 extern int audit_exe_compare(struct task_struc !! 284 extern int audit_exe_compare(struct task_struct *tsk, struct audit_fsnotify_mark *mark); 286 struct audit_fsno << 287 << 288 extern struct audit_chunk *audit_tree_lookup(c << 289 extern void audit_put_chunk(struct audit_chunk << 290 extern bool audit_tree_match(struct audit_chun << 291 struct audit_tree << 292 extern int audit_make_tree(struct audit_krule << 293 extern int audit_add_tree_rule(struct audit_kr << 294 extern int audit_remove_tree_rule(struct audit << 295 extern void audit_trim_trees(void); << 296 extern int audit_tag_tree(char *old, char *new << 297 extern const char *audit_tree_path(struct audi << 298 extern void audit_put_tree(struct audit_tree * << 299 extern void audit_kill_trees(struct audit_cont << 300 285 301 extern int audit_signal_info_syscall(struct ta !! 286 #else 302 extern void audit_filter_inodes(struct task_st !! 287 #define audit_put_watch(w) {} 303 struct audit_c !! 288 #define audit_get_watch(w) {} 304 extern struct list_head *audit_killed_trees(vo << 305 #else /* CONFIG_AUDITSYSCALL */ << 306 #define auditsc_get_stamp(c, t, s) 0 << 307 #define audit_put_watch(w) do { } while (0) << 308 #define audit_get_watch(w) do { } while (0) << 309 #define audit_to_watch(k, p, l, o) (-EINVAL) 289 #define audit_to_watch(k, p, l, o) (-EINVAL) 310 #define audit_add_watch(k, l) (-EINVAL) 290 #define audit_add_watch(k, l) (-EINVAL) 311 #define audit_remove_watch_rule(k) BUG() 291 #define audit_remove_watch_rule(k) BUG() 312 #define audit_watch_path(w) "" 292 #define audit_watch_path(w) "" 313 #define audit_watch_compare(w, i, d) 0 293 #define audit_watch_compare(w, i, d) 0 314 294 315 #define audit_alloc_mark(k, p, l) (ERR_PTR(-EI 295 #define audit_alloc_mark(k, p, l) (ERR_PTR(-EINVAL)) 316 #define audit_mark_path(m) "" 296 #define audit_mark_path(m) "" 317 #define audit_remove_mark(m) do { } while (0) !! 297 #define audit_remove_mark(m) 318 #define audit_remove_mark_rule(k) do { } while !! 298 #define audit_remove_mark_rule(k) 319 #define audit_mark_compare(m, i, d) 0 299 #define audit_mark_compare(m, i, d) 0 320 #define audit_exe_compare(t, m) (-EINVAL) 300 #define audit_exe_compare(t, m) (-EINVAL) 321 #define audit_dupe_exe(n, o) (-EINVAL) 301 #define audit_dupe_exe(n, o) (-EINVAL) >> 302 #endif /* CONFIG_AUDIT_WATCH */ 322 303 >> 304 #ifdef CONFIG_AUDIT_TREE >> 305 extern struct audit_chunk *audit_tree_lookup(const struct inode *inode); >> 306 extern void audit_put_chunk(struct audit_chunk *chunk); >> 307 extern bool audit_tree_match(struct audit_chunk *chunk, struct audit_tree *tree); >> 308 extern int audit_make_tree(struct audit_krule *rule, char *pathname, u32 op); >> 309 extern int audit_add_tree_rule(struct audit_krule *rule); >> 310 extern int audit_remove_tree_rule(struct audit_krule *rule); >> 311 extern void audit_trim_trees(void); >> 312 extern int audit_tag_tree(char *old, char *new); >> 313 extern const char *audit_tree_path(struct audit_tree *tree); >> 314 extern void audit_put_tree(struct audit_tree *tree); >> 315 extern void audit_kill_trees(struct list_head *list); >> 316 #else 323 #define audit_remove_tree_rule(rule) BUG() 317 #define audit_remove_tree_rule(rule) BUG() 324 #define audit_add_tree_rule(rule) -EINVAL 318 #define audit_add_tree_rule(rule) -EINVAL 325 #define audit_make_tree(rule, str, op) -EINVAL 319 #define audit_make_tree(rule, str, op) -EINVAL 326 #define audit_trim_trees() do { } while (0) !! 320 #define audit_trim_trees() (void)0 327 #define audit_put_tree(tree) do { } while (0) !! 321 #define audit_put_tree(tree) (void)0 328 #define audit_tag_tree(old, new) -EINVAL 322 #define audit_tag_tree(old, new) -EINVAL 329 #define audit_tree_path(rule) "" /* nev 323 #define audit_tree_path(rule) "" /* never called */ 330 #define audit_kill_trees(context) BUG() !! 324 #define audit_kill_trees(list) BUG() 331 !! 325 #endif 332 static inline int audit_signal_info_syscall(st << 333 { << 334 return 0; << 335 } << 336 << 337 #define audit_filter_inodes(t, c) do { } while << 338 #endif /* CONFIG_AUDITSYSCALL */ << 339 326 340 extern char *audit_unpack_string(void **bufp, 327 extern char *audit_unpack_string(void **bufp, size_t *remain, size_t len); 341 328 >> 329 extern pid_t audit_sig_pid; >> 330 extern kuid_t audit_sig_uid; >> 331 extern u32 audit_sig_sid; >> 332 342 extern int audit_filter(int msgtype, unsigned 333 extern int audit_filter(int msgtype, unsigned int listtype); 343 334 >> 335 #ifdef CONFIG_AUDITSYSCALL >> 336 extern int audit_signal_info(int sig, struct task_struct *t); >> 337 extern void audit_filter_inodes(struct task_struct *tsk, struct audit_context *ctx); >> 338 extern struct list_head *audit_killed_trees(void); >> 339 #else >> 340 #define audit_signal_info(s,t) AUDIT_DISABLED >> 341 #define audit_filter_inodes(t,c) AUDIT_DISABLED >> 342 #endif >> 343 344 extern void audit_ctl_lock(void); 344 extern void audit_ctl_lock(void); 345 extern void audit_ctl_unlock(void); 345 extern void audit_ctl_unlock(void); 346 << 347 #endif << 348 346
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.