| 1 |
24 |
jeremybenn |
README for GNU Debugger for OpenRISC 1000
|
| 2 |
|
|
|
| 3 |
|
|
This directory contains only the files for the OpenRISC 1000 port of GDB 6.8
|
| 4 |
|
|
which differ from standard GDB 6.8.
|
| 5 |
|
|
|
| 6 |
|
|
To build the OpenRISC 1000 version of GDB 6.8, download and unpack the source
|
| 7 |
|
|
of standard GDB 6.8 from your favourite mirror. Then copy the files in this
|
| 8 |
|
|
directory to the corresponding files in the standard GDB 6.8 (this will
|
| 9 |
|
|
involve overwriting some files).
|
| 10 |
|
|
|
| 11 |
|
|
For your convenience, snapshots of known stable versions of the port are
|
| 12 |
|
|
provided as patch files. For example if you have downloaded GDB 6.8 in
|
| 13 |
|
|
directory gdb-6.8, then the tree could be patched by using:
|
| 14 |
|
|
|
| 15 |
|
|
cd gdb-6.8
|
| 16 |
|
|
bzcat -dc ../or32-gdb-6.8-patch-1.0.bz2 | patch -p1
|
| 17 |
|
|
|
| 18 |
|
|
(assuming the patch file was in hte parent directory)
|
| 19 |
|
|
|
| 20 |
|
|
GDB can then be built as normal, having configured with target or32-uclinux,
|
| 21 |
|
|
viz:
|
| 22 |
|
|
|
| 23 |
|
|
mkdir bd-gdb
|
| 24 |
|
|
cd bd-gdb
|
| 25 |
|
|
../gdb-6.8/configure --target=or32-uclinux --prefix= ...
|
| 26 |
|
|
make all
|
| 27 |
|
|
make check (optional, needs DejaGNU)
|
| 28 |
|
|
make install
|
| 29 |
|
|
|
| 30 |
|
|
Documentation of the port may be found in the modified GDB User Guide (in
|
| 31 |
|
|
gdb/doc/gdb.texinfo) and in the OpenRISC 1000 tutorial guide (in
|
| 32 |
|
|
gdb/doc/or1k.texinfo). Build these for HTML or PDF with for example
|
| 33 |
|
|
|
| 34 |
|
|
cd bd-gdb/gdb/doc
|
| 35 |
|
|
make html
|
| 36 |
|
|
make pdf
|
| 37 |
|
|
|
| 38 |
|
|
If you intend using GDB 6.8 with Or1ksim, the architectural simulator, you
|
| 39 |
|
|
will need a patch. A patch suitable for use with Or1ksim 0.2.0 (the latest
|
| 40 |
|
|
stable version, not the current top of CVS tree) is also available for
|
| 41 |
|
|
download. Apply this to the Or1ksim sources before building. Something like
|
| 42 |
|
|
the following
|
| 43 |
|
|
|
| 44 |
|
|
tar zxf or1ksim-0.2.0.tar.gz
|
| 45 |
|
|
cd or1ksim-0.2.0
|
| 46 |
|
|
bzcat -dc ../or1ksim-0.2.0-gdb-6.8-patch-1.0.bz2 | patch -p1
|
| 47 |
|
|
cd ..
|
| 48 |
|
|
mkdir bd-or1ksim
|
| 49 |
|
|
cd bd-or1ksim
|
| 50 |
|
|
../or1ksim-0.2.0/configure --target=or32-uclinux --prefix=
|
| 51 |
|
|
make all
|
| 52 |
|
|
make install
|
| 53 |
|
|
|
| 54 |
|
|
The free Embecosm Application Note EAN2 has full details on all aspects of
|
| 55 |
|
|
building the toolchain for OpenRISC 1000. For details visit:
|
| 56 |
|
|
|
| 57 |
|
|
www.embecosm.com/download/index.html
|
| 58 |
|
|
|
| 59 |
|
|
Much of the code and documentation enclosed is copyright by the Free Software
|
| 60 |
|
|
Foundation, Inc and others. See the file COPYING or COPYING.LIB in the
|
| 61 |
|
|
various directories, for a description of the GNU General Public License terms
|
| 62 |
|
|
under which you can copy the files.
|
| 63 |
|
|
|
| 64 |
|
|
REPORTING BUGS: Again, see gdb/README, binutils/README, etc., for info
|
| 65 |
|
|
on where and how to report problems.
|
