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 possi‐
       ble values for failure_action are: FAIL_IGNORE (0), FAIL_LOG (1),
       and FAIL_TERMINATE (2). Upon  failure,  get_auditfail_action  re‐
       turns a return code of one.

ERRORS         top

       An  error  is  returned  if there is an error reading /etc/libau‐
       dit.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 unavail‐
       able");
                       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.   Informa‐
       tion    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 [email protected].
       This page was obtained from the project's upstream Git repository
       ⟨https://github.com/linux-audit/audit-userspace.git⟩           on
       2024-06-14.   (At  that  time, the date of the most recent commit
       that was  found  in  the  repository  was  2024-06-12.)   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 [email protected]

Linux 2.7                       2006-7-10        GET_AUDITFAIL_ACTION(3)

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