NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | EXAMPLES | SEE ALSO | AUTHOR | COLOPHON |
|
|
GET_AUDITFAIL_ACTION(3) Linux Programmer's ManualGET_AUDITFAIL_ACTION(3)
get_auditfail_action - Get failure_action tunable value
#include <libaudit.h> int get_auditfail_action(auditfail_t *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 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.
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.
/* 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 */ } }
audit_open(3), auditd(8).
Lisa M. Smith.
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)