get_auditfail_action






get_auditfail_action − Get failure_action tunable value



#include <libaudit.h>

int get_auditfail_action (int *failmode);





     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.





     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.





     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.





            /* Sample code */
       auditfail_t failmode;

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

            /* Get the failure_action */









                             ‐2‐


            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 */
            }
       }






Lisa M. Smith.