summaryrefslogtreecommitdiff
path: root/doc/dlt-control.1.md
blob: 35d86cf1f5e8b2cd87574afdd2e1555190811010 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
% DLT-CONTROL(1)

# NAME

**dlt-control** - Send control messages to DLT Daemon

# 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**\] hostname/serial\_device\_name

# DESCRIPTION

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

**Note** Use -u option instead of hostname/serial\_device\_name if Unix Socket
is used. See example for detail.

## OPTIONS

-v

:    Verbose mode

-h

:    Usage

-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:
      -l level -a appid -c ctid
      -l level -a abc* (set level for all ctxts of apps name starts with abc)
      -l level -a appid (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 ctxid (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:
       -r tracestatus -a appid -c ctid
       -r tracestatus -a abc* (set status for all ctxts of apps name starts with abc)
       -r tracestatus -a appid (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 ctxid (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

-j

:    Get log info

-u
:    unix port

# 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.

# AUTHOR

Saya Sugiura (ssugiura (at) jp.adit-jv (dot) com)

# 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/GENIVI/dlt-daemon/issues>

# SEE ALSO

**dlt-daemon(1)**