retrace-server-task(1)

1RETRACE-SERVER-TAS(1)        Retrace Server Manual       RETRACE-SERVER-TAS(1)
2
3
4

NAME

6       retrace-server-task - Create tasks, get and set fields on existing
7       tasks
8

SYNOPSIS

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
14       retrace-server-task get [-h] [-p PASSWORD] [-s SERVER] [-n] [-v] [-t |
15       -b | -m | -e | -c | -bz] TASK_ID
16
17       retrace-server-task set [-h] [-p PASSWORD] [-s SERVER] [-n] [-v] [-c
18       CASENO] [-e EMAIL] [-bz BUGZILLANO] TASK_ID
19

DESCRIPTION

21       This tool is able to communicate with Retrace server: create a new
22       task, get and set values in existing tasks. If kerberos ticket is
23       available, all communication uses it. To stop using the ticket you must
24       destroy it (kdestroy).
25

OPERATIONS

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
35       set
36           Write (set) information on an existing task. Available only for
37           manager and ftp task.
38
39       get
40           Read (get) information on an existing task.
41
42       batch
43           Very similar to create (has the same parameters) but also waits
44           until task is finished. If tasks finishes successfully backtrace is
45           downloaded
46

COMMON OPTIONS

48       -h, --help
49           Display help and exit.
50
51       -s, --server SERVER
52           URL for Retrace server. If not specified local server is tried and
53           if not available https://retrace.fedoraproject.org/ is used.
54
55       -n, --no-verify
56           Do not verify certificate. (off by default)
57
58       -v, --verbose
59           Be verbose
60
61       -p, --password PASSWORD
62           Password of the task (only for http tasks)
63

CREATE OR BATCH OPTIONS

65       -u, --userspace_core
66           The COREFILE specified is userspace core.
67
68       -k, --kernel_core
69           The COREFILE specified is kernel core. (default)
70
71       -t, --http
72           The COREFILE is assumed to be a local file, submitted through http
73
74       -f, --ftp
75           The COREFILE is assumed to be on the ftp server as configured in
76           retrace-server
77
78       -m, --manager
79           The COREFILE is assumed to be either a URL that is wget-able or a
80           local file
81
82       -i, --interactive
83           Create an interactive (persistent) task that may be accessed later
84           in an interactive debug session. Without this option, manager and
85           ftp tasks are interactive, and http tasks are not.
86
87       -k KERNELVER, --kernelver KERNELVER
88           Force the kernel version in the COREFILE to KERNELVER. Only valid
89           for kernel cores.
90
91       -o OS_RELEASE, --os_release OS_RELEASE
92           Force the version of the operating system in COREFILE to
93           OS_RELEASE. Only valid for userspace cores.
94
95       -p PACKAGE, --package PACKAGE
96           Force the version of the RPM package corresponding to COREFILE to
97           PACKAGE. Only valid for userspace cores.
98
99       -x EXECUTABLE, --executable EXECUTABLE
100           Force the COREDUMP executable to EXECUTABLE. Only valid for
101           userspace cores.
102

GET OPTIONS

104       -b, --backtrace
105           Return the backtrace in a file in the current directory
106
107       -bz, --bugzillano
108           Return the value of the bugzillano field in the task to the
109           terminal. Available only for manager and ftp task.
110
111       -c, --caseno
112           Return the value of the caseno field in the task to the terminal.
113           Available only for manager and ftp task.
114
115       -e, --email
116           Return the value of the email field in the task to the terminal.
117           Available only for manager and ftp task.
118
119       -m, --md5sum
120           Return the md5sum field in the task to the terminal. Available only
121           for manager and ftp task.
122

SET OPTIONS

124       -bz BUGZILLANO, --bugzillano BUGZILLANO
125           Write the bugzillano field in the task to BUGZILLANO. Available
126           only for manager and ftp task.
127
128       -c CASENO, --caseno CASENO
129           Write the caseno field in the task to CASENO. Available only for
130           manager and ftp task.
131
132       -e EMAIL, --email EMAIL
133           Write the email field in the task to EMAIL. Available only for
134           manager and ftp task.
135

EXAMPLES

137       Create a task from a local file (kernel vmcore)
138
139           retrace-server-task create ./localfile
140
141       Create a task where the file (kernel vmcore) exists on FTP server
142
143           retrace-server-task create 012345-vmcore
144
145       Batch run local file on https://retrace.fedoraproject.org/ (usperspace
146       core)
147
148           retrace-server-task batch -u -t -o "Fedora release 25 (Twenty five)" -p \
149           "coreutils-8.25-17.fc25" -x "/usr/bin/sleep" ./coredump
150
151       Read the md5sum field for task 925483242
152
153           retrace-server-task get --md5sum 925483242
154
155       Write the caseno field for task 925483242 to 01234567
156
157           retrace-server-task set --caseno 01234567 925483242
158
159       Write the bugzillano field for task 31415926 to 53589793, 23846264
160
161           retrace-server-task set --bugzillano 53589793,23846264 31415926
162

AUTHORS

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

NOTES

167        1. mmarusak@redhat.com
168           mailto:mmarusak@redhat.com
169
170
171
172retrace-server 1.19.0             08/27/2018             RETRACE-SERVER-TAS(1)