1DLT.CONF(5) DLT.CONF(5)
2
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 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 Default: Off
24 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 Default: 0
31 SendSerialHeader
33 If set to 1 DLT daemon sends each DLT message to the client with
34 prepanding the serial header “DLS0x01”.
35 Default: 0
37 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 Default: 1
44 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 Default: 0
50 ECUId
52 This value sets the ECU Id, which is sent with each DLT message.
53 Default: ECU1
55 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 Default: 100000
63 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 Default: /tmp
70 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 Default: 0
77 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 Default: 6
84 LoggingFilename
86 If LoggingMode is set to 2 logs are written to the file path given
87 here.
88 Default: /tmp/dlt.log
90 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 Default: 0
100 LoggingFileSize
102 Only considered for logging in file (LoggingMode = 2) and EnableLog‐
103 gingFileLimit = 1. Maximum size in bytes of one logging file.
104 Default: 250000
106 LoggingFileMaxSize
108 Only considered for logging in file (LoggingMode = 2) and EnableLog‐
109 gingFileLimit = 1. Maximum size in bytes of all logging files.
110 Default: 1000000
112 TimeOutOnSend
114 Socket timeout in seconds for sending to clients.
115 Default: 4
117 RingbufferMinSize
119 The minimum size of the Ringbuffer, used for storing temporary DLT mes‐
120 sages, until client is connected.
121 Default: 500000
123 RingbufferMaxSize
125 The max size of the Ringbuffer, used for storing temporary DLT mes‐
126 sages, until client is connected.
127 Default: 10000000
129 RingbufferStepSize
131 The step size the Ringbuffer is increased, used for storing temporary
132 DLT messages, until client is connected.
133 Default: 500000
135 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 Default: 65536
142 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 Default: 4
149 ContextTraceStatus
151 Initial trace-status that is sent when an application registers.
152 DLT_TRACE_STATUS_OFF = 0, DLT_TRACE_STATUS_ON = 1
153 Default: 0
155 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 Default: 0
163 InjectionMode
165 If set to 0, the injection mode (see here) is disabled.
166 Default: 1
168
170 GatewayMode
171 Enable Gateway mode
172 Default: 0
174 GatewayConfigFile
176 Read gateway configuration from another location
177 Default: /etc/dlt_gateway.conf
179
181 DLT daemon runs with e.g. User: genivi_dlt Group: genivi_dlt
182 DLT user applications run with different user and group than dlt-daemon
184 but with supplimentory group: dlt_user_apps_group
185 /dlt FIFO will be created by dlt-daemon with User: genivi_dlt Group:
187 dlt_user_apps_group Permission: 620
188 so that only dlt-daemon can read and only processes in dlt_us‐
190 er_apps_group can write.
191 /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 /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 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 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 One dlt user application cannot access dlt FIFO created by other dlt
208 user application(if they run with different user).
209 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 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 Default: group of dlt-daemon process (/tmp/dlt)
222
224 ControlSocketPath
225 Path to control socket.
226 Default: /tmp/dlt-ctrl.sock
228
230 OfflineTraceDirectory
231 Store DLT messages to local directory, if not set offline Trace is off.
232 Default: /tmp
234 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 Default: 1000000
241 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 Default: 4000000
249 OfflineTraceFileNameTimestampBased
251 Filename timestamp based or index based. 1 = timestamp based, 0 = in‐
252 dex based
253 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 Default: Function is disabled
263 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 Default: Function is disabled
270 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 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 Default: Serial port for logging is disabled
284 RS232Baudrate
286 The used serial baud rate, if serial loggin is enabled. The RS232Devi‐
287 ceName must be set to enable serial logging.
288 Default: 115200
290 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 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 Default: Function is disabled
305
307 SendECUSoftwareVersion
308 Periodically send ECU version info. 0 = disabled, 1 = enabled
309 Default: Function is disabled
311
313 Absolute path to file storing version information - if disabled the DLT
314 version will be send.
315 Default: Function is disabled.
317
320 Periodically send timezone info. 0 = disabled, 1 = enabled
321 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 Default: 0 (Function is disabled)
330 OfflineLogstorageDirPath
332 Path to store DLT offline log storage messages.
333 Default: off
335 OfflineLogstorageTimestamp
337 Appends timestamp in log file name. 0 = disabled, 1 = enabled
338 Default: 0
340 OfflineLogstorageDelimiter
342 Appends delimiter in log file name, only punctuation characters al‐
343 lowed.
344 Default: _
346 OfflineLogstorageMaxCounter
348 Wrap around value for log file count in file name.
349 Default: UINT_MAX
351 OfflineLogstorageCacheSize
353 Maximal used memory for log storage cache in KB.
354 Default: 30000 KB
356 UDPConnectionSetup
358 Enable or disable UDP connection. 0 = disabled, 1 = enabled
359 UDPMulticastIPAddress
361 The address on which daemon multicasts the log messages
362 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 DLT.CONF(5)