1RETRACE-SERVER-TAS(1) Retrace Server Manual RETRACE-SERVER-TAS(1)
2
6 retrace-server-task - Create a task, get and set fields on an existing
7 task
8
10 retrace-server-task create [-h] [-u | -k] [-t | -m | -f] [-i] [-d] [-s
11 SERVER] [-n] [-v] [-r KERNELVER] [-o OS_RELEASE] [-p PACKAGE] [-x
12 EXECUTABLE] [-e EMAIL] [-c CASENO] [-bz BUGZILLANO] COREFILE
13 retrace-server-task get [-h] [-p PASSWORD] [-s SERVER] [-n] [-v] [-t |
15 -b | -m | -e | -c | -bz] TASK_ID
16 retrace-server-task set [-h] [-p PASSWORD] [-s SERVER] [-n] [-v] [-c
18 CASENO] [-e EMAIL] [-bz BUGZILLANO] TASK_ID
19
21 This tool is able to communicate with Retrace server: create a new
22 task, get and set values of an existing task. If kerberos ticket is
23 available, all communication uses it. To stop using the ticket you must
24 destroy it (kdestroy).
25
27 create
28 Create a new task. Task can be either http task (COREFILE is
29 compressed and sent through http API), manager task (/manager site
30 must be available) or ftp task (same as manager task, but uses ftp
31 file). If none of the options "-t", "-m", or "-f" are given, the
32 following logic is tried. If COREFILE is a local file, then the
33 "-m" option is used, otherwise the "-f" option is used.
34 set
36 Write (set) information on an existing task. Available only for
37 manager and ftp task. See retrace-server-interact for setting the
38 success or failure of a task. See SET OPTIONS section for list of
39 set options available.
40 get
42 Read (get) information on an existing task. If no parameters
43 specified the output will default to the task status. See GET
44 OPTIONS section for list of get options available.
45 batch
47 Very similar to create (has the same parameters) but also waits
48 until task is finished. If the task finishes successfully
49 thebacktrace is downloaded
50
52 -h, --help
53 Display help and exit.
54 -s, --server SERVER
56 URL for Retrace server. If not specified local server is tried and
57 if not available https://retrace.fedoraproject.org/ is used.
58 -n, --no-verify
60 Do not verify certificate. (off by default)
61 -v, --verbose
63 Be verbose
64 -p, --password PASSWORD
66 Password of the task (only for http tasks)
67
69 -u, --userspace_core
70 The COREFILE specified is userspace core.
71 -k, --kernel_core
73 The COREFILE specified is kernel core. (default)
74 -t, --http
76 The COREFILE is assumed to be a local file, submitted through http
77 -f, --ftp
79 The COREFILE is assumed to be on the ftp server as configured in
80 retrace-server
81 -m, --manager
83 The COREFILE is assumed to be either a URL that is wget-able or a
84 local file
85 -i, --interactive
87 Create an interactive (persistent) task that may be accessed later
88 in an interactive debug session. Without this option, manager and
89 ftp tasks are interactive, and http tasks are not.
90 -k KERNELVER, --kernelver KERNELVER
92 Force the kernel version in the COREFILE to KERNELVER. Only valid
93 for kernel cores.
94 -o OS_RELEASE, --os_release OS_RELEASE
96 Force the version of the operating system in COREFILE to
97 OS_RELEASE. Only valid for userspace cores.
98 -p PACKAGE, --package PACKAGE
100 Force the version of the RPM package corresponding to COREFILE to
101 PACKAGE. Only valid for userspace cores.
102 -x EXECUTABLE, --executable EXECUTABLE
104 Force the COREDUMP executable to EXECUTABLE. Only valid for
105 userspace cores.
106
108 -b, --backtrace
109 Return the backtrace in a file in the current directory
110 -bz, --bugzillano
112 Return the value of the bugzillano field in the task to the
113 terminal. Available only for manager and ftp task.
114 -c, --caseno
116 Return the value of the caseno field in the task to the terminal.
117 Available only for manager and ftp task.
118 -e, --email
120 Return the value of the email field in the task to the terminal.
121 Available only for manager and ftp task.
122 -m, --md5sum
124 Return the md5sum field in the task to the terminal. Available only
125 for manager and ftp task.
126
128 -bz BUGZILLANO, --bugzillano BUGZILLANO
129 Write the bugzillano field in the task to BUGZILLANO. Available
130 only for manager and ftp task.
131 -c CASENO, --caseno CASENO
133 Write the caseno field in the task to CASENO. Available only for
134 manager and ftp task.
135 -e EMAIL, --email EMAIL
137 Write the email field in the task to EMAIL. Available only for
138 manager and ftp task.
139
141 Create a task from a local file (kernel vmcore)
142 retrace-server-task create ./localfile
144 Create a task where the file (kernel vmcore) exists on FTP server
146 retrace-server-task create 012345-vmcore
148 Batch run local file on https://retrace.fedoraproject.org/ (usperspace
150 core)
151 retrace-server-task batch -u -t -o "Fedora release 25 (Twenty five)" -p \
153 "coreutils-8.25-17.fc25" -x "/usr/bin/sleep" ./coredump
154 Read the md5sum field for task 925483242
156 retrace-server-task get --md5sum 925483242
158 Write the caseno field for task 925483242 to 01234567
160 retrace-server-task set --caseno 01234567 925483242
162 Write the bugzillano field for task 31415926 to 53589793, 23846264
164 retrace-server-task set --bugzillano 53589793,23846264 31415926
166
168 ยท Matej Marusak <mmarusak@redhat.com[1]>
169
171 1. mmarusak@redhat.com
172 mailto:mmarusak@redhat.com
173retrace-server 1.21.0 02/07/2020 RETRACE-SERVER-TAS(1)