.\" Automatically generated by Pandoc 2.17.1.1
.\"
.\" 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-CONTROL" "1" "" "" ""
.hy
.SH NAME
.PP
\f[B]dlt-control\f[R] - Send control messages to DLT Daemon
.SH SYNOPSIS
.PP
\f[B]dlt-control\f[R] [\f[B]-v\f[R]] [\f[B]-h\f[R]] [\f[B]-S\f[R]]
[\f[B]-R\f[R]] [\f[B]-y\f[R]] [\f[B]-b\f[R] baudrate] [\f[B]-e\f[R]
ecuid] [\f[B]-a\f[R] id] [\f[B]-c\f[R] id] [\f[B]-s\f[R] id]
[\f[B]-m\f[R] message] [\f[B]-x\f[R] message] [\f[B]-t\f[R]
milliseconds] [\f[B]-l\f[R] level] [\f[B]-r\f[R] tracestatus]
[\f[B]-d\f[R] loglevel] [\f[B]-f\f[R] tracestatus] [\f[B]-i\f[R] enable]
[\f[B]-o\f[R]] [\f[B]-g\f[R]] [\f[B]-j\f[R]] [\f[B]-u\f[R]]
[\f[B]-p\f[R] port] hostname/serial_device_name
.SH DESCRIPTION
.PP
Send control messages to DLT Daemon.
This is useful when there is no client (e.g.\ DLT Viewer) available.
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
.PP
\f[B]Note\f[R] Use -u option instead of hostname/serial_device_name if
Unix Socket is used.
See example for detail.
.SS OPTIONS
.TP
-v
Verbose mode
.TP
-h
Usage
.TP
-S
Send message with serial header (Default: Without serial header)
.TP
-R
Enable resync serial header
.TP
-y
Serial device mode
.TP
-b
Serial device baudrate (Default: 115200)
.TP
-e
Set ECU ID (Default: RECV)
.TP
-a
Control message application id
.TP
-c
Control message context id
.TP
-s
Control message injection service id
.TP
-m
Control message injection in ASCII
.TP
-x
Control message injection in Hex e.g.\ `ad 01 24 ef'
.TP
-t
Timeout to terminate application (Default:1000)
.PP
-l
.IP
.nf
\f[C]
Set the log level (0=off - 6=verbose, default= -1)
supported options:
  -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)
\f[R]
.fi
.TP
-r
Set the trace status (0=off - 1=on, default=255) supported options: -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)
.TP
-d
Set the default log level (0=off - 5=verbose)
.TP
-f
Set the default trace status (0=off - 1=on)
.TP
-i
Enable timing packets (0=off - 1=on)
.TP
-o
Store configuration
.TP
-g
Reset to factory default
.TP
-j
Get log info
.TP
-u
unix port
.TP
-p
Port for TCP communication (Default: 3490).
.SH EXAMPLES
.PP
Change log level of application \[lq]APP1\[rq] to DEBUG with unix port
\f[B]dlt-control -a APP1 -l 5 -u\f[R]
.PP
Change log level of application \[lq]APP1\[rq] and context
\[lq]CON1\[rq] to ERROR \f[B]dlt-control -a APP1 -c CON1 -l 2
localhost\f[R]
.PP
Get logging information of current running applications with unix port
(IPC: Unix Socket) \f[B]dlt-control -j -u\f[R]
.PP
Get logging information of current running applications (IPC:FIFO)
\f[B]dlt-control -j localhost\f[R]
.SH EXIT STATUS
.PP
Non zero is returned in case of failure.
.SH AUTHOR
.PP
Saya Sugiura (ssugiura (at) jp.adit-jv (dot) com)
.SH COPYRIGHT
.PP
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/.
.SH BUGS
.PP
See Github issue: <https://github.com/GENIVI/dlt-daemon/issues>
.SH SEE ALSO
.PP
\f[B]dlt-daemon(1)\f[R]