summaryrefslogtreecommitdiff
path: root/doc/dlt-convert.1.txt
diff options
context:
space:
mode:
Diffstat (limited to 'doc/dlt-convert.1.txt')
-rw-r--r--doc/dlt-convert.1.txt87
1 files changed, 87 insertions, 0 deletions
diff --git a/doc/dlt-convert.1.txt b/doc/dlt-convert.1.txt
new file mode 100644
index 0000000..37d4886
--- /dev/null
+++ b/doc/dlt-convert.1.txt
@@ -0,0 +1,87 @@
+DLT-CONVERT(1)
+=============
+:doctype: manpage
+
+NAME
+----
+dlt-convert - Convert DLT Logging files into ASCII
+
+SYNOPSIS
+--------
+*dlt-convert* [-h] [-a] [-x] [-m] [-s][-o filename] [-v] [-c] [-b number] [-e number] [-w] file1 [file2] [file3]
+
+DESCRIPTION
+-----------
+Read DLT files, print DLT messages as ASCII and store the messages again.
+Use Ranges and Output file to cut DLT files.
+Use two files and Output file to join DLT files.
+
+OPTIONS
+-------
+*-h*::
+ Display a short help text.
+
+*-a*::
+ Print DLT file; payload as ASCII.
+
+*-x*::
+ Print DLT file; payload as hex.
+
+*-m*::
+ Print DLT file; payload as hex and ASCII.
+
+*-s*::
+ Print DLT file; only headers.
+
+*-o*::
+ Output messages in new DLT file.
+
+*-v*::
+ Verbose mode.
+
+*-c*::
+ Count number of messages.
+
+*-b*::
+ First messages to be handled.
+
+*-e*::
+ Last message to be handled.
+
+*-w*::
+ Follow dlt file while file is increasing.
+
+EXAMPLES
+--------
+Start DLT daemon in background mode::
+ *dlt-daemon -d*
+
+Start DLT daemon with own configuration::
+ *dlt-daemon -c ~/my-dlt-configuration.cfg*
+
+Convert DLT file into ASCII::
+ *dlt-convert -a mylog.dlt*
+
+Cut a specific range, e.g. from message 1 to message 3 from a file called log.dlt and store the result to a file called newlog.dlt::
+ *dlt-convert -b 1 -e 3 -o newlog.dlt log.dlt*
+
+Paste two dlt files log1.dlt and log2.dlt to a new file called newlog.dlt::
+ *dlt-convert -o newlog.dlt log1.dlt log2.dlt*
+
+EXIT STATUS
+-----------
+Non zero is returned in case of failure.
+
+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)
+