Linux Certif

Toute la documentation sur la certification Linux LPI

ausearch_add_item

NAME

ausearch_add_item - build up search rule

SYNOPSIS

#include <auparse.h>

int ausearch_add_item(auparse_state_t *au, const char *field, const char *op, const char *value, ausearch_rule_t how);

DESCRIPTION

ausearch_add_item adds one search condition to the audit search API. The search conditions can then be used to scan logs, files, or buffers for something of interest. The field value is the field name that the value will be checked for. The op variable describes what kind of check is to be done. Legal op values are:

exists

 just check that a field name exists

=

 locate the field name and check that the value associated with it is equal to the value given in this rule.

!=

 locate the field name and check that the value associated with it is NOT equal to the value given in this rule.

The how value determines how this search condition will be stored internally. The possible values are:

AUSEARCH_RULE_CLEAR

When this is used, it clears any previous search condition and inserts it as the first one.

AUSEARCH_RULE_OR

When this is used, it means that the results of its evaluation will be "or"ed with other search conditions.

AUSEARCH_RULE_AND

When this is used, it means that the results of its evaluation will be "and"ed with other search conditions.

All search conditions must be the same type, you cannot mix "and" and "or".

RETURN VALUE

Returns -1 if an error occurs; otherwise, 0 for success.

SEE ALSO

ausearch_add_regex(3), ausearch_set_stop(3), ausearch_clear(3), ausearch_next_event(3).

AUTHOR

Steve Grubb