Debian Codegraph @

upstream/debian-unstable/man3/audit_set_failure.3

raw
1 .TH "AUDIT_SET_FAILURE" "3" "June 2015" "Red Hat" "Linux Audit API"
2 .SH NAME
3 audit_set_failure \- Set audit failure flag
4 .SH "SYNOPSIS"
5
6 .B #include <libaudit.h>
7 .sp
8 .BI "int audit_set_failure(int" fd, uint32_t" failure);"
9
10 .SH "DESCRIPTION"
11
12 audit_set_failure sets the action that the kernel will perform when the backlog limit is reached or when it encounters an error and cannot proceed. Possible values are:
13
14 .TP
15 0 - AUDIT_FAIL_SILENT
16 Do nothing, report nothing, skip logging the record and continue.
17
18 .TP
19 1 - AUDIT_FAIL_PRINTK [default]
20 Log the audit record using printk which will cause subsequent events to get written to syslog.
21
22 .TP
23 2 - AUDIT_FAIL_PANIC
24 Call the panic function. This would be used to prevent use of the machine upon loss of audit events.
25
26 .SH "RETURN VALUE"
27
28 The return value is <= 0 on error, otherwise it is the netlink sequence id number. This function can have any error that sendto would encounter.
29
30 .SH "SEE ALSO"
31
32 .BR audit_set_backlog_limit (3),
33 .BR audit_open (3),
34 .BR auditd (8),
35 .BR auditctl (8).
36
37 .SH AUTHOR
38 Steve Grubb