diff options
Diffstat (limited to 'doc/dlt-convert.1')
| -rw-r--r-- | doc/dlt-convert.1 | 200 |
1 files changed, 134 insertions, 66 deletions
diff --git a/doc/dlt-convert.1 b/doc/dlt-convert.1 index aceb3fc..4272845 100644 --- a/doc/dlt-convert.1 +++ b/doc/dlt-convert.1 @@ -1,68 +1,136 @@ -.TH dlt-convert 1 "April 13, 2012" "version 2.9.0" "USER COMMANDS" -.SH NAME +'\" t +.\" Title: dlt-convert +.\" Author: [see the "AUTHOR" section] +.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/> +.\" Date: 10/11/2012 +.\" Manual: \ \& +.\" Source: \ \& +.\" Language: English +.\" +.TH "DLT\-CONVERT" "1" "10/11/2012" "\ \&" "\ \&" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" dlt-convert \- Convert DLT Logging files into ASCII -.SH SYNOPSIS -.B dlt-convert -[\-h] [\-a] [\-x] [\-m] [\-s][\-o filename] [\-v] [\-c] [\-b number] -[\-e number] [\-w] file1 [file2] [file3] -.SH DESCRIPTION -Read DLT files, print DLT messages as ASCII and store the messages again. -Use Ranges and Output file to cut DLT files. -Use two files and Output file to join DLT files. -.SH 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 -\-v -Verbose mode. -.TP -\-c -Count number of messages. -.TP -\-b -First messages to be handled. -.TP -\-e -Last message to be handled. -.TP -\-w -Follow dlt file while file is increasing. -.SH EXAMPLES -.TP -Convert DLT file into ASCII: -.B dlt-convert -\-a mylog.dlt -.PP -.TP -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: -.B dlt-convert -\-b 1 -e 3 -o newlog.dlt log.dlt -.PP -.TP -Paste two dlt files log1.dlt and log2.dlt to a new file called newlog.dlt: -.B dlt-convert -\-o newlog.dlt log1.dlt log2.dlt -.PP -.SH EXIT STATUS -Non zero is returned in case of failure. -.SH AUTHOR -Alexander Wenzel (alexander.aw.wenzel (at) bmw.de) -.SH SEE ALSO -dlt-daemon(1) +.SH "SYNOPSIS" +.sp +\fBdlt\-convert\fR [\-h] [\-a] [\-x] [\-m] [\-s][\-o filename] [\-v] [\-c] [\-b number] [\-e number] [\-w] file1 [file2] [file3] +.SH "DESCRIPTION" +.sp +Read DLT files, print DLT messages as ASCII and store the messages again\&. Use Ranges and Output file to cut DLT files\&. Use two files and Output file to join DLT files\&. +.SH "OPTIONS" +.PP +\fB\-h\fR +.RS 4 +Display a short help text\&. +.RE +.PP +\fB\-a\fR +.RS 4 +Print DLT file; payload as ASCII\&. +.RE +.PP +\fB\-x\fR +.RS 4 +Print DLT file; payload as hex\&. +.RE +.PP +\fB\-m\fR +.RS 4 +Print DLT file; payload as hex and ASCII\&. +.RE +.PP +\fB\-s\fR +.RS 4 +Print DLT file; only headers\&. +.RE +.PP +\fB\-o\fR +.RS 4 +Output messages in new DLT file\&. +.RE +.PP +\fB\-v\fR +.RS 4 +Verbose mode\&. +.RE +.PP +\fB\-c\fR +.RS 4 +Count number of messages\&. +.RE +.PP +\fB\-b\fR +.RS 4 +First messages to be handled\&. +.RE +.PP +\fB\-e\fR +.RS 4 +Last message to be handled\&. +.RE +.PP +\fB\-w\fR +.RS 4 +Follow dlt file while file is increasing\&. +.RE +.SH "EXAMPLES" +.PP +Start DLT daemon in background mode +.RS 4 + +\fBdlt\-daemon \-d\fR +.RE +.PP +Start DLT daemon with own configuration +.RS 4 + +\fBdlt\-daemon \-c ~/my\-dlt\-configuration\&.cfg\fR +.RE +.PP +Convert DLT file into ASCII +.RS 4 + +\fBdlt\-convert \-a mylog\&.dlt\fR +.RE +.PP +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 +.RS 4 + +\fBdlt\-convert \-b 1 \-e 3 \-o newlog\&.dlt log\&.dlt\fR +.RE +.PP +Paste two dlt files log1\&.dlt and log2\&.dlt to a new file called newlog\&.dlt +.RS 4 +\fBdlt\-convert \-o newlog\&.dlt log1\&.dlt log2\&.dlt\fR +.RE +.SH "EXIT STATUS" +.sp +Non zero is returned in case of failure\&. +.SH "AUTHOR" +.sp +Alexander Wenzel (alexander\&.aw\&.wenzel (at) bmw\&.de) +.SH "RESOURCES" +.sp +Main web site: http://projects\&.genivi\&.org/diagnostic\-log\-trace Mailinglist: https://lists\&.genivi\&.org/mailman/listinfo/genivi\-diagnostic\-log\-and\-trace +.SH "SEE ALSO" +.sp +dlt\-daemon(1) |