get_auditfail_action(3) — Linux manual page



NAME         top

       get_auditfail_action - Get failure_action tunable value

SYNOPSIS         top

       #include <libaudit.h>

       int get_auditfail_action (int *failmode);

DESCRIPTION         top

       This function gets the failure_action tunable value stored in
       /etc/libaudit.conf. get_auditfail_action should be called after an
       audit_open call returns an error to see what action the admin

       The failure_action value found in /etc/libaudit.conf is copied into
       the failmode argument upon function return.  This value should then
       be used by the calling application to determine what action should be
       taken when the audit subsystem is unavailable.

RETURN VALUE         top

       Upon success, get_auditfail_action returns a zero, and the failmode
       argument will hold the failure_action value.  The possible values for
       failure_action are: FAIL_IGNORE (0), FAIL_LOG (1), and FAIL_TERMINATE
       (2). Upon failure, get_auditfail_action returns a return code of one.

ERRORS         top

       An error is returned if there is an error reading /etc/libaudit.conf
       or if the failure_action tunable is not found in the file.

EXAMPLES         top

              /* Sample code */
              auditfail_t failmode;

              if ((fd = audit_open() ) < 0 ) {
                   fprintf (stderr, "Cannot open netlink audit socket");

                   /* Get the failure_action */
                   if ((rc = get_auditfail_action(&failmode)) == 0) {
                       if (failmode == FAIL_LOG)
                            fprintf (stderr, "Audit subsystem unavailable");
                       else if (failmode == FAIL_TERMINATE)
                            exit (1);
                       /* If failmode == FAIL_IGNORE, do nothing */

SEE ALSO         top

       audit_open(3), auditd(8).

AUTHOR         top

       Lisa M. Smith.

COLOPHON         top

       This page is part of the audit (Linux Audit) project.  Information
       about the project can be found at 
       ⟨⟩.  If you have a bug report
       for this manual page, send it to  This page
       was obtained from the project's upstream Git repository
       ⟨⟩ on 2020-09-18.
       (At that time, the date of the most recent commit that was found in
       the repository was 2020-09-07.)  If you discover any rendering prob‐
       lems in this HTML version of the page, or you believe there is a bet‐
       ter 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

Linux 2.7                         2006-7-10          GET_AUDITFAIL_ACTION(3)

Pages that refer to this page: libaudit.conf(5)