audit_add_rule_data (3) Linux Manual Page
NAME
audit_add_rule_data – Add new audit rule
SYNOPSIS
#include <libaudit.h>
int audit_add_rule_data (int fd, struct audit_rule_data *rule, int flags, int action);
DESCRIPTION
audit_add_rule adds an audit rule previously constructed with audit_rule_fieldpair_data(3) to one of several kernel event filters. The filter is specified by the flags argument. Possible values for flags are:
- •
- AUDIT_FILTER_USER – Apply rule to userspace generated messages.
- •
- AUDIT_FILTER_TASK – Apply rule at task creation (not syscall).
- •
- AUDIT_FILTER_EXIT – Apply rule at syscall exit.
- •
- AUDIT_FILTER_TYPE – Apply rule at audit_log_start.
The rule’s action has two possible values:
- •
- AUDIT_NEVER – Do not build context if rule matches.
- •
- AUDIT_ALWAYS – Generate audit record if rule matches.
RETURN VALUE
The return value is <= 0 on error, otherwise it is the netlink sequence id number. This function can have any error that sendto would encounter.
SEE ALSO
audit_rule_fieldpair_data(3), audit_delete_rule_data(3), auditctl(8).
AUTHOR
Steve Grubb.