.\" Automatically generated by Pandoc 2.17.1.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "DLT-SORTBYTIMESTAMP" "1" "" "" ""
.hy
.SH NAME
.PP
\f[B]dlt-sortbytimestamp\f[R] - Re-order DLT Logging files according to
message creation time and timestamp.
.SH SYNOPSIS
.PP
\f[B]dlt-sortbytimestamp\f[R] [\f[B]-h\f[R]] [\f[B]-v\f[R]]
[\f[B]-c\f[R]] [\f[B]-f\f[R] filterfile] [\f[B]-b\f[R] number]
[\f[B]-e\f[R] number] dltfile_in dltfile_out
.SH DESCRIPTION
.PP
By default messages in DLT files are ordered according to the time the
logger received them.
This can unhelpful when tracing a sequence of events on a busy
multi-threaded/multi-core system, because thread pre-emption combined
with multiple processes attempting to log messages simultaneously means
that the order in which the messages are received may vary significantly
from the order in which they were created.
.PP
\f[I]dlt-sortbytimestamp\f[R] is able to re-order a DLT input file\[cq]s
messages according both their creation time and timestamp, and writes
them to an output DLT file.
.SH NOTE
.PP
Use the *-b* and/or *-e* options to specify a range of messages within a
single reboot cycle and all will be well.
.PP
Hint: use \f[I]dlt-viewer\f[R] to ascertain the endpoints of the range
in question.
.SH OPTIONS
.TP
-h
Display a short help text.
.TP
-v
Verbose mode.
Repeat to give more information.
.TP
-c
Count number of messages.
.TP
-f
Enable filtering of messages.
Incompatible with range options.
.TP
-b
First message to be handled.
Zero based index.
.TP
-e
Last message to be handled.
Zero based index.
.SH EXAMPLES
.PP
Sort an entire file by message timestamp: \f[B]dlt-sortbytimestamp
input.dlt output.dlt\f[R]
.PP
Sort a specific range, e.g.\ from message 1,000,000 to message 1,500,000
from a file called input.dlt and store the result in a file called
output.dlt: \f[B]dlt-sortbytimestamp -b 1000000 -e 1500000 input.dlt
output.dlt\f[R]
.SH EXIT STATUS
.PP
Non zero is returned in case of failure.
.SH AUTHOR
.PP
Jonathan Sambrook (jonathan.sambrook (at) codethink (dot) co (dot) uk)
Alexander Wenzel (alexander.aw.wenzel (at) bmw (dot) de)
.SH COPYRIGHT
.PP
Copyright (C) 2018 Codethink Ltd.
Copyright (C) 2015 BMW AG.
License MPL-2.0: Mozilla Public License version 2.0
.
.SH BUGS
.PP
See Github issue:
.SH SEE ALSO
.PP
\f[B]dlt-daemon(1)\f[R], \f[B]dlt-convert(1)\f[R]