1GDB-ADD-INDEX(1) GNU Development Tools GDB-ADD-INDEX(1)
2
3
4
6 gdb-add-index - Add index files to speed up GDB
7
9 gdb-add-index filename
10
12 When GDB finds a symbol file, it scans the symbols in the file in order
13 to construct an internal symbol table. This lets most GDB operations
14 work quickly--at the cost of a delay early on. For large programs,
15 this delay can be quite lengthy, so GDB provides a way to build an
16 index, which speeds up startup.
17
18 To determine whether a file contains such an index, use the command
19 "readelf -S filename": the index is stored in a section named
20 ".gdb_index". The index file can only be produced on systems which use
21 ELF binaries and DWARF debug information (i.e., sections named
22 ".debug_*").
23
24 gdb-add-index uses GDB and objdump found in the PATH environment
25 variable. If you want to use different versions of these programs, you
26 can specify them through the GDB and OBJDUMP environment variables.
27
28 See more in the GDB manual in node "Index Files" -- shell command "info
29 -f gdb -n "Index Files"".
30
33 The full documentation for GDB is maintained as a Texinfo manual. If
34 the "info" and "gdb" programs and GDB's Texinfo documentation are
35 properly installed at your site, the command
36
37 info gdb
38
39 should give you access to the complete manual.
40
41 Using GDB: A Guide to the GNU Source-Level Debugger, Richard M.
42 Stallman and Roland H. Pesch, July 1991.
43
45 Copyright (c) 1988-2023 Free Software Foundation, Inc.
46
47 Permission is granted to copy, distribute and/or modify this document
48 under the terms of the GNU Free Documentation License, Version 1.3 or
49 any later version published by the Free Software Foundation; with the
50 Invariant Sections being "Free Software" and "Free Software Needs Free
51 Documentation", with the Front-Cover Texts being "A GNU Manual," and
52 with the Back-Cover Texts as in (a) below.
53
54 (a) The FSF's Back-Cover Text is: "You are free to copy and modify this
55 GNU Manual. Buying copies from GNU Press supports the FSF in
56 developing GNU and promoting software freedom."
57
58
59
60gdb-14.1-1.fc39 2023-12-07 GDB-ADD-INDEX(1)