1 /* audit.c -- Auditing support
2 * Gateway between the kernel (e.g., selinux) and the user-space audit daemon.
3 * System-call specific features have moved to auditsc.c
5 * Copyright 2003-2007 Red Hat Inc., Durham, North Carolina.
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
22 * Written by Rickard E. (Rik) Faith <faith@redhat.com>
24 * Goals: 1) Integrate fully with Security Modules.
25 * 2) Minimal run-time overhead:
26 * a) Minimal when syscall auditing is disabled (audit_enable=0).
27 * b) Small when syscall auditing is enabled and no audit record
28 * is generated (defer as much work as possible to record
30 * i) context is allocated,
31 * ii) names from getname are stored without a copy, and
32 * iii) inode information stored from path_lookup.
33 * 3) Ability to disable syscall auditing at boot time (audit=0).
34 * 4) Usable by other parts of the kernel (if audit_log* is called,
35 * then a syscall record will be generated automatically for the
37 * 5) Netlink interface to user-space.
38 * 6) Support low-overhead kernel-based filtering to minimize the
39 * information that must be passed to user-space.
41 * Example user-space utilities: http://people.redhat.com/sgrubb/audit/
44 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
46 #include <linux/file.h>
47 #include <linux/init.h>
48 #include <linux/types.h>
49 #include <linux/atomic.h>
51 #include <linux/export.h>
52 #include <linux/slab.h>
53 #include <linux/err.h>
54 #include <linux/kthread.h>
55 #include <linux/kernel.h>
56 #include <linux/syscalls.h>
58 #include <linux/audit.h>
61 #include <net/netlink.h>
62 #include <linux/skbuff.h>
63 #ifdef CONFIG_SECURITY
64 #include <linux/security.h>
66 #include <linux/freezer.h>
67 #include <linux/pid_namespace.h>
68 #include <net/netns/generic.h>
72 /* No auditing will take place until audit_initialized == AUDIT_INITIALIZED.
73 * (Initialization happens after skb_init is called.) */
74 #define AUDIT_DISABLED -1
75 #define AUDIT_UNINITIALIZED 0
76 #define AUDIT_INITIALIZED 1
77 static int audit_initialized
;
81 #define AUDIT_LOCKED 2
83 u32 audit_ever_enabled
;
85 EXPORT_SYMBOL_GPL(audit_enabled
);
87 /* Default state when kernel boots without any parameters. */
88 static u32 audit_default
;
90 /* If auditing cannot proceed, audit_failure selects what happens. */
91 static u32 audit_failure
= AUDIT_FAIL_PRINTK
;
94 * If audit records are to be written to the netlink socket, audit_pid
95 * contains the pid of the auditd process and audit_nlk_portid contains
96 * the portid to use to send netlink messages to that process.
99 static __u32 audit_nlk_portid
;
101 /* If audit_rate_limit is non-zero, limit the rate of sending audit records
102 * to that number per second. This prevents DoS attacks, but results in
103 * audit records being dropped. */
104 static u32 audit_rate_limit
;
106 /* Number of outstanding audit_buffers allowed.
107 * When set to zero, this means unlimited. */
108 static u32 audit_backlog_limit
= 64;
109 #define AUDIT_BACKLOG_WAIT_TIME (60 * HZ)
110 static u32 audit_backlog_wait_time
= AUDIT_BACKLOG_WAIT_TIME
;
112 /* The identity of the user shutting down the audit system. */
113 kuid_t audit_sig_uid
= INVALID_UID
;
114 pid_t audit_sig_pid
= -1;
115 u32 audit_sig_sid
= 0;
117 /* Records can be lost in several ways:
118 0) [suppressed in audit_alloc]
119 1) out of memory in audit_log_start [kmalloc of struct audit_buffer]
120 2) out of memory in audit_log_move [alloc_skb]
121 3) suppressed due to audit_rate_limit
122 4) suppressed due to audit_backlog_limit
124 static atomic_t audit_lost
= ATOMIC_INIT(0);
126 /* The netlink socket. */
127 static struct sock
*audit_sock
;
128 static unsigned int audit_net_id
;
130 /* Hash for inode-based rules */
131 struct list_head audit_inode_hash
[AUDIT_INODE_BUCKETS
];
133 /* The audit_freelist is a list of pre-allocated audit buffers (if more
134 * than AUDIT_MAXFREE are in use, the audit buffer is freed instead of
135 * being placed on the freelist). */
136 static DEFINE_SPINLOCK(audit_freelist_lock
);
137 static int audit_freelist_count
;
138 static LIST_HEAD(audit_freelist
);
140 /* queue msgs to send via kauditd_task */
141 static struct sk_buff_head audit_queue
;
142 /* queue msgs due to temporary unicast send problems */
143 static struct sk_buff_head audit_retry_queue
;
144 /* queue msgs waiting for new auditd connection */
145 static struct sk_buff_head audit_hold_queue
;
147 /* queue servicing thread */
148 static struct task_struct
*kauditd_task
;
149 static DECLARE_WAIT_QUEUE_HEAD(kauditd_wait
);
151 /* waitqueue for callers who are blocked on the audit backlog */
152 static DECLARE_WAIT_QUEUE_HEAD(audit_backlog_wait
);
154 static struct audit_features af
= {.vers
= AUDIT_FEATURE_VERSION
,
159 static char *audit_feature_names
[2] = {
160 "only_unset_loginuid",
161 "loginuid_immutable",
165 /* Serialize requests from userspace. */
166 DEFINE_MUTEX(audit_cmd_mutex
);
168 /* AUDIT_BUFSIZ is the size of the temporary buffer used for formatting
169 * audit records. Since printk uses a 1024 byte buffer, this buffer
170 * should be at least that large. */
171 #define AUDIT_BUFSIZ 1024
173 /* AUDIT_MAXFREE is the number of empty audit_buffers we keep on the
174 * audit_freelist. Doing so eliminates many kmalloc/kfree calls. */
175 #define AUDIT_MAXFREE (2*NR_CPUS)
177 /* The audit_buffer is used when formatting an audit record. The caller
178 * locks briefly to get the record off the freelist or to allocate the
179 * buffer, and locks briefly to send the buffer to the netlink layer or
180 * to place it on a transmit queue. Multiple audit_buffers can be in
181 * use simultaneously. */
182 struct audit_buffer
{
183 struct list_head list
;
184 struct sk_buff
*skb
; /* formatted skb ready to send */
185 struct audit_context
*ctx
; /* NULL or associated context */
195 static void audit_set_portid(struct audit_buffer
*ab
, __u32 portid
)
198 struct nlmsghdr
*nlh
= nlmsg_hdr(ab
->skb
);
199 nlh
->nlmsg_pid
= portid
;
203 void audit_panic(const char *message
)
205 switch (audit_failure
) {
206 case AUDIT_FAIL_SILENT
:
208 case AUDIT_FAIL_PRINTK
:
209 if (printk_ratelimit())
210 pr_err("%s\n", message
);
212 case AUDIT_FAIL_PANIC
:
213 /* test audit_pid since printk is always losey, why bother? */
215 panic("audit: %s\n", message
);
220 static inline int audit_rate_check(void)
222 static unsigned long last_check
= 0;
223 static int messages
= 0;
224 static DEFINE_SPINLOCK(lock
);
227 unsigned long elapsed
;
230 if (!audit_rate_limit
) return 1;
232 spin_lock_irqsave(&lock
, flags
);
233 if (++messages
< audit_rate_limit
) {
237 elapsed
= now
- last_check
;
244 spin_unlock_irqrestore(&lock
, flags
);
250 * audit_log_lost - conditionally log lost audit message event
251 * @message: the message stating reason for lost audit message
253 * Emit at least 1 message per second, even if audit_rate_check is
255 * Always increment the lost messages counter.
257 void audit_log_lost(const char *message
)
259 static unsigned long last_msg
= 0;
260 static DEFINE_SPINLOCK(lock
);
265 atomic_inc(&audit_lost
);
267 print
= (audit_failure
== AUDIT_FAIL_PANIC
|| !audit_rate_limit
);
270 spin_lock_irqsave(&lock
, flags
);
272 if (now
- last_msg
> HZ
) {
276 spin_unlock_irqrestore(&lock
, flags
);
280 if (printk_ratelimit())
281 pr_warn("audit_lost=%u audit_rate_limit=%u audit_backlog_limit=%u\n",
282 atomic_read(&audit_lost
),
284 audit_backlog_limit
);
285 audit_panic(message
);
289 static int audit_log_config_change(char *function_name
, u32
new, u32 old
,
292 struct audit_buffer
*ab
;
295 ab
= audit_log_start(NULL
, GFP_KERNEL
, AUDIT_CONFIG_CHANGE
);
298 audit_log_format(ab
, "%s=%u old=%u", function_name
, new, old
);
299 audit_log_session_info(ab
);
300 rc
= audit_log_task_context(ab
);
302 allow_changes
= 0; /* Something weird, deny request */
303 audit_log_format(ab
, " res=%d", allow_changes
);
308 static int audit_do_config_change(char *function_name
, u32
*to_change
, u32
new)
310 int allow_changes
, rc
= 0;
311 u32 old
= *to_change
;
313 /* check if we are locked */
314 if (audit_enabled
== AUDIT_LOCKED
)
319 if (audit_enabled
!= AUDIT_OFF
) {
320 rc
= audit_log_config_change(function_name
, new, old
, allow_changes
);
325 /* If we are allowed, make the change */
326 if (allow_changes
== 1)
328 /* Not allowed, update reason */
334 static int audit_set_rate_limit(u32 limit
)
336 return audit_do_config_change("audit_rate_limit", &audit_rate_limit
, limit
);
339 static int audit_set_backlog_limit(u32 limit
)
341 return audit_do_config_change("audit_backlog_limit", &audit_backlog_limit
, limit
);
344 static int audit_set_backlog_wait_time(u32 timeout
)
346 return audit_do_config_change("audit_backlog_wait_time",
347 &audit_backlog_wait_time
, timeout
);
350 static int audit_set_enabled(u32 state
)
353 if (state
> AUDIT_LOCKED
)
356 rc
= audit_do_config_change("audit_enabled", &audit_enabled
, state
);
358 audit_ever_enabled
|= !!state
;
363 static int audit_set_failure(u32 state
)
365 if (state
!= AUDIT_FAIL_SILENT
366 && state
!= AUDIT_FAIL_PRINTK
367 && state
!= AUDIT_FAIL_PANIC
)
370 return audit_do_config_change("audit_failure", &audit_failure
, state
);
374 * For one reason or another this nlh isn't getting delivered to the userspace
375 * audit daemon, just send it to printk.
377 static void kauditd_printk_skb(struct sk_buff
*skb
)
379 struct nlmsghdr
*nlh
= nlmsg_hdr(skb
);
380 char *data
= nlmsg_data(nlh
);
382 if (nlh
->nlmsg_type
!= AUDIT_EOE
) {
383 if (printk_ratelimit())
384 pr_notice("type=%d %s\n", nlh
->nlmsg_type
, data
);
386 audit_log_lost("printk limit exceeded");
391 * kauditd_hold_skb - Queue an audit record, waiting for auditd
395 * Queue the audit record, waiting for an instance of auditd. When this
396 * function is called we haven't given up yet on sending the record, but things
397 * are not looking good. The first thing we want to do is try to write the
398 * record via printk and then see if we want to try and hold on to the record
399 * and queue it, if we have room. If we want to hold on to the record, but we
400 * don't have room, record a record lost message.
402 static void kauditd_hold_skb(struct sk_buff
*skb
)
404 /* at this point it is uncertain if we will ever send this to auditd so
405 * try to send the message via printk before we go any further */
406 kauditd_printk_skb(skb
);
408 /* can we just silently drop the message? */
409 if (!audit_default
) {
414 /* if we have room, queue the message */
415 if (!audit_backlog_limit
||
416 skb_queue_len(&audit_hold_queue
) < audit_backlog_limit
) {
417 skb_queue_tail(&audit_hold_queue
, skb
);
421 /* we have no other options - drop the message */
422 audit_log_lost("kauditd hold queue overflow");
427 * kauditd_retry_skb - Queue an audit record, attempt to send again to auditd
431 * Not as serious as kauditd_hold_skb() as we still have a connected auditd,
432 * but for some reason we are having problems sending it audit records so
433 * queue the given record and attempt to resend.
435 static void kauditd_retry_skb(struct sk_buff
*skb
)
437 /* NOTE: because records should only live in the retry queue for a
438 * short period of time, before either being sent or moved to the hold
439 * queue, we don't currently enforce a limit on this queue */
440 skb_queue_tail(&audit_retry_queue
, skb
);
444 * auditd_reset - Disconnect the auditd connection
447 * Break the auditd/kauditd connection and move all the records in the retry
448 * queue into the hold queue in case auditd reconnects. The audit_cmd_mutex
449 * must be held when calling this function.
451 static void auditd_reset(void)
455 /* break the connection */
457 sock_put(audit_sock
);
461 audit_nlk_portid
= 0;
463 /* flush all of the retry queue to the hold queue */
464 while ((skb
= skb_dequeue(&audit_retry_queue
)))
465 kauditd_hold_skb(skb
);
469 * kauditd_send_unicast_skb - Send a record via unicast to auditd
472 static int kauditd_send_unicast_skb(struct sk_buff
*skb
)
476 /* if we know nothing is connected, don't even try the netlink call */
478 return -ECONNREFUSED
;
480 /* get an extra skb reference in case we fail to send */
482 rc
= netlink_unicast(audit_sock
, skb
, audit_nlk_portid
, 0);
492 * kauditd_send_multicast_skb - Send a record to any multicast listeners
496 * This function doesn't consume an skb as might be expected since it has to
499 static void kauditd_send_multicast_skb(struct sk_buff
*skb
)
501 struct sk_buff
*copy
;
502 struct audit_net
*aunet
= net_generic(&init_net
, audit_net_id
);
503 struct sock
*sock
= aunet
->nlsk
;
504 struct nlmsghdr
*nlh
;
506 if (!netlink_has_listeners(sock
, AUDIT_NLGRP_READLOG
))
510 * The seemingly wasteful skb_copy() rather than bumping the refcount
511 * using skb_get() is necessary because non-standard mods are made to
512 * the skb by the original kaudit unicast socket send routine. The
513 * existing auditd daemon assumes this breakage. Fixing this would
514 * require co-ordinating a change in the established protocol between
515 * the kaudit kernel subsystem and the auditd userspace code. There is
516 * no reason for new multicast clients to continue with this
519 copy
= skb_copy(skb
, GFP_KERNEL
);
522 nlh
= nlmsg_hdr(copy
);
523 nlh
->nlmsg_len
= skb
->len
;
525 nlmsg_multicast(sock
, copy
, 0, AUDIT_NLGRP_READLOG
, GFP_KERNEL
);
529 * kauditd_wake_condition - Return true when it is time to wake kauditd_thread
532 * This function is for use by the wait_event_freezable() call in
535 static int kauditd_wake_condition(void)
537 static int pid_last
= 0;
541 /* wake on new messages or a change in the connected auditd */
542 rc
= skb_queue_len(&audit_queue
) || (pid
&& pid
!= pid_last
);
549 static int kauditd_thread(void *dummy
)
555 struct nlmsghdr
*nlh
;
557 #define UNICAST_RETRIES 5
558 #define AUDITD_BAD(x,y) \
559 ((x) == -ECONNREFUSED || (x) == -EPERM || ++(y) >= UNICAST_RETRIES)
561 /* NOTE: we do invalidate the auditd connection flag on any sending
562 * errors, but we only "restore" the connection flag at specific places
563 * in the loop in order to help ensure proper ordering of audit
567 while (!kthread_should_stop()) {
568 /* NOTE: possible area for future improvement is to look at
569 * the hold and retry queues, since only this thread
570 * has access to these queues we might be able to do
571 * our own queuing and skip some/all of the locking */
573 /* NOTE: it might be a fun experiment to split the hold and
574 * retry queue handling to another thread, but the
575 * synchronization issues and other overhead might kill
576 * any performance gains */
578 /* attempt to flush the hold queue */
579 while (auditd
&& (skb
= skb_dequeue(&audit_hold_queue
))) {
580 rc
= kauditd_send_unicast_skb(skb
);
582 /* requeue to the same spot */
583 skb_queue_head(&audit_hold_queue
, skb
);
586 if (AUDITD_BAD(rc
, reschedule
)) {
587 mutex_lock(&audit_cmd_mutex
);
589 mutex_unlock(&audit_cmd_mutex
);
593 /* we were able to send successfully */
597 /* attempt to flush the retry queue */
598 while (auditd
&& (skb
= skb_dequeue(&audit_retry_queue
))) {
599 rc
= kauditd_send_unicast_skb(skb
);
602 if (AUDITD_BAD(rc
, reschedule
)) {
603 kauditd_hold_skb(skb
);
604 mutex_lock(&audit_cmd_mutex
);
606 mutex_unlock(&audit_cmd_mutex
);
609 /* temporary problem (we hope), queue
610 * to the same spot and retry */
611 skb_queue_head(&audit_retry_queue
, skb
);
613 /* we were able to send successfully */
617 /* standard queue processing, try to be as quick as possible */
619 skb
= skb_dequeue(&audit_queue
);
621 /* setup the netlink header, see the comments in
622 * kauditd_send_multicast_skb() for length quirks */
623 nlh
= nlmsg_hdr(skb
);
624 nlh
->nlmsg_len
= skb
->len
- NLMSG_HDRLEN
;
626 /* attempt to send to any multicast listeners */
627 kauditd_send_multicast_skb(skb
);
629 /* attempt to send to auditd, queue on failure */
631 rc
= kauditd_send_unicast_skb(skb
);
634 if (AUDITD_BAD(rc
, reschedule
)) {
635 mutex_lock(&audit_cmd_mutex
);
637 mutex_unlock(&audit_cmd_mutex
);
641 /* move to the retry queue */
642 kauditd_retry_skb(skb
);
644 /* everything is working so go fast! */
646 } else if (reschedule
)
647 /* we are currently having problems, move to
649 kauditd_retry_skb(skb
);
651 /* dump the message via printk and hold it */
652 kauditd_hold_skb(skb
);
654 /* we have flushed the backlog so wake everyone */
655 wake_up(&audit_backlog_wait
);
657 /* if everything is okay with auditd (if present), go
658 * to sleep until there is something new in the queue
659 * or we have a change in the connected auditd;
660 * otherwise simply reschedule to give things a chance
663 set_current_state(TASK_INTERRUPTIBLE
);
666 wait_event_freezable(kauditd_wait
,
667 kauditd_wake_condition());
669 /* update the auditd connection status */
670 auditd
= (audit_pid
? 1 : 0);
677 int audit_send_list(void *_dest
)
679 struct audit_netlink_list
*dest
= _dest
;
681 struct net
*net
= dest
->net
;
682 struct audit_net
*aunet
= net_generic(net
, audit_net_id
);
684 /* wait for parent to finish and send an ACK */
685 mutex_lock(&audit_cmd_mutex
);
686 mutex_unlock(&audit_cmd_mutex
);
688 while ((skb
= __skb_dequeue(&dest
->q
)) != NULL
)
689 netlink_unicast(aunet
->nlsk
, skb
, dest
->portid
, 0);
697 struct sk_buff
*audit_make_reply(__u32 portid
, int seq
, int type
, int done
,
698 int multi
, const void *payload
, int size
)
701 struct nlmsghdr
*nlh
;
703 int flags
= multi
? NLM_F_MULTI
: 0;
704 int t
= done
? NLMSG_DONE
: type
;
706 skb
= nlmsg_new(size
, GFP_KERNEL
);
710 nlh
= nlmsg_put(skb
, portid
, seq
, t
, size
, flags
);
713 data
= nlmsg_data(nlh
);
714 memcpy(data
, payload
, size
);
722 static int audit_send_reply_thread(void *arg
)
724 struct audit_reply
*reply
= (struct audit_reply
*)arg
;
725 struct net
*net
= reply
->net
;
726 struct audit_net
*aunet
= net_generic(net
, audit_net_id
);
728 mutex_lock(&audit_cmd_mutex
);
729 mutex_unlock(&audit_cmd_mutex
);
731 /* Ignore failure. It'll only happen if the sender goes away,
732 because our timeout is set to infinite. */
733 netlink_unicast(aunet
->nlsk
, reply
->skb
, reply
->portid
, 0);
740 * audit_send_reply - send an audit reply message via netlink
741 * @request_skb: skb of request we are replying to (used to target the reply)
742 * @seq: sequence number
743 * @type: audit message type
744 * @done: done (last) flag
745 * @multi: multi-part message flag
746 * @payload: payload data
747 * @size: payload size
749 * Allocates an skb, builds the netlink message, and sends it to the port id.
750 * No failure notifications.
752 static void audit_send_reply(struct sk_buff
*request_skb
, int seq
, int type
, int done
,
753 int multi
, const void *payload
, int size
)
755 u32 portid
= NETLINK_CB(request_skb
).portid
;
756 struct net
*net
= sock_net(NETLINK_CB(request_skb
).sk
);
758 struct task_struct
*tsk
;
759 struct audit_reply
*reply
= kmalloc(sizeof(struct audit_reply
),
765 skb
= audit_make_reply(portid
, seq
, type
, done
, multi
, payload
, size
);
769 reply
->net
= get_net(net
);
770 reply
->portid
= portid
;
773 tsk
= kthread_run(audit_send_reply_thread
, reply
, "audit_send_reply");
782 * Check for appropriate CAP_AUDIT_ capabilities on incoming audit
785 static int audit_netlink_ok(struct sk_buff
*skb
, u16 msg_type
)
789 /* Only support initial user namespace for now. */
791 * We return ECONNREFUSED because it tricks userspace into thinking
792 * that audit was not configured into the kernel. Lots of users
793 * configure their PAM stack (because that's what the distro does)
794 * to reject login if unable to send messages to audit. If we return
795 * ECONNREFUSED the PAM stack thinks the kernel does not have audit
796 * configured in and will let login proceed. If we return EPERM
797 * userspace will reject all logins. This should be removed when we
798 * support non init namespaces!!
800 if (current_user_ns() != &init_user_ns
)
801 return -ECONNREFUSED
;
810 case AUDIT_GET_FEATURE
:
811 case AUDIT_SET_FEATURE
:
812 case AUDIT_LIST_RULES
:
815 case AUDIT_SIGNAL_INFO
:
819 case AUDIT_MAKE_EQUIV
:
820 /* Only support auditd and auditctl in initial pid namespace
822 if (task_active_pid_ns(current
) != &init_pid_ns
)
825 if (!netlink_capable(skb
, CAP_AUDIT_CONTROL
))
829 case AUDIT_FIRST_USER_MSG
... AUDIT_LAST_USER_MSG
:
830 case AUDIT_FIRST_USER_MSG2
... AUDIT_LAST_USER_MSG2
:
831 if (!netlink_capable(skb
, CAP_AUDIT_WRITE
))
834 default: /* bad msg */
841 static void audit_log_common_recv_msg(struct audit_buffer
**ab
, u16 msg_type
)
843 uid_t uid
= from_kuid(&init_user_ns
, current_uid());
844 pid_t pid
= task_tgid_nr(current
);
846 if (!audit_enabled
&& msg_type
!= AUDIT_USER_AVC
) {
851 *ab
= audit_log_start(NULL
, GFP_KERNEL
, msg_type
);
854 audit_log_format(*ab
, "pid=%d uid=%u", pid
, uid
);
855 audit_log_session_info(*ab
);
856 audit_log_task_context(*ab
);
859 int is_audit_feature_set(int i
)
861 return af
.features
& AUDIT_FEATURE_TO_MASK(i
);
865 static int audit_get_feature(struct sk_buff
*skb
)
869 seq
= nlmsg_hdr(skb
)->nlmsg_seq
;
871 audit_send_reply(skb
, seq
, AUDIT_GET_FEATURE
, 0, 0, &af
, sizeof(af
));
876 static void audit_log_feature_change(int which
, u32 old_feature
, u32 new_feature
,
877 u32 old_lock
, u32 new_lock
, int res
)
879 struct audit_buffer
*ab
;
881 if (audit_enabled
== AUDIT_OFF
)
884 ab
= audit_log_start(NULL
, GFP_KERNEL
, AUDIT_FEATURE_CHANGE
);
885 audit_log_task_info(ab
, current
);
886 audit_log_format(ab
, " feature=%s old=%u new=%u old_lock=%u new_lock=%u res=%d",
887 audit_feature_names
[which
], !!old_feature
, !!new_feature
,
888 !!old_lock
, !!new_lock
, res
);
892 static int audit_set_feature(struct sk_buff
*skb
)
894 struct audit_features
*uaf
;
897 BUILD_BUG_ON(AUDIT_LAST_FEATURE
+ 1 > ARRAY_SIZE(audit_feature_names
));
898 uaf
= nlmsg_data(nlmsg_hdr(skb
));
900 /* if there is ever a version 2 we should handle that here */
902 for (i
= 0; i
<= AUDIT_LAST_FEATURE
; i
++) {
903 u32 feature
= AUDIT_FEATURE_TO_MASK(i
);
904 u32 old_feature
, new_feature
, old_lock
, new_lock
;
906 /* if we are not changing this feature, move along */
907 if (!(feature
& uaf
->mask
))
910 old_feature
= af
.features
& feature
;
911 new_feature
= uaf
->features
& feature
;
912 new_lock
= (uaf
->lock
| af
.lock
) & feature
;
913 old_lock
= af
.lock
& feature
;
915 /* are we changing a locked feature? */
916 if (old_lock
&& (new_feature
!= old_feature
)) {
917 audit_log_feature_change(i
, old_feature
, new_feature
,
918 old_lock
, new_lock
, 0);
922 /* nothing invalid, do the changes */
923 for (i
= 0; i
<= AUDIT_LAST_FEATURE
; i
++) {
924 u32 feature
= AUDIT_FEATURE_TO_MASK(i
);
925 u32 old_feature
, new_feature
, old_lock
, new_lock
;
927 /* if we are not changing this feature, move along */
928 if (!(feature
& uaf
->mask
))
931 old_feature
= af
.features
& feature
;
932 new_feature
= uaf
->features
& feature
;
933 old_lock
= af
.lock
& feature
;
934 new_lock
= (uaf
->lock
| af
.lock
) & feature
;
936 if (new_feature
!= old_feature
)
937 audit_log_feature_change(i
, old_feature
, new_feature
,
938 old_lock
, new_lock
, 1);
941 af
.features
|= feature
;
943 af
.features
&= ~feature
;
950 static int audit_replace(pid_t pid
)
952 struct sk_buff
*skb
= audit_make_reply(0, 0, AUDIT_REPLACE
, 0, 0,
957 return netlink_unicast(audit_sock
, skb
, audit_nlk_portid
, 0);
960 static int audit_receive_msg(struct sk_buff
*skb
, struct nlmsghdr
*nlh
)
965 struct audit_buffer
*ab
;
966 u16 msg_type
= nlh
->nlmsg_type
;
967 struct audit_sig_info
*sig_data
;
971 err
= audit_netlink_ok(skb
, msg_type
);
975 seq
= nlh
->nlmsg_seq
;
976 data
= nlmsg_data(nlh
);
980 struct audit_status s
;
981 memset(&s
, 0, sizeof(s
));
982 s
.enabled
= audit_enabled
;
983 s
.failure
= audit_failure
;
985 s
.rate_limit
= audit_rate_limit
;
986 s
.backlog_limit
= audit_backlog_limit
;
987 s
.lost
= atomic_read(&audit_lost
);
988 s
.backlog
= skb_queue_len(&audit_queue
);
989 s
.feature_bitmap
= AUDIT_FEATURE_BITMAP_ALL
;
990 s
.backlog_wait_time
= audit_backlog_wait_time
;
991 audit_send_reply(skb
, seq
, AUDIT_GET
, 0, 0, &s
, sizeof(s
));
995 struct audit_status s
;
996 memset(&s
, 0, sizeof(s
));
997 /* guard against past and future API changes */
998 memcpy(&s
, data
, min_t(size_t, sizeof(s
), nlmsg_len(nlh
)));
999 if (s
.mask
& AUDIT_STATUS_ENABLED
) {
1000 err
= audit_set_enabled(s
.enabled
);
1004 if (s
.mask
& AUDIT_STATUS_FAILURE
) {
1005 err
= audit_set_failure(s
.failure
);
1009 if (s
.mask
& AUDIT_STATUS_PID
) {
1010 /* NOTE: we are using task_tgid_vnr() below because
1011 * the s.pid value is relative to the namespace
1012 * of the caller; at present this doesn't matter
1013 * much since you can really only run auditd
1014 * from the initial pid namespace, but something
1015 * to keep in mind if this changes */
1016 int new_pid
= s
.pid
;
1017 pid_t requesting_pid
= task_tgid_vnr(current
);
1019 if ((!new_pid
) && (requesting_pid
!= audit_pid
)) {
1020 audit_log_config_change("audit_pid", new_pid
, audit_pid
, 0);
1023 if (audit_pid
&& new_pid
&&
1024 audit_replace(requesting_pid
) != -ECONNREFUSED
) {
1025 audit_log_config_change("audit_pid", new_pid
, audit_pid
, 0);
1028 if (audit_enabled
!= AUDIT_OFF
)
1029 audit_log_config_change("audit_pid", new_pid
, audit_pid
, 1);
1032 sock_put(audit_sock
);
1033 audit_pid
= new_pid
;
1034 audit_nlk_portid
= NETLINK_CB(skb
).portid
;
1036 audit_sock
= skb
->sk
;
1040 wake_up_interruptible(&kauditd_wait
);
1042 if (s
.mask
& AUDIT_STATUS_RATE_LIMIT
) {
1043 err
= audit_set_rate_limit(s
.rate_limit
);
1047 if (s
.mask
& AUDIT_STATUS_BACKLOG_LIMIT
) {
1048 err
= audit_set_backlog_limit(s
.backlog_limit
);
1052 if (s
.mask
& AUDIT_STATUS_BACKLOG_WAIT_TIME
) {
1053 if (sizeof(s
) > (size_t)nlh
->nlmsg_len
)
1055 if (s
.backlog_wait_time
> 10*AUDIT_BACKLOG_WAIT_TIME
)
1057 err
= audit_set_backlog_wait_time(s
.backlog_wait_time
);
1063 case AUDIT_GET_FEATURE
:
1064 err
= audit_get_feature(skb
);
1068 case AUDIT_SET_FEATURE
:
1069 err
= audit_set_feature(skb
);
1074 case AUDIT_FIRST_USER_MSG
... AUDIT_LAST_USER_MSG
:
1075 case AUDIT_FIRST_USER_MSG2
... AUDIT_LAST_USER_MSG2
:
1076 if (!audit_enabled
&& msg_type
!= AUDIT_USER_AVC
)
1079 err
= audit_filter(msg_type
, AUDIT_FILTER_USER
);
1080 if (err
== 1) { /* match or error */
1082 if (msg_type
== AUDIT_USER_TTY
) {
1083 err
= tty_audit_push();
1087 mutex_unlock(&audit_cmd_mutex
);
1088 audit_log_common_recv_msg(&ab
, msg_type
);
1089 if (msg_type
!= AUDIT_USER_TTY
)
1090 audit_log_format(ab
, " msg='%.*s'",
1091 AUDIT_MESSAGE_TEXT_MAX
,
1096 audit_log_format(ab
, " data=");
1097 size
= nlmsg_len(nlh
);
1099 ((unsigned char *)data
)[size
- 1] == '\0')
1101 audit_log_n_untrustedstring(ab
, data
, size
);
1103 audit_set_portid(ab
, NETLINK_CB(skb
).portid
);
1105 mutex_lock(&audit_cmd_mutex
);
1108 case AUDIT_ADD_RULE
:
1109 case AUDIT_DEL_RULE
:
1110 if (nlmsg_len(nlh
) < sizeof(struct audit_rule_data
))
1112 if (audit_enabled
== AUDIT_LOCKED
) {
1113 audit_log_common_recv_msg(&ab
, AUDIT_CONFIG_CHANGE
);
1114 audit_log_format(ab
, " audit_enabled=%d res=0", audit_enabled
);
1118 err
= audit_rule_change(msg_type
, NETLINK_CB(skb
).portid
,
1119 seq
, data
, nlmsg_len(nlh
));
1121 case AUDIT_LIST_RULES
:
1122 err
= audit_list_rules_send(skb
, seq
);
1126 audit_log_common_recv_msg(&ab
, AUDIT_CONFIG_CHANGE
);
1127 audit_log_format(ab
, " op=trim res=1");
1130 case AUDIT_MAKE_EQUIV
: {
1133 size_t msglen
= nlmsg_len(nlh
);
1137 if (msglen
< 2 * sizeof(u32
))
1139 memcpy(sizes
, bufp
, 2 * sizeof(u32
));
1140 bufp
+= 2 * sizeof(u32
);
1141 msglen
-= 2 * sizeof(u32
);
1142 old
= audit_unpack_string(&bufp
, &msglen
, sizes
[0]);
1147 new = audit_unpack_string(&bufp
, &msglen
, sizes
[1]);
1153 /* OK, here comes... */
1154 err
= audit_tag_tree(old
, new);
1156 audit_log_common_recv_msg(&ab
, AUDIT_CONFIG_CHANGE
);
1158 audit_log_format(ab
, " op=make_equiv old=");
1159 audit_log_untrustedstring(ab
, old
);
1160 audit_log_format(ab
, " new=");
1161 audit_log_untrustedstring(ab
, new);
1162 audit_log_format(ab
, " res=%d", !err
);
1168 case AUDIT_SIGNAL_INFO
:
1170 if (audit_sig_sid
) {
1171 err
= security_secid_to_secctx(audit_sig_sid
, &ctx
, &len
);
1175 sig_data
= kmalloc(sizeof(*sig_data
) + len
, GFP_KERNEL
);
1178 security_release_secctx(ctx
, len
);
1181 sig_data
->uid
= from_kuid(&init_user_ns
, audit_sig_uid
);
1182 sig_data
->pid
= audit_sig_pid
;
1183 if (audit_sig_sid
) {
1184 memcpy(sig_data
->ctx
, ctx
, len
);
1185 security_release_secctx(ctx
, len
);
1187 audit_send_reply(skb
, seq
, AUDIT_SIGNAL_INFO
, 0, 0,
1188 sig_data
, sizeof(*sig_data
) + len
);
1191 case AUDIT_TTY_GET
: {
1192 struct audit_tty_status s
;
1195 t
= READ_ONCE(current
->signal
->audit_tty
);
1196 s
.enabled
= t
& AUDIT_TTY_ENABLE
;
1197 s
.log_passwd
= !!(t
& AUDIT_TTY_LOG_PASSWD
);
1199 audit_send_reply(skb
, seq
, AUDIT_TTY_GET
, 0, 0, &s
, sizeof(s
));
1202 case AUDIT_TTY_SET
: {
1203 struct audit_tty_status s
, old
;
1204 struct audit_buffer
*ab
;
1207 memset(&s
, 0, sizeof(s
));
1208 /* guard against past and future API changes */
1209 memcpy(&s
, data
, min_t(size_t, sizeof(s
), nlmsg_len(nlh
)));
1210 /* check if new data is valid */
1211 if ((s
.enabled
!= 0 && s
.enabled
!= 1) ||
1212 (s
.log_passwd
!= 0 && s
.log_passwd
!= 1))
1216 t
= READ_ONCE(current
->signal
->audit_tty
);
1218 t
= s
.enabled
| (-s
.log_passwd
& AUDIT_TTY_LOG_PASSWD
);
1219 t
= xchg(¤t
->signal
->audit_tty
, t
);
1221 old
.enabled
= t
& AUDIT_TTY_ENABLE
;
1222 old
.log_passwd
= !!(t
& AUDIT_TTY_LOG_PASSWD
);
1224 audit_log_common_recv_msg(&ab
, AUDIT_CONFIG_CHANGE
);
1225 audit_log_format(ab
, " op=tty_set old-enabled=%d new-enabled=%d"
1226 " old-log_passwd=%d new-log_passwd=%d res=%d",
1227 old
.enabled
, s
.enabled
, old
.log_passwd
,
1228 s
.log_passwd
, !err
);
1237 return err
< 0 ? err
: 0;
1241 * Get message from skb. Each message is processed by audit_receive_msg.
1242 * Malformed skbs with wrong length are discarded silently.
1244 static void audit_receive_skb(struct sk_buff
*skb
)
1246 struct nlmsghdr
*nlh
;
1248 * len MUST be signed for nlmsg_next to be able to dec it below 0
1249 * if the nlmsg_len was not aligned
1254 nlh
= nlmsg_hdr(skb
);
1257 while (nlmsg_ok(nlh
, len
)) {
1258 err
= audit_receive_msg(skb
, nlh
);
1259 /* if err or if this message says it wants a response */
1260 if (err
|| (nlh
->nlmsg_flags
& NLM_F_ACK
))
1261 netlink_ack(skb
, nlh
, err
);
1263 nlh
= nlmsg_next(nlh
, &len
);
1267 /* Receive messages from netlink socket. */
1268 static void audit_receive(struct sk_buff
*skb
)
1270 mutex_lock(&audit_cmd_mutex
);
1271 audit_receive_skb(skb
);
1272 mutex_unlock(&audit_cmd_mutex
);
1275 /* Run custom bind function on netlink socket group connect or bind requests. */
1276 static int audit_bind(struct net
*net
, int group
)
1278 if (!capable(CAP_AUDIT_READ
))
1284 static int __net_init
audit_net_init(struct net
*net
)
1286 struct netlink_kernel_cfg cfg
= {
1287 .input
= audit_receive
,
1289 .flags
= NL_CFG_F_NONROOT_RECV
,
1290 .groups
= AUDIT_NLGRP_MAX
,
1293 struct audit_net
*aunet
= net_generic(net
, audit_net_id
);
1295 aunet
->nlsk
= netlink_kernel_create(net
, NETLINK_AUDIT
, &cfg
);
1296 if (aunet
->nlsk
== NULL
) {
1297 audit_panic("cannot initialize netlink socket in namespace");
1300 aunet
->nlsk
->sk_sndtimeo
= MAX_SCHEDULE_TIMEOUT
;
1304 static void __net_exit
audit_net_exit(struct net
*net
)
1306 struct audit_net
*aunet
= net_generic(net
, audit_net_id
);
1307 struct sock
*sock
= aunet
->nlsk
;
1308 mutex_lock(&audit_cmd_mutex
);
1309 if (sock
== audit_sock
)
1311 mutex_unlock(&audit_cmd_mutex
);
1313 netlink_kernel_release(sock
);
1317 static struct pernet_operations audit_net_ops __net_initdata
= {
1318 .init
= audit_net_init
,
1319 .exit
= audit_net_exit
,
1320 .id
= &audit_net_id
,
1321 .size
= sizeof(struct audit_net
),
1324 /* Initialize audit support at boot time. */
1325 static int __init
audit_init(void)
1329 if (audit_initialized
== AUDIT_DISABLED
)
1332 pr_info("initializing netlink subsys (%s)\n",
1333 audit_default
? "enabled" : "disabled");
1334 register_pernet_subsys(&audit_net_ops
);
1336 skb_queue_head_init(&audit_queue
);
1337 skb_queue_head_init(&audit_retry_queue
);
1338 skb_queue_head_init(&audit_hold_queue
);
1339 audit_initialized
= AUDIT_INITIALIZED
;
1340 audit_enabled
= audit_default
;
1341 audit_ever_enabled
|= !!audit_default
;
1343 for (i
= 0; i
< AUDIT_INODE_BUCKETS
; i
++)
1344 INIT_LIST_HEAD(&audit_inode_hash
[i
]);
1346 kauditd_task
= kthread_run(kauditd_thread
, NULL
, "kauditd");
1347 if (IS_ERR(kauditd_task
)) {
1348 int err
= PTR_ERR(kauditd_task
);
1349 panic("audit: failed to start the kauditd thread (%d)\n", err
);
1352 audit_log(NULL
, GFP_KERNEL
, AUDIT_KERNEL
, "initialized");
1356 __initcall(audit_init
);
1358 /* Process kernel command-line parameter at boot time. audit=0 or audit=1. */
1359 static int __init
audit_enable(char *str
)
1361 audit_default
= !!simple_strtol(str
, NULL
, 0);
1363 audit_initialized
= AUDIT_DISABLED
;
1365 pr_info("%s\n", audit_default
?
1366 "enabled (after initialization)" : "disabled (until reboot)");
1370 __setup("audit=", audit_enable
);
1372 /* Process kernel command-line parameter at boot time.
1373 * audit_backlog_limit=<n> */
1374 static int __init
audit_backlog_limit_set(char *str
)
1376 u32 audit_backlog_limit_arg
;
1378 pr_info("audit_backlog_limit: ");
1379 if (kstrtouint(str
, 0, &audit_backlog_limit_arg
)) {
1380 pr_cont("using default of %u, unable to parse %s\n",
1381 audit_backlog_limit
, str
);
1385 audit_backlog_limit
= audit_backlog_limit_arg
;
1386 pr_cont("%d\n", audit_backlog_limit
);
1390 __setup("audit_backlog_limit=", audit_backlog_limit_set
);
1392 static void audit_buffer_free(struct audit_buffer
*ab
)
1394 unsigned long flags
;
1400 spin_lock_irqsave(&audit_freelist_lock
, flags
);
1401 if (audit_freelist_count
> AUDIT_MAXFREE
)
1404 audit_freelist_count
++;
1405 list_add(&ab
->list
, &audit_freelist
);
1407 spin_unlock_irqrestore(&audit_freelist_lock
, flags
);
1410 static struct audit_buffer
* audit_buffer_alloc(struct audit_context
*ctx
,
1411 gfp_t gfp_mask
, int type
)
1413 unsigned long flags
;
1414 struct audit_buffer
*ab
= NULL
;
1415 struct nlmsghdr
*nlh
;
1417 spin_lock_irqsave(&audit_freelist_lock
, flags
);
1418 if (!list_empty(&audit_freelist
)) {
1419 ab
= list_entry(audit_freelist
.next
,
1420 struct audit_buffer
, list
);
1421 list_del(&ab
->list
);
1422 --audit_freelist_count
;
1424 spin_unlock_irqrestore(&audit_freelist_lock
, flags
);
1427 ab
= kmalloc(sizeof(*ab
), gfp_mask
);
1433 ab
->gfp_mask
= gfp_mask
;
1435 ab
->skb
= nlmsg_new(AUDIT_BUFSIZ
, gfp_mask
);
1439 nlh
= nlmsg_put(ab
->skb
, 0, 0, type
, 0, 0);
1449 audit_buffer_free(ab
);
1454 * audit_serial - compute a serial number for the audit record
1456 * Compute a serial number for the audit record. Audit records are
1457 * written to user-space as soon as they are generated, so a complete
1458 * audit record may be written in several pieces. The timestamp of the
1459 * record and this serial number are used by the user-space tools to
1460 * determine which pieces belong to the same audit record. The
1461 * (timestamp,serial) tuple is unique for each syscall and is live from
1462 * syscall entry to syscall exit.
1464 * NOTE: Another possibility is to store the formatted records off the
1465 * audit context (for those records that have a context), and emit them
1466 * all at syscall exit. However, this could delay the reporting of
1467 * significant errors until syscall exit (or never, if the system
1470 unsigned int audit_serial(void)
1472 static atomic_t serial
= ATOMIC_INIT(0);
1474 return atomic_add_return(1, &serial
);
1477 static inline void audit_get_stamp(struct audit_context
*ctx
,
1478 struct timespec
*t
, unsigned int *serial
)
1480 if (!ctx
|| !auditsc_get_stamp(ctx
, t
, serial
)) {
1482 *serial
= audit_serial();
1487 * audit_log_start - obtain an audit buffer
1488 * @ctx: audit_context (may be NULL)
1489 * @gfp_mask: type of allocation
1490 * @type: audit message type
1492 * Returns audit_buffer pointer on success or NULL on error.
1494 * Obtain an audit buffer. This routine does locking to obtain the
1495 * audit buffer, but then no locking is required for calls to
1496 * audit_log_*format. If the task (ctx) is a task that is currently in a
1497 * syscall, then the syscall is marked as auditable and an audit record
1498 * will be written at syscall exit. If there is no associated task, then
1499 * task context (ctx) should be NULL.
1501 struct audit_buffer
*audit_log_start(struct audit_context
*ctx
, gfp_t gfp_mask
,
1504 struct audit_buffer
*ab
;
1506 unsigned int uninitialized_var(serial
);
1508 if (audit_initialized
!= AUDIT_INITIALIZED
)
1511 if (unlikely(!audit_filter(type
, AUDIT_FILTER_TYPE
)))
1514 /* don't ever fail/sleep on these two conditions:
1515 * 1. auditd generated record - since we need auditd to drain the
1516 * queue; also, when we are checking for auditd, compare PIDs using
1517 * task_tgid_vnr() since auditd_pid is set in audit_receive_msg()
1518 * using a PID anchored in the caller's namespace
1519 * 2. audit command message - record types 1000 through 1099 inclusive
1520 * are command messages/records used to manage the kernel subsystem
1521 * and the audit userspace, blocking on these messages could cause
1522 * problems under load so don't do it (note: not all of these
1523 * command types are valid as record types, but it is quicker to
1524 * just check two ints than a series of ints in a if/switch stmt) */
1525 if (!((audit_pid
&& audit_pid
== task_tgid_vnr(current
)) ||
1526 (type
>= 1000 && type
<= 1099))) {
1527 long sleep_time
= audit_backlog_wait_time
;
1529 while (audit_backlog_limit
&&
1530 (skb_queue_len(&audit_queue
) > audit_backlog_limit
)) {
1531 /* wake kauditd to try and flush the queue */
1532 wake_up_interruptible(&kauditd_wait
);
1534 /* sleep if we are allowed and we haven't exhausted our
1535 * backlog wait limit */
1536 if ((gfp_mask
& __GFP_DIRECT_RECLAIM
) &&
1538 DECLARE_WAITQUEUE(wait
, current
);
1540 add_wait_queue_exclusive(&audit_backlog_wait
,
1542 set_current_state(TASK_UNINTERRUPTIBLE
);
1543 sleep_time
= schedule_timeout(sleep_time
);
1544 remove_wait_queue(&audit_backlog_wait
, &wait
);
1546 if (audit_rate_check() && printk_ratelimit())
1547 pr_warn("audit_backlog=%d > audit_backlog_limit=%d\n",
1548 skb_queue_len(&audit_queue
),
1549 audit_backlog_limit
);
1550 audit_log_lost("backlog limit exceeded");
1556 ab
= audit_buffer_alloc(ctx
, gfp_mask
, type
);
1558 audit_log_lost("out of memory in audit_log_start");
1562 audit_get_stamp(ab
->ctx
, &t
, &serial
);
1563 audit_log_format(ab
, "audit(%lu.%03lu:%u): ",
1564 t
.tv_sec
, t
.tv_nsec
/1000000, serial
);
1570 * audit_expand - expand skb in the audit buffer
1572 * @extra: space to add at tail of the skb
1574 * Returns 0 (no space) on failed expansion, or available space if
1577 static inline int audit_expand(struct audit_buffer
*ab
, int extra
)
1579 struct sk_buff
*skb
= ab
->skb
;
1580 int oldtail
= skb_tailroom(skb
);
1581 int ret
= pskb_expand_head(skb
, 0, extra
, ab
->gfp_mask
);
1582 int newtail
= skb_tailroom(skb
);
1585 audit_log_lost("out of memory in audit_expand");
1589 skb
->truesize
+= newtail
- oldtail
;
1594 * Format an audit message into the audit buffer. If there isn't enough
1595 * room in the audit buffer, more room will be allocated and vsnprint
1596 * will be called a second time. Currently, we assume that a printk
1597 * can't format message larger than 1024 bytes, so we don't either.
1599 static void audit_log_vformat(struct audit_buffer
*ab
, const char *fmt
,
1603 struct sk_buff
*skb
;
1611 avail
= skb_tailroom(skb
);
1613 avail
= audit_expand(ab
, AUDIT_BUFSIZ
);
1617 va_copy(args2
, args
);
1618 len
= vsnprintf(skb_tail_pointer(skb
), avail
, fmt
, args
);
1620 /* The printk buffer is 1024 bytes long, so if we get
1621 * here and AUDIT_BUFSIZ is at least 1024, then we can
1622 * log everything that printk could have logged. */
1623 avail
= audit_expand(ab
,
1624 max_t(unsigned, AUDIT_BUFSIZ
, 1+len
-avail
));
1627 len
= vsnprintf(skb_tail_pointer(skb
), avail
, fmt
, args2
);
1638 * audit_log_format - format a message into the audit buffer.
1640 * @fmt: format string
1641 * @...: optional parameters matching @fmt string
1643 * All the work is done in audit_log_vformat.
1645 void audit_log_format(struct audit_buffer
*ab
, const char *fmt
, ...)
1651 va_start(args
, fmt
);
1652 audit_log_vformat(ab
, fmt
, args
);
1657 * audit_log_hex - convert a buffer to hex and append it to the audit skb
1658 * @ab: the audit_buffer
1659 * @buf: buffer to convert to hex
1660 * @len: length of @buf to be converted
1662 * No return value; failure to expand is silently ignored.
1664 * This function will take the passed buf and convert it into a string of
1665 * ascii hex digits. The new string is placed onto the skb.
1667 void audit_log_n_hex(struct audit_buffer
*ab
, const unsigned char *buf
,
1670 int i
, avail
, new_len
;
1672 struct sk_buff
*skb
;
1679 avail
= skb_tailroom(skb
);
1681 if (new_len
>= avail
) {
1682 /* Round the buffer request up to the next multiple */
1683 new_len
= AUDIT_BUFSIZ
*(((new_len
-avail
)/AUDIT_BUFSIZ
) + 1);
1684 avail
= audit_expand(ab
, new_len
);
1689 ptr
= skb_tail_pointer(skb
);
1690 for (i
= 0; i
< len
; i
++)
1691 ptr
= hex_byte_pack_upper(ptr
, buf
[i
]);
1693 skb_put(skb
, len
<< 1); /* new string is twice the old string */
1697 * Format a string of no more than slen characters into the audit buffer,
1698 * enclosed in quote marks.
1700 void audit_log_n_string(struct audit_buffer
*ab
, const char *string
,
1705 struct sk_buff
*skb
;
1712 avail
= skb_tailroom(skb
);
1713 new_len
= slen
+ 3; /* enclosing quotes + null terminator */
1714 if (new_len
> avail
) {
1715 avail
= audit_expand(ab
, new_len
);
1719 ptr
= skb_tail_pointer(skb
);
1721 memcpy(ptr
, string
, slen
);
1725 skb_put(skb
, slen
+ 2); /* don't include null terminator */
1729 * audit_string_contains_control - does a string need to be logged in hex
1730 * @string: string to be checked
1731 * @len: max length of the string to check
1733 bool audit_string_contains_control(const char *string
, size_t len
)
1735 const unsigned char *p
;
1736 for (p
= string
; p
< (const unsigned char *)string
+ len
; p
++) {
1737 if (*p
== '"' || *p
< 0x21 || *p
> 0x7e)
1744 * audit_log_n_untrustedstring - log a string that may contain random characters
1746 * @len: length of string (not including trailing null)
1747 * @string: string to be logged
1749 * This code will escape a string that is passed to it if the string
1750 * contains a control character, unprintable character, double quote mark,
1751 * or a space. Unescaped strings will start and end with a double quote mark.
1752 * Strings that are escaped are printed in hex (2 digits per char).
1754 * The caller specifies the number of characters in the string to log, which may
1755 * or may not be the entire string.
1757 void audit_log_n_untrustedstring(struct audit_buffer
*ab
, const char *string
,
1760 if (audit_string_contains_control(string
, len
))
1761 audit_log_n_hex(ab
, string
, len
);
1763 audit_log_n_string(ab
, string
, len
);
1767 * audit_log_untrustedstring - log a string that may contain random characters
1769 * @string: string to be logged
1771 * Same as audit_log_n_untrustedstring(), except that strlen is used to
1772 * determine string length.
1774 void audit_log_untrustedstring(struct audit_buffer
*ab
, const char *string
)
1776 audit_log_n_untrustedstring(ab
, string
, strlen(string
));
1779 /* This is a helper-function to print the escaped d_path */
1780 void audit_log_d_path(struct audit_buffer
*ab
, const char *prefix
,
1781 const struct path
*path
)
1786 audit_log_format(ab
, "%s", prefix
);
1788 /* We will allow 11 spaces for ' (deleted)' to be appended */
1789 pathname
= kmalloc(PATH_MAX
+11, ab
->gfp_mask
);
1791 audit_log_string(ab
, "<no_memory>");
1794 p
= d_path(path
, pathname
, PATH_MAX
+11);
1795 if (IS_ERR(p
)) { /* Should never happen since we send PATH_MAX */
1796 /* FIXME: can we save some information here? */
1797 audit_log_string(ab
, "<too_long>");
1799 audit_log_untrustedstring(ab
, p
);
1803 void audit_log_session_info(struct audit_buffer
*ab
)
1805 unsigned int sessionid
= audit_get_sessionid(current
);
1806 uid_t auid
= from_kuid(&init_user_ns
, audit_get_loginuid(current
));
1808 audit_log_format(ab
, " auid=%u ses=%u", auid
, sessionid
);
1811 void audit_log_key(struct audit_buffer
*ab
, char *key
)
1813 audit_log_format(ab
, " key=");
1815 audit_log_untrustedstring(ab
, key
);
1817 audit_log_format(ab
, "(null)");
1820 void audit_log_cap(struct audit_buffer
*ab
, char *prefix
, kernel_cap_t
*cap
)
1824 audit_log_format(ab
, " %s=", prefix
);
1825 CAP_FOR_EACH_U32(i
) {
1826 audit_log_format(ab
, "%08x",
1827 cap
->cap
[CAP_LAST_U32
- i
]);
1831 static void audit_log_fcaps(struct audit_buffer
*ab
, struct audit_names
*name
)
1833 kernel_cap_t
*perm
= &name
->fcap
.permitted
;
1834 kernel_cap_t
*inh
= &name
->fcap
.inheritable
;
1837 if (!cap_isclear(*perm
)) {
1838 audit_log_cap(ab
, "cap_fp", perm
);
1841 if (!cap_isclear(*inh
)) {
1842 audit_log_cap(ab
, "cap_fi", inh
);
1847 audit_log_format(ab
, " cap_fe=%d cap_fver=%x",
1848 name
->fcap
.fE
, name
->fcap_ver
);
1851 static inline int audit_copy_fcaps(struct audit_names
*name
,
1852 const struct dentry
*dentry
)
1854 struct cpu_vfs_cap_data caps
;
1860 rc
= get_vfs_caps_from_disk(dentry
, &caps
);
1864 name
->fcap
.permitted
= caps
.permitted
;
1865 name
->fcap
.inheritable
= caps
.inheritable
;
1866 name
->fcap
.fE
= !!(caps
.magic_etc
& VFS_CAP_FLAGS_EFFECTIVE
);
1867 name
->fcap_ver
= (caps
.magic_etc
& VFS_CAP_REVISION_MASK
) >>
1868 VFS_CAP_REVISION_SHIFT
;
1873 /* Copy inode data into an audit_names. */
1874 void audit_copy_inode(struct audit_names
*name
, const struct dentry
*dentry
,
1875 struct inode
*inode
)
1877 name
->ino
= inode
->i_ino
;
1878 name
->dev
= inode
->i_sb
->s_dev
;
1879 name
->mode
= inode
->i_mode
;
1880 name
->uid
= inode
->i_uid
;
1881 name
->gid
= inode
->i_gid
;
1882 name
->rdev
= inode
->i_rdev
;
1883 security_inode_getsecid(inode
, &name
->osid
);
1884 audit_copy_fcaps(name
, dentry
);
1888 * audit_log_name - produce AUDIT_PATH record from struct audit_names
1889 * @context: audit_context for the task
1890 * @n: audit_names structure with reportable details
1891 * @path: optional path to report instead of audit_names->name
1892 * @record_num: record number to report when handling a list of names
1893 * @call_panic: optional pointer to int that will be updated if secid fails
1895 void audit_log_name(struct audit_context
*context
, struct audit_names
*n
,
1896 const struct path
*path
, int record_num
, int *call_panic
)
1898 struct audit_buffer
*ab
;
1899 ab
= audit_log_start(context
, GFP_KERNEL
, AUDIT_PATH
);
1903 audit_log_format(ab
, "item=%d", record_num
);
1906 audit_log_d_path(ab
, " name=", path
);
1908 switch (n
->name_len
) {
1909 case AUDIT_NAME_FULL
:
1910 /* log the full path */
1911 audit_log_format(ab
, " name=");
1912 audit_log_untrustedstring(ab
, n
->name
->name
);
1915 /* name was specified as a relative path and the
1916 * directory component is the cwd */
1917 audit_log_d_path(ab
, " name=", &context
->pwd
);
1920 /* log the name's directory component */
1921 audit_log_format(ab
, " name=");
1922 audit_log_n_untrustedstring(ab
, n
->name
->name
,
1926 audit_log_format(ab
, " name=(null)");
1928 if (n
->ino
!= AUDIT_INO_UNSET
)
1929 audit_log_format(ab
, " inode=%lu"
1930 " dev=%02x:%02x mode=%#ho"
1931 " ouid=%u ogid=%u rdev=%02x:%02x",
1936 from_kuid(&init_user_ns
, n
->uid
),
1937 from_kgid(&init_user_ns
, n
->gid
),
1943 if (security_secid_to_secctx(
1944 n
->osid
, &ctx
, &len
)) {
1945 audit_log_format(ab
, " osid=%u", n
->osid
);
1949 audit_log_format(ab
, " obj=%s", ctx
);
1950 security_release_secctx(ctx
, len
);
1954 /* log the audit_names record type */
1955 audit_log_format(ab
, " nametype=");
1957 case AUDIT_TYPE_NORMAL
:
1958 audit_log_format(ab
, "NORMAL");
1960 case AUDIT_TYPE_PARENT
:
1961 audit_log_format(ab
, "PARENT");
1963 case AUDIT_TYPE_CHILD_DELETE
:
1964 audit_log_format(ab
, "DELETE");
1966 case AUDIT_TYPE_CHILD_CREATE
:
1967 audit_log_format(ab
, "CREATE");
1970 audit_log_format(ab
, "UNKNOWN");
1974 audit_log_fcaps(ab
, n
);
1978 int audit_log_task_context(struct audit_buffer
*ab
)
1985 security_task_getsecid(current
, &sid
);
1989 error
= security_secid_to_secctx(sid
, &ctx
, &len
);
1991 if (error
!= -EINVAL
)
1996 audit_log_format(ab
, " subj=%s", ctx
);
1997 security_release_secctx(ctx
, len
);
2001 audit_panic("error in audit_log_task_context");
2004 EXPORT_SYMBOL(audit_log_task_context
);
2006 void audit_log_d_path_exe(struct audit_buffer
*ab
,
2007 struct mm_struct
*mm
)
2009 struct file
*exe_file
;
2014 exe_file
= get_mm_exe_file(mm
);
2018 audit_log_d_path(ab
, " exe=", &exe_file
->f_path
);
2022 audit_log_format(ab
, " exe=(null)");
2025 struct tty_struct
*audit_get_tty(struct task_struct
*tsk
)
2027 struct tty_struct
*tty
= NULL
;
2028 unsigned long flags
;
2030 spin_lock_irqsave(&tsk
->sighand
->siglock
, flags
);
2032 tty
= tty_kref_get(tsk
->signal
->tty
);
2033 spin_unlock_irqrestore(&tsk
->sighand
->siglock
, flags
);
2037 void audit_put_tty(struct tty_struct
*tty
)
2042 void audit_log_task_info(struct audit_buffer
*ab
, struct task_struct
*tsk
)
2044 const struct cred
*cred
;
2045 char comm
[sizeof(tsk
->comm
)];
2046 struct tty_struct
*tty
;
2051 /* tsk == current */
2052 cred
= current_cred();
2053 tty
= audit_get_tty(tsk
);
2054 audit_log_format(ab
,
2055 " ppid=%d pid=%d auid=%u uid=%u gid=%u"
2056 " euid=%u suid=%u fsuid=%u"
2057 " egid=%u sgid=%u fsgid=%u tty=%s ses=%u",
2060 from_kuid(&init_user_ns
, audit_get_loginuid(tsk
)),
2061 from_kuid(&init_user_ns
, cred
->uid
),
2062 from_kgid(&init_user_ns
, cred
->gid
),
2063 from_kuid(&init_user_ns
, cred
->euid
),
2064 from_kuid(&init_user_ns
, cred
->suid
),
2065 from_kuid(&init_user_ns
, cred
->fsuid
),
2066 from_kgid(&init_user_ns
, cred
->egid
),
2067 from_kgid(&init_user_ns
, cred
->sgid
),
2068 from_kgid(&init_user_ns
, cred
->fsgid
),
2069 tty
? tty_name(tty
) : "(none)",
2070 audit_get_sessionid(tsk
));
2072 audit_log_format(ab
, " comm=");
2073 audit_log_untrustedstring(ab
, get_task_comm(comm
, tsk
));
2074 audit_log_d_path_exe(ab
, tsk
->mm
);
2075 audit_log_task_context(ab
);
2077 EXPORT_SYMBOL(audit_log_task_info
);
2080 * audit_log_link_denied - report a link restriction denial
2081 * @operation: specific link operation
2082 * @link: the path that triggered the restriction
2084 void audit_log_link_denied(const char *operation
, const struct path
*link
)
2086 struct audit_buffer
*ab
;
2087 struct audit_names
*name
;
2089 name
= kzalloc(sizeof(*name
), GFP_NOFS
);
2093 /* Generate AUDIT_ANOM_LINK with subject, operation, outcome. */
2094 ab
= audit_log_start(current
->audit_context
, GFP_KERNEL
,
2098 audit_log_format(ab
, "op=%s", operation
);
2099 audit_log_task_info(ab
, current
);
2100 audit_log_format(ab
, " res=0");
2103 /* Generate AUDIT_PATH record with object. */
2104 name
->type
= AUDIT_TYPE_NORMAL
;
2105 audit_copy_inode(name
, link
->dentry
, d_backing_inode(link
->dentry
));
2106 audit_log_name(current
->audit_context
, name
, link
, 0, NULL
);
2112 * audit_log_end - end one audit record
2113 * @ab: the audit_buffer
2115 * We can not do a netlink send inside an irq context because it blocks (last
2116 * arg, flags, is not set to MSG_DONTWAIT), so the audit buffer is placed on a
2117 * queue and a tasklet is scheduled to remove them from the queue outside the
2118 * irq context. May be called in any context.
2120 void audit_log_end(struct audit_buffer
*ab
)
2124 if (!audit_rate_check()) {
2125 audit_log_lost("rate limit exceeded");
2127 skb_queue_tail(&audit_queue
, ab
->skb
);
2128 wake_up_interruptible(&kauditd_wait
);
2131 audit_buffer_free(ab
);
2135 * audit_log - Log an audit record
2136 * @ctx: audit context
2137 * @gfp_mask: type of allocation
2138 * @type: audit message type
2139 * @fmt: format string to use
2140 * @...: variable parameters matching the format string
2142 * This is a convenience function that calls audit_log_start,
2143 * audit_log_vformat, and audit_log_end. It may be called
2146 void audit_log(struct audit_context
*ctx
, gfp_t gfp_mask
, int type
,
2147 const char *fmt
, ...)
2149 struct audit_buffer
*ab
;
2152 ab
= audit_log_start(ctx
, gfp_mask
, type
);
2154 va_start(args
, fmt
);
2155 audit_log_vformat(ab
, fmt
, args
);
2161 #ifdef CONFIG_SECURITY
2163 * audit_log_secctx - Converts and logs SELinux context
2165 * @secid: security number
2167 * This is a helper function that calls security_secid_to_secctx to convert
2168 * secid to secctx and then adds the (converted) SELinux context to the audit
2169 * log by calling audit_log_format, thus also preventing leak of internal secid
2170 * to userspace. If secid cannot be converted audit_panic is called.
2172 void audit_log_secctx(struct audit_buffer
*ab
, u32 secid
)
2177 if (security_secid_to_secctx(secid
, &secctx
, &len
)) {
2178 audit_panic("Cannot convert secid to context");
2180 audit_log_format(ab
, " obj=%s", secctx
);
2181 security_release_secctx(secctx
, len
);
2184 EXPORT_SYMBOL(audit_log_secctx
);
2187 EXPORT_SYMBOL(audit_log_start
);
2188 EXPORT_SYMBOL(audit_log_end
);
2189 EXPORT_SYMBOL(audit_log_format
);
2190 EXPORT_SYMBOL(audit_log
);