blob: f3244d824bcbfa62b550eca3e24c0c2edab58d36 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
|
_dnl__ -*- Texinfo -*-
_dnl__ Copyright (c) 1990 1991 Free Software Foundation, Inc.
_dnl__ This file is part of the source for the GDB manual.
_dnl__ $Id$
@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
|