(split) LDP: Update releases based on LDP 3.52 release

[linuxjm/LDP_man-pages.git] / release / man3 / backtrace.3

diff --git a/release/man3/backtrace.3 b/release/man3/backtrace.3
index da2f315..d007971 100644 (file)
--- a/release/man3/backtrace.3
+++ b/release/man3/backtrace.3
@@ -1,6 +1,7 @@
 .\" Copyright (C) 2007 Michael Kerrisk <mtk.manpages@gmail.com>
 .\" drawing on material by Justin Pryzby <pryzbyj@justinpryzby.com>
 .\"
+.\" %%%LICENSE_START(PERMISSIVE_MISC)
 .\" Permission is hereby granted, free of charge, to any person obtaining
 .\" a copy of this software and associated documentation files (the
 .\" "Software"), to deal in the Software without restriction, including
@@ -19,6 +20,7 @@
 .\" CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
 .\" TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 .\" SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+.\" %%%LICENSE_END
 .\"
 .\" References:
 .\"   glibc manual and source
@@ -41,11 +43,15 @@ 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()  は、呼び出したプログラムのバックトレースを \fIbuffer\fP が指す配列に入れて返す。バックトレースは、プログラムで
-現在動作中の関数呼び出しの並びである。 \fIbuffer\fP が指す配列の個々の要素は \fIvoid *\fP 型で、
-対応するスタックフレームからのリターンアドレスである。 \fIsize\fP 引き数は \fIbuffer\fP に格納できるアドレスの最大個数を指定する。
-バックトレースが \fIsize\fP より大きい場合、 \fIsize\fP 個の直近の関数呼び出しに対応するアドレスが返される。
-完全なバックトレースを取得するためには、確実に \fIbuffer\fP と \fIsize\fP が十分大きくなるようにすること。
+\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 にアドレスの集合が得られたら、 \fBbacktrace_symbols\fP()
 によって、アドレス集合を、そのアドレスをシンボルで表した文字列の配列 に翻訳できる。 \fIsize\fP 引き数は \fIbuffer\fP
@@ -164,6 +170,6 @@ main(int argc, char *argv[])
 .SH 関連項目
 \fBgcc\fP(1), \fBld\fP(1), \fBdlopen\fP(3), \fBmalloc\fP(3)
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.40 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。