bionic (3) get_auditfail_action.3.gz

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.