docs/ausearch_next_event.3

   1 .TH "AUSEARCH_NEXT_EVENT" "3" "Feb 2007" "Red Hat" "Linux Audit API"
   2 .SH NAME
   3 ausearch_next_event \- find the next event that meets search criteria
   4 .SH "SYNOPSIS"
   5 .B #include <auparse.h>
   6 .sp
   7 int ausearch_next_event(auparse_state_t *au);
   8
   9 .SH "DESCRIPTION"
  10
  11 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.
  12
  13 .SH "RETURN VALUE"
  14
  15 Returns \-1 if an error occurs, 0 if no matches, and 1 for success.
  16
  17 .SH "SEE ALSO"
  18
  19 .BR ausearch_add_item (3),
  20 .BR ausearch_add_regex (3),
  21 .BR ausearch_set_stop (3).
  22
  23 .SH AUTHOR
  24 Steve Grubb