1DLT.CONF(5) DLT.CONF(5)
2
3
4
6 dlt.conf - DLT daemon configuration file
7
9 The DLT daemon is the central application which gathers logs and traces
10 from different applications, stores them temporarily or permanently and
11 transfers them to a DLT client application, which could run directly on
12 the GENIVI system or more likely on some external tester device.
13
14 The configuration file dlt.conf allows to configure the different run‐
15 time behaviour of the dlt-daemon. It is loaded during startup of dlt-
16 daemon.
17
19 Verbose
20 Start daemon in debug mode, so that all internal debug information is
21 printed out on the console.
22
23 Default: Off
24
25 Daemonize
26 If set to 1 DLT daemon is started in background as daemon. This option
27 is only needed in System V init systems. In systemd based startup sys‐
28 tems the daemon is started by spawning own process.
29
30 Default: 0
31
32 SendSerialHeader
33 If set to 1 DLT daemon sends each DLT message to the client with
34 prepanding the serial header “DLS0x01”.
35
36 Default: 0
37
38 SendContextRegistration
39 If set to 1 each context which is registered from an application in the
40 DLT daemon generates a message to inform the DLT client about the new
41 context.
42
43 Default: 1
44
45 SendMessageTime
46 If set to 1 DLt daemon sends each second a DLT control message to the
47 client with the current timestamp from the system.
48
49 Default: 0
50
51 ECUId
52 This value sets the ECU Id, which is sent with each DLT message.
53
54 Default: ECU1
55
56 SharedMemorySize
57 This value sets the size of the shared memory, which is used to ex‐
58 change DLT messages between applications and daemon. This value is de‐
59 fined in bytes. If this value is changed the system must be rebooted
60 to take effect.
61
62 Default: 100000
63
64 PersistanceStoragePath
65 This is the directory path, where the DLT daemon stores its runtime
66 configuration. Runtime configuration includes stored log levels, trace
67 status and changed logging mode.
68
69 Default: /tmp
70
71 LoggingMode
72 The logging console for internal logging of dlt-daemon. 0 = log to
73 stdout, 1 = log to syslog, 2 = log to file (see LoggingFilename), 3 =
74 log to stderr
75
76 Default: 0
77
78 LoggingLevel
79 The internal log level, up to which logs are written. LOG_EMERG = 0,
80 LOG_ALERT = 1, LOG_CRIT = 2, LOG_ERR = 3, LOG_WARNING = 4, LOG_NOTICE =
81 5, LOG_INFO = 6, LOG_DEBUG = 7
82
83 Default: 6
84
85 LoggingFilename
86 If LoggingMode is set to 2 logs are written to the file path given
87 here.
88
89 Default: /tmp/dlt.log
90
91 EnableLoggingFileLimit
92 Only relevant for logging in file (LoggingMode = 2). If EnableLogging‐
93 FileLimit is set to 0, the daemon logs to one logging file without any
94 size limit. If EnableLoggingFileLimit is set to 1, the daemon consid‐
95 ers the size limits configured by LoggingFileSize and LoggingFileMax‐
96 Size. If the limits are configured accordingly, multiple log files are
97 used.
98
99 Default: 0
100
101 LoggingFileSize
102 Only considered for logging in file (LoggingMode = 2) and EnableLog‐
103 gingFileLimit = 1. Maximum size in bytes of one logging file.
104
105 Default: 250000
106
107 LoggingFileMaxSize
108 Only considered for logging in file (LoggingMode = 2) and EnableLog‐
109 gingFileLimit = 1. Maximum size in bytes of all logging files.
110
111 Default: 1000000
112
113 TimeOutOnSend
114 Socket timeout in seconds for sending to clients.
115
116 Default: 4
117
118 RingbufferMinSize
119 The minimum size of the Ringbuffer, used for storing temporary DLT mes‐
120 sages, until client is connected.
121
122 Default: 500000
123
124 RingbufferMaxSize
125 The max size of the Ringbuffer, used for storing temporary DLT mes‐
126 sages, until client is connected.
127
128 Default: 10000000
129
130 RingbufferStepSize
131 The step size the Ringbuffer is increased, used for storing temporary
132 DLT messages, until client is connected.
133
134 Default: 500000
135
136 Daemon FIFOSize
137 The size of Daemon FIFO (MinSize: depend on pagesize of system, Max‐
138 Size: please check /proc/sys/fs/pipe-max-size) This is only supported
139 for Linux.
140
141 Default: 65536
142
143 ContextLogLevel
144 Initial log-level that is sent when an application registers.
145 DLT_LOG_OFF = 0, DLT_LOG_FATAL = 1, DLT_LOG_ERROR = 2, DLT_LOG_WARN =
146 3, DLT_LOG_INFO = 4, DLT_LOG_DEBUG = 5, DLT_LOG_VERBOSE = 6
147
148 Default: 4
149
150 ContextTraceStatus
151 Initial trace-status that is sent when an application registers.
152 DLT_TRACE_STATUS_OFF = 0, DLT_TRACE_STATUS_ON = 1
153
154 Default: 0
155
156 ForceContextLogLevelAndTraceStatus
157 Force log level and trace status of contexts to not exceed “Context‐
158 LogLevel” and “ContextTraceStatus”. If set to 1 (ON) whenever a con‐
159 text registers or changes the log-level it has to be lower or equal to
160 ContextLogLevel.
161
162 Default: 0
163
164 InjectionMode
165 If set to 0, the injection mode (see here) is disabled.
166
167 Default: 1
168
170 GatewayMode
171 Enable Gateway mode
172
173 Default: 0
174
175 GatewayConfigFile
176 Read gateway configuration from another location
177
178 Default: /etc/dlt_gateway.conf
179
181 DLT daemon runs with e.g. User: genivi_dlt Group: genivi_dlt
182
183 DLT user applications run with different user and group than dlt-daemon
184 but with supplimentory group: dlt_user_apps_group
185
186 /dlt FIFO will be created by dlt-daemon with User: genivi_dlt Group:
187 dlt_user_apps_group Permission: 620
188
189 so that only dlt-daemon can read and only processes in dlt_us‐
190 er_apps_group can write.
191
192 /dltpipes will be created by dlt-daemon with User: genivi_dlt Group:
193 genivi_dlt Permission: 3733 (i.e Sticky bit and SGID turned on)
194
195 /dltpipes/dlt FIFO will be created by dlt application (user lib) with
196 User: Group: genivi_dlt (inherited from dltpipes/ due to SGID) Permis‐
197 sion: 620
198
199 Thus DLT user applications (and also or attackers) can create the dlt
200 FIFO (for communication from dlt-daemon to DLT user application) under
201 /dltpipes/. Since sticky bit is set the applications who creates the
202 FIFO can only rename/delete it.
203
204 Since SGID of /dltpipes is set the group of dlt FIFO will be genivi_dlt
205 which enables dlt daemon to have write permission on all the dlt FIFO.
206
207 One dlt user application cannot access dlt FIFO created by other dlt
208 user application(if they run with different user).
209
210 Owner group of daemon FIFO directory(Default: /tmp/dlt) (If not set,
211 primary group of dlt-daemon process is used). Application should have
212 write permission to this group for tracing into dlt. For this opton to
213 work, dlt-daemon should have this group in it’s supplementary group.
214
215 DaemonFifoGroup
216 Owner group of daemon FIFO directory (If not set, primary group of dlt-
217 daemon process is used) Application should have write permission to
218 this group for tracing into dlt For this opton to work, dlt-daemon
219 should have this group in it’s Supplementary group
220
221 Default: group of dlt-daemon process (/tmp/dlt)
222
224 ControlSocketPath
225 Path to control socket.
226
227 Default: /tmp/dlt-ctrl.sock
228
230 OfflineTraceDirectory
231 Store DLT messages to local directory, if not set offline Trace is off.
232
233 Default: /tmp
234
235 OfflineTraceFileSize
236 This value defines the max size of a offline trace file, if offline
237 trace is enabled. This value is defined in bytes. If the files size
238 of the current used log file is exceeded, a new log file is created.
239
240 Default: 1000000
241
242 OfflineTraceMaxSize
243 This value defines the max offline Trace memory size, if offline trace
244 is enabled. This value is defined in bytes. If the overall offline
245 trace size is excedded, the oldest log files are deleted, until a new
246 trace file fits the overall offline trace max size.
247
248 Default: 4000000
249
250 OfflineTraceFileNameTimestampBased
251 Filename timestamp based or index based. 1 = timestamp based, 0 = in‐
252 dex based
253
254 Default: Function is disabled
255
257 PrintASCII
258 Prints each received DLT message from the application in ASCII to the
259 local console. This option should only be anabled for debugging pur‐
260 pose.
261
262 Default: Function is disabled
263
264 PrintHex
265 Prints each received DLT message from the application in ASCII to the
266 local console. The payload is printed in Hex. This option should only
267 be anabled for debugging purpose.
268
269 Default: Function is disabled
270
271 PrintHeadersOnly
272 Prints each received DLT message from the application in ASCII to the
273 local console. Only the header is printed. This option should only be
274 anabled for debugging purpose.
275
276 Default: Function is disabled
277
279 RS232DeviceName
280 If this value is set to a serial device name, e.g. /dev/ttyS0, a serial
281 port is used for logging to a client.
282
283 Default: Serial port for logging is disabled
284
285 RS232Baudrate
286 The used serial baud rate, if serial loggin is enabled. The RS232Devi‐
287 ceName must be set to enable serial logging.
288
289 Default: 115200
290
291 RS232SyncSerialHeader
292 If serial logging is enabled, each received DLT message is checked to
293 contain a serial header. If the DLT message contains no serial header,
294 the message is ignored.
295
296 Default: Function is disabled
297
299 TCPSyncSerialHeader
300 Each received DLT message on a TCP connection is checked to contain a
301 serial header. If the DLT message contains no serial header, the mes‐
302 sage is ignored.
303
304 Default: Function is disabled
305
307 SendECUSoftwareVersion
308 Periodically send ECU version info. 0 = disabled, 1 = enabled
309
310 Default: Function is disabled
311
313 Absolute path to file storing version information - if disabled the DLT
314 version will be send.
315
316 Default: Function is disabled.
317
320 Periodically send timezone info. 0 = disabled, 1 = enabled
321
322 Default: Function is disabled
323
325 OfflineLogstorageMaxDevices
326 Maximum devices to be used as offline logstorage devices. 0 = dis‐
327 abled, 1 .. DLT_OFFLINE_LOGSTORAGE_MAX_DEVICES
328
329 Default: 0 (Function is disabled)
330
331 OfflineLogstorageDirPath
332 Path to store DLT offline log storage messages.
333
334 Default: off
335
336 OfflineLogstorageTimestamp
337 Appends timestamp in log file name. 0 = disabled, 1 = enabled
338
339 Default: 0
340
341 OfflineLogstorageDelimiter
342 Appends delimiter in log file name, only punctuation characters al‐
343 lowed.
344
345 Default: _
346
347 OfflineLogstorageMaxCounter
348 Wrap around value for log file count in file name.
349
350 Default: UINT_MAX
351
352 OfflineLogstorageCacheSize
353 Maximal used memory for log storage cache in KB.
354
355 Default: 30000 KB
356
357 UDPConnectionSetup
358 Enable or disable UDP connection. 0 = disabled, 1 = enabled
359
360 UDPMulticastIPAddress
361 The address on which daemon multicasts the log messages
362
363 UDPMulticastIPPort
364 The Multicase IP port. Default: 3491
365
367 Alexander Wenzel (alexander.aw.wenzel (at) bmw (dot) de)
368
370 Copyright (C) 2015 BMW AG. License MPL-2.0: Mozilla Public License
371 version 2.0 <http://mozilla.org/MPL/2.0/>.
372
374 See Github issue: <https://github.com/GENIVI/dlt-daemon/issues>
375
377 dlt-daemon(1), dlt-system(1)
378
379
380
381 DLT.CONF(5)