man7.org > Linux > man-pages

Linux/UNIX system programming training

ausearch_next_event(3) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO | AUTHOR | COLOPHON 

AUSEARCH_NEXT_EVENT(3)       Linux Audit API       AUSEARCH_NEXT_EVENT(3)

NAME         top

       ausearch_next_event - find the next event that meets search
       criteria

SYNOPSIS         top

       #include <auparse.h>

       int ausearch_next_event(auparse_state_t *au);"

DESCRIPTION         top

       ausearch_next_event will scan the input source and evaluate
       whether any record in an event contains the data being searched
       for. Evaluation is done at the record level.

RETURN VALUE         top

       Returns -1 if an error occurs, 0 if no matches, and 1 for success.

SEE ALSO         top

       ausearch_add_item(3), ausearch_add_regex(3), ausearch_set_stop(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 
       ⟨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-08-11.  (At that time, the date of the most recent commit
       that was found in the repository was 2025-08-09.)  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

Red Hat                          Feb 2007          AUSEARCH_NEXT_EVENT(3)

Pages that refer to this page: ausearch_add_expression(3),  ausearch_add_interpreted_item(3),  ausearch_add_item(3),  ausearch_add_regex(3),  ausearch_add_timestamp_item(3),  ausearch_add_timestamp_item_ex(3),  ausearch_cur_event(3),  ausearch_set_stop(3)

HTML rendering created 2025-09-06 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.

Cover of TLPI