|
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | EXAMPLES | SEE ALSO | AUTHOR | COLOPHON |
GET_AUDITFAIL_ACTION(3) Linux Programmer's Manual GET_AUDITFAIL_ACTION(3)
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 */
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 */
}
}
audit_open(3), auditd(8).
Lisa M. Smith.
This page is part of the audit (Linux Audit) project. Information
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 linux-audit@redhat.com. This page
was obtained from the project's upstream Git repository
⟨https://github.com/linux-audit/audit-userspace.git⟩ on 2017-07-05.
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 man-pages@man7.org
Linux 2.7 2006-7-10 GET_AUDITFAIL_ACTION(3)
Pages that refer to this page: libaudit.conf(5)