security: update documentation for security_request_module
[linux-2.6-block.git] / include / linux / lsm_audit.h
CommitLineData
6e837fb1
EB
1/*
2 * Common LSM logging functions
3 * Heavily borrowed from selinux/avc.h
4 *
5 * Author : Etienne BASSET <etienne.basset@ensta.org>
6 *
7 * All credits to : Stephen Smalley, <sds@epoch.ncsc.mil>
8 * All BUGS to : Etienne BASSET <etienne.basset@ensta.org>
9 */
10#ifndef _LSM_COMMON_LOGGING_
11#define _LSM_COMMON_LOGGING_
12
13#include <linux/stddef.h>
14#include <linux/errno.h>
15#include <linux/kernel.h>
16#include <linux/kdev_t.h>
17#include <linux/spinlock.h>
18#include <linux/init.h>
19#include <linux/audit.h>
20#include <linux/in6.h>
21#include <linux/path.h>
22#include <linux/key.h>
23#include <linux/skbuff.h>
24#include <asm/system.h>
25
26
27/* Auxiliary data to use in generating the audit record. */
28struct common_audit_data {
29 char type;
30#define LSM_AUDIT_DATA_FS 1
31#define LSM_AUDIT_DATA_NET 2
32#define LSM_AUDIT_DATA_CAP 3
33#define LSM_AUDIT_DATA_IPC 4
34#define LSM_AUDIT_DATA_TASK 5
35#define LSM_AUDIT_DATA_KEY 6
36 struct task_struct *tsk;
37 union {
38 struct {
39 struct path path;
40 struct inode *inode;
41 } fs;
42 struct {
43 int netif;
44 struct sock *sk;
45 u16 family;
46 __be16 dport;
47 __be16 sport;
48 union {
49 struct {
50 __be32 daddr;
51 __be32 saddr;
52 } v4;
53 struct {
54 struct in6_addr daddr;
55 struct in6_addr saddr;
56 } v6;
57 } fam;
58 } net;
59 int cap;
60 int ipc_id;
61 struct task_struct *tsk;
62#ifdef CONFIG_KEYS
63 struct {
64 key_serial_t key;
65 char *key_desc;
66 } key_struct;
67#endif
68 } u;
6e837fb1
EB
69 /* this union contains LSM specific data */
70 union {
65c3f0a2 71#ifdef CONFIG_SECURITY_SMACK
6e837fb1
EB
72 /* SMACK data */
73 struct smack_audit_data {
ed5215a2 74 const char *function;
6e837fb1
EB
75 char *subject;
76 char *object;
77 char *request;
78 int result;
79 } smack_audit_data;
65c3f0a2
TL
80#endif
81#ifdef CONFIG_SECURITY_SELINUX
6e837fb1
EB
82 /* SELinux data */
83 struct {
84 u32 ssid;
85 u32 tsid;
86 u16 tclass;
87 u32 requested;
88 u32 audited;
89 struct av_decision *avd;
90 int result;
91 } selinux_audit_data;
65c3f0a2 92#endif
d4131ded 93 };
6e837fb1
EB
94 /* these callback will be implemented by a specific LSM */
95 void (*lsm_pre_audit)(struct audit_buffer *, void *);
96 void (*lsm_post_audit)(struct audit_buffer *, void *);
97};
98
99#define v4info fam.v4
100#define v6info fam.v6
101
102int ipv4_skb_to_auditdata(struct sk_buff *skb,
103 struct common_audit_data *ad, u8 *proto);
104
105int ipv6_skb_to_auditdata(struct sk_buff *skb,
106 struct common_audit_data *ad, u8 *proto);
107
108/* Initialize an LSM audit data structure. */
109#define COMMON_AUDIT_DATA_INIT(_d, _t) \
110 { memset((_d), 0, sizeof(struct common_audit_data)); \
ed5215a2 111 (_d)->type = LSM_AUDIT_DATA_##_t; }
6e837fb1
EB
112
113void common_lsm_audit(struct common_audit_data *a);
114
115#endif