sdcdb(1) [debian man page]
SDCDB(1) General Commands Manual SDCDB(1) NAME
sdcdb - Source debugger for SDCC SYNOPSIS
sdcdb [options] filename WARNING
The information in this man page is an extract from the full documentation of SDCC, and is limited to the meaning of the options. For complete and current documentation, refer to the SDCC Compiler User Guide. DESCRIPTION
sdcdb is a source debugger for SDCC. It uses ucSim to execute the program, the programm execution is controlled by the debugger. The command interface for the debugger has been deliberately kept as close the GNU debugger gdb, as possible. This will help the integra- tion with existing graphical user interfaces (like ddd, xxgdb or xemacs) existing for the GNU debugger. STARTING THE DEBUGGER
The debugger can be started using the following command line (Assume the file you are debugging has the file name foo): sdcdb foo The debugger will look for the following files: foo.c - the source file. foo.cdb - the debugger symbol information file. foo.ihx - the intel hex format object file. OPTIONS
-directory=<source file directory> This option can used to specify the directory search list. The debugger will look into the directory list specified for source, cdb & ihx files. The items in the directory list must be separated by ':', e.g. if the source files can be in the directories /home/src1 and /home/src2, the -directory option should be -directory=/home/src1:/home/src2. Note there can be no spaces in the option. -cd <directory> Change to the <directory>. -fullname Used by GUI front ends. -cpu <cpu-type> This argument is passed to the simulator. Please see the simulator docs for details. -X <Clock frequency> This option is passed to the simulator. Please see the simulator docs for details. -s <serial port file> This option is passed to simulator. Please see the simulator docs for details. -S <serial in,out> This argument is passed to simulator. Please see the simulator docs for details. COPYING
The entire source code for the debugger is distributed under GNU General Public License. SEE ALSO
sdcc(1), ucsim(1), s51(1), savr(1), sz80(1). AUTHOR
This manual page was written by Aurelien Jarno <aurel32@debian.org>, for the Debian GNU/Linux system (but may be used by others). SDCDB(1)
Check Out this Related Man Page
ddd(1) GNU Tools ddd(1) NAME
ddd - The Data Display Debugger SYNOPSIS
ddd [--help] [--gdb] [--dbx] [--ladebug] [--wdb] [--xdb] [--jdb] [--pydb] [--perl] [--debugger name] [--[r]host [[username@]hostname]] [--trace] [--version] [--configuration] [options...] [prog[core|procID]] but usually just ddd program DESCRIPTION
DDD is a graphical front-end for GDB and other command-line debuggers. Using DDD, you can see what is going on "inside" another program while it executes--or what another program was doing at the moment it crashed. DDD can do four main kinds of things (plus other things in support of these) to help you catch bugs in the act: o Start your program, specifying anything that might affect its behavior. o Make your program stop on specified conditions. o Examine what has happened, when your program has stopped. o Change things in your program, so you can experiment with correcting the effects of one bug and go on to learn about another. "Classical" UNIX debuggers such as the GNU debugger (GDB) provide a command-line interface and a multitude of commands for these and other debugging purposes. DDD is a comfortable graphical user interface around an inferior GDB, DBX, Ladebug, XDB, JDB, Python debugger, or Perl debugger. DDD is invoked with the shell command ddd. You can open a program to be debugged using `File->Open Program' (the `Open Program' item in the `File' menu. You can get online help at any time using the `Help' menu; for the first steps, try `Help->What Now?'. Quit DDD using `File->Exit'. More information on DDD is contained in the DDD Manual. You can read the text-only version in DDD (via `Help->DDD Reference') or in Emacs (as Info file). Full-fledged HTML, PostScript, and PDF versions are available online via the DDD WWW page, http://www.gnu.org/software/ddd/ OPTIONS
These are the most important options used when starting DDD. All options may be abbreviated, as long as they are unambiguous; single dashes may also be used. DDD also understands the usual X options such as `-display' or `-geometry'; see X(1) for details. All arguments and options not handled by DDD are passed to the inferior debugger. To pass an option to the inferior debugger that con- flicts with an X option, or with a DDD option listed here, use the `--debugger' option, below. --configuration Show the DDD configuration settings and exit. --dbx Run the DBX debugger as inferior debugger. --debugger name Invoke the inferior debugger name. This is useful if you have several debugger versions around, or if the inferior debugger cannot be invoked as `gdb', `dbx', `xdb', `jdb', `pydb', or `perl' respectively. This option can also be used to pass options to the inferior debugger that would otherwise conflict with DDD options. For instance, to pass the option `-d directory' to XDB, use: ddd --debugger "xdb -d directory" If you use the `--debugger' option, be sure that the type of inferior debugger is specified as well. That is, use one of the options `--gdb', `--dbx', `--xdb', `--jdb' `--pydb', or `--perl' (unless the default setting works fine). --gdb Run the GDB debugger as inferior debugger. --help Give a list of frequently used options. Show options of the inferior debugger as well. --host [username@]hostname Invoke the inferior debugger directly on the remote host hostname. If username is given and the `--login' option is not used, use username as remote user name. --jdb Run JDB as inferior debugger. --ladebug Run Ladebug as inferior debugger. --perl Run Perl as inferior debugger. --pydb Run PYDB as inferior debugger. --rhost [username@]hostname Run the inferior debugger interactively on the remote host hostname. If username is given and the `--login' option is not used, use username as remote user name. --trace Show the interaction between DDD and the inferior debugger on standard error. This is useful for debugging DDD. If `--trace' is not specified, this information is written into `$HOME/.ddd/log', such that you can also do a post-mortem debugging. --version Show the DDD version and exit. --wdb Run the WDB debugger as inferior debugger. --xdb Run XDB as inferior debugger. A full list of options, including important options of the inferior debugger, can be found in the DDD manual. SEE ALSO
X(1), gdb(1), dbx(1), wdb(1), xdb(1), perldebug(1) `ddd' entry in info. `gdb' entry in info. Debugging with DDD: User's Guide and Reference Manual, by Andreas Zeller. Using GDB: A Guide to the GNU Source-Level Debugger, by Richard M. Stallman and Roland H. Pesch. Java Language Debugging, at http://java.sun.com/ (and its mirrors) in /products/jdk/1.1/debugging/ The Python Language, at http://www.python.org/ and its mirrors. DDD--A Free Graphical Front-End for UNIX Debuggers, by Andreas Zeller and Dorothea Luetkehaus, Computer Science Report 95-07, Technische Universitaet Braunschweig, 1995. DDD - ein Debugger mit graphischer Datendarstellung, by Dorothea Luetkehaus, Diploma Thesis, Technische Universitaet Braunschweig, 1994. The DDD FTP site, ftp://ftp.gnu.org/gnu/ddd The DDD WWW page, http://www.gnu.org/software/ddd/ The DDD Mailing List, ddd@gnu.org For more information on this list, send a mail to ddd-request@gnu.org . COPYRIGHT
This manual page is Copyright (C) 2001 Universitaet Passau, Germany and (C) 2001-2004 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual page provided the copyright notice and this permission notice are preserved on all copies. Permission is granted to copy and distribute modified versions of this manual page under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one. Permission is granted to copy and distribute translations of this manual page into another language, under the above conditions for modi- fied versions, except that this permission notice may be included in translations approved by the Free Software Foundation instead of in the original English. DDD 3.3.12 2001-01-15 ddd(1)