RETRACE-SERVER-INT(1)

📦
version 1.24.2 · 2 versions
, in fedora 43

💖 retrace-server-interact 💖

okay so bestie, welcome to the Retrace Server Manual</> page for retrace-server-interact — literally the glow-up your debugging session needed ✨ she's the one who opens up the Retrace server's chroot so you can actually go in there and vibe with it yourself 🫶

✨ SYNOPSIS ✨

retrace-server-interact [-h] [--priv] task_id action

🌸 DESCRIPTION 🌸

So the way this works: this tool makes the Retrace server's chroot available for interactive debugging 💅 It lets you, the user, jump straight into the chroot and run the correct tool — that's gdb or crash — and it automatically loads all the relevant files for you. no cap, no manual hunting around, she just handles it 👑

🎀 ACTIONS 🎀

  • shell — jump into a shell, bestie 🐚 She's not available if mock chroot is not used, which is the case when you're dealing with vmcores from the same architecture as the host system. iykyk.
  • gdb — runs GDB, loads the executable and the coredump, and drops you right at the prompt 🔥 Only available for binary crashes</> — that's coredumps, periodt.
  • crash — runs Crash, loads the vmcore and the vmlinux, and lands you at the prompt 💥 Only available for kernel crashes</> — that's vmcores, obviously.
  • printdir — prints the directory of the task 📂 cute and simple.
  • delete — deletes the task. ⚠️ Use with caution — there is no undo. it's giving point-of-no-return, and not in a fun way 💀
  • set-success — forces the task status to success 👑 This is useful when retrace-server marked a task as "failed" but you, the user, have other knowledge that it's still useful. It'll avoid a possible early deletion of the task by retrace-server-cleanup, which uses the DeleteFailedTaskAfter configuration setting. main character move honestly ✨
  • set-fail — forces the task status to fail 💔 This is useful when retrace-server marked a task as "success" but you have other knowledge that it is not useful. This allows a possible early deletion of the task by retrace-server-cleanup, which uses the DeleteFailedTaskAfter configuration setting. letting it go, we love a clean exit 🌈

💅 OPTIONS 💅

  • -h — displays help and exits 🙈 your little safety net bestie, use her.
  • --priv — uses the chroot as a privileged user 👑 big energy, handle with care.

🦋 AUTHORS 🦋

  • Michal Toman — _mtoman@redhat.com_ [1]

⭐ NOTES ⭐

  1. _mtoman@redhat.com_ mailto:_mtoman@redhat.com_
🌟 reminder bestie: delete has no undo, so maybe don't be reckless with it, mwah 💖

and that's the whole page, we ate and left no crumbs 🍓 this was the retrace-server manual, version 1.24.2, dated 09/19/2025 — go forth and debug, my love 💜🧚

📦 where this page comes from