You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
167 lines
8.0 KiB
HTML
167 lines
8.0 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<html>
|
|
<!-- Copyright (C) 1988-2019 Free Software Foundation, Inc.
|
|
|
|
Permission is granted to copy, distribute and/or modify this document
|
|
under the terms of the GNU Free Documentation License, Version 1.3 or
|
|
any later version published by the Free Software Foundation; with the
|
|
Invariant Sections being "Free Software" and "Free Software Needs
|
|
Free Documentation", with the Front-Cover Texts being "A GNU Manual,"
|
|
and with the Back-Cover Texts as in (a) below.
|
|
|
|
(a) The FSF's Back-Cover Text is: "You are free to copy and modify
|
|
this GNU Manual. Buying copies from GNU Press supports the FSF in
|
|
developing GNU and promoting software freedom." -->
|
|
<!-- Created by GNU Texinfo 6.4, http://www.gnu.org/software/texinfo/ -->
|
|
<head>
|
|
<title>Startup (Debugging with GDB)</title>
|
|
|
|
<meta name="description" content="Startup (Debugging with GDB)">
|
|
<meta name="keywords" content="Startup (Debugging with GDB)">
|
|
<meta name="resource-type" content="document">
|
|
<meta name="distribution" content="global">
|
|
<meta name="Generator" content="makeinfo">
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<link href="index.html#Top" rel="start" title="Top">
|
|
<link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
|
|
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
|
|
<link href="Invoking-GDB.html#Invoking-GDB" rel="up" title="Invoking GDB">
|
|
<link href="Quitting-GDB.html#Quitting-GDB" rel="next" title="Quitting GDB">
|
|
<link href="Mode-Options.html#Mode-Options" rel="prev" title="Mode Options">
|
|
<style type="text/css">
|
|
<!--
|
|
a.summary-letter {text-decoration: none}
|
|
blockquote.indentedblock {margin-right: 0em}
|
|
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
|
|
blockquote.smallquotation {font-size: smaller}
|
|
div.display {margin-left: 3.2em}
|
|
div.example {margin-left: 3.2em}
|
|
div.lisp {margin-left: 3.2em}
|
|
div.smalldisplay {margin-left: 3.2em}
|
|
div.smallexample {margin-left: 3.2em}
|
|
div.smalllisp {margin-left: 3.2em}
|
|
kbd {font-style: oblique}
|
|
pre.display {font-family: inherit}
|
|
pre.format {font-family: inherit}
|
|
pre.menu-comment {font-family: serif}
|
|
pre.menu-preformatted {font-family: serif}
|
|
pre.smalldisplay {font-family: inherit; font-size: smaller}
|
|
pre.smallexample {font-size: smaller}
|
|
pre.smallformat {font-family: inherit; font-size: smaller}
|
|
pre.smalllisp {font-size: smaller}
|
|
span.nolinebreak {white-space: nowrap}
|
|
span.roman {font-family: initial; font-weight: normal}
|
|
span.sansserif {font-family: sans-serif; font-weight: normal}
|
|
ul.no-bullet {list-style: none}
|
|
-->
|
|
</style>
|
|
|
|
|
|
</head>
|
|
|
|
<body lang="en">
|
|
<a name="Startup"></a>
|
|
<div class="header">
|
|
<p>
|
|
Previous: <a href="Mode-Options.html#Mode-Options" accesskey="p" rel="prev">Mode Options</a>, Up: <a href="Invoking-GDB.html#Invoking-GDB" accesskey="u" rel="up">Invoking GDB</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
|
|
</div>
|
|
<hr>
|
|
<a name="What-GDB-Does-During-Startup"></a>
|
|
<h4 class="subsection">2.1.3 What <small>GDB</small> Does During Startup</h4>
|
|
<a name="index-GDB-startup"></a>
|
|
|
|
<p>Here’s the description of what <small>GDB</small> does during session startup:
|
|
</p>
|
|
<ol>
|
|
<li> Sets up the command interpreter as specified by the command line
|
|
(see <a href="Mode-Options.html#Mode-Options">interpreter</a>).
|
|
|
|
</li><li> <a name="index-init-file"></a>
|
|
Reads the system-wide <em>init file</em> (if <samp>--with-system-gdbinit</samp> was
|
|
used when building <small>GDB</small>; see <a href="System_002dwide-configuration.html#System_002dwide-configuration">System-wide configuration and settings</a>) and executes all the commands in
|
|
that file.
|
|
|
|
<a name="Home-Directory-Init-File"></a></li><li> Reads the init file (if any) in your home directory<a name="DOCF1" href="#FOOT1"><sup>1</sup></a> and executes all the commands in
|
|
that file.
|
|
|
|
<a name="Option-_002dinit_002deval_002dcommand"></a></li><li> Executes commands and command files specified by the ‘<samp>-iex</samp>’ and
|
|
‘<samp>-ix</samp>’ options in their specified order. Usually you should use the
|
|
‘<samp>-ex</samp>’ and ‘<samp>-x</samp>’ options instead, but this way you can apply
|
|
settings before <small>GDB</small> init files get executed and before inferior
|
|
gets loaded.
|
|
|
|
</li><li> Processes command line options and operands.
|
|
|
|
<a name="Init-File-in-the-Current-Directory-during-Startup"></a></li><li> Reads and executes the commands from init file (if any) in the current
|
|
working directory as long as ‘<samp>set auto-load local-gdbinit</samp>’ is set to
|
|
‘<samp>on</samp>’ (see <a href="Init-File-in-the-Current-Directory.html#Init-File-in-the-Current-Directory">Init File in the Current Directory</a>).
|
|
This is only done if the current directory is
|
|
different from your home directory. Thus, you can have more than one
|
|
init file, one generic in your home directory, and another, specific
|
|
to the program you are debugging, in the directory where you invoke
|
|
<small>GDB</small>.
|
|
|
|
</li><li> If the command line specified a program to debug, or a process to
|
|
attach to, or a core file, <small>GDB</small> loads any auto-loaded
|
|
scripts provided for the program or for its loaded shared libraries.
|
|
See <a href="Auto_002dloading.html#Auto_002dloading">Auto-loading</a>.
|
|
|
|
<p>If you wish to disable the auto-loading during startup,
|
|
you must do something like the following:
|
|
</p>
|
|
<div class="smallexample">
|
|
<pre class="smallexample">$ gdb -iex "set auto-load python-scripts off" myprogram
|
|
</pre></div>
|
|
|
|
<p>Option ‘<samp>-ex</samp>’ does not work because the auto-loading is then turned
|
|
off too late.
|
|
</p>
|
|
</li><li> Executes commands and command files specified by the ‘<samp>-ex</samp>’ and
|
|
‘<samp>-x</samp>’ options in their specified order. See <a href="Command-Files.html#Command-Files">Command Files</a>, for
|
|
more details about <small>GDB</small> command files.
|
|
|
|
</li><li> Reads the command history recorded in the <em>history file</em>.
|
|
See <a href="Command-History.html#Command-History">Command History</a>, for more details about the command history and the
|
|
files where <small>GDB</small> records it.
|
|
</li></ol>
|
|
|
|
<p>Init files use the same syntax as <em>command files</em> (see <a href="Command-Files.html#Command-Files">Command Files</a>) and are processed by <small>GDB</small> in the same way. The init
|
|
file in your home directory can set options (such as ‘<samp>set
|
|
complaints</samp>’) that affect subsequent processing of command line options
|
|
and operands. Init files are not executed if you use the ‘<samp>-nx</samp>’
|
|
option (see <a href="Mode-Options.html#Mode-Options">Choosing Modes</a>).
|
|
</p>
|
|
<p>To display the list of init files loaded by gdb at startup, you
|
|
can use <kbd>gdb --help</kbd>.
|
|
</p>
|
|
<a name="index-init-file-name"></a>
|
|
<a name="index-_002egdbinit"></a>
|
|
<a name="index-gdb_002eini"></a>
|
|
<p>The <small>GDB</small> init files are normally called <samp>.gdbinit</samp>.
|
|
The DJGPP port of <small>GDB</small> uses the name <samp>gdb.ini</samp>, due to
|
|
the limitations of file names imposed by DOS filesystems. The Windows
|
|
port of <small>GDB</small> uses the standard name, but if it finds a
|
|
<samp>gdb.ini</samp> file in your home directory, it warns you about that
|
|
and suggests to rename the file to the standard name.
|
|
</p>
|
|
|
|
<div class="footnote">
|
|
<hr>
|
|
<h4 class="footnotes-heading">Footnotes</h4>
|
|
|
|
<h3><a name="FOOT1" href="#DOCF1">(1)</a></h3>
|
|
<p>On
|
|
DOS/Windows systems, the home directory is the one pointed to by the
|
|
<code>HOME</code> environment variable.</p>
|
|
</div>
|
|
<hr>
|
|
<div class="header">
|
|
<p>
|
|
Previous: <a href="Mode-Options.html#Mode-Options" accesskey="p" rel="prev">Mode Options</a>, Up: <a href="Invoking-GDB.html#Invoking-GDB" accesskey="u" rel="up">Invoking GDB</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
|
|
</div>
|
|
|
|
|
|
|
|
</body>
|
|
</html>
|