名称

utrace — ktrace ログにユーザレコードを挿入する

ライブラリ

Standard C Library (libc, -lc)

書式

#include < sys/types.h>
#include < sys/param.h>
#include < sys/time.h>
#include < sys/uio.h>
#include < sys/ktrace.h>

int
utrace( const void *addr, size_t len);

解説

ユーザによって供給された情報を付けてプロセストレースにレコードを追加します。レコードは、 addr に指されたメモリから len バイトを含んでいます。この呼び出しは、呼び出しているプロセスがトレースされている場合のみ、効果があります。

戻り値

Upon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

エラー

[ EINVAL]

指定されたデータ長 len が KTR_USER_MAXLEN より大きかった。

[ ENOMEM]

要求を引き受けるためのメモリが不足しています。

[ ENOSYS]

現在実行中のカーネルが ktrace(2) のサポート ( options KTRACE) を外してコンパイルされています。現在実行しているカーネルが ktrace(2) をサポートする ( options KTRACE) なしでコンパイルされました。

関連項目

kdump(1), ktrace(1), ktrace(2)

歴史

utrace() システムコールは、 FreeBSD 2.2 ではじめて登場しました。