gdb960 is a source-level debugger for C programs compiled for
a commercial i960 processor. gdb960 runs on a DOS, Unix, or Windows
95 host system and debugs, over a serial line, a program running
on the i960 processor with the MON960 debug monitor.
gdb960 can debug an executable ELF/DWARF2 object file that conforms
to the 80960 Embedded ABI specification. It can also debug b.out
and COFF executable object files created with ic960 or gcc960.
The gdb960 debugger invocation command is:
- gdb960 [
-option ]... [ file ]
Each invocation option must be preceded by a -
character. (On DOS, you can also use a /
character.) Click on option for a list
of gdb960 invocation options. All options that take an argument
allow white space between the option and the argument.
If file
is given on the command line, gdb960 will read symbolic debug
information from the file, try to connect to the target system,
and if successful, download the file. For related information,
see Specifying gdb960's Input Files.
Once the invocation command has been processed, gdb960 will:
- Check your home directory for a .gdbinit
(Unix) or init.gdb
(DOS) file. If it exists (and if nx
was not specified), gdb960 executes the commands in it.
- Check the current working directory for a .gdbinit
(Unix) or init.gdb
(DOS) file. If it exists (and if nx
was not specified), gdb960 executes the commands in it.
- If you specified a remote serial device in the invocation
command (or a PCI device on a PCI-enabled DOS host, and you are
using the Cyclone PLX baseboard) connect to the target using the
specified device.
- If you specified file
or se
file in the invocation command, load symbol
information from file and download it to the target.
The gdb960 invocation options are listed below. The options can
be abbreviated, as long as the abbreviations are unambiguous.
- b rate
Sets the baud rate of the serial port used for
debugging to rate.
The default baud rate is 38400. MON960 supports baud rates of
2400, 4800, 9600, 19200, and 38400 bps; all of these may not be
available on every host. Some hosts also support the additional
higher rates of 57600 and 115200 bps.
- batch
Run in batch mode. gdb960 exits with code 0 after
processing all the command files specified with x
(and .gdbinit,
if not inhibited). gdb960 exits with non-zero status if an error
occurs in executing the gdb960 commands in the command files.
Batch mode may be useful for running gdb960 as a filter (for example,
to download and run a series of programs and capture their output).
- brk
Sends a break (about 1/4 second long) to the target
system after opening the connection but before trying to talk.
If the target board is equipped with a break-triggered reset circuit,
this allows the user to connect to a running system.
- cd dir
Changes the current working directory
to dir.
- command file
Executes gdb960 commands from file
as soon as this option is encountered on the invocation line.
- directory dir
Adds directory dir
to the list of directories to search for source files.
- exec file
Downloads the executable object file file
to the i960 processor for debugging. Does not read symbols from
file.
- G
Informs gdb960 that the target has big-endian
memory.
- help
Displays online help.
- nx
Inhibits execution of .gdbinit
startup command file. On DOS hosts, the command file is init.gdb
instead of .gdbinit.
- parallel device
Downloads using device
rather than the serial device specified with r.
This option affects downloads only. Other debugger/monitor communications
use the serial device.
- pci
(DOS / PCI / Cyclone baseboard only) Uses the
PCI bus for downloading, and for debugger/monitor communication,
if r is
not also used. The default target is the Cyclone/PLX baseboard.
- pcib busno
devno funcno
(DOS / PCI / Cyclone baseboard only) Uses the
PCI bus for downloading, and for debugger/monitor communication,
if r is
not also used. Select the target by specifying a PCI address.
The arguments must be specified in hex.
- pcic io
(DOS / PCI / Cyclone baseboard only) Uses I/O
instructions when communicating with the PCI device. This is the
default PCI configuration.
- pcic mmap
(DOS / PCI / Cyclone baseboard only) Uses memory
instructions when communicating with the PCI device. This allows
faster target access, but may not work with all PCI system configurations.
- pciv vendorid
deviceid
(DOS / PCI / Cyclone baseboard only) Uses the
PCI bus for downloading, and for debugger/monitor communication,
if r is
not also used. Select the PCI target by specifying a PCI vendor
and device ID. The arguments must be specified in hex.
- pc
picoffset
Debugs position-independent code. The code will
be downloaded at link-time-address
+
picoffset instead of the usual link-time-address.
- pd
pidoffset
Debugs position-independent data. Data and bss
sections will be downloaded at link-time-address
+
pidoffset instead of the usual link-time-address.
- px offset
Debugs position-independent code and data. Code,
data and bss sections will be downloaded at link-time-address
+ offset instead of the usual link-time-address.
- quiet
Suppresses the normal (verbose) startup messages.
- r device
Opens communications with the target board
using serial device device.
On UNIX hosts, device /dev/ttynn
can be abbreviated as nn.
On DOS hosts, use the serial port name (typically COM1 or COM2)
instead of /dev/ttynn.
- readnow
Fully reads symbol files on the first access.
This defeats gdb960's symbol read-on-demand algorithm and is not
recommended.
- se file
Loads symbolic debug information from file,
marks it as the file to debug, and downloads it for debugging.
- symbols file
Loads symbolic debug information from file.
- t mon960
Specifies MON960 as gdb960's target. MON960 is
the default target, and currently the only supported target. Therefore,
this option is not needed.
- v960
Prints version information about gdb960 on stdout
and exits.
- x file
Executes gdb960 commands from file
as soon as this option is encountered on the invocation line.
This works as a synonym for command.
Normally, gdb960 is given its file names as command-line arguments.
You can also change to a different file while running gdb960 using
gdb960's file specification commands, listed below.
- exec-file file
- Specifies file
as the object file for future downloads, start address, and disassembly.
Can be abbreviated: exec
file
- symbol-file file
- Reads symbols from file.
Can be abbreviated: sym
file
- file file
- Shorthand for exec
file or sym
file.
- load file
- Downloads file.
If file
is omitted, downloads the file specified by the last exec
file command. Fails if no exec
command was executed.
Return
to the top of this page.
Go
to the ic960 Interface Index.
Go
to the gcc960 Interface Index.