* Projects: Patching executables is done.
* Makefile.in (VERSION): Roll to gdb-4.4. * README: Update for gdb-4.4.
This commit is contained in:
parent
4a1dcb7f7f
commit
ee7270cdca
|
@ -1,5 +1,9 @@
|
||||||
Fri Jan 31 00:05:01 1992 John Gilmore (gnu at cygnus.com)
|
Fri Jan 31 00:05:01 1992 John Gilmore (gnu at cygnus.com)
|
||||||
|
|
||||||
|
* Projects: Patching executables is done.
|
||||||
|
* Makefile.in (VERSION): Roll to gdb-4.4.
|
||||||
|
* README: Update for gdb-4.4.
|
||||||
|
|
||||||
* symfile.c (reread_symbols): Whenever we reread one object
|
* symfile.c (reread_symbols): Whenever we reread one object
|
||||||
file's symbols, we must restart the scan, because the object_files
|
file's symbols, we must restart the scan, because the object_files
|
||||||
chain has been permuted.
|
chain has been permuted.
|
||||||
|
|
|
@ -83,8 +83,6 @@ Enhance the gdb manual with extra examples where needed.
|
||||||
Arrange for list_command not to use decode_line_1 and thus not require
|
Arrange for list_command not to use decode_line_1 and thus not require
|
||||||
symbols to be read in simply to read a source file.
|
symbols to be read in simply to read a source file.
|
||||||
|
|
||||||
Allow patching of executables, a la "adb -w".
|
|
||||||
|
|
||||||
Add a command for searching memory, a la adb. It specifies size,
|
Add a command for searching memory, a la adb. It specifies size,
|
||||||
mask, value, start address. ADB searches until it finds it or hits
|
mask, value, start address. ADB searches until it finds it or hits
|
||||||
an error (or is interrupted).
|
an error (or is interrupted).
|
||||||
|
|
87
gdb/README
87
gdb/README
|
@ -1,8 +1,8 @@
|
||||||
README for gdb-4.3 release
|
README for gdb-4.4 release
|
||||||
John Gilmore 7 Dec 1991
|
John Gilmore & Stu Grossman 31 Jan 1992
|
||||||
|
|
||||||
This is GDB, the GNU source-level debugger, presently running under un*x.
|
This is GDB, the GNU source-level debugger, presently running under un*x.
|
||||||
A summary of features new since gdb-3.5 is in the file `WHATS.NEW'.
|
A summary of new features is in the file `WHATS.NEW'.
|
||||||
|
|
||||||
|
|
||||||
Unpacking and Installation -- quick overview
|
Unpacking and Installation -- quick overview
|
||||||
|
@ -11,22 +11,21 @@ Unpacking and Installation -- quick overview
|
||||||
In this release, the GDB debugger sources, the generic GNU include
|
In this release, the GDB debugger sources, the generic GNU include
|
||||||
files, the BFD ("binary file description") library, the readline library,
|
files, the BFD ("binary file description") library, the readline library,
|
||||||
and a miscellaneous library all have directories of their own underneath
|
and a miscellaneous library all have directories of their own underneath
|
||||||
the gdb-4.3 directory. The idea is that a variety of GNU tools can
|
the gdb-4.4 directory. The idea is that a variety of GNU tools can
|
||||||
share a common copy of these things. Configuration scripts and
|
share a common copy of these things. Configuration scripts and
|
||||||
makefiles exist to cruise up and down this directory tree and
|
makefiles exist to cruise up and down this directory tree and
|
||||||
automatically build all the pieces in the right order.
|
automatically build all the pieces in the right order.
|
||||||
|
|
||||||
When you unpack the gdb-4.3.tar.Z file, you'll get a directory called
|
When you unpack the gdb-4.4.tar.Z file, you'll get a directory called
|
||||||
`gdb-4.3', which contains:
|
`gdb-4.4', which contains:
|
||||||
|
|
||||||
Makefile.in config/ gdb/ texinfo/
|
DOC.configure bfd/ configure* glob/ readline/
|
||||||
README config.sub* include/
|
Makefile.in config/ configure.in include/ texinfo/
|
||||||
README.configure configure* libiberty/
|
README config.sub* gdb/ libiberty/
|
||||||
bfd/ configure.in readline/
|
|
||||||
|
|
||||||
To build GDB, you can just do:
|
To build GDB, you can just do:
|
||||||
|
|
||||||
cd gdb-4.3
|
cd gdb-4.4
|
||||||
./configure HOSTTYPE (e.g. sun4, decstation)
|
./configure HOSTTYPE (e.g. sun4, decstation)
|
||||||
make
|
make
|
||||||
cp gdb/gdb /usr/local/bin/gdb (or wherever you want)
|
cp gdb/gdb /usr/local/bin/gdb (or wherever you want)
|
||||||
|
@ -42,22 +41,22 @@ while debugging a program running on a machine of another type. See below.
|
||||||
More Documentation
|
More Documentation
|
||||||
==================
|
==================
|
||||||
|
|
||||||
The GDB 4.3 release includes an already-formatted reference card,
|
The GDB 4.4 release includes an already-formatted reference card,
|
||||||
ready for printing on a PostScript printer, as
|
ready for printing on a PostScript printer, as
|
||||||
`gdb-4.3/gdb/refcard.ps'. It uses the most common PostScript fonts:
|
`gdb-4.4/gdb/refcard.ps'. It uses the most common PostScript fonts:
|
||||||
the Times family, Courier, and Symbol. If you have a PostScript
|
the Times family, Courier, and Symbol. If you have a PostScript
|
||||||
printer, you can print the reference card by just sending `refcard.ps'
|
printer, you can print the reference card by just sending `refcard.ps'
|
||||||
to the printer.
|
to the printer.
|
||||||
|
|
||||||
The release also includes the online Info version of this manual
|
The release also includes the online Info version of this manual
|
||||||
already formatted: the main Info file is `gdb-4.3/gdb/gdb.info', and it
|
already formatted: the main Info file is `gdb-4.4/gdb/gdb.info', and it
|
||||||
refers to subordinate files matching `gdb.info*' in the same directory.
|
refers to subordinate files matching `gdb.info*' in the same directory.
|
||||||
|
|
||||||
If you want to make these Info files yourself from the GDB manual's
|
If you want to make these Info files yourself from the GDB manual's
|
||||||
source, you need the GNU `makeinfo' program. Once you have it, you
|
source, you need the GNU `makeinfo' program. Once you have it, you
|
||||||
can type
|
can type
|
||||||
|
|
||||||
cd gdb-4.3/gdb
|
cd gdb-4.4/gdb
|
||||||
make gdb.info
|
make gdb.info
|
||||||
|
|
||||||
to make the Info file.
|
to make the Info file.
|
||||||
|
@ -69,7 +68,7 @@ several things:
|
||||||
Knuth, must be installed on your system and available through
|
Knuth, must be installed on your system and available through
|
||||||
your execution path.
|
your execution path.
|
||||||
|
|
||||||
* `gdb-4.3/texinfo': TeX macros defining the GNU Documentation
|
* `gdb-4.4/texinfo': TeX macros defining the GNU Documentation
|
||||||
Format.
|
Format.
|
||||||
|
|
||||||
* *A DVI output program.* TeX does not actually make marks on
|
* *A DVI output program.* TeX does not actually make marks on
|
||||||
|
@ -80,7 +79,7 @@ several things:
|
||||||
|
|
||||||
Once you have these things, you can type
|
Once you have these things, you can type
|
||||||
|
|
||||||
cd gdb-4.3/gdb
|
cd gdb-4.4/gdb
|
||||||
make gdb.dvi
|
make gdb.dvi
|
||||||
|
|
||||||
to format the text of this manual, and print it with the usual output
|
to format the text of this manual, and print it with the usual output
|
||||||
|
@ -91,7 +90,7 @@ PostScript printer, or you want to use Computer Modern fonts instead,
|
||||||
you can still print it if you have TeX. Format the reference card by
|
you can still print it if you have TeX. Format the reference card by
|
||||||
typing
|
typing
|
||||||
|
|
||||||
cd gdb-4.3/gdb
|
cd gdb-4.4/gdb
|
||||||
make refcard.dvi
|
make refcard.dvi
|
||||||
|
|
||||||
The GDB reference card is designed to print in landscape mode on US
|
The GDB reference card is designed to print in landscape mode on US
|
||||||
|
@ -108,30 +107,30 @@ preparing GDB for installation; you can then use `make' to build the
|
||||||
`gdb' program.
|
`gdb' program.
|
||||||
|
|
||||||
The gdb distribution includes all the source code you need for gdb
|
The gdb distribution includes all the source code you need for gdb
|
||||||
in a single directory `gdb-4.3'. That directory in turn contains:
|
in a single directory `gdb-4.4'. That directory in turn contains:
|
||||||
|
|
||||||
`gdb-4.3/configure (and supporting files)'
|
`gdb-4.4/configure (and supporting files)'
|
||||||
script for configuring GDB and all its supporting libraries.
|
script for configuring GDB and all its supporting libraries.
|
||||||
|
|
||||||
`gdb-4.3/gdb'
|
`gdb-4.4/gdb'
|
||||||
the source specific to GDB itself
|
the source specific to GDB itself
|
||||||
|
|
||||||
`gdb-4.3/bfd'
|
`gdb-4.4/bfd'
|
||||||
source for the Binary File Descriptor Library
|
source for the Binary File Descriptor Library
|
||||||
|
|
||||||
`gdb-4.3/include'
|
`gdb-4.4/include'
|
||||||
GNU include files
|
GNU include files
|
||||||
|
|
||||||
`gdb-4.3/libiberty'
|
`gdb-4.4/libiberty'
|
||||||
source for the `-liberty' free software library
|
source for the `-liberty' free software library
|
||||||
|
|
||||||
`gdb-4.3/readline'
|
`gdb-4.4/readline'
|
||||||
source for the GNU command-line interface
|
source for the GNU command-line interface
|
||||||
|
|
||||||
It is most convenient to run `configure' from the `gdb-4.3' directory.
|
It is most convenient to run `configure' from the `gdb-4.4' directory.
|
||||||
The simplest way to configure and build GDB is the following:
|
The simplest way to configure and build GDB is the following:
|
||||||
|
|
||||||
cd gdb-4.3
|
cd gdb-4.4
|
||||||
./configure HOST
|
./configure HOST
|
||||||
make
|
make
|
||||||
|
|
||||||
|
@ -150,7 +149,7 @@ directories in the GDB distribution (if you only want to configure
|
||||||
that subdirectory); but be sure to specify a path to it. For example,
|
that subdirectory); but be sure to specify a path to it. For example,
|
||||||
to configure only the `bfd' subdirectory,
|
to configure only the `bfd' subdirectory,
|
||||||
|
|
||||||
cd gdb-4.3/bfd
|
cd gdb-4.4/bfd
|
||||||
../configure HOST
|
../configure HOST
|
||||||
|
|
||||||
You can install `gdb' anywhere; it has no hardwired paths. Simply
|
You can install `gdb' anywhere; it has no hardwired paths. Simply
|
||||||
|
@ -179,7 +178,7 @@ even for a single configuration. You can specify the use of
|
||||||
subdirectories using the `+subdirs' option (abbreviated `+sub'). For
|
subdirectories using the `+subdirs' option (abbreviated `+sub'). For
|
||||||
example, you can build GDB this way on a Sun 4 as follows:
|
example, you can build GDB this way on a Sun 4 as follows:
|
||||||
|
|
||||||
cd gdb-4.3
|
cd gdb-4.4
|
||||||
./configure +sub sun4
|
./configure +sub sun4
|
||||||
cd H-sun4/T-sun4
|
cd H-sun4/T-sun4
|
||||||
make
|
make
|
||||||
|
@ -198,21 +197,21 @@ the other hand, whenever you specify both hosts and targets on the
|
||||||
same command line, `configure' creates all combinations of the hosts
|
same command line, `configure' creates all combinations of the hosts
|
||||||
and targets you list.
|
and targets you list.
|
||||||
|
|
||||||
If you run `configure' from a directory (notably, `gdb-4.3') that
|
If you run `configure' from a directory (notably, `gdb-4.4') that
|
||||||
contains source directories for multiple libraries or programs,
|
contains source directories for multiple libraries or programs,
|
||||||
`configure' creates the `H-HOST/T-TARGET' subdirectories in each
|
`configure' creates the `H-HOST/T-TARGET' subdirectories in each
|
||||||
library or program's source directory. For example, typing:
|
library or program's source directory. For example, typing:
|
||||||
|
|
||||||
cd gdb-4.3
|
cd gdb-4.4
|
||||||
configure sun4 +target=vxworks960
|
configure sun4 +target=vxworks960
|
||||||
|
|
||||||
creates the following directories:
|
creates the following directories:
|
||||||
|
|
||||||
gdb-4.3/H-sun4/T-vxworks960
|
gdb-4.4/H-sun4/T-vxworks960
|
||||||
gdb-4.3/bfd/H-sun4/T-vxworks960
|
gdb-4.4/bfd/H-sun4/T-vxworks960
|
||||||
gdb-4.3/gdb/H-sun4/T-vxworks960
|
gdb-4.4/gdb/H-sun4/T-vxworks960
|
||||||
gdb-4.3/libiberty/H-sun4/T-vxworks960
|
gdb-4.4/libiberty/H-sun4/T-vxworks960
|
||||||
gdb-4.3/readline/H-sun4/T-vxworks960
|
gdb-4.4/readline/H-sun4/T-vxworks960
|
||||||
|
|
||||||
When you run `make' to build a program or library, you must run it
|
When you run `make' to build a program or library, you must run it
|
||||||
in a configured directory. If you made a single configuration,
|
in a configured directory. If you made a single configuration,
|
||||||
|
@ -221,8 +220,8 @@ have `H-HOST/T-TARGET' subdirectories, run `make' in those
|
||||||
subdirectories.
|
subdirectories.
|
||||||
|
|
||||||
The `Makefile' generated by `configure' for each source directory
|
The `Makefile' generated by `configure' for each source directory
|
||||||
runs recursively, so that typing `make' in `gdb-4.3' (or in a
|
runs recursively, so that typing `make' in `gdb-4.4' (or in a
|
||||||
`gdb-4.3/H-HOST/T-TARGET' subdirectory) builds all the required
|
`gdb-4.4/H-HOST/T-TARGET' subdirectory) builds all the required
|
||||||
libraries, then GDB.
|
libraries, then GDB.
|
||||||
|
|
||||||
When you have multiple hosts or targets configured, you can run
|
When you have multiple hosts or targets configured, you can run
|
||||||
|
@ -249,7 +248,7 @@ a `+target=TARGET' option, but the equivalent full name is
|
||||||
`sparc-sun-sunos4'.
|
`sparc-sun-sunos4'.
|
||||||
|
|
||||||
The following table shows all the architectures, hosts, and OS
|
The following table shows all the architectures, hosts, and OS
|
||||||
prefixes that `configure' recognizes in GDB 4.3. Entries in the "OS
|
prefixes that `configure' recognizes in GDB 4.4. Entries in the "OS
|
||||||
prefix" column ending in a `*' may be followed by a release number.
|
prefix" column ending in a `*' may be followed by a release number.
|
||||||
|
|
||||||
|
|
||||||
|
@ -286,7 +285,7 @@ prefix" column ending in a `*' may be followed by a release number.
|
||||||
combinations of architecture, vendor, and OS. There is by no
|
combinations of architecture, vendor, and OS. There is by no
|
||||||
means support available for all possible combinations!
|
means support available for all possible combinations!
|
||||||
|
|
||||||
The `configure' script accompanying GDB 4.3 does not provide any
|
The `configure' script accompanying GDB 4.4 does not provide any
|
||||||
query facility to list all supported host and target names or aliases.
|
query facility to list all supported host and target names or aliases.
|
||||||
`configure' calls the Bourne shell script `config.sub' to map
|
`configure' calls the Bourne shell script `config.sub' to map
|
||||||
abbreviations to full names; you can read the script, if you wish, or
|
abbreviations to full names; you can read the script, if you wish, or
|
||||||
|
@ -305,7 +304,7 @@ you can use it to test your guesses on abbreviations--for example:
|
||||||
% sh config.sub i486v
|
% sh config.sub i486v
|
||||||
*** Configuration "i486v" not recognized
|
*** Configuration "i486v" not recognized
|
||||||
|
|
||||||
`config.sub' is also distributed in the directory `gdb-4.3'.
|
`config.sub' is also distributed in the directory `gdb-4.4'.
|
||||||
|
|
||||||
|
|
||||||
`configure' Options
|
`configure' Options
|
||||||
|
@ -393,7 +392,7 @@ or nested functions will not currently work.
|
||||||
I have't done this myself so I can't really offer any advice.
|
I have't done this myself so I can't really offer any advice.
|
||||||
Remote debugging over serial lines works fine, but the kernel debugging
|
Remote debugging over serial lines works fine, but the kernel debugging
|
||||||
code in here has not been tested in years. Van Jacobson claims to have
|
code in here has not been tested in years. Van Jacobson claims to have
|
||||||
better kernel debugging, but won't release it for ordinary mortals.
|
better kernel debugging.
|
||||||
|
|
||||||
|
|
||||||
Remote debugging
|
Remote debugging
|
||||||
|
@ -424,7 +423,7 @@ via-ethernet back ends.
|
||||||
|
|
||||||
The correct address for reporting bugs found in gdb is
|
The correct address for reporting bugs found in gdb is
|
||||||
"bug-gdb@prep.ai.mit.edu". Please email all bugs to that address.
|
"bug-gdb@prep.ai.mit.edu". Please email all bugs to that address.
|
||||||
Please include the GDB version number (e.g. gdb-4.3), and how
|
Please include the GDB version number (e.g. gdb-4.4), and how
|
||||||
you configured it (e.g. "sun4" or "mach386 host, i586-intel-synopsys
|
you configured it (e.g. "sun4" or "mach386 host, i586-intel-synopsys
|
||||||
target").
|
target").
|
||||||
|
|
||||||
|
@ -446,7 +445,7 @@ the compiler actually outputs or the debugger actually understands.
|
||||||
|
|
||||||
If you port gdb to a new machine, please send the required changes to
|
If you port gdb to a new machine, please send the required changes to
|
||||||
bug-gdb@prep.ai.mit.edu. There's lots of information about doing your
|
bug-gdb@prep.ai.mit.edu. There's lots of information about doing your
|
||||||
own port in the file gdb-4.3/gdb/doc/gdbint.texinfo, which you can
|
own port in the file gdb-4.4/gdb/doc/gdbint.texinfo, which you can
|
||||||
print out, or read with `info' (see the Makefile.in there). If your
|
print out, or read with `info' (see the Makefile.in there). If your
|
||||||
changes are more than a few lines, obtain and send in a copyright
|
changes are more than a few lines, obtain and send in a copyright
|
||||||
assignment from gnu@prep.ai.mit.edu, as described in the section
|
assignment from gnu@prep.ai.mit.edu, as described in the section
|
||||||
|
|
Loading…
Reference in New Issue