.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "DLT-RECEIVE" "1" "" "" ""
.hy
.SH NAME
.PP
\f[B]dlt-receive\f[R] - Console based client for DLT Logging
.SH SYNOPSIS
.PP
\f[B]dlt-receive\f[R] [\f[B]-h\f[R]] [\f[B]-a\f[R]] [\f[B]-x\f[R]]
[\f[B]-m\f[R]] [\f[B]-s\f[R]] [\f[B]-o\f[R] filename] [\f[B]-c\f[R]
limit] [\f[B]-v\f[R]] [\f[B]-y\f[R]] [\f[B]-b\f[R] baudrate]
[\f[B]-e\f[R] ecuid] [\f[B]-f\f[R] filterfile]
hostname/serial_device_name
.SH DESCRIPTION
.PP
Receive DLT messages from DLT daemon and print or store the messages.
.SS OPTIONS
.TP
-h
Display a short help text.
.TP
-a
Print DLT file; payload as ASCII.
.TP
-x
Print DLT file; payload as hex.
.TP
-m
Print DLT file; payload as hex and ASCII.
.TP
-s
Print DLT file; only headers.
.TP
-o
Output messages in new DLT file.
.TP
-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).
.TP
-v
Verbose mode.
.TP
-y
Serial device mode.
.TP
-b
Serial device baudrate (Default: 115200).
.TP
-e
Set ECU ID (Default: RECV).
.TP
-f
Enable filtering of messages.
.SH EXAMPLES
.PP
Print received message headers received from a dlt-daemon running on
localhost:: \f[B]dlt-receive -s localhost\f[R]
.PP
Print received message headers received from a serila interface::
\f[B]dlt-receive -s -y /dev/ttySO\f[R]
.PP
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)::
\f[B]dlt-receive -s -o log.dlt -f filter.txt localhost\f[R]
.PP
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:: \f[B]dlt-receive -o
log.dlt -c 1M localhost\f[R]
.SH EXIT STATUS
.PP
Non zero is returned in case of failure.
.SH NOTES
.PP
Be aware that dlt-receive will never delete any files.
Instead, it creates a new file.
.SH AUTHOR
.PP
Alexander Wenzel (alexander.aw.wenzel (at) bmw (dot) de)
.SH COPYRIGHT
.PP
Copyright (C) 2015 BMW AG.
License MPL-2.0: Mozilla Public License version 2.0
<http://mozilla.org/MPL/2.0/>.
.SH BUGS
.PP
See Github issue: <https://github.com/GENIVI/dlt-daemon/issues>
.SH SEE ALSO
.PP
\f[B]dlt-daemon(1)\f[R]