diff options
Diffstat (limited to 'share/doc/gdb/Startup.html')
| -rw-r--r-- | share/doc/gdb/Startup.html | 149 |
1 files changed, 149 insertions, 0 deletions
diff --git a/share/doc/gdb/Startup.html b/share/doc/gdb/Startup.html new file mode 100644 index 0000000..282bff7 --- /dev/null +++ b/share/doc/gdb/Startup.html @@ -0,0 +1,149 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 1988-2023 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 5.1, http://www.gnu.org/software/texinfo/ --> +<head> +<title>Debugging with GDB: Startup</title> + +<meta name="description" content="Debugging with GDB: Startup"> +<meta name="keywords" content="Debugging with GDB: Startup"> +<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="Initialization-Files.html#Initialization-Files" rel="next" title="Initialization Files"> +<link href="Mode-Options.html#Mode-Options" rel="previous" title="Mode Options"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.smallquotation {font-size: smaller} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.indentedblock {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +div.smalldisplay {margin-left: 3.2em} +div.smallexample {margin-left: 3.2em} +div.smallindentedblock {margin-left: 3.2em; font-size: smaller} +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.nocodebreak {white-space:nowrap} +span.nolinebreak {white-space:nowrap} +span.roman {font-family:serif; font-weight:normal} +span.sansserif {font-family:sans-serif; font-weight:normal} +ul.no-bullet {list-style: none} +--> +</style> + + +</head> + +<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000"> +<a name="Startup"></a> +<div class="header"> +<p> +Next: <a href="Initialization-Files.html#Initialization-Files" accesskey="n" rel="next">Initialization Files</a>, Previous: <a href="Mode-Options.html#Mode-Options" accesskey="p" rel="previous">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> Performs minimal setup required to initialize basic internal state. + +</li><li> <a name="index-early-initialization-file"></a> +Reads commands from the early initialization file (if any) in your +home directory. Only a restricted set of commands can be placed into +an early initialization file, see <a href="Initialization-Files.html#Initialization-Files">Initialization Files</a>, for +details. + +</li><li> Executes commands and command files specified by the ‘<samp>-eiex</samp>’ and +‘<samp>-eix</samp>’ command line options in their specified order. Only a +restricted set of commands can be used with ‘<samp>-eiex</samp>’ and +‘<samp>eix</samp>’, see <a href="Initialization-Files.html#Initialization-Files">Initialization Files</a>, for details. + +</li><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 initialization file and the files from the +system wide initialization directory, see <a href="Initialization-Files.html#System-Wide-Init-Files">System Wide Init Files</a>. + +</li><li> Reads the initialization file (if any) in your home directory and +executes all the commands in that file, see <a href="Initialization-Files.html#Home-Directory-Init-File">Home Directory Init File</a>. + +<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. + +</li><li> Reads and executes the commands from the initialization 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>. See <a href="Initialization-Files.html#Init-File-in-the-Current-Directory-during-Startup">Init File in the Current Directory during Startup</a>. + +</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> + +<hr> +<div class="header"> +<p> +Next: <a href="Initialization-Files.html#Initialization-Files" accesskey="n" rel="next">Initialization Files</a>, Previous: <a href="Mode-Options.html#Mode-Options" accesskey="p" rel="previous">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> |