gdb/doc/gdb.install-m4

   1 _dnl__                                                          -*- Texinfo -*-
   2 _dnl__ Copyright (c) 1990 1991 Free Software Foundation, Inc.
   3 _dnl__ This file is part of the source for the GDB manual.
   4 @c M4 FRAGMENT: $Id$
   5 @node Installing _GDBN__, Copying, Renamed Commands, Top
   6 @appendix Installing _GDBN__
   7 @cindex configuring _GDBN__
   8 @cindex installation
   9
  10 The script @code{config.gdb} automates the process of preparing _GDBN__
  11 for installation; you can then use @code{make} to actually build it.
  12 The best way to build _GDBN__ is in a subdirectory that records the
  13 configuration options used; this gives you a clean way of building
  14 _GDBN__ binaries with several different configuration options.
  15 @code{config.gdb} doesn't depend on this---it's just a good habit.  For
  16 example, assuming the _GDBN__ source is in a directory called
  17 ``@code{gdb-4.0}'':
  18
  19 @example
  20 cd gdb-4.0
  21 mkdir =sun3os4
  22 cd =sun3os4
  23 ../config.gdb sun3os4
  24 make
  25 @end example
  26
  27 @noindent
  28 will install _GDBN__ on a Sun 3 running SunOS 4.
  29
  30 @table @code
  31 @kindex config.gdb
  32 @item config.gdb @var{machine}
  33 @itemx config.gdb -srcdir=@var{dir} @var{machine}
  34 This is the most usual way of configuring _GDBN__; to debug programs running
  35 on the same machine as _GDBN__ itself.  If you wish to build the _GDBN__ binaries
  36 in a completely different directory from the sources, specify a path to
  37 the source directory using the @samp{-srcdir} option.
  38
  39 @item config.gdb -host
  40 @cindex host environments
  41 Display a list of supported host environments for _GDBN__.
  42
  43 @item config.gdb @var{host} @var{target}
  44 @itemx config.gdb -srcdir=@var{dir} @var{host} @var{target}
  45 @cindex cross-debugging
  46 _GDBN__ can also be used as a cross-debugger, running on a machine of one
  47 type while debugging a program running on a machine of another type.
  48 You configure it this way by specifying first the @var{host}, then the
  49 @var{target} environment on the @code{config.gdb} argument list; the
  50 @var{host} is where _GDBN__ runs, and the @var{target} is where your program
  51 runs. @xref{Remote}.  Again, you can use @samp{-srcdir} to specify a
  52 path to the _GDBN__ source.
  53
  54 @item config.gdb -target
  55 @cindex target environments
  56 Display a list of supported target environments for _GDBN__.
  57 @end table