Query the diagnostic event log for entries matching an input criteria.
#include <diag/diag_log.h> int dlog_query(query_log *criteria, query_results *results)
The dlog_query subroutine queries the diagnostic event log for entries matching an input criteria.
| criteria | Criteria used to search the diagnostic event log. Unused fields must be set to 0. |
| results | Structure containing a pointer to a list of entries matching the input criteria.Entries are returned sorted by diagnostic event log sequence number (highest first). |
The dlog_query subroutine returns one of the following values:
| 0 | If successful |
| -1 | The diagnostic event log could not be opened |
| -2 | An error occurs reading from the diagnostic event log |
| -3 | The search criteria is invalid |
| -4 | Memory could not be allocated |