---
name: "ausearch_next_event"
section: "3"
platform: "linux"
package: "audit"
version: "4.2.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/ausearch_next_event"
---

# ausearch\_next\_event(3)

find the next event that meets search criteria

## NAME

ausearch\_next\_event - find the next event that meets search criteria

## SYNOPSIS

**#include \<auparse.h\>**

**int ausearch\_next\_event(auparse\_state\_t \****au);"*

## DESCRIPTION

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

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

## SEE ALSO

[**ausearch\_add\_item**(3)](/ausearch_add_item/3.md), [**ausearch\_add\_regex**(3)](/ausearch_add_regex/3.md), [**ausearch\_set\_stop**(3)](/ausearch_set_stop/3.md).

## AUTHOR

Steve Grubb