NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO | AUTHOR | COLOPHON

AUDIT_SET_FAILURE(3)           Linux Audit API          AUDIT_SET_FAILURE(3)

NAME         top

       audit_set_failure - Set audit failure flag

SYNOPSIS         top

       #include <libaudit.h>

       int audit_set_failure(int fd, int failure);

DESCRIPTION         top

       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:

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

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

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

RETURN VALUE         top

       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.

SEE ALSO         top

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

AUTHOR         top

       Steve Grubb

COLOPHON         top

       This page is part of the audit (Linux Audit) project.  Information
       about the project can be found at 
       ⟨http://people.redhat.com/sgrubb/audit/⟩.  If you have a bug report
       for this manual page, send it to linux-audit@redhat.com.  This page
       was obtained from the project's upstream Git repository 
       ⟨https://github.com/linux-audit/audit-userspace.git⟩ on 2017-03-13.
       If you discover any rendering problems in this HTML version of the
       page, or you believe there is a better or more up-to-date source for
       the page, or you have corrections or improvements to the information
       in this COLOPHON (which is not part of the original manual page),
       send a mail to man-pages@man7.org

Red Hat                           June 2015             AUDIT_SET_FAILURE(3)