mingw/info/gdb/Configure-Options.html

   1 <html lang="en">
   2 <head>
   3 <title>Debugging with GDB</title>
   4 <meta http-equiv="Content-Type" content="text/html">
   5 <meta name="description" content="Debugging with GDB">
   6 <meta name="generator" content="makeinfo 4.3">
   7 <link href="http://www.gnu.org/software/texinfo/" rel="generator-home">
   8 </head>
   9 <body>
  10 <div class="node">
  11 <p>
  12 Node:<a name="Configure%20Options">Configure Options</a>,
  13 Previous:<a rel="previous" accesskey="p" href="Config-Names.html#Config%20Names">Config Names</a>,
  14 Up:<a rel="up" accesskey="u" href="Installing-GDB.html#Installing%20GDB">Installing GDB</a>
  15 <hr><br>
  16 </div>
  17
  18 <h3 class="section"><code>configure</code> options</h3>
  19
  20    <p>Here is a summary of the <code>configure</code> options and arguments that
  21 are most often useful for building GDB.  <code>configure</code> also has
  22 several other options not listed here.  see <a href="../configure.info/What-Configure-Does.html#What%20Configure%20Does">What Configure Does</a>, for a full explanation of <code>configure</code>.
  23
  24 <pre class="example">     configure [--help]
  25                [--prefix=<var>dir</var>]
  26                [--exec-prefix=<var>dir</var>]
  27                [--srcdir=<var>dirname</var>]
  28                [--norecursion] [--rm]
  29                [--target=<var>target</var>]
  30                <var>host</var>
  31      </pre>
  32
  33 <p>You may introduce options with a single <code>-</code> rather than
  34 <code>--</code> if you prefer; but you may abbreviate option names if you use
  35 <code>--</code>.
  36
  37      <dl>
  38 <dt><code>--help</code>
  39      <dd>Display a quick summary of how to invoke <code>configure</code>.
  40
  41      <br><dt><code>--prefix=</code><var>dir</var><code></code>
  42      <dd>Configure the source to install programs and files under directory
  43 <code></code><var>dir</var><code></code>.
  44
  45      <br><dt><code>--exec-prefix=</code><var>dir</var><code></code>
  46      <dd>Configure the source to install programs under directory
  47 <code></code><var>dir</var><code></code>.
  48
  49      <br><dt><code>--srcdir=</code><var>dirname</var><code></code>
  50      <dd><strong>Warning: using this option requires </stronG><SMALL>GNU</small><strong> </strong><code>make</code><strong>, or another
  51 </strong><code>make</code><strong> that implements the </strong><code>VPATH</code><strong> feature.</strong><br>
  52 Use this option to make configurations in directories separate from the
  53 GDB source directories.  Among other things, you can use this to
  54 build (or maintain) several configurations simultaneously, in separate
  55 directories.  <code>configure</code> writes configuration specific files in
  56 the current directory, but arranges for them to use the source in the
  57 directory <var>dirname</var>.  <code>configure</code> creates directories under
  58 the working directory in parallel to the source directories below
  59 <var>dirname</var>.
  60
  61      <br><dt><code>--norecursion</code>
  62      <dd>Configure only the directory level where <code>configure</code> is executed; do not
  63 propagate configuration to subdirectories.
  64
  65      <br><dt><code>--target=</code><var>target</var><code></code>
  66      <dd>Configure GDB for cross-debugging programs running on the specified
  67 <var>target</var>.  Without this option, GDB is configured to debug
  68 programs that run on the same machine (<var>host</var>) as GDB itself.
  69
  70      <p>There is no convenient way to generate a list of all available targets.
  71
  72      <br><dt><code></code><var>host</var><code> ...</code>
  73      <dd>Configure GDB to run on the specified <var>host</var>.
  74
  75      <p>There is no convenient way to generate a list of all available hosts.
  76 </dl>
  77
  78    <p>There are many other options available as well, but they are generally
  79 needed for special purposes only.
  80
  81    </body></html>
  82