1DLT-SYSTEM.CONF(5)                                          DLT-SYSTEM.CONF(5)
2
3
4

NAME

6       dlt-system.conf - DLT system process configuration file
7

DESCRIPTION

9       The  DLT  system logging process is the central application, which logs
10       system information from the platform.  It provides the  features  file‐
11       transfer,  syslog  adapater,  logging  of  any  kind of files and proc‐
12       filesystem logger.  The individual features can be enabled and disabled
13       in the configuration file.
14
15       The  configuration file dlt-system.conf allows to configure the differ‐
16       ent runtime behaviour of dlt-system.  The configuration file is  loaded
17       during startup of dlt-system.
18
19       dlt-system  loads  by  default  the  configuration  file  /etc/dlt-sys‐
20       tem.conf.  An alternative configuration file can be loaded with the op‐
21       tion -c.
22

GENERAL OPTIONS

24   ApplicationId
25       The application Id used for the dlt-system process.
26
27              Default: SYS
28

SHELL OPTIONS

30   ShellEnable
31       Enable  the Shell for command line injections.  Be careful when you en‐
32       able this feature.  The user can send any kind of shell commands.   The
33       commands  are executed with the rights of the dlt-system process.  Dlt-
34       system is started by default as user genivi.
35
36              Default: 0
37

SYSLOG ADAPTER OPTIONS

39   SyslogEnable
40       If this option is set to 1, the  syslog  adapter  feature  is  enabled.
41       SyslogPort needs to be configured too if Syslog is enabled.
42
43              Default: 0
44
45   SyslogContextId
46       This value defines context id of the syslog adapter.
47
48              Default: SYSL
49
50   SyslogPort
51       This  value defines the UDP port opened for receiving log messages from
52       syslog.  Configuration for syslog to forward log to this port is neces‐
53       sary.   Adding  this  config  *.*    @localhost:47111 in config file of
54       syslog (usually in /etc/rsyslog.d/50-default.conf) and restart the sys‐
55       log service by command “sudo systemctl restart rsyslog.service”.
56
57              Default: 47111
58

SYSTEMD JOURNAL ADAPTER OPTIONS

60   JournalEnable
61       Enable  the  Systemd  Journal Adapter.  This feature is only available,
62       when dlt is compiled with the option “WITH_SYSTEMD_JOURNAL”.   Dlt-sys‐
63       tem  is started by default as user genivi, see dlt-system.service file.
64       The user genivi must be added to one of the groups  `adm',  `wheel'  or
65       `systemd-journal' to have access to all journal entries.
66
67              Default: 0
68
69   JournalContextId
70       The Context Id of the journal adapter.
71
72              Default: JOUR
73
74   JournalCurrentBoot
75       Show  only  log entries of current boot and follow.  If JournalCurrent‐
76       Boot and JournalFollow are not set all persistent journal entries  will
77       be logged.
78
79              Default: 1
80
81   JournalFollow
82       Show only the last 10 entries and follow.
83
84              Default: 0
85
86   JournalMapLogLevels
87       Map journal log levels to DLT log levels.
88
89              - 0       Emergency     DLT_LOG_FATAL
90              - 1       Alert         DLT_LOG_FATAL
91              - 2       Critical      DLT_LOG_FATAL
92              - 3       Error         DLT_LOG_ERROR
93              - 4       Warning       DLT_LOG_WARN
94              - 5       Notice        DLT_LOG_INFO
95              - 6       Informational DLT_LOG_INFO
96              - 7       Debug         DLT_LOG_DEBUG
97
98              Default: 1
99

FILETRANSFER OPTIONS

101   FiletransferEnable
102       Enable the Filetransfer feature.  0 = disabled, 1 = enabled
103
104              Default: 0
105
106   FiletransferContextId
107       The Context Id of the filetransfer.
108
109              Default: FILE
110
111   FiletransferTimeStartup
112       Time  in  seconds after startup of dlt-system when first file is trans‐
113       fered.
114
115              Default: 0
116
117   FiletransferTimeoutBetweenLogs
118       Time in seconds to wait between two file transfer logs of a single file
119       to DLT.
120
121              Default: 10
122
123   FiletransferDirectory
124       You can define multiple file transfer directories.  Define the directo‐
125       ry to watch, whether to compress the file with zlib and the  zlib  com‐
126       pression  level.   For  parsing  purposes, FiletransferCompressionLevel
127       must be the last one of three values.
128
129   FiletransferCompression
130       See FiletransferDirectory option for explanation.
131
132              Default: 0
133
134   FiletransferCompressionLevel
135       See FiletransferDirectory option for explanation.
136
137              Default: 5
138

LOG FILES OPTIONS

140   LogFileEnable
141       If this option is set to 1, the log files feature is enabled.
142
143              Default: 0
144
145   LogFileFilename
146       This value sets the full filename path to the  file,  which  should  be
147       logged.
148
149   LogFileMode
150       This value defines in which operation mode the file is logged.  In mode
151       1 the file is only logged once when dlt-system is started.  In  mode  2
152       the file is logged regularly every time LogFileTimeDelay timer elapses.
153       0 = off, 1 = startup only, 2 = regular
154
155   LogFileTimeDelay
156       This value is used in mode 3 and defines the number of  seconds,  after
157       which the defined file is logged.
158
159   LogFileContextId
160       This value defines the context id, which is used for logging the file.
161

LOG PROCESSES OPTIONS

163   LogProcessesEnable
164       Enable the logging of processes.  0 = disabled, 1 = enabled
165
166              Default: 0
167
168   LogProcessesContextId
169       This  value defines the context id, which is used for logging processes
170       files.
171
172              Default: PROC
173
174   LogProcessName
175       This value defines the name of the process to be logged, as used in the
176       file stat of each process.  If the value is defined as *, all processes
177       are logged.
178
179   LogProcessFilename
180       This value sets the relative filename path to the file, which should be
181       logged.   The  path  is  relative  to  the procfilesystem folder of the
182       process.
183
184   LogProcessMode
185       This value the defines in which operation mode  this  process  file  is
186       logged.   In  mode  1  the  file is only logged once when dlt-system is
187       started.  In mode 2 the file is logged regularly  every  time  LogFile‐
188       TimeDelay timer elapses.  0 = off, 1 = startup only, 2 = regular.
189
190              Default: 0
191
192   LogProcessTimeDelay
193       This  value  is used in mode 3 and defines the number of seconds, after
194       which the defined procfilesystem file is logged.
195
196              Default: 0
197

AUTHOR

199       Alexander Wenzel (alexander.aw.wenzel (at) bmw (dot) de)
200
202       Copyright (C) 2015 BMW AG.  License  MPL-2.0:  Mozilla  Public  License
203       version 2.0 <http://mozilla.org/MPL/2.0/>.
204

BUGS

206       See Github issue: <https://github.com/GENIVI/dlt-daemon/issues>
207

SEE ALSO

209       dlt-system(1), dlt-daemon(1)
210
211
212
213                                                            DLT-SYSTEM.CONF(5)
Impressum