Records a trace event, including a time stamp, for a generic trace channel.
#include <sys/types.h> #include <sys/errno.h> #include <sys/trchkid.h>
void trcgenkt (chan, hk_word, data_word, len, buf) unsigned int chan, hk_word, data_word, len; char *buf;
chan | Specifies the channel number for the trace session. This number is obtained from the trcstart subroutine. | ||||
hk_word | An integer containing a hook ID and a hook type:
| ||||
data_word | Specifies a word of user-defined data. | ||||
len | Specifies the length, in bytes, of the buffer identified by the buf parameter. | ||||
buf | Points to a buffer of trace data. The maximum amount of trace data is 4096 bytes. |
The trcgenkt kernel service records a trace event if a trace session is active for the specified trace channel. If a trace session is not active, the trcgenkt service simply returns. The trcgenkt kernel service is located in pinned kernel memory.
The trcgenkt service records a trace entry consisting of an hk_word entry, a data_word entry, a variable number of bytes of trace data, and a time stamp.
The trcgenkt kernel service can be called from either the process or interrupt environment.
The trcgenkt service has no return values.
The trcgenkt kernel service is part of Base Operating System (BOS) Runtime.
The trace daemon.
The trcgenk kernel service.
The trcgen subroutine, trcgent subroutine, trchook subroutine, trcoff subroutine, trcon subroutine, trcstart subroutine, trcstop subroutine.
RAS Kernel Services in AIX Kernel Extensions and Device Support Programming Concepts.