RETRACE-SERVER-TAS(1)

📦

version 1.24.2 · 2 versions

1.24.2 · fedora 43 (latest)
1.24.2 · fedora 44

✨ RETRACE-SERVER-TAS(1) ✨

okay bestie, sit down, hydrate, and let me tell you about retrace-server-task 💖 this little icon lives in the Retrace Server Manual and it's literally your group chat with the Retrace server. you can make a task, restart a task, and read or write fields on a task that already exists. slay.

🌸 NAME 🌸

retrace-server-task — create a task, get and set fields on an existing task

🎀 SYNOPSIS 🎀

retrace-server-task create [-h] [-n] [-s SERVER] [-v] [-u | -k] [-t | -m
| -f] [-i] [-d] [-bz BUGZILLANO] [-c CASENO] [-e EMAIL] [-o OS_RELEASE]
[-p PACKAGE] [-x EXECUTABLE] [-r KERNELVER] [--vmem VMEM] COREFILE

retrace-server-task restart [-h] [-n] [-s SERVER] [-v] [-bz BUGZILLANO]
[-c CASENO] [-e EMAIL] [-r KERNELVER] TASK_ID

retrace-server-task get [-h] [-n] [-p PASSWORD] [-s SERVER] [-v] [-b |
-bz | -c | -e | -m | -t] TASK_ID

retrace-server-task set [-h] [-n] [-p PASSWORD] [-s SERVER] [-v] [-bz
BUGZILLANO] [-c CASENO] [-e EMAIL] TASK_ID

🦋 DESCRIPTION 🦋

this tool talks to the Retrace server, no cap. it can create a brand new task, restart a task that already exists, and get or set the values of a task. and here's the tea: if a kerberos ticket is available, all the communication uses it. so if you want to stop using the ticket, you have to destroy it with kdestroy. periodt. 💅

👑 OPERATIONS 👑

🌈 `create`

make a whole new task, bestie. the task can be one of three vibes:

an http task — COREFILE gets compressed and yeeted through the http API
a manager task — the /manager site must be available
an ftp task — same as the manager task but it uses an ftp file

if none of the options -t, -m, or -f are given, this logic gets tried: if COREFILE is a local file, then the -m option is used; otherwise the -f option is used. iykyk.

🌈 `restart`

restart a task that already exists. but heads up 🚨 restarting an existing task removes all files inside the results directory. like, gone gone.

🌈 `set`

write (set) info on a task that exists. this is available only for manager and ftp task. for setting the success or failure of a task, go see retrace-server-interact. and for the full list of set options, scroll down to the SET OPTIONS section. 🫶

🌈 `get`

read (get) info on a task that exists. if you pass no parameters at all, the output defaults to the task status. the full list of get options is in the GET OPTIONS section. ✨

🌈 `batch`

very similar to create — literally has the same parameters — but it also waits until the task is finished. and if the task finishes successfully thebacktrace is downloaded 💖

💖 COMMON OPTIONS 💖

-h, --help — display help and exit.
-n, --no-verify — do not verify certificate. (off by default)
-p, --password PASSWORD — password of the task (only for http tasks)
-s, --server SERVER — URL for the Retrace server. if it's not specified, the local server is tried, and if that's not available, https://retrace.fedoraproject.org/ is used.
-v, --verbose — be verbose. note that this also turns on debug logging for create, batch or restart operations.

🧚 CREATE OR BATCH OPTIONS 🧚

-bz BUGZILLANO, --bugzillano BUGZILLANO — write the bugzillano field in the task to BUGZILLANO. available only for manager and ftp task.
-c CASENO, --caseno CASENO — write the caseno field in the task to CASENO. available only for manager and ftp task.
-e EMAIL, --email EMAIL — write the email field in the task to EMAIL. available only for manager and ftp task.
-d, --no-md5 — do not calculate md5sum on the task. available only for manager and ftp task.
-u, --userspace_core — the COREFILE specified is a userspace core.
-k, --kernel_core — the COREFILE specified is a kernel core. (default)
-t, --http — the COREFILE is assumed to be a local file, submitted through http
-f, --ftp — the COREFILE is assumed to be on the ftp server as configured in retrace-server
-m, --manager — the COREFILE is assumed to be either a URL that is wget-able or a local file
-i, --interactive — create an interactive (persistent) task that may be accessed later in an interactive debug session. without this option, manager and ftp tasks are interactive, and http tasks are not.
--vmem VMEM — virtual memory file VMEM needed for retracing kernel vmcore snapshots. only valid for kernel cores.
-r KERNELVER, --kernelver KERNELVER — force the kernel version in the COREFILE to KERNELVER. only valid for kernel cores.
-o OS_RELEASE, --os_release OS_RELEASE — force the version of the operating system in COREFILE to OS_RELEASE. only valid for userspace cores.
-p PACKAGE, --package PACKAGE — force the version of the RPM package corresponding to COREFILE to PACKAGE. only valid for userspace cores.
-x EXECUTABLE, --executable EXECUTABLE — force the COREDUMP executable to EXECUTABLE. only valid for userspace cores.

🔥 RESTART OPTIONS 🔥

-bz BUGZILLANO, --bugzillano BUGZILLANO — write the bugzillano field in the task to BUGZILLANO. available only for manager and ftp task.
-c CASENO, --caseno CASENO — write the caseno field in the task to CASENO. available only for manager and ftp task.
-e EMAIL, --email EMAIL — write the email field in the task to EMAIL. available only for manager and ftp task.
-r KERNELVER, --kernelver KERNELVER — force the kernel version in the task to KERNELVER. only valid for kernel cores.

💜 GET OPTIONS 💜

-b, --backtrace — return the backtrace in a file in the current directory
-bz, --bugzillano — return the value of the bugzillano field in the task to the terminal. available only for manager and ftp task.
-c, --caseno — return the value of the caseno field in the task to the terminal. available only for manager and ftp task.
-e, --email — return the value of the email field in the task to the terminal. available only for manager and ftp task.
-m, --md5sum — return the md5sum field in the task to the terminal. available only for manager and ftp task.
-t, --status — return the status field in the task to the terminal. if no option is given, this field is selected as default.

🌈 SET OPTIONS 🌈

-bz BUGZILLANO, --bugzillano BUGZILLANO — write the bugzillano field in the task to BUGZILLANO. available only for manager and ftp task.
-c CASENO, --caseno CASENO — write the caseno field in the task to CASENO. available only for manager and ftp task.
-e EMAIL, --email EMAIL — write the email field in the task to EMAIL. available only for manager and ftp task.

⭐ EXAMPLES ⭐

create a task from a local file (kernel vmcore) 🐚

retrace-server-task create ./localfile

create a task where the file (kernel vmcore) exists on FTP server 📡

retrace-server-task create 012345-vmcore

create a task for kernel vmcore snapshot with vmem file included 🧠

retrace-server-task create 012345-vmcore.vmss --vmem 012345-vmcore.vmem

batch run local file on https://retrace.fedoraproject.org/ (usperspace core) 🚀

retrace-server-task batch -u -t -o "Fedora release 25 (Twenty five)" -p \
"coreutils-8.25-17.fc25" -x "/usr/bin/sleep" ./coredump

read the md5sum field for task 925483242 🔍

retrace-server-task get --md5sum 925483242

write the caseno field for task 925483242 to 01234567 ✍️

retrace-server-task set --caseno 01234567 925483242

write the bugzillano field for task 31415926 to 53589793, 23846264 🐛

retrace-server-task set --bugzillano 53589793,23846264 31415926

restart task 790216008 🔄

retrace-server-task restart 790216008

restart task 164167944 forcing kernel version to 4.18.0-80.el8.x86_64 💫

retrace-server-task restart 790216008 --kernelver 4.18.0-80.el8.x86_64

🫶 AUTHORS 🫶

Matej Marusak <mmarusak@redhat.com[1]>

📝 NOTES 📝

mmarusak@redhat.com mailto:mmarusak@redhat.com

and that's the whole page, bestie!! 🎀 this was retrace-server version 1.24.2, dated 09/19/2025, and it's giving main character energy from the Retrace Server Manual. go forth and retrace, you absolute icon 💅✨

📦 where this page comes from

fedora 43: retrace-server 1.24.2-14.fc43 · GPL-2.0-or-later
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-10-18: a language model's rewrite of the original, under its terms