|
HTML rendering created 2025-02-02 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
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(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 in‐
to 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 returns
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. 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
2025-02-02. (At that time, the date of the most recent commit
that was found in the repository was 2025-01-31.) 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)
|
HTML rendering created 2025-02-02 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|