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)

                                                                                                  DLT-RECEIVE(1)