lsm_audit.h

  1/* SPDX-License-Identifier: GPL-2.0 */
  2/*
  3 * Common LSM logging functions
  4 * Heavily borrowed from selinux/avc.h
  5 *
  6 * Author : Etienne BASSET  <etienne.basset@ensta.org>
  7 *
  8 * All credits to : Stephen Smalley
  9 * All BUGS to : Etienne BASSET  <etienne.basset@ensta.org>
 10 */
 11#ifndef _LSM_COMMON_LOGGING_
 12#define _LSM_COMMON_LOGGING_
 13
 14#include <linux/stddef.h>
 15#include <linux/errno.h>
 16#include <linux/kernel.h>
 17#include <linux/kdev_t.h>
 18#include <linux/spinlock.h>
 19#include <linux/init.h>
 20#include <linux/audit.h>
 21#include <linux/in6.h>
 22#include <linux/path.h>
 23#include <linux/key.h>
 24#include <linux/skbuff.h>
 25#include <rdma/ib_verbs.h>
 26
 27struct lsm_network_audit {
 28	int netif;
 29	const struct sock *sk;
 30	u16 family;
 31	__be16 dport;
 32	__be16 sport;
 33	union {
 34		struct {
 35			__be32 daddr;
 36			__be32 saddr;
 37		} v4;
 38		struct {
 39			struct in6_addr daddr;
 40			struct in6_addr saddr;
 41		} v6;
 42	} fam;
 43};
 44
 45struct lsm_ioctlop_audit {
 46	struct path path;
 47	u16 cmd;
 48};
 49
 50struct lsm_ibpkey_audit {
 51	u64 subnet_prefix;
 52	u16 pkey;
 53};
 54
 55struct lsm_ibendport_audit {
 56	const char *dev_name;
 57	u8 port;
 58};
 59
 60/* Auxiliary data to use in generating the audit record. */
 61struct common_audit_data {
 62	char type;
 63#define LSM_AUDIT_DATA_PATH	1
 64#define LSM_AUDIT_DATA_NET	2
 65#define LSM_AUDIT_DATA_CAP	3
 66#define LSM_AUDIT_DATA_IPC	4
 67#define LSM_AUDIT_DATA_TASK	5
 68#define LSM_AUDIT_DATA_KEY	6
 69#define LSM_AUDIT_DATA_NONE	7
 70#define LSM_AUDIT_DATA_KMOD	8
 71#define LSM_AUDIT_DATA_INODE	9
 72#define LSM_AUDIT_DATA_DENTRY	10
 73#define LSM_AUDIT_DATA_IOCTL_OP	11
 74#define LSM_AUDIT_DATA_FILE	12
 75#define LSM_AUDIT_DATA_IBPKEY	13
 76#define LSM_AUDIT_DATA_IBENDPORT 14
 77#define LSM_AUDIT_DATA_LOCKDOWN 15
 78#define LSM_AUDIT_DATA_NOTIFICATION 16
 79#define LSM_AUDIT_DATA_ANONINODE	17
 80#define LSM_AUDIT_DATA_NLMSGTYPE	18
 81	union 	{
 82		struct path path;
 83		struct dentry *dentry;
 84		struct inode *inode;
 85		struct lsm_network_audit *net;
 86		int cap;
 87		int ipc_id;
 88		struct task_struct *tsk;
 89#ifdef CONFIG_KEYS
 90		struct {
 91			key_serial_t key;
 92			char *key_desc;
 93		} key_struct;
 94#endif
 95		char *kmod_name;
 96		struct lsm_ioctlop_audit *op;
 97		struct file *file;
 98		struct lsm_ibpkey_audit *ibpkey;
 99		struct lsm_ibendport_audit *ibendport;
100		int reason;
101		const char *anonclass;
102		u16 nlmsg_type;
103	} u;
104	/* this union contains LSM specific data */
105	union {
106#ifdef CONFIG_SECURITY_SMACK
107		struct smack_audit_data *smack_audit_data;
108#endif
109#ifdef CONFIG_SECURITY_SELINUX
110		struct selinux_audit_data *selinux_audit_data;
111#endif
112#ifdef CONFIG_SECURITY_APPARMOR
113		struct apparmor_audit_data *apparmor_audit_data;
114#endif
115	}; /* per LSM data pointer union */
116};
117
118#define v4info fam.v4
119#define v6info fam.v6
120
121#ifdef CONFIG_AUDIT
122
123int ipv4_skb_to_auditdata(struct sk_buff *skb,
124		struct common_audit_data *ad, u8 *proto);
125
126#if IS_ENABLED(CONFIG_IPV6)
127int ipv6_skb_to_auditdata(struct sk_buff *skb,
128		struct common_audit_data *ad, u8 *proto);
129#endif /* IS_ENABLED(CONFIG_IPV6) */
130
131void common_lsm_audit(struct common_audit_data *a,
132	void (*pre_audit)(struct audit_buffer *, void *),
133	void (*post_audit)(struct audit_buffer *, void *));
134
135void audit_log_lsm_data(struct audit_buffer *ab,
136			const struct common_audit_data *a);
137
138#else /* CONFIG_AUDIT */
139
140static inline void common_lsm_audit(struct common_audit_data *a,
141	void (*pre_audit)(struct audit_buffer *, void *),
142	void (*post_audit)(struct audit_buffer *, void *))
143{
144}
145
146static inline void audit_log_lsm_data(struct audit_buffer *ab,
147			const struct common_audit_data *a)
148{
149}
150
151#endif /* CONFIG_AUDIT */
152
153#endif