UTRACE(2)

名称
utrace - ktrace のログの中へのユーザレコードの挿入

ライブラリ
libc

書式
<sys/types.h> <sys/param.h> <sys/time.h> <sys/uio.h> <sys/ktrace.h> int utrace(const void *addr, size_t len)

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

戻り値
成功して完了した時には、0 の値が返されます。 そうでない時には、-1 の値が返され、そのエラーを示すために errno が設定されます。

エラー

[EINVAL]
    指定されたデータの長さ len が KTR_USER_MAXLEN よりも大きいです。

[ENOMEM]
    要求を実現するためにはメモリが不足しています。

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

関連項目
kdump(1), ktrace(1), ktrace(2)

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