summaryrefslogtreecommitdiff
path: root/doc/dlt-receive.1.md
diff options
context:
space:
mode:
authorChristoph Lipka <clipka@users.noreply.github.com>2019-02-12 10:32:13 +0100
committerGitHub <noreply@github.com>2019-02-12 10:32:13 +0100
commit1713e3913722d1222c968ca53326865d23a2b0ab (patch)
tree477489d98c7694fd8937debadb2fcf61b2f7fa3e /doc/dlt-receive.1.md
parent4c4cc967ad46abae60f2f9bf5e47b65e8bcbb4b1 (diff)
downloadDLT-daemon-2.18.1.tar.gz
doc: Move all man pages to markdown files (#102)v2.18.1
All manpages have been removed, because they will be autogenerated from markdown files using pandoc.
Diffstat (limited to 'doc/dlt-receive.1.md')
-rw-r--r--doc/dlt-receive.1.md101
1 files changed, 101 insertions, 0 deletions
diff --git a/doc/dlt-receive.1.md b/doc/dlt-receive.1.md
new file mode 100644
index 0000000..38cd2be
--- /dev/null
+++ b/doc/dlt-receive.1.md
@@ -0,0 +1,101 @@
+% DLT-RECEIVE(1)
+
+# NAME
+
+**dlt-receive** - Console based client for DLT Logging
+
+# SYNOPSIS
+
+**dlt-receive** \[**-h**\] \[**-a**\] \[**-x**\] \[**-m**\] \[**-s**\] \[**-o** filename\] \[**-c** limit\] \[**-v**\] \[**-y**\] \[**-b** baudrate\] \[**-e** ecuid\] \[**-f** filterfile\] hostname/serial_device_name
+
+# DESCRIPTION
+
+Receive DLT messages from DLT daemon and print or store the messages.
+
+## 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.
+
+-c
+
+: Set limit when storing messages in file. When limit is reached, a new file is opened. Use K,M,G as suffix to specify kilo-, mega-, giga-bytes respectively, e.g. 1M for one megabyte (Default: unlimited).
+
+-v
+
+: Verbose mode.
+
+-y
+
+: Serial device mode.
+
+-b
+
+: Serial device baudrate (Default: 115200).
+
+-e
+
+: Set ECU ID (Default: RECV).
+
+-f
+
+: Enable filtering of messages.
+
+# EXAMPLES
+
+Print received message headers received from a dlt-daemon running on localhost::
+ **dlt-receive -s localhost**
+
+Print received message headers received from a serila interface::
+ **dlt-receive -s -y /dev/ttySO**
+
+Store received message headers from a dlt-daemon to a log file called log.dlt and filter them for e.g. Application ID ABCD and Context ID EFGH (Write:ABCD EFGH as single line to a file called filter.txt)::
+ **dlt-receive -s -o log.dlt -f filter.txt localhost**
+
+Store incoming messages in file(s) and restrict file sizes to 1 megabyte. If limit is reached, log.dlt will be renamed into log.0.dlt, log.1.dlt, ... No files will be overwritten in this mode::
+ **dlt-receive -o log.dlt -c 1M localhost**
+
+# EXIT STATUS
+
+Non zero is returned in case of failure.
+
+# NOTES
+
+Be aware that dlt-receive will never delete any files. Instead, it creates a new file.
+
+# AUTHOR
+
+Alexander Wenzel (alexander.aw.wenzel (at) bmw (dot) de)
+
+# COPYRIGHT
+
+Copyright (C) 2015 BMW AG. License MPL-2.0: Mozilla Public License version 2.0 <http://mozilla.org/MPL/2.0/>.
+
+# BUGS
+
+See Github issue: <https://github.com/GENIVI/dlt-daemon/issues>
+
+# SEE ALSO
+
+**dlt-daemon(1)**