RETRACE-SERVER-WOR(1)

📦
version 1.24.2 · 2 versions
, in fedora 43

👑 RETRACE-SERVER-WORKER 💅

okay bestie, so this is retrace-server-worker from the Retrace Server Manual, and honestly? it's giving main character energy. it's the little tool that does the actual heavy lifting of a retrace job. no cap. 🫶

✨ SYNOPSIS ✨

retrace-server-worker [-h] [-v] [--restart] [--foreground] [--kernelver
KERNELVER] [--arch ARCH] task_id

like. look at her. so simple. so iconic. 🎀

🌸 DESCRIPTION 🌸

So here's the vibe: this tool spins up a worker process, and that worker does the bulk of the processing for a retrace-server task. it's the one doing the work while everyone else is just vibing, fr fr. 💖

The way the worker handles processing depends a lil on the value of CONFIG["RetraceEnvironment"], and it may use mock, podman, or the native environment to prep an environment for processing the coredump or vmcore. lowkey versatile, highkey essential. ✨

Then it runs the debugger — that's gdb in the case of a coredump, or crash in the case of a vmcore — saves the backtrace, and also calls hooks at various points in the processing, assuming hooks is configured (peep /etc/retrace-server-hooks.conf for that whole situation 👀).

Once all processing is complete, the worker process cleans up the environment. queen behavior. responsible queen behavior. 👑

heads up bestie: the task_id argument is a number derived from the name of the directory where crash data is saved, CONFIG["SaveDir"]/task_id. so it's literally just a number pointing at a folder. iykyk. 💀

🦋 COMMON OPTIONS 🦋

  • -h, --help — shows you the help and then dips. bye! 👋
  • -v, --verbose — be verbose, bestie. also note: this turns on debug logging for create, batch or restart operations. so like. extra loud. extra chatty. we love that. 🗣️
  • --restart — restarts an existing task. super useful for vmcore tasks where kernelver may not have been detected and the task just flopped 😭. in those cases, using this option along with --kernelver may allow a task to succeed. glow up arc. 🌈
  • --foreground — run the worker task in the foreground instead of forking to the background. sometimes you wanna watch. no judgment. 🙈
  • --kernelver — for vmcore tasks, you specify the version of the kernel instead of letting it try to detect it by scanning the vmcore file. you said "i got this" and honestly? you do. ⭐
  • --arch — the architecture of the vmcore file. this option should be used with the kernelver option — they're a package deal, don't split them up. 💜

💖 AUTHORS 💖

  • Michal Toman <mtoman@redhat.com> — the icon, the legend, the moment. 👑

📝 NOTES 📝

  1. mtoman@redhat.com — mailto:mtoman@redhat.com

and that's the whole page, bestie!! 🎀 it's retrace-server version 1.24.2, dated 09/19/2025, and honestly she ate. periodt. 💅✨

📦 where this page comes from