dlt-sortbytimestamp(1)

1DLT-SORTBYTIMESTAMP(1)                                  DLT-SORTBYTIMESTAMP(1)
2
3
4

NAME

6       dlt-sortbytimestamp  -  Re-order DLT Logging files according to message
7       creation time and timestamp.
8

SYNOPSIS

10       dlt-sortbytimestamp [-h] [-v] [-c] [-f filterfile] [-b number] [-e num‐
11       ber] dltfile_in dltfile_out
12

DESCRIPTION

14       By  default messages in DLT files are ordered according to the time the
15       logger received them.  This can unhelpful when tracing  a  sequence  of
16       events  on a busy multi-threaded/multi-core system, because thread pre-
17       emption combined with multiple processes attempting to log messages si‐
18       multaneously  means  that  the order in which the messages are received
19       may vary significantly from the order in which they were created.
20
21       dlt-sortbytimestamp is able to re-order a DLT input file’s messages ac‐
22       cording  both  their creation time and timestamp, and writes them to an
23       output DLT file.
24

NOTE

26       Use the *-b* and/or *-e* options to specify a range of messages  within
27       a single reboot cycle and all will be well.
28
29       Hint:  use  dlt-viewer to ascertain the endpoints of the range in ques‐
30       tion.
31

OPTIONS

33       -h     Display a short help text.
34
35       -v     Verbose mode.  Repeat to give more information.
36
37       -c     Count number of messages.
38
39       -f     Enable filtering of messages.  Incompatible with range options.
40
41       -b     First message to be handled.  Zero based index.
42
43       -e     Last message to be handled.  Zero based index.
44

EXAMPLES

46       Sort an entire file by message timestamp: dlt-sortbytimestamp input.dlt
47       output.dlt
48
49       Sort a specific range, e.g. from message 1,000,000 to message 1,500,000
50       from a file called input.dlt and store the result in a file called out‐
51       put.dlt: dlt-sortbytimestamp -b 1000000 -e 1500000 input.dlt output.dlt
52

EXIT STATUS

54       Non zero is returned in case of failure.
55

AUTHOR

57       Jonathan  Sambrook (jonathan.sambrook (at) codethink (dot) co (dot) uk)
58       Alexander Wenzel (alexander.aw.wenzel (at) bmw (dot) de)
59

COPYRIGHT

61       Copyright (C) 2018 Codethink Ltd.  Copyright (C) 2015 BMW AG.   License
62       MPL-2.0:    Mozilla   Public   License   version   2.0   <http://mozil‐
63       la.org/MPL/2.0/>.
64

BUGS

66       See Github issue: <https://github.com/GENIVI/dlt-daemon/issues>
67