INSIGHT(1)

💖 INSIGHT 💖

okay bestie, so you know how debugging can feel like screaming into the void?? not anymore. insight is the GDB/Insight graphical debugger and it is literally the loml of low-level code. 🫶

🌸 NAME 🌸

insight — the GDB/Insight graphical debugger, no cap

✨ DESCRIPTION ✨

so like. this is the GNU debugger. iconic, we know. here's how you use it:

insight [options] [executable-file [core-file or process-id]]
insight [options] --args executable-file [inferior-arguments ...]

💅 OPTIONS 💅

one bullet per flag because we are thorough and we ate, fr fr.

• --args — everything after executable-file gets passed along to the inferior. giving handoff energy.
• -b BAUDRATE — sets the serial port baud rate for remote debugging. yes bestie, baud rate, we're being vintage on purpose.
• --batch — dips out after processing the options. bye queen 👑
• --batch-silent — same as --batch, but it suppresses all insight stdout output. silent but deadly. 💀
• --return-child-result — INSIGHT's exit code becomes the child's exit code. passing the torch, passing the vibes.
• --cd=DIR — changes the current directory to DIR. we're relocating, it's a whole thing.
• --command=FILE, -x — runs INSIGHT commands from FILE.
• --eval-command=COMMAND, -ex — runs a single INSIGHT command. you can stack it multiple times, and it plays nice with --command. multitasking queen.
• --core=COREFILE — analyzes the core dump COREFILE. forensic era. 🔍
• --pid=PID — attaches to the already-running process PID. sliding into its DMs, technically.
• --dbx — DBX compatibility mode.
• --directory=DIR — searches for source files in DIR.
• --epoch — outputs info used by the epoch emacs-GDB interface.
• --exec=EXECFILE — uses EXECFILE as the executable.
• --fullname — outputs info used by the emacs-GDB interface.
• --help — prints this message. classic.
• --interpreter=INTERP — picks a specific interpreter / user interface.
• -l TIMEOUT — sets the timeout in seconds for remote debugging. patience is a virtue but we have limits.
• --nw — do not use a window interface.
• --nx — do not read the .gdbinit file.
• --quiet — does not print the version number on startup. lowkey mode activated.
• --readnow — fully reads symbol files on first access. no waiting around.
• --se=FILE — uses FILE as both the symbol file and the executable file. two-for-one, we love a bundle deal.
• --symbols=SYMFILE — reads symbols from SYMFILE.
• --tty=TTY — uses TTY for input/output by the program being debugged.
• --tui — uses a terminal user interface.
• --version — prints version information and then exits. quick lil flex.
• -w — uses a window interface.
• --write — sets writing into executable and core files. ⚠️ writing into files, bestie, be normal about it.
• --xdb — XDB compatibility mode.

🎀 for more info, type help from inside GDB, or go read the GDB manual (available as on-line info or a printed manual). it's giving homework but it's giving helpful homework.

🐛 REPORTING BUGS 🐛

found a bug?? report it to "bug-gdb@gnu.org". do NOT suffer in silence, we're a community.

📜 COPYRIGHT 📜

Copyright © 2007 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>

this is free software: you are free to change and redistribute it. there is NO WARRANTY, to the extent permitted by law. type "show copying" and "show warranty" for details. this GDB was configured as "i386-linux-gnu". 💾

👀 SEE ALSO 👀

the full documentation for gdb is maintained as a Texinfo manual. if the info and gdb programs are properly installed at your site, the command

info gdb

should give you access to the complete manual. iykyk. 🌈

and that's the whole page bestie ✨ this was insight 6.7.1, dated December 2007 — yeah she's a vintage icon and she still slays. go debug something and make me proud 💜