[JM:02597] [POST:DP] GNU gdb 10.2 gdb-add-index.1

アーカイブの一覧に戻る
matsuand michio_matsu****@yahoo*****
2021年 7月 4日 (日) 13:58:21 JST


<STATUS>
stat: DP
ppkg: GNU gdb 10.2
page: gdb-add-index.1
date: 2021/04/25
mail: michio_matsu****@yahoo*****
name: Michio MATSUYAMA
</STATUS>

.\"O .TH GDB-ADD-INDEX 1 "2021-04-25" "gdb-10.2" "GNU Development Tools"
.\"O .if n .ad l
.\"O .nh
.TH GDB\-ADD\-INDEX 1 2021\-04\-25 gdb\-10.2 "GNU Development Tools"
.if  n .ad l
.nh
.\"O ----------------------------------------
.\"O .SH "NAME"
.\"O gdb\-add\-index \- Add index files to speed up GDB
.SH 名前
gdb\-add\-index \- GDB 処理を高速にするインデックスファイルの追加
.\"O ----------------------------------------
.\"O .SH "SYNOPSIS"
.\"O .IX Header "SYNOPSIS"
.\"O gdb-add-index \fIfilename\fR
.SH 書式
.IX Header 書式
gdb\-add\-index \fIfilename\fP
.\"O ----------------------------------------
.\"O .SH "DESCRIPTION"
.\"O .IX Header "DESCRIPTION"
.\"O When \s-1GDB\s0 finds a symbol file, it scans the symbols in the
.\"O file in order to construct an internal symbol table.  This lets most
.\"O \&\s-1GDB\s0 operations work quickly\*(--at the cost of a delay early on.
.\"O For large programs, this delay can be quite lengthy, so \s-1GDB\s0
.\"O provides a way to build an index, which speeds up startup.
.SH 説明
.IX Header 説明
\s-1GDB\s0 が 1 つのシンボルファイル内を検索する際には、 そのファイル内のシンボルをスキャンして、 内部シンボルテーブルを構成します。
これにより \&\s-1GDB\s0 のたいていの処理は高速になります。 ただし初期起動に若干の遅延が発生します。
プログラムが大きくなると、この遅延はかなり大きくなります。 そこで \s-1GDB\s0 では、 インデックスの構築機能を提供して、
起動時の高速化を図っています。
.\"O ----------------------------------------
.\"O .PP
.\"O To determine whether a file contains such an index, use the command
.\"O \&\f(CW\*(C`readelf \-S filename\*(C'\fR: the index is stored in a section named
.\"O \&\f(CW\*(C`.gdb_index\*(C'\fR.  The index file can only be produced on systems
.\"O which use \s-1ELF\s0 binaries and \s-1DWARF\s0 debug information (i.e., sections
.\"O named \f(CW\*(C`.debug_*\*(C'\fR).
.PP
ファイル内にそのようなインデックスが含まれているかどうかは、 コマンド \&\f(CW\*(C`readelf \-S filename\*(C'\fP
を使って確認します。 インデックスは \&\f(CW\*(C`.gdb_index\*(C'\fP というセクションに保存されています。
インデックスファイルは、 \s-1ELF\s0 バイナリおよび \s-1DWARF\s0 デバッグ情報 (つまり
\f(CW\*(C`.debug_*\*(C'\fP というセクション) を扱うシステムにおいてのみ生成されます。
.\"O ----------------------------------------
.\"O .PP
.\"O \&\fBgdb-add-index\fR uses \s-1GDB\s0 and \fBobjdump\fR found
.\"O in the \fB\s-1PATH\s0\fR environment variable.  If you want to use different
.\"O versions of these programs, you can specify them through the
.\"O \&\fB\s-1GDB\s0\fR and \fB\s-1OBJDUMP\s0\fR environment variables.
.PP
\&\fBgdb\-add\-index\fP は、 環境変数 \fB\s-1PATH\s0\fP 上に見つかった \s-1GDB\s0 と \fBobjdump\fP
を利用します。 そのプログラムの別バージョンを利用したい場合は、 環境変数 \&\fB\s-1GDB\s0\fP と \fB\s-1OBJDUMP\s0\fP
を用いて設定してください。
.\"O ----------------------------------------
.\"O .PP
.\"O See more in
.\"O the \s-1GDB\s0 manual in node \f(CW\*(C`Index Files\*(C'\fR
.\"O \&\*(-- shell command \f(CW\*(C`info \-f gdb \-n "Index Files"\*(C'\fR.
.PP
詳しくは \s-1GDB\s0 マニュアルの \f(CW\*(C`Index Files\*(C'\fP ノードを参照してください。 シェルコマンドでは
\f(CW\*(C`info \-f gdb \-n "Index Files"\*(C'\fP を実行します。
.\"O ----------------------------------------
.\"O .SH "OPTIONS"
.\"O .IX Header "OPTIONS"
.SH オプション
.IX Header オプション
.\"O ----------------------------------------
.\"O .SH "SEE ALSO"
.\"O .IX Header "SEE ALSO"
.\"O The full documentation for \s-1GDB\s0 is maintained as a Texinfo manual.
.\"O If the \f(CW\*(C`info\*(C'\fR and \f(CW\*(C`gdb\*(C'\fR programs and \s-1GDB\s0's Texinfo
.\"O documentation are properly installed at your site, the command
.SH 関連項目
.IX Header 関連項目
\s-1GDB\s0 の完全なドキュメントは Texinfo マニュアルとしてメンテナンスされています。\f(CW\*(C`info\*(C'\fP と
\f(CW\*(C`gdb\*(C'\fP の両プログラム、および \s-1GDB\s0 の Texinfo
ドキュメントが適切にインストールされていれば、以下のコマンド
.\"O ----------------------------------------
.\"O .PP
.\"O .Vb 1
.\"O \&        info gdb
.\"O .Ve
.PP
.Vb 1
\& info gdb
.Ve
.\"O ----------------------------------------
.\"O .PP
.\"O should give you access to the complete manual.
.PP
を実行して完全なマニュアルを参照できます。
.\"O ----------------------------------------
.\"O .PP
.\"O \&\fIUsing \s-1GDB: A\s0 Guide to the \s-1GNU\s0 Source-Level Debugger\fR,
.\"O Richard M. Stallman and Roland H. Pesch, July 1991.
.PP
\&\fIUsing \s-1GDB: A\s0 Guide to the \s-1GNU\s0 Source\-Level Debugger\fP,
Richard M. Stallman and Roland H. Pesch, July 1991.
.\"O ----------------------------------------
.\"O .SH "COPYRIGHT"
.\"O .IX Header "COPYRIGHT"
.\"O Copyright (c) 1988\-2021 Free Software Foundation, Inc.
.SH 著作権
.IX Header 著作権
Copyright (c) 1988\-2021 Free Software Foundation, Inc.
.\"O ----------------------------------------
.\"O .PP
.\"O Permission is granted to copy, distribute and/or modify this document
.\"O under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3 or
.\"O any later version published by the Free Software Foundation; with the
.\"O Invariant Sections being \*(L"Free Software\*(R" and \*(L"Free Software Needs
.\"O Free Documentation\*(R", with the Front-Cover Texts being \*(L"A \s-1GNU\s0 Manual,\*(R"
.\"O and with the Back-Cover Texts as in (a) below.
.PP
Permission is granted to copy, distribute and/or modify this document under
the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3 or any
later version published by the Free Software Foundation; with the Invariant
Sections being \*(L"Free Software\*(R" and \*(L"Free Software Needs Free
Documentation\*(R", with the Front\-Cover Texts being \*(L"A \s-1GNU\s0
Manual,\*(R" and with the Back\-Cover Texts as in (a) below.
.\"O ----------------------------------------
.\"O .PP
.\"O (a) The \s-1FSF\s0's Back-Cover Text is: \*(L"You are free to copy and modify
.\"O this \s-1GNU\s0 Manual.  Buying copies from \s-1GNU\s0 Press supports the \s-1FSF\s0 in
.\"O developing \s-1GNU\s0 and promoting software freedom.\*(R"
.PP
(a) \s-1FSF\s0 の裏表紙には、 以下の文章が記述されています: \*(L"You are free to copy and modify
this \s-1GNU\s0 Manual.  Buying copies from \s-1GNU\s0 Press supports the
\s-1FSF\s0 in developing \s-1GNU\s0 and promoting software freedom.\*(R"
.\"O ----------------------------------------



linuxjm-discuss メーリングリストの案内
アーカイブの一覧に戻る