| 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 |