get_auditfail_action(3) — Linux manual page

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

GET_AUDITFAIL_ACTION(3) Linux Programmer's ManualGET_AUDITFAIL_ACTION(3)

NAME         top

       get_auditfail_action - Get failure_action tunable value

SYNOPSIS         top

       #include <libaudit.h>

       int get_auditfail_action(auditfail_t *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
       prefers.

       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 
       ⟨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
       2023-12-22.  (At that time, the date of the most recent commit
       that was found in the repository was 2023-11-30.)  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

Linux 2.7                       2006-7-10        GET_AUDITFAIL_ACTION(3)

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