copyinstr()

string copyinstr(uintptr_t addr)

copyinstr() は、指定されたユーザーアドレス addr から DTrace スクラッチバッファーに、NULL で終了する C 文字列をコピーし、このバッファーのアドレスを返します。ユーザーアドレスは、現在のスレッドに関連付けられたプロセスの空間に含まれるアドレスであると見なされます。文字列長は、strsize オプションで設定された値以下に制限されます。詳細については、第 16 章オプションとチューニング可能パラメータを参照してください。copyin の場合と同じく、指定されたアドレスは、現在のプロセス内のフォルトインページに対応している必要があります。アドレスがフォルトインページに対応していない場合や、使用できるスクラッチ空間が不足している場合は、NULL が返され、エラーが生成されます。第 33 章ユーザープロセスのトレース エラーが発生する可能性を減らすテクニックについては、Chapter 33, User Process Tracingを参照してください。