1991-05-23 00:14:26 +00:00
|
|
|
_dnl__ -*- Texinfo -*-
|
|
|
|
|
_dnl__ Copyright (c) 1990 1991 Free Software Foundation, Inc.
|
|
|
|
|
_dnl__ This file is part of the source for the GDB manual.
|
1991-07-24 01:51:32 +00:00
|
|
|
@c M4 FRAGMENT: $Id$
|
1991-05-23 00:14:26 +00:00
|
|
|
@node Installing _GDBN__, Copying, Renamed Commands, Top
|
|
|
|
|
@appendix Installing _GDBN__
|
|
|
|
|
@cindex configuring _GDBN__
|
|
|
|
|
@cindex installation
|
|
|
|
|
|
|
|
|
|
The script @code{config.gdb} automates the process of preparing _GDBN__
|
|
|
|
|
for installation; you can then use @code{make} to actually build it.
|
|
|
|
|
The best way to build _GDBN__ is in a subdirectory that records the
|
|
|
|
|
configuration options used; this gives you a clean way of building
|
|
|
|
|
_GDBN__ binaries with several different configuration options.
|
|
|
|
|
@code{config.gdb} doesn't depend on this---it's just a good habit. For
|
|
|
|
|
example, assuming the _GDBN__ source is in a directory called
|
|
|
|
|
``@code{gdb-4.0}'':
|
|
|
|
|
|
|
|
|
|
@example
|
|
|
|
|
cd gdb-4.0
|
|
|
|
|
mkdir =sun3os4
|
|
|
|
|
cd =sun3os4
|
|
|
|
|
../config.gdb sun3os4
|
|
|
|
|
make
|
|
|
|
|
@end example
|
|
|
|
|
|
|
|
|
|
@noindent
|
|
|
|
|
will install _GDBN__ on a Sun 3 running SunOS 4.
|
|
|
|
|
|
|
|
|
|
@table @code
|
|
|
|
|
@kindex config.gdb
|
|
|
|
|
@item config.gdb @var{machine}
|
|
|
|
|
@itemx config.gdb -srcdir=@var{dir} @var{machine}
|
|
|
|
|
This is the most usual way of configuring _GDBN__; to debug programs running
|
|
|
|
|
on the same machine as _GDBN__ itself. If you wish to build the _GDBN__ binaries
|
|
|
|
|
in a completely different directory from the sources, specify a path to
|
|
|
|
|
the source directory using the @samp{-srcdir} option.
|
|
|
|
|
|
|
|
|
|
@item config.gdb -host
|
|
|
|
|
@cindex host environments
|
|
|
|
|
Display a list of supported host environments for _GDBN__.
|
|
|
|
|
|
|
|
|
|
@item config.gdb @var{host} @var{target}
|
|
|
|
|
@itemx config.gdb -srcdir=@var{dir} @var{host} @var{target}
|
|
|
|
|
@cindex cross-debugging
|
|
|
|
|
_GDBN__ can also be used as a cross-debugger, running on a machine of one
|
|
|
|
|
type while debugging a program running on a machine of another type.
|
|
|
|
|
You configure it this way by specifying first the @var{host}, then the
|
|
|
|
|
@var{target} environment on the @code{config.gdb} argument list; the
|
|
|
|
|
@var{host} is where _GDBN__ runs, and the @var{target} is where your program
|
|
|
|
|
runs. @xref{Remote}. Again, you can use @samp{-srcdir} to specify a
|
|
|
|
|
path to the _GDBN__ source.
|
|
|
|
|
|
|
|
|
|
@item config.gdb -target
|
|
|
|
|
@cindex target environments
|
|
|
|
|
Display a list of supported target environments for _GDBN__.
|
|
|
|
|
@end table
|
