.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "DLT-CONVERT" "1" "" "" ""
.hy
.SH NAME
.PP
\f[B]dlt-convert\f[R] - Convert DLT Logging files into ASCII
.SH SYNOPSIS
.PP
\f[B]dlt-convert\f[R] [\f[B]-h\f[R]] [\f[B]-a\f[R]] [\f[B]-x\f[R]]
[\f[B]-m\f[R]] [\f[B]-s\f[R]] [\f[B]-t\f[R]] [\f[B]-o\f[R] filename]
[\f[B]-v\f[R]] [\f[B]-c\f[R]] [\f[B]-f\f[R] filterfile] [\f[B]-b\f[R]
number] [\f[B]-e\f[R] number] [\f[B]-w\f[R]] file1 [file2] [file3]
.SH DESCRIPTION
.PP
Read DLT files, print DLT messages as ASCII and store the messages
again.
Use Ranges and Output file to cut DLT files.
Use two files and Output file to join DLT files.
.SS OPTIONS
.TP
-h
Display a short help text.
.TP
-a
Print DLT file; payload as ASCII.
.TP
-x
Print DLT file; payload as hex.
.TP
-m
Print DLT file; payload as hex and ASCII.
.PP
-s Print DLT file; only headers.
.TP
-o
Output messages in new DLT file.
.TP
-v
Verbose mode.
.TP
-c
Count number of messages.
.TP
-f
Enable filtering of messages.
.TP
-b
First messages to be handled.
.TP
-e
Last message to be handled.
.TP
-w
Follow dlt file while file is increasing.
.TP
-t
Handling the compressed input files (tar.gz).
.SH EXAMPLES
.PP
Convert DLT file into ASCII: \f[B]dlt-convert -a mylog.dlt\f[R]
.PP
Cut a specific range, e.g.\ from message 1 to message 3 from a file
called log.dlt and store the result to a file called newlog.dlt:
\f[B]dlt-convert -b 1 -e 3 -o newlog.dlt log.dlt\f[R]
.PP
Paste two dlt files log1.dlt and log2.dlt to a new file called
newlog.dlt: \f[B]dlt-convert -o newlog.dlt log1.dlt log2.dlt\f[R]
.PP
Handle the compressed input files and join inputs into a new file called
newlog.dlt: \f[B]dlt-convert -t -o newlog.dlt log1.dlt
compressed_log2.tar.gz\f[R]
.SH EXIT STATUS
.PP
Non zero is returned in case of failure.
.SH AUTHOR
.PP
Alexander Wenzel (alexander.aw.wenzel (at) bmw (dot) de)
.SH COPYRIGHT
.PP
Copyright (C) 2015 BMW AG.
License MPL-2.0: Mozilla Public License version 2.0
<http://mozilla.org/MPL/2.0/>.
.SH BUGS
.PP
See Github issue: <https://github.com/COVESA/dlt-daemon/issues>
.SH SEE ALSO
.PP
\f[B]dlt-daemon(1)\f[R]