To Next Page

To Previous Page

IBM® Carrier Grade Server X3650 T

Revision 3.0

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.

IBM Carrier Grade X3650 T User Manual

Questions and Answers: