<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 ----------------------------------------