x86/speculation/mds: Fix documentation typo
[linux/fpc-iii.git] / security / lsm_audit.c
blob3a8916aa73c4842ac66a0865bb48e814c70af6cd
1 /*
2 * common LSM auditing functions
4 * Based on code written for SELinux by :
5 * Stephen Smalley, <sds@tycho.nsa.gov>
6 * James Morris <jmorris@redhat.com>
7 * Author : Etienne Basset, <etienne.basset@ensta.org>
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License version 2,
11 * as published by the Free Software Foundation.
14 #include <linux/types.h>
15 #include <linux/stddef.h>
16 #include <linux/kernel.h>
17 #include <linux/gfp.h>
18 #include <linux/fs.h>
19 #include <linux/init.h>
20 #include <net/sock.h>
21 #include <linux/un.h>
22 #include <net/af_unix.h>
23 #include <linux/audit.h>
24 #include <linux/ipv6.h>
25 #include <linux/ip.h>
26 #include <net/ip.h>
27 #include <net/ipv6.h>
28 #include <linux/tcp.h>
29 #include <linux/udp.h>
30 #include <linux/dccp.h>
31 #include <linux/sctp.h>
32 #include <linux/lsm_audit.h>
34 /**
35 * ipv4_skb_to_auditdata : fill auditdata from skb
36 * @skb : the skb
37 * @ad : the audit data to fill
38 * @proto : the layer 4 protocol
40 * return 0 on success
42 int ipv4_skb_to_auditdata(struct sk_buff *skb,
43 struct common_audit_data *ad, u8 *proto)
45 int ret = 0;
46 struct iphdr *ih;
48 ih = ip_hdr(skb);
49 if (ih == NULL)
50 return -EINVAL;
52 ad->u.net->v4info.saddr = ih->saddr;
53 ad->u.net->v4info.daddr = ih->daddr;
55 if (proto)
56 *proto = ih->protocol;
57 /* non initial fragment */
58 if (ntohs(ih->frag_off) & IP_OFFSET)
59 return 0;
61 switch (ih->protocol) {
62 case IPPROTO_TCP: {
63 struct tcphdr *th = tcp_hdr(skb);
64 if (th == NULL)
65 break;
67 ad->u.net->sport = th->source;
68 ad->u.net->dport = th->dest;
69 break;
71 case IPPROTO_UDP: {
72 struct udphdr *uh = udp_hdr(skb);
73 if (uh == NULL)
74 break;
76 ad->u.net->sport = uh->source;
77 ad->u.net->dport = uh->dest;
78 break;
80 case IPPROTO_DCCP: {
81 struct dccp_hdr *dh = dccp_hdr(skb);
82 if (dh == NULL)
83 break;
85 ad->u.net->sport = dh->dccph_sport;
86 ad->u.net->dport = dh->dccph_dport;
87 break;
89 case IPPROTO_SCTP: {
90 struct sctphdr *sh = sctp_hdr(skb);
91 if (sh == NULL)
92 break;
93 ad->u.net->sport = sh->source;
94 ad->u.net->dport = sh->dest;
95 break;
97 default:
98 ret = -EINVAL;
100 return ret;
102 #if IS_ENABLED(CONFIG_IPV6)
104 * ipv6_skb_to_auditdata : fill auditdata from skb
105 * @skb : the skb
106 * @ad : the audit data to fill
107 * @proto : the layer 4 protocol
109 * return 0 on success
111 int ipv6_skb_to_auditdata(struct sk_buff *skb,
112 struct common_audit_data *ad, u8 *proto)
114 int offset, ret = 0;
115 struct ipv6hdr *ip6;
116 u8 nexthdr;
117 __be16 frag_off;
119 ip6 = ipv6_hdr(skb);
120 if (ip6 == NULL)
121 return -EINVAL;
122 ad->u.net->v6info.saddr = ip6->saddr;
123 ad->u.net->v6info.daddr = ip6->daddr;
124 ret = 0;
125 /* IPv6 can have several extension header before the Transport header
126 * skip them */
127 offset = skb_network_offset(skb);
128 offset += sizeof(*ip6);
129 nexthdr = ip6->nexthdr;
130 offset = ipv6_skip_exthdr(skb, offset, &nexthdr, &frag_off);
131 if (offset < 0)
132 return 0;
133 if (proto)
134 *proto = nexthdr;
135 switch (nexthdr) {
136 case IPPROTO_TCP: {
137 struct tcphdr _tcph, *th;
139 th = skb_header_pointer(skb, offset, sizeof(_tcph), &_tcph);
140 if (th == NULL)
141 break;
143 ad->u.net->sport = th->source;
144 ad->u.net->dport = th->dest;
145 break;
147 case IPPROTO_UDP: {
148 struct udphdr _udph, *uh;
150 uh = skb_header_pointer(skb, offset, sizeof(_udph), &_udph);
151 if (uh == NULL)
152 break;
154 ad->u.net->sport = uh->source;
155 ad->u.net->dport = uh->dest;
156 break;
158 case IPPROTO_DCCP: {
159 struct dccp_hdr _dccph, *dh;
161 dh = skb_header_pointer(skb, offset, sizeof(_dccph), &_dccph);
162 if (dh == NULL)
163 break;
165 ad->u.net->sport = dh->dccph_sport;
166 ad->u.net->dport = dh->dccph_dport;
167 break;
169 case IPPROTO_SCTP: {
170 struct sctphdr _sctph, *sh;
172 sh = skb_header_pointer(skb, offset, sizeof(_sctph), &_sctph);
173 if (sh == NULL)
174 break;
175 ad->u.net->sport = sh->source;
176 ad->u.net->dport = sh->dest;
177 break;
179 default:
180 ret = -EINVAL;
182 return ret;
184 #endif
187 static inline void print_ipv6_addr(struct audit_buffer *ab,
188 struct in6_addr *addr, __be16 port,
189 char *name1, char *name2)
191 if (!ipv6_addr_any(addr))
192 audit_log_format(ab, " %s=%pI6c", name1, addr);
193 if (port)
194 audit_log_format(ab, " %s=%d", name2, ntohs(port));
197 static inline void print_ipv4_addr(struct audit_buffer *ab, __be32 addr,
198 __be16 port, char *name1, char *name2)
200 if (addr)
201 audit_log_format(ab, " %s=%pI4", name1, &addr);
202 if (port)
203 audit_log_format(ab, " %s=%d", name2, ntohs(port));
207 * dump_common_audit_data - helper to dump common audit data
208 * @a : common audit data
211 static void dump_common_audit_data(struct audit_buffer *ab,
212 struct common_audit_data *a)
214 char comm[sizeof(current->comm)];
217 * To keep stack sizes in check force programers to notice if they
218 * start making this union too large! See struct lsm_network_audit
219 * as an example of how to deal with large data.
221 BUILD_BUG_ON(sizeof(a->u) > sizeof(void *)*2);
223 audit_log_format(ab, " pid=%d comm=", task_tgid_nr(current));
224 audit_log_untrustedstring(ab, memcpy(comm, current->comm, sizeof(comm)));
226 switch (a->type) {
227 case LSM_AUDIT_DATA_NONE:
228 return;
229 case LSM_AUDIT_DATA_IPC:
230 audit_log_format(ab, " key=%d ", a->u.ipc_id);
231 break;
232 case LSM_AUDIT_DATA_CAP:
233 audit_log_format(ab, " capability=%d ", a->u.cap);
234 break;
235 case LSM_AUDIT_DATA_PATH: {
236 struct inode *inode;
238 audit_log_d_path(ab, " path=", &a->u.path);
240 inode = d_backing_inode(a->u.path.dentry);
241 if (inode) {
242 audit_log_format(ab, " dev=");
243 audit_log_untrustedstring(ab, inode->i_sb->s_id);
244 audit_log_format(ab, " ino=%lu", inode->i_ino);
246 break;
248 case LSM_AUDIT_DATA_FILE: {
249 struct inode *inode;
251 audit_log_d_path(ab, " path=", &a->u.file->f_path);
253 inode = file_inode(a->u.file);
254 if (inode) {
255 audit_log_format(ab, " dev=");
256 audit_log_untrustedstring(ab, inode->i_sb->s_id);
257 audit_log_format(ab, " ino=%lu", inode->i_ino);
259 break;
261 case LSM_AUDIT_DATA_IOCTL_OP: {
262 struct inode *inode;
264 audit_log_d_path(ab, " path=", &a->u.op->path);
266 inode = a->u.op->path.dentry->d_inode;
267 if (inode) {
268 audit_log_format(ab, " dev=");
269 audit_log_untrustedstring(ab, inode->i_sb->s_id);
270 audit_log_format(ab, " ino=%lu", inode->i_ino);
273 audit_log_format(ab, " ioctlcmd=0x%hx", a->u.op->cmd);
274 break;
276 case LSM_AUDIT_DATA_DENTRY: {
277 struct inode *inode;
279 audit_log_format(ab, " name=");
280 audit_log_untrustedstring(ab, a->u.dentry->d_name.name);
282 inode = d_backing_inode(a->u.dentry);
283 if (inode) {
284 audit_log_format(ab, " dev=");
285 audit_log_untrustedstring(ab, inode->i_sb->s_id);
286 audit_log_format(ab, " ino=%lu", inode->i_ino);
288 break;
290 case LSM_AUDIT_DATA_INODE: {
291 struct dentry *dentry;
292 struct inode *inode;
294 inode = a->u.inode;
295 dentry = d_find_alias(inode);
296 if (dentry) {
297 audit_log_format(ab, " name=");
298 audit_log_untrustedstring(ab,
299 dentry->d_name.name);
300 dput(dentry);
302 audit_log_format(ab, " dev=");
303 audit_log_untrustedstring(ab, inode->i_sb->s_id);
304 audit_log_format(ab, " ino=%lu", inode->i_ino);
305 break;
307 case LSM_AUDIT_DATA_TASK: {
308 struct task_struct *tsk = a->u.tsk;
309 if (tsk) {
310 pid_t pid = task_tgid_nr(tsk);
311 if (pid) {
312 char comm[sizeof(tsk->comm)];
313 audit_log_format(ab, " opid=%d ocomm=", pid);
314 audit_log_untrustedstring(ab,
315 memcpy(comm, tsk->comm, sizeof(comm)));
318 break;
320 case LSM_AUDIT_DATA_NET:
321 if (a->u.net->sk) {
322 struct sock *sk = a->u.net->sk;
323 struct unix_sock *u;
324 struct unix_address *addr;
325 int len = 0;
326 char *p = NULL;
328 switch (sk->sk_family) {
329 case AF_INET: {
330 struct inet_sock *inet = inet_sk(sk);
332 print_ipv4_addr(ab, inet->inet_rcv_saddr,
333 inet->inet_sport,
334 "laddr", "lport");
335 print_ipv4_addr(ab, inet->inet_daddr,
336 inet->inet_dport,
337 "faddr", "fport");
338 break;
340 #if IS_ENABLED(CONFIG_IPV6)
341 case AF_INET6: {
342 struct inet_sock *inet = inet_sk(sk);
344 print_ipv6_addr(ab, &sk->sk_v6_rcv_saddr,
345 inet->inet_sport,
346 "laddr", "lport");
347 print_ipv6_addr(ab, &sk->sk_v6_daddr,
348 inet->inet_dport,
349 "faddr", "fport");
350 break;
352 #endif
353 case AF_UNIX:
354 u = unix_sk(sk);
355 addr = smp_load_acquire(&u->addr);
356 if (!addr)
357 break;
358 if (u->path.dentry) {
359 audit_log_d_path(ab, " path=", &u->path);
360 break;
362 len = addr->len-sizeof(short);
363 p = &addr->name->sun_path[0];
364 audit_log_format(ab, " path=");
365 if (*p)
366 audit_log_untrustedstring(ab, p);
367 else
368 audit_log_n_hex(ab, p, len);
369 break;
373 switch (a->u.net->family) {
374 case AF_INET:
375 print_ipv4_addr(ab, a->u.net->v4info.saddr,
376 a->u.net->sport,
377 "saddr", "src");
378 print_ipv4_addr(ab, a->u.net->v4info.daddr,
379 a->u.net->dport,
380 "daddr", "dest");
381 break;
382 case AF_INET6:
383 print_ipv6_addr(ab, &a->u.net->v6info.saddr,
384 a->u.net->sport,
385 "saddr", "src");
386 print_ipv6_addr(ab, &a->u.net->v6info.daddr,
387 a->u.net->dport,
388 "daddr", "dest");
389 break;
391 if (a->u.net->netif > 0) {
392 struct net_device *dev;
394 /* NOTE: we always use init's namespace */
395 dev = dev_get_by_index(&init_net, a->u.net->netif);
396 if (dev) {
397 audit_log_format(ab, " netif=%s", dev->name);
398 dev_put(dev);
401 break;
402 #ifdef CONFIG_KEYS
403 case LSM_AUDIT_DATA_KEY:
404 audit_log_format(ab, " key_serial=%u", a->u.key_struct.key);
405 if (a->u.key_struct.key_desc) {
406 audit_log_format(ab, " key_desc=");
407 audit_log_untrustedstring(ab, a->u.key_struct.key_desc);
409 break;
410 #endif
411 case LSM_AUDIT_DATA_KMOD:
412 audit_log_format(ab, " kmod=");
413 audit_log_untrustedstring(ab, a->u.kmod_name);
414 break;
415 case LSM_AUDIT_DATA_IBPKEY: {
416 struct in6_addr sbn_pfx;
418 memset(&sbn_pfx.s6_addr, 0,
419 sizeof(sbn_pfx.s6_addr));
420 memcpy(&sbn_pfx.s6_addr, &a->u.ibpkey->subnet_prefix,
421 sizeof(a->u.ibpkey->subnet_prefix));
422 audit_log_format(ab, " pkey=0x%x subnet_prefix=%pI6c",
423 a->u.ibpkey->pkey, &sbn_pfx);
424 break;
426 case LSM_AUDIT_DATA_IBENDPORT:
427 audit_log_format(ab, " device=%s port_num=%u",
428 a->u.ibendport->dev_name,
429 a->u.ibendport->port);
430 break;
431 } /* switch (a->type) */
435 * common_lsm_audit - generic LSM auditing function
436 * @a: auxiliary audit data
437 * @pre_audit: lsm-specific pre-audit callback
438 * @post_audit: lsm-specific post-audit callback
440 * setup the audit buffer for common security information
441 * uses callback to print LSM specific information
443 void common_lsm_audit(struct common_audit_data *a,
444 void (*pre_audit)(struct audit_buffer *, void *),
445 void (*post_audit)(struct audit_buffer *, void *))
447 struct audit_buffer *ab;
449 if (a == NULL)
450 return;
451 /* we use GFP_ATOMIC so we won't sleep */
452 ab = audit_log_start(current->audit_context, GFP_ATOMIC | __GFP_NOWARN,
453 AUDIT_AVC);
455 if (ab == NULL)
456 return;
458 if (pre_audit)
459 pre_audit(ab, a);
461 dump_common_audit_data(ab, a);
463 if (post_audit)
464 post_audit(ab, a);
466 audit_log_end(ab);