gobj_add_trace_filter()

`gobj_add_trace_filter()`#

Adds a trace filter to a given gclass, allowing selective tracing based on attribute values.

C

Prototype

int gobj_add_trace_filter(
    hgclass gclass,
    const char *attr,
    const char *value
);

Parameters

Key	Type	Description
`gclass`	`hgclass`	The gclass to which the trace filter will be applied.
`attr`	`const char *`	The attribute name to filter traces on.
`value`	`const char *`	The attribute value that must match for tracing to be enabled.

Return Value

Returns 0 on success, or -1 if the attribute is invalid or the gclass does not support the specified attribute.

Notes

This function allows filtering trace messages based on specific attribute values. If the attribute does not exist in hgclass, an error is logged.

JS

Prototype

// Not applicable in JS

Python

Prototype

# Not applicable in Python