Finds the first diagnostic log entry that matches the specified criteria.
#include <diag/diag_log.h> int dlog_find_next(dl_info *dlogInfo,int index,dlSearch *filter,dlEntry **results)
The dlog_find_next subroutine finds the first diagnostic log entry that matches the specified search filter. It allocates memory for the matching entry, and returns the array index of the matching entry. It is the responsibility of the calling application to free the memory allocated for dlEntry.
Parameter | Description |
---|---|
dlogInfo | Pointer to log information in dl_info |
index | Starting index |
filter | Parsed search criteria |
results | Pointer to entry matching the search criteria |
Call this function after calling dlog_find_first.
Upon successful completion, a value >= 0 is returned. Otherwise, a value of -1 is returned.