| 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 | _dnl__ $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 |