* Projects: Patching executables is done.

* Makefile.in (VERSION):  Roll to gdb-4.4.
* README:  Update for gdb-4.4.
This commit is contained in:
John Gilmore 1992-01-31 22:16:45 +00:00
parent 4a1dcb7f7f
commit ee7270cdca
3 changed files with 47 additions and 46 deletions

View File

@ -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.

View File

@ -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).

View File

@ -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