* 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)
|
||||
|
||||
* 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
|
||||
file's symbols, we must restart the scan, because the object_files
|
||||
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
|
||||
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,
|
||||
mask, value, start address. ADB searches until it finds it or hits
|
||||
an error (or is interrupted).
|
||||
|
|
87
gdb/README
87
gdb/README
|
@ -1,8 +1,8 @@
|
|||
README for gdb-4.3 release
|
||||
John Gilmore 7 Dec 1991
|
||||
README for gdb-4.4 release
|
||||
John Gilmore & Stu Grossman 31 Jan 1992
|
||||
|
||||
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
|
||||
|
@ -11,22 +11,21 @@ Unpacking and Installation -- quick overview
|
|||
In this release, the GDB debugger sources, the generic GNU include
|
||||
files, the BFD ("binary file description") library, the readline library,
|
||||
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
|
||||
makefiles exist to cruise up and down this directory tree and
|
||||
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
|
||||
`gdb-4.3', which contains:
|
||||
When you unpack the gdb-4.4.tar.Z file, you'll get a directory called
|
||||
`gdb-4.4', which contains:
|
||||
|
||||
Makefile.in config/ gdb/ texinfo/
|
||||
README config.sub* include/
|
||||
README.configure configure* libiberty/
|
||||
bfd/ configure.in readline/
|
||||
DOC.configure bfd/ configure* glob/ readline/
|
||||
Makefile.in config/ configure.in include/ texinfo/
|
||||
README config.sub* gdb/ libiberty/
|
||||
|
||||
To build GDB, you can just do:
|
||||
|
||||
cd gdb-4.3
|
||||
cd gdb-4.4
|
||||
./configure HOSTTYPE (e.g. sun4, decstation)
|
||||
make
|
||||
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
|
||||
==================
|
||||
|
||||
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
|
||||
`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
|
||||
printer, you can print the reference card by just sending `refcard.ps'
|
||||
to the printer.
|
||||
|
||||
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.
|
||||
|
||||
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
|
||||
can type
|
||||
|
||||
cd gdb-4.3/gdb
|
||||
cd gdb-4.4/gdb
|
||||
make gdb.info
|
||||
|
||||
to make the Info file.
|
||||
|
@ -69,7 +68,7 @@ several things:
|
|||
Knuth, must be installed on your system and available through
|
||||
your execution path.
|
||||
|
||||
* `gdb-4.3/texinfo': TeX macros defining the GNU Documentation
|
||||
* `gdb-4.4/texinfo': TeX macros defining the GNU Documentation
|
||||
Format.
|
||||
|
||||
* *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
|
||||
|
||||
cd gdb-4.3/gdb
|
||||
cd gdb-4.4/gdb
|
||||
make gdb.dvi
|
||||
|
||||
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
|
||||
typing
|
||||
|
||||
cd gdb-4.3/gdb
|
||||
cd gdb-4.4/gdb
|
||||
make refcard.dvi
|
||||
|
||||
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.
|
||||
|
||||
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.
|
||||
|
||||
`gdb-4.3/gdb'
|
||||
`gdb-4.4/gdb'
|
||||
the source specific to GDB itself
|
||||
|
||||
`gdb-4.3/bfd'
|
||||
`gdb-4.4/bfd'
|
||||
source for the Binary File Descriptor Library
|
||||
|
||||
`gdb-4.3/include'
|
||||
`gdb-4.4/include'
|
||||
GNU include files
|
||||
|
||||
`gdb-4.3/libiberty'
|
||||
`gdb-4.4/libiberty'
|
||||
source for the `-liberty' free software library
|
||||
|
||||
`gdb-4.3/readline'
|
||||
`gdb-4.4/readline'
|
||||
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:
|
||||
|
||||
cd gdb-4.3
|
||||
cd gdb-4.4
|
||||
./configure HOST
|
||||
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,
|
||||
to configure only the `bfd' subdirectory,
|
||||
|
||||
cd gdb-4.3/bfd
|
||||
cd gdb-4.4/bfd
|
||||
../configure HOST
|
||||
|
||||
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
|
||||
example, you can build GDB this way on a Sun 4 as follows:
|
||||
|
||||
cd gdb-4.3
|
||||
cd gdb-4.4
|
||||
./configure +sub sun4
|
||||
cd H-sun4/T-sun4
|
||||
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
|
||||
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,
|
||||
`configure' creates the `H-HOST/T-TARGET' subdirectories in each
|
||||
library or program's source directory. For example, typing:
|
||||
|
||||
cd gdb-4.3
|
||||
cd gdb-4.4
|
||||
configure sun4 +target=vxworks960
|
||||
|
||||
creates the following directories:
|
||||
|
||||
gdb-4.3/H-sun4/T-vxworks960
|
||||
gdb-4.3/bfd/H-sun4/T-vxworks960
|
||||
gdb-4.3/gdb/H-sun4/T-vxworks960
|
||||
gdb-4.3/libiberty/H-sun4/T-vxworks960
|
||||
gdb-4.3/readline/H-sun4/T-vxworks960
|
||||
gdb-4.4/H-sun4/T-vxworks960
|
||||
gdb-4.4/bfd/H-sun4/T-vxworks960
|
||||
gdb-4.4/gdb/H-sun4/T-vxworks960
|
||||
gdb-4.4/libiberty/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
|
||||
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.
|
||||
|
||||
The `Makefile' generated by `configure' for each source directory
|
||||
runs recursively, so that typing `make' in `gdb-4.3' (or in a
|
||||
`gdb-4.3/H-HOST/T-TARGET' subdirectory) builds all the required
|
||||
runs recursively, so that typing `make' in `gdb-4.4' (or in a
|
||||
`gdb-4.4/H-HOST/T-TARGET' subdirectory) builds all the required
|
||||
libraries, then GDB.
|
||||
|
||||
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'.
|
||||
|
||||
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.
|
||||
|
||||
|
||||
|
@ -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
|
||||
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.
|
||||
`configure' calls the Bourne shell script `config.sub' to map
|
||||
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
|
||||
*** 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
|
||||
|
@ -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.
|
||||
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
|
||||
better kernel debugging, but won't release it for ordinary mortals.
|
||||
better kernel debugging.
|
||||
|
||||
|
||||
Remote debugging
|
||||
|
@ -424,7 +423,7 @@ via-ethernet back ends.
|
|||
|
||||
The correct address for reporting bugs found in gdb is
|
||||
"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
|
||||
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
|
||||
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
|
||||
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
|
||||
|
|
Loading…
Reference in New Issue