SDCDB(1)

📦
version 4.5.0 · 2 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ SDCDB(1) ✨

okay bestie, sit down, hydrate, and let me tell you about sdcdb from the General Commands Manual section 1 — the source debugger for SDCC 💖

🎀 NAME 🎀

sdcdb — the Source debugger for SDCC, and yes she's that girl 💅

🌸 SYNOPSIS 🌸

sdcdb [options] filename

⚠️ WARNING ⚠️

The info on this man page is an extract from the full documentation of SDCC, and it's limited to the meaning of the options. That's it. That's the whole scope.
For the complete and current documentation, go read the SDCC Compiler User Guide. No cap. This page is the trailer, not the movie 🎬

🦋 DESCRIPTION 🦋

sdcdb is a source debugger for SDCC, periodt. It uses ucSim to actually execute the program — and the program execution is controlled by the debugger. So like, debugger runs the show, simulator does the running. main character energy fr fr 👑

The command interface for the debugger has been deliberately kept as close to the GNU debugger gdb as possible. Why? Because that helps with integration into existing graphical user interfaces — the ones like ddd, xxgdb or xemacs that already exist for the GNU debugger. The way that she just fits in with the gdb girlies 🫶

🌈 STARTING THE DEBUGGER 🌈

You can start the debugger with the following command line (assume the file you're debugging has the file name foo):

sdcdb foo

And then the debugger goes looking for these files, bestie:

  • foo.c — the source file.
  • foo.cdb — the debugger symbol information file.
  • foo.ihx — the intel hex format object file.

Three files, one vibe check ✅

💖 OPTIONS 💖

  • -directory=<source file directory> — use this to specify the directory search list. The debugger will look into the directory list you specified for the source, cdb & ihx files. The items in the directory list must be separated by ':'. So like, if your source files can live in the directories /home/src1 and /home/src2, the -directory option should be -directory=/home/src1:/home/src2. And heads up: there can be no spaces in the option. None. Zero. 🙈
  • -cd <directory> — change to the <directory>. Just... go there. 🚶‍♀️
  • -fullname — used by GUI front ends. That's the whole thing, she's a supporting character 🎭
  • -cpu <cpu-type> — this argument is passed to the simulator. Please see the simulator docs for details, iykyk 👀
  • -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 the simulator. Please see the simulator docs for details 💜
  • -S <serial in,out> — this argument is passed to the simulator. Please see the simulator docs for details ⭐
not me noticing that four of these just say "see the simulator docs" 😭 she's not gatekeeping, she's just delegating. Go read ucsim(1), bestie.

👑 COPYING 👑

The entire source code for the debugger is distributed under the GNU General Public License. Free as in slay 💅

🍓 SEE ALSO 🍓

🧚 AUTHOR 🧚

This manual page was written by Aurelien Jarno <aurel32@debian.org>, for the Debian GNU/Linux system (but may be used by others). Shoutout to Aurelien, iconic behaviour 🌸

and that's the whole page, bestie — SDCDB(1), closing out exactly like she opened, no notes, periodt 💖✨🎀

📦 where this page comes from