Retrieves the trace event name from a trace event type identifier.
Posix Trace Library (libposixtrace.a)
#include <trace.h>
int posix_trace_eventid_get_name(trid, event, event_name)
trace_id_t trid;
trace_event_id_t event;
char *event_name;
The posix_trace_eventid_get_name subroutine returns the trace event name associated with the trace event type identifier for a trace stream or a trace log in the argument pointed to by the event_name parameter. The event argument defines the trace event type identifier. The trid argument defines the trace stream or the trace log. The name of the trace event will have a maximum number of characters defined in the TRACE_EVENT_NAME_MAX variable, which has the minimum value _POSIX_TRACE_EVENT_NAME_MAX. Successive calls to this subroutine with the same trace event type identifier and the same trace stream identifier return the same event name.
Item | Description |
---|---|
trid | Specifies the trace stream identifier. |
event | Specifies the trace event identifier. |
event_name | Specifies the trace event name. |
On successful completion, the posix_trace_eventid_get_name subroutine returns a value of zero. Otherwise, it returns the corresponding error number.
If successful, the posix_trace_eventid_get_name subroutine stores the trace event name value in the object pointed to by the event_name parameter.
Item | Description |
---|---|
EINVAL | The trid argument is not a valid trace stream identifier. The trace event type identifier event is not associated with any name. |
The trace.h file in AIX® Version 7.1 Files Reference.