Modified library for new test cases to corrupt data - related to the bug fix for...
[profile/ivi/dlt-daemon.git] / doc / dlt-convert.1
1 .TH dlt-convert 1  "March 2, 2012" "version 2.5.0" "USER COMMANDS"
2 .SH NAME
3 dlt-convert \- Convert DLT Logging files into ASCII
4 .SH SYNOPSIS
5 .B dlt-convert
6 [\-h] [\-a] [\-x] [\-m] [\-s][\-o filename] [\-v] [\-c] [\-b number]
7 [\-e number] [\-w] file1 [file2] [file3]
8 .SH DESCRIPTION
9 Read DLT files, print DLT messages as ASCII and store the messages again.
10 Use Ranges and Output file to cut DLT files.
11 Use two files and Output file to join DLT files. 
12 .SH OPTIONS
13 .TP
14 \-h
15 Display a short help text.
16 .TP
17 \-a
18 Print DLT file; payload as ASCII.
19 .TP
20 \-x
21 Print DLT file; payload as hex.
22 .TP
23 \-m
24 Print DLT file; payload as hex and ASCII.
25 .TP
26 \-s
27 Print DLT file; only headers.
28 .TP
29 \-o
30 Output messages in new DLT file.
31 .TP
32 \-v
33 Verbose mode.
34 .TP
35 \-c
36 Count number of messages.
37 .TP
38 \-b
39 First messages to be handled.
40 .TP
41 \-e
42 Last message to be handled.
43 .TP
44 \-w
45 Follow dlt file while file is increasing.
46 .SH EXAMPLES
47 .TP
48 Convert DLT file into ASCII:
49 .B dlt-convert
50 \-a mylog.dlt
51 .PP
52 .TP
53 Cut a specific range, e.g. from message 1 to message 3 from a file called log.dlt and store the result to a file called newlog.dlt:
54 .B dlt-convert
55 \-b 1 -e 3 -o newlog.dlt log.dlt
56 .PP
57 .TP
58 Paste two dlt files log1.dlt and log2.dlt to a new file called newlog.dlt:
59 .B dlt-convert
60 \-o newlog.dlt log1.dlt log2.dlt
61 .PP
62 .SH EXIT STATUS
63 Non zero is returned in case of failure.
64 .SH AUTHOR
65 Alexander Wenzel (alexander.aw.wenzel (at) bmw.de)
66 .SH SEE ALSO
67 dlt-daemon(1)
68