diff options
author | Alexander Wenzel <Alexander.AW.Wenzel@bmw.de> | 2012-10-11 17:39:25 +0200 |
---|---|---|
committer | Alexander Wenzel <Alexander.AW.Wenzel@bmw.de> | 2012-11-26 12:39:50 +0100 |
commit | 4d3b32d9f36e8a304e2c71503c7c824376425b0d (patch) | |
tree | 4c4981028d1d90960f5e5ffeb36f8c5a69248726 /doc/dlt.conf.5.txt | |
parent | f27d1eaff740e3d508680788a09a92fcc1f7c9b6 (diff) | |
download | DLT-daemon-4d3b32d9f36e8a304e2c71503c7c824376425b0d.tar.gz |
Modfied documentation using asciibook.
Signed-off-by: Alexander Wenzel <Alexander.AW.Wenzel@bmw.de>
Diffstat (limited to 'doc/dlt.conf.5.txt')
-rw-r--r-- | doc/dlt.conf.5.txt | 183 |
1 files changed, 183 insertions, 0 deletions
diff --git a/doc/dlt.conf.5.txt b/doc/dlt.conf.5.txt new file mode 100644 index 0000000..b21ab18 --- /dev/null +++ b/doc/dlt.conf.5.txt @@ -0,0 +1,183 @@ +DLT.CONF(5) +============= +:doctype: manpage + +NAME +---- +dlt.conf - DLT daemon configuration file + +DESCRIPTION +----------- +The DLT daemon is the central place where logs and traces are gathered +from different applications, stored temporarily or permanently and +transferred to a DLT client application, which can run directly on the +GENIVI system or more likely on a external tester device. + +The configuration file dlt.conf allows to configure the different +runtime behaviour of the dlt-daemon. The configuration file is loaded +during startup of dlt-daemon. + +dlt-daemon loads by default the configuration file /etc/dlt.conf. An +alternative configuration file can be loaded with the option -c. + +GENERAL OPTIONS +--------------- + +*Daemonize*:: + If set to 1 DLT daemon is started in background as daemon. This option + is only needed in System V init systems. In systemd based startup + systems the daemon is started by spawning own process. + + Default: 0 + +*SendSerialHeader*:: + If set to 1 DLT daemon sends each DLT message to the client with + prepanding the serial header "DLS0x01". + + Default: 0 + +*SendContextRegistration*:: + If set to 1 each context which is registered from an application in the + DLT daemon generates a message to inform the DLT client about the new + context. + + Default: 0 + +*SendMessageTime*:: + If set to 1 DLt daemon sends each second a DLT control message to the + client with the current timestamp from the system. + + Default: 0 + +*ECUId*:: + This value sets the ECU Id, which is sent with each DLT message. + + Default: ECU1 + +*SharedMemorySize*:: + This value sets the size of the shared memory, which is used to exchange + DLT messages between applications and daemon. This value is defined in + bytes. If this value is changed the system must be rebooted to take + effect. + + Default: 100000 + +*PersistanceStoragePath*:: + This is the directory path, where the DLT daemon stores its runtime + configuration. Runtime configuration includes stored log levels, trace + status and changed logging mode. + + Default: /tmp + +OFFLINE TRACE OPTIONS +--------------------- + +*OfflineTraceDirectory*:: + If this option is set, offline trace is enabled. This value sets the + directory path to the offline trace memory. The directory must already + exist. + + Default: Offline tracing is disabled. + +*OfflineTraceFileSize*:: + This value defines the max size of a offline trace file, if offline trace + is enabled. This value is defined in bytes. If the files size of the + current used log file is exceeded, a new log file is created. + + Default: 1000000 + +*OfflineTraceMaxSize*:: + This value defines the max offline Trace memory size, if offline trace + is enabled. This value is defined in bytes. If the overall offline trace + size is excedded, the oldest log files are deleted, until a new trace + file fits the overall offline trace max size. + + Default: 4000000 + +LOCAL CONSOLE OUTPUT OPTIONS +---------------------------- + +*PrintASCII*:: + Prints each received DLT message from the application in ASCII to the + local console. + This option should only be anabled for debugging purpose. + + Default: Function is disabled + +*PrintHex*:: + Prints each received DLT message from the application in ASCII to the + local console. The payload is printed in Hex. + This option should only be anabled for debugging purpose. + + Default: Function is disabled + +*PrintHeadersOnly*:: + Prints each received DLT message from the application in ASCII to the + local console. Only the header is printed. + This option should only be anabled for debugging purpose. + + Default: Function is disabled + +SERIAL CLIENT OPTIONS +--------------------- + +*RS232DeviceName*:: + If this value is set to a serial device name, e.g. /dev/ttyS0, a serial + port is used for logging to a client. + + Default: Serial port for logging is disabled + +*RS232Baudrate*:: + The used serial baud rate, if serial loggin is enabled. The + RS232DeviceName must be set to enable serial logging. + + Default: 115200 + +*RS232SyncSerialHeader*:: + If serial logging is enabled, each received DLT message is checked to + contain a serial header. If the DLT message contains no serial header, + the message is ignored. + + Default: Function is disabled + +TCP CLIENT OPTIONS +------------------ + +*TCPSyncSerialHeader*:: + Each received DLT message on a TCP connection is checked to contain a + serial header. If the DLT message contains no serial header, the message + is ignored. + +ECU Software version info +------------------------- + +*SendECUSoftwareVersion*:: + Send periodic ECU version info. 0=disabled, 1=enabled. + + Default: 0 + +*PathToECUSoftwareVersion*:: + Absolute path to file storing version information - if disabled the DLT version will be send. + +EXAMPLES +-------- +Start DLT daemon in background mode:: + *dlt-daemon -d* + +Start DLT daemon with own configuration:: + *dlt-daemon -c ~/my-dlt-configuration.cfg* + +AUTHOR +------ +Alexander Wenzel (alexander.aw.wenzel (at) bmw.de) + +RESOURCES +--------- +Main web site: <http://projects.genivi.org/diagnostic-log-trace> + +Mailinglist: <https://lists.genivi.org/mailman/listinfo/genivi-diagnostic-log-and-trace> + +SEE ALSO +-------- +dlt-daemon(1) + +dlt-system(1) + |