DLT-CONVERT(1)

💖 DLT-CONVERT(1) 💖

okay bestie, welcome to the dlt-convert page, section 1 of the manual, and ngl it's a lil gem 🫶

✨ NAME ✨

dlt-convert — turn DLT Logging files into ASCII. that's the whole job. it's giving translator, but for logs 💅

---

🌸 SYNOPSIS 🌸

dlt-convert [-h] [-a] [-x] [-m] [-s] [-t] [-o filename] [-v] [-c] [-f
filterfile] [-b number] [-e number] [-w] file1 [file2] [file3]

🦋 DESCRIPTION 🦋

so what does it actually do? it reads DLT files, prints the DLT messages as ASCII, and then stores those messages again. read, glow up, re-save ✨

want to cut a DLT file down to size? use Ranges plus an Output file. want to smoosh two DLT files together into one? use two files plus an Output file. iconic, no cap.

🎀 OPTIONS 🎀

• -h — shows you a short help text. tiny lil rescue map 🗺️
• -a — prints the DLT file with the payload as ASCII. the classic ✨
• -x — prints the DLT file with the payload as hex. very raw, very hexcore 🔥
• -m — prints the DLT file with the payload as hex and ASCII. both. because why choose 💅
• -s — prints the DLT file, but only the headers. no payload, just the vibe check 👑
• -o — outputs the messages into a new DLT file.
• -v — verbose mode. it will Not shut up (affectionately) 🗣️
• -c — counts the number of messages. math era 🔢
• -f — enables filtering of messages.
• -b — the first messages to be handled.
• -e — the last message to be handled.
• -w — follows the dlt file while the file is increasing. it's literally stalking the file, consensually 🙈
• -t — handles the compressed input files (tar.gz). zip zap 🧚

---

🌈 EXAMPLES 🌈

convert a DLT file into ASCII:

dlt-convert -a mylog.dlt

cut a specific range — say from message 1 to message 3 — out of a file called log.dlt and store the result in a file called newlog.dlt:

dlt-convert -b 1 -e 3 -o newlog.dlt log.dlt

paste two dlt files, log1.dlt and log2.dlt, into a new file called newlog.dlt:

dlt-convert -o newlog.dlt log1.dlt log2.dlt

handle the compressed input files and join the inputs into a new file called newlog.dlt:

dlt-convert -t -o newlog.dlt log1.dlt compressed_log2.tar.gz

---

💀 EXIT STATUS 💀

if something goes wrong, it returns non zero. that's the failure signal, bestie. zero = we ate, non-zero = we did not eat 😭

👑 AUTHOR 👑

Alexander Wenzel (alexander.aw.wenzel (at) bmw (dot) de)

💜 COPYRIGHT 💜

Copyright (C) 2015 BMW AG. License MPL-2.0: Mozilla Public License version 2.0 http://mozilla.org/MPL/2.0/.

🍓 BUGS 🍓

found a lil gremlin? See Github issue: https://github.com/COVESA/dlt-daemon/issues

⭐ SEE ALSO ⭐

dlt-daemon(1)

---

fr fr, the only hard rule here: if it fails, the exit status is non-zero. no gaslighting.

okay that's the whole page, mwah 💖 this was DLT-CONVERT(1), and heads up — there's no version or date stamped on this one, so just the manual name and that's it. bye bestie, go convert something 🦋✨