SIMPLE SOLUTIONS

GET_AUDITFAIL_ACTION(3) - Linux man page online | Library functions

Get failure_action tunable value.

Chapter
2006-7-10
GET_AUDITFAIL_ACTION(3) Linux Programmer's Manual GET_AUDITFAIL_ACTION(3)

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_au‐ ditfail_action should be called after an audit_open call returns an error to see what ac‐ tion 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 deter‐ mine 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_ac‐ tion 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.
Linux 2.7 2006-7-10 GET_AUDITFAIL_ACTION(3)
This manual Reference Other manuals
get_auditfail_action(3) referred by libaudit.conf(5)
refer to audit_open(3) | auditd(8)
Download raw manual
Main page Linux Programmer's Manual (+2508) Linux 2.7 (+1) № 3 (+68044)
Go top