IBM® Carrier Grade Server X3650 T
Revision 3.0
97
17.2.9.1 Synopsis
#include <syscon.h>
int syscon_log_query_destroy(syscon_log_query_t *query);
17.2.9.2 Description
The
syscon_log_query_destroy
() function destroys the log query object pointed to by the
query
argument;
the object becomes, in effect, uninitialized. Memory allocated to the query object itself is not deal located,
but any associated data structures allocated by the
syscon_log_query_create
() function may be deal
located.
A destroyed query object can be reinitialized using
syscon_log_query_create
(). The effect of otherwise
referencing the object after it has been destroyed is undefined.
17.2.9.3 Returns
Upon successful completion,
syscon_log_query_destroy
() shall return zero. Otherwise, an error number
shall be returned to indicate the error.
17.2.9.4 Errors
If any of the following conditions occur, the
syscon_log_query_destroy
() function shall return the
corresponding error number:
[EINVAL]: The
query
argument does not point to a valid query object, as initialized by
syscon_log_query_create
().
17.2.9.5 Cross-References
syscon_log_query_create()
17.2.10
Test Event Record against Query Criteria
Function: syscon_log_query_match()
17.2.10.1 Synopsis
#include <syscon.h>
int syscon_log_query_match(const syscon_log_query_t *query,
const struct syscon_log_entry *entry, const void *buf,
int *match);
17.2.10.2 Description
The
syscon_log_query_match
() function tests the event record specified by the
entry
and
buf
arguments
against the query object pointed to by the
query
argument. If the event record matches the query (that is,
the query expression evaluates to true for that record’s attributes), the value 1 shall be stored at the
location pointed to by the
match
argument; otherwise, the value zero shall be stored there.
The
entry
argument shall point to the event record’s
syscon_log_entry
struct. If the value of
entry
-
>
log_size
is not zero,
buf
shall point to the event record’s variable-length data. Otherwise,
buf
shall be
NULL
. The
query
argument shall not be
NULL
.
Summary of Contents for Carrier Grade X3650 T
Page 8: ...IBM Carrier Grade Server X3650 T Revision 3 0 viii This page intentionally left blank...
Page 12: ...IBM Carrier Grade Server X3650 T Revision 3 0 4...
Page 15: ...IBM Carrier Grade Server X3650 T Revision 3 0 7...
Page 17: ...IBM Carrier Grade Server X3650 T Revision 3 0 9...
Page 25: ...IBM Carrier Grade Server X3650 T Revision 3 0 17...
Page 43: ...IBM Carrier Grade Server X3650 T Revision 3 0 35...