NAME

       get_auditfail_action - Get failure_action tunable value

SYNOPSIS

       #include <libaudit.h>

       int get_auditfail_action (int *failmode);

DESCRIPTION

       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

       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

       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

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

       audit_open(3), auditd(8).

AUTHOR

       Lisa M. Smith.