audit.h 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345
  1. /* audit -- definition of audit_context structure and supporting types
  2. *
  3. * Copyright 2003-2004 Red Hat, Inc.
  4. * Copyright 2005 Hewlett-Packard Development Company, L.P.
  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
  20. */
  21. #include <linux/fs.h>
  22. #include <linux/audit.h>
  23. #include <linux/skbuff.h>
  24. #include <uapi/linux/mqueue.h>
  25. #include <linux/tty.h>
  26. /* AUDIT_NAMES is the number of slots we reserve in the audit_context
  27. * for saving names from getname(). If we get more names we will allocate
  28. * a name dynamically and also add those to the list anchored by names_list. */
  29. #define AUDIT_NAMES 5
  30. /* At task start time, the audit_state is set in the audit_context using
  31. a per-task filter. At syscall entry, the audit_state is augmented by
  32. the syscall filter. */
  33. enum audit_state {
  34. AUDIT_DISABLED, /* Do not create per-task audit_context.
  35. * No syscall-specific audit records can
  36. * be generated. */
  37. AUDIT_BUILD_CONTEXT, /* Create the per-task audit_context,
  38. * and fill it in at syscall
  39. * entry time. This makes a full
  40. * syscall record available if some
  41. * other part of the kernel decides it
  42. * should be recorded. */
  43. AUDIT_RECORD_CONTEXT /* Create the per-task audit_context,
  44. * always fill it in at syscall entry
  45. * time, and always write out the audit
  46. * record at syscall exit time. */
  47. };
  48. /* Rule lists */
  49. struct audit_watch;
  50. struct audit_fsnotify_mark;
  51. struct audit_tree;
  52. struct audit_chunk;
  53. struct audit_entry {
  54. struct list_head list;
  55. struct rcu_head rcu;
  56. struct audit_krule rule;
  57. };
  58. struct audit_cap_data {
  59. kernel_cap_t permitted;
  60. kernel_cap_t inheritable;
  61. union {
  62. unsigned int fE; /* effective bit of file cap */
  63. kernel_cap_t effective; /* effective set of process */
  64. };
  65. kernel_cap_t ambient;
  66. };
  67. /* When fs/namei.c:getname() is called, we store the pointer in name and bump
  68. * the refcnt in the associated filename struct.
  69. *
  70. * Further, in fs/namei.c:path_lookup() we store the inode and device.
  71. */
  72. struct audit_names {
  73. struct list_head list; /* audit_context->names_list */
  74. struct filename *name;
  75. int name_len; /* number of chars to log */
  76. bool hidden; /* don't log this record */
  77. unsigned long ino;
  78. dev_t dev;
  79. umode_t mode;
  80. kuid_t uid;
  81. kgid_t gid;
  82. dev_t rdev;
  83. u32 osid;
  84. struct audit_cap_data fcap;
  85. unsigned int fcap_ver;
  86. unsigned char type; /* record type */
  87. /*
  88. * This was an allocated audit_names and not from the array of
  89. * names allocated in the task audit context. Thus this name
  90. * should be freed on syscall exit.
  91. */
  92. bool should_free;
  93. };
  94. struct audit_proctitle {
  95. int len; /* length of the cmdline field. */
  96. char *value; /* the cmdline field */
  97. };
  98. /* The per-task audit context. */
  99. struct audit_context {
  100. int dummy; /* must be the first element */
  101. int in_syscall; /* 1 if task is in a syscall */
  102. enum audit_state state, current_state;
  103. unsigned int serial; /* serial number for record */
  104. int major; /* syscall number */
  105. struct timespec64 ctime; /* time of syscall entry */
  106. unsigned long argv[4]; /* syscall arguments */
  107. long return_code;/* syscall return code */
  108. u64 prio;
  109. int return_valid; /* return code is valid */
  110. /*
  111. * The names_list is the list of all audit_names collected during this
  112. * syscall. The first AUDIT_NAMES entries in the names_list will
  113. * actually be from the preallocated_names array for performance
  114. * reasons. Except during allocation they should never be referenced
  115. * through the preallocated_names array and should only be found/used
  116. * by running the names_list.
  117. */
  118. struct audit_names preallocated_names[AUDIT_NAMES];
  119. int name_count; /* total records in names_list */
  120. struct list_head names_list; /* struct audit_names->list anchor */
  121. char *filterkey; /* key for rule that triggered record */
  122. struct path pwd;
  123. struct audit_aux_data *aux;
  124. struct audit_aux_data *aux_pids;
  125. struct sockaddr_storage *sockaddr;
  126. size_t sockaddr_len;
  127. /* Save things to print about task_struct */
  128. pid_t pid, ppid;
  129. kuid_t uid, euid, suid, fsuid;
  130. kgid_t gid, egid, sgid, fsgid;
  131. unsigned long personality;
  132. int arch;
  133. pid_t target_pid;
  134. kuid_t target_auid;
  135. kuid_t target_uid;
  136. unsigned int target_sessionid;
  137. u32 target_sid;
  138. char target_comm[TASK_COMM_LEN];
  139. struct audit_tree_refs *trees, *first_trees;
  140. struct list_head killed_trees;
  141. int tree_count;
  142. int type;
  143. union {
  144. struct {
  145. int nargs;
  146. long args[6];
  147. } socketcall;
  148. struct {
  149. kuid_t uid;
  150. kgid_t gid;
  151. umode_t mode;
  152. u32 osid;
  153. int has_perm;
  154. uid_t perm_uid;
  155. gid_t perm_gid;
  156. umode_t perm_mode;
  157. unsigned long qbytes;
  158. } ipc;
  159. struct {
  160. mqd_t mqdes;
  161. struct mq_attr mqstat;
  162. } mq_getsetattr;
  163. struct {
  164. mqd_t mqdes;
  165. int sigev_signo;
  166. } mq_notify;
  167. struct {
  168. mqd_t mqdes;
  169. size_t msg_len;
  170. unsigned int msg_prio;
  171. struct timespec64 abs_timeout;
  172. } mq_sendrecv;
  173. struct {
  174. int oflag;
  175. umode_t mode;
  176. struct mq_attr attr;
  177. } mq_open;
  178. struct {
  179. pid_t pid;
  180. struct audit_cap_data cap;
  181. } capset;
  182. struct {
  183. int fd;
  184. int flags;
  185. } mmap;
  186. struct {
  187. int argc;
  188. } execve;
  189. struct {
  190. char *name;
  191. } module;
  192. };
  193. int fds[2];
  194. struct audit_proctitle proctitle;
  195. };
  196. extern u32 audit_ever_enabled;
  197. extern void audit_copy_inode(struct audit_names *name,
  198. const struct dentry *dentry,
  199. struct inode *inode);
  200. extern void audit_log_cap(struct audit_buffer *ab, char *prefix,
  201. kernel_cap_t *cap);
  202. extern void audit_log_name(struct audit_context *context,
  203. struct audit_names *n, const struct path *path,
  204. int record_num, int *call_panic);
  205. extern int auditd_test_task(struct task_struct *task);
  206. #define AUDIT_INODE_BUCKETS 32
  207. extern struct list_head audit_inode_hash[AUDIT_INODE_BUCKETS];
  208. static inline int audit_hash_ino(u32 ino)
  209. {
  210. return (ino & (AUDIT_INODE_BUCKETS-1));
  211. }
  212. /* Indicates that audit should log the full pathname. */
  213. #define AUDIT_NAME_FULL -1
  214. extern int audit_match_class(int class, unsigned syscall);
  215. extern int audit_comparator(const u32 left, const u32 op, const u32 right);
  216. extern int audit_uid_comparator(kuid_t left, u32 op, kuid_t right);
  217. extern int audit_gid_comparator(kgid_t left, u32 op, kgid_t right);
  218. extern int parent_len(const char *path);
  219. extern int audit_compare_dname_path(const char *dname, const char *path, int plen);
  220. extern struct sk_buff *audit_make_reply(int seq, int type, int done, int multi,
  221. const void *payload, int size);
  222. extern void audit_panic(const char *message);
  223. struct audit_netlink_list {
  224. __u32 portid;
  225. struct net *net;
  226. struct sk_buff_head q;
  227. };
  228. int audit_send_list_thread(void *_dest);
  229. extern int selinux_audit_rule_update(void);
  230. extern struct mutex audit_filter_mutex;
  231. extern int audit_del_rule(struct audit_entry *entry);
  232. extern void audit_free_rule_rcu(struct rcu_head *head);
  233. extern struct list_head audit_filter_list[];
  234. extern struct audit_entry *audit_dupe_rule(struct audit_krule *old);
  235. extern void audit_log_d_path_exe(struct audit_buffer *ab,
  236. struct mm_struct *mm);
  237. extern struct tty_struct *audit_get_tty(struct task_struct *tsk);
  238. extern void audit_put_tty(struct tty_struct *tty);
  239. /* audit watch functions */
  240. #ifdef CONFIG_AUDIT_WATCH
  241. extern void audit_put_watch(struct audit_watch *watch);
  242. extern void audit_get_watch(struct audit_watch *watch);
  243. extern int audit_to_watch(struct audit_krule *krule, char *path, int len, u32 op);
  244. extern int audit_add_watch(struct audit_krule *krule, struct list_head **list);
  245. extern void audit_remove_watch_rule(struct audit_krule *krule);
  246. extern char *audit_watch_path(struct audit_watch *watch);
  247. extern int audit_watch_compare(struct audit_watch *watch, unsigned long ino, dev_t dev);
  248. extern struct audit_fsnotify_mark *audit_alloc_mark(struct audit_krule *krule, char *pathname, int len);
  249. extern char *audit_mark_path(struct audit_fsnotify_mark *mark);
  250. extern void audit_remove_mark(struct audit_fsnotify_mark *audit_mark);
  251. extern void audit_remove_mark_rule(struct audit_krule *krule);
  252. extern int audit_mark_compare(struct audit_fsnotify_mark *mark, unsigned long ino, dev_t dev);
  253. extern int audit_dupe_exe(struct audit_krule *new, struct audit_krule *old);
  254. extern int audit_exe_compare(struct task_struct *tsk, struct audit_fsnotify_mark *mark);
  255. #else
  256. #define audit_put_watch(w) {}
  257. #define audit_get_watch(w) {}
  258. #define audit_to_watch(k, p, l, o) (-EINVAL)
  259. #define audit_add_watch(k, l) (-EINVAL)
  260. #define audit_remove_watch_rule(k) BUG()
  261. #define audit_watch_path(w) ""
  262. #define audit_watch_compare(w, i, d) 0
  263. #define audit_alloc_mark(k, p, l) (ERR_PTR(-EINVAL))
  264. #define audit_mark_path(m) ""
  265. #define audit_remove_mark(m)
  266. #define audit_remove_mark_rule(k)
  267. #define audit_mark_compare(m, i, d) 0
  268. #define audit_exe_compare(t, m) (-EINVAL)
  269. #define audit_dupe_exe(n, o) (-EINVAL)
  270. #endif /* CONFIG_AUDIT_WATCH */
  271. #ifdef CONFIG_AUDIT_TREE
  272. extern struct audit_chunk *audit_tree_lookup(const struct inode *inode);
  273. extern void audit_put_chunk(struct audit_chunk *chunk);
  274. extern bool audit_tree_match(struct audit_chunk *chunk, struct audit_tree *tree);
  275. extern int audit_make_tree(struct audit_krule *rule, char *pathname, u32 op);
  276. extern int audit_add_tree_rule(struct audit_krule *rule);
  277. extern int audit_remove_tree_rule(struct audit_krule *rule);
  278. extern void audit_trim_trees(void);
  279. extern int audit_tag_tree(char *old, char *new);
  280. extern const char *audit_tree_path(struct audit_tree *tree);
  281. extern void audit_put_tree(struct audit_tree *tree);
  282. extern void audit_kill_trees(struct list_head *list);
  283. #else
  284. #define audit_remove_tree_rule(rule) BUG()
  285. #define audit_add_tree_rule(rule) -EINVAL
  286. #define audit_make_tree(rule, str, op) -EINVAL
  287. #define audit_trim_trees() (void)0
  288. #define audit_put_tree(tree) (void)0
  289. #define audit_tag_tree(old, new) -EINVAL
  290. #define audit_tree_path(rule) "" /* never called */
  291. #define audit_kill_trees(list) BUG()
  292. #endif
  293. extern char *audit_unpack_string(void **bufp, size_t *remain, size_t len);
  294. extern pid_t audit_sig_pid;
  295. extern kuid_t audit_sig_uid;
  296. extern u32 audit_sig_sid;
  297. extern int audit_filter(int msgtype, unsigned int listtype);
  298. #ifdef CONFIG_AUDITSYSCALL
  299. extern int audit_signal_info(int sig, struct task_struct *t);
  300. extern void audit_filter_inodes(struct task_struct *tsk, struct audit_context *ctx);
  301. extern struct list_head *audit_killed_trees(void);
  302. #else
  303. #define audit_signal_info(s,t) AUDIT_DISABLED
  304. #define audit_filter_inodes(t,c) AUDIT_DISABLED
  305. #endif
  306. extern struct mutex audit_cmd_mutex;