AUSEARCH_SET_STOP(3)           Linux Audit API          AUSEARCH_SET_STOP(3)

NAME         top

        ausearch_set_stop - set the cursor position

SYNOPSIS         top

       #include <auparse.h>

       int ausearch_set_stop(auparse_state_t *au, austop_t where);

DESCRIPTION         top

       ausearch_set_stop determines where the internal cursor will stop when
       a search condition is met. The possible values are:

                     This one repositions the cursors to the first field of
                     the first record of the event containing the items
                     searched for.

                     This one repositions the cursors to the first field of
                     the record containing the items searched for.

                     This one simply stops on the current field when the
                     evaluation of the rules becomes true.

RETURN VALUE         top

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

SEE ALSO         top

       ausearch_add_item(3), ausearch_add_regex(3), ausearch_clear(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 2017-03-13.
       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

Red Hat                           Feb 2007              AUSEARCH_SET_STOP(3)