File: audit_set_failure.3

package info (click to toggle)
audit 1:2.4-1
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-backports, jessie-kfreebsd
  • size: 5,308 kB
  • ctags: 5,589
  • sloc: ansic: 47,383; sh: 11,886; python: 1,949; makefile: 824
file content (38 lines) | stat: -rw-r--r-- 1,039 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
.TH "AUDIT_SET_FAILURE" "3" "Oct 2006" "Red Hat" "Linux Audit API"
.SH NAME
audit_set_failure \- Set audit failure flag
.SH "SYNOPSIS"

.B #include <libaudit.h>
.sp
int audit_set_failure (int fd, int failure);

.SH "DESCRIPTION"

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:

.TP
0 - AUDIT_FAIL_PRINTK [default]
Log the audit record using printk which will cause subsequent events to get written to syslog.

.TP
1 - AUDIT_FAIL_SILENT
Do nothing, report nothing, skip logging the record and continue.

.TP
2 - AUDIT_FAIL_PANIC
Call the panic function. This would be used to prevent use of the machine upon loss of audit events.

.SH "RETURN VALUE"

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.

.SH "SEE ALSO"

.BR audit_set_backlog (3),
.BR audit_open (3),
.BR auditd (8),
.BR auditctl (8).

.SH AUTHOR
Steve Grubb