DLT-CONTROL(1)

👑 NAME 👑

dlt-control — bestie, this is the lil tool that slides into DLT Daemon's DMs and sends control messages. 💌

---

🦋 SYNOPSIS 🦋

dlt-control [-v] [-h] [-S] [-R] [-y] [-b baudrate] [-e ecuid] [-a id]
[-c id] [-s id] [-m message] [-x message] [-t milliseconds] [-l level]
[-r tracestatus] [-d loglevel] [-f tracestatus] [-i enable] [-o] [-g]
[-j] [-u] [-p port] hostname/serial_device_name

okay so that's a LOT of little flags and honestly? they're all iconic in their own way. let's go. 💅

---

💜 DESCRIPTION 💜

So like. dlt-control sends control messages to the DLT Daemon. ✨

When is this a whole mood? When there's no client available — think no DLT Viewer sitting there doing its thing. Then this little queen steps in. 👑

It supports several control messages, including:

• Setting log level / trace level
• Setting default log level / default trace level
• Enable timing packets
• Store configuration
• Reset to factory default
• Get logging information

🫶 note, bestie: use the -u option instead of hostname/serial_device_name if a Unix Socket is being used. the example section has the receipts, scroll down. 💖

---

✨ OPTIONS ✨

• -v — Verbose mode. she talks more. 🗣️
• -h — Usage. the "help meee" button. 🙈
• -S — Send message with serial header. (Default: Without serial header)
• -R — Enable resync serial header.
• -y — Serial device mode. 🎀
• -b — Serial device baudrate. (Default: 115200)
• -e — Set ECU ID. (Default: RECV)
• -a — Control message application id.
• -c — Control message context id.
• -s — Control message injection service id.
• -m — Control message injection in ASCII.
• -x — Control message injection in Hex, e.g. ad 01 24 ef. 🔥
• -t — Timeout to terminate application. (Default: 1000)
• -l — Set the log level (0=off - 6=verbose, default= -1). supported options, and yes you get all of them:
  • -l level -a apid -c ctid
  • -l level -a abc* (set level for all ctxts of apps name starts with abc)
  • -l level -a apid (set level for all ctxts of this app)
  • -l level -c xyz* (set level for all ctxts whose name starts with xyz)
  • -l level -c ctid (set level for the particular ctxt)
  • -l level (set level for all the registered contexts)
• -r — Set the trace status (0=off - 1=on, default= 255). supported options, again, the whole lineup:
  • -r tracestatus -a apid -c ctid
  • -r tracestatus -a abc* (set status for all ctxts of apps name starts with abc)
  • -r tracestatus -a apid (set status for all ctxts of this app)
  • -r tracestatus -c xyz* (set status for all ctxts whose name starts with xyz)
  • -r tracestatus -c ctid (set status for the particular ctxt)
  • -r tracestatus (set status for all the registered contexts)
• -d — Set the default log level (0=off - 5=verbose). 📶
• -f — Set the default trace status (0=off - 1=on).
• -i — Enable timing packets (0=off - 1=on). ⏱️
• -o — Store configuration. 💾
• -g — Reset to factory default. the "we're so back to zero" button. 💀
• -j — Get log info. the gossip session. ☕
• -u — unix port.
• -p — Port for TCP communication. (Default: 3490)

---

🌈 EXAMPLES 🌈

Change log level of application "APP1" to DEBUG with unix port

dlt-control -a APP1 -l 5 -u

---

Change log level of application "APP1" and context "CON1" to ERROR

dlt-control -a APP1 -c CON1 -l 2 localhost

---

Get logging information of current running applications with unix port (IPC: Unix Socket)

dlt-control -j -u

---

Get logging information of current running applications (IPC:FIFO)

dlt-control -j localhost

---

⭐ EXIT STATUS ⭐

Non zero is returned in case of failure. so like, if it's not 0, something went wrong. no cap. 😭

---

💖 AUTHOR 💖

Saya Sugiura (ssugiura (at) jp.adit-jv (dot) com) — the queen who built this. 👑

---

🎀 COPYRIGHT 🎀

Copyright (C) 2019 Advanced Driver Information Technology, Bosch and DENSO. License MPL-2.0: Mozilla Public License version 2.0 http://mozilla.org/MPL/2.0/.

---

🐛 BUGS 🐛

See Github issue: https://github.com/COVESA/dlt-daemon/issues

(go tell them, they're nice about it fr fr 🫶)

---

🦋 SEE ALSO 🦋

• dlt-daemon(1)

---

and that's the whole page bestie 💜 this was DLT-CONTROL(1) — the one and only dlt-control(1) manual page. go forth and control your daemon. slay. ✨🌸