AUSEARCH_ADD_REGEX(3)          Linux Audit API         AUSEARCH_ADD_REGEX(3)

NAME         top

       ausearch_add_regex - use regular expression search rule

SYNOPSIS         top

       #include <auparse.h>

       int ausearch_add_regex(auparse_state_t *au, const char *expr);

DESCRIPTION         top

       ausearch_add_regex adds one search condition based on a regular
       expression to the current audit search expression. The search
       conditions can then be used to scan logs, files, or buffers for
       something of interest. The regular expression follows the posix
       extended regular expression conventions, and is matched against the
       full record (without interpreting field values).

       If an existing search expression E is already defined, this function
       replaces it by (E && this_regexp).

RETURN VALUE         top

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

SEE ALSO         top

       ausearch_add_expression(3), ausearch_add_item(3), ausearch_clear(3),
       ausearch_next_event(3), regcomp(3).

AUTHOR         top

       Steve Grubb

COLOPHON         top

       This page is part of the audit (Linux Audit) project.  Information
       about the project can be found at 
       ⟨⟩.  If you have a bug report
       for this manual page, send it to  This page
       was obtained from the project's upstream Git repository
       ⟨⟩ on 2020-02-08.
       (At that time, the date of the most recent commit that was found in
       the repository was 2020-02-07.)  If you discover any rendering prob‐
       lems in this HTML version of the page, or you believe there is a bet‐
       ter 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

Red Hat                           Sept 2007            AUSEARCH_ADD_REGEX(3)

Pages that refer to this page: ausearch_add_expression(3)ausearch_add_interpreted_item(3)ausearch_add_item(3)ausearch_add_timestamp_item(3)ausearch_add_timestamp_item_ex(3)ausearch_clear(3)ausearch_next_event(3)ausearch_set_stop(3)