trcgenk カーネル・サービス

目的

汎用トレース・チャネルのトレース・イベントを記録します。

構文

#include <sys/types.h>
#include <sys/errno.h>
#include <sys/trchkid.h>

void trcgenk (chan, hk_word, data_word, len, buf) unsigned int chan, hk_word, data_word, len; char * buf;

パラメーター

項目	説明
Chan	トレース・セッションのチャネル番号を指定します。この番号は、 Trcstart サブルーチンから取得されます。
HK ワード	フック ID とフックタイプを含む整数です。 HKID AIX® 6.1以前のフック識別子は12ビット値である。 AIX 6.1 以上では、フック ID は 16 ビットの値です。 hhh0 という形式の 16 ビット値は、hhh という形式の 12 ビット値に相当します。 HK タイプ 4 ビットのフック型。 Trcgenk サービスは、この情報を自動的に記録します。この値は、 AIX 6.1より前でのみ有効です。
データ・ワード	ユーザー定義データのワードを指定します。
len	ブフパラメーターで指定されたバッファーの長さ (バイト単位) を指定します。
buf	トレース・データのバッファーを指します。トレース・データの最大量は 4096 バイトです。

説明

指定されたトレース・チャネルのトレース・セッションがアクティブな場合、 Trcgenk カーネル・サービスはトレース・イベントを記録します。トレース・セッションがアクティブでない場合、 Trcgenk カーネル・サービスは単に戻ります。 Trcgenk カーネル・サービスは、固定されたカーネル・メモリー内にあります。

trcgenk カーネル・サービスは、 hk_word 項目、 data_word 項目、可変数のバイト数のトレース・データ、および AIX 5L バージョン 5.3 (5300-05 テクノロジー・レベル以上) のタイム・スタンプで構成されるトレース項目を記録するために使用されます。

実行環境

Trcgenk カーネル・サービスは、処理環境または割り込み環境のいずれかから呼び出すことができます。

戻り値

Trcgenk カーネル・サービスには戻り値はありません。