man7.org > Linux > man-pages

Linux/UNIX system programming training

ausearch_set_stop(3) — Linux manual page

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

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:

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

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

              AUSEARCH_STOP_FIELD
                     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),
       ausearch_cur_event(3), ausearch_next_event(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
       2024-06-14.  (At that time, the date of the most recent commit
       that was found in the repository was 2024-06-12.)  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_SET_STOP(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_cur_event(3),  ausearch_next_event(3)

HTML rendering created 2024-06-26 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