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  program
       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 integration  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)