OSDN Git Service

(split) LDP: Update release pages
[linuxjm/LDP_man-pages.git] / release / man3 / backtrace.3
index d007971..7a5477a 100644 (file)
@@ -43,15 +43,11 @@ backtrace, backtrace_symbols, backtrace_symbols_fd \- アプリケーション
 \fBvoid backtrace_symbols_fd(void *const\fP \fB*\fP\fIbuffer\fP\fB,\fP \fBint\fP
 \fIsize\fP\fB,\fP \fBint\fP \fIfd\fP\fB);\fP
 .SH 説明
-\fBbacktrace\fP()  returns a backtrace for the calling program, in the array
-pointed to by \fIbuffer\fP.  A backtrace is the series of currently active
-function calls for the program.  Each item in the array pointed to by
-\fIbuffer\fP is of type \fIvoid\ *\fP, and is the return address from the
-corresponding stack frame.  The \fIsize\fP argument specifies the maximum
-number of addresses that can be stored in \fIbuffer\fP.  If the backtrace is
-larger than \fIsize\fP, then the addresses corresponding to the \fIsize\fP most
-recent function calls are returned; to obtain the complete backtrace, make
-sure that \fIbuffer\fP and \fIsize\fP are large enough.
+\fBbacktrace\fP()  は、呼び出したプログラムのバックトレースを \fIbuffer\fP が指す配列に入れて返す。バックトレースは、プログラムで
+現在動作中の関数呼び出しの並びである。 \fIbuffer\fP が指す配列の個々の要素は \fIvoid\ *\fP 型で、
+対応するスタックフレームからのリターンアドレスである。 \fIsize\fP 引き数は \fIbuffer\fP に格納できるアドレスの最大個数を指定する。
+バックトレースが \fIsize\fP より大きい場合、 \fIsize\fP 個の直近の関数呼び出しに対応するアドレスが返される。
+完全なバックトレースを取得するためには、確実に \fIbuffer\fP と \fIsize\fP が十分大きくなるようにすること。
 
 \fBbacktrace\fP()  によって \fIbuffer\fP にアドレスの集合が得られたら、 \fBbacktrace_symbols\fP()
 によって、アドレス集合を、そのアドレスをシンボルで表した文字列の配列 に翻訳できる。 \fIsize\fP 引き数は \fIbuffer\fP