Commit | Line | Data |
---|---|---|
9bcc06ef RP |
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. | |
16e58d91 | 4 | @c M4 FRAGMENT: $Id$ |
9bcc06ef RP |
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 |