.\" Man page generated from reStructuredText.
.
.TH "TRAFFIC_LOGCAT" "8" "January 24, 2017" "7.0" "Apache Traffic Server"
.SH NAME
traffic_logcat \- Traffic Server log spooler
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.sp
\fBtraffic_logcat\fP [\-o output\-file | \-a] [\-CEhSVw2] [input\-file ...]
.SH DESCRIPTION
.sp
To analyse a binary log file using standard tools, you must first convert
it to ASCII. \fBtraffic_logcat\fP does exactly that.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-o PATH, \-\-output_file PATH
.UNINDENT
.sp
Specifies where the command output is directed.
.INDENT 0.0
.TP
.B \-a, \-\-auto_filename
.UNINDENT
.sp
Automatically generates the output filename based on the input
filename. If the input is from stdin, then this option is ignored.
For example:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
traffic_logcat \-a squid\-1.blog squid\-2.blog squid\-3.blog
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
generates:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
squid\-1.log squid\-2.log squid\-3.log
.ft P
.fi
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-f, \-\-follow
.UNINDENT
.sp
Follows the file, like \fItail(1)\fP \fB\-f\fP
.INDENT 0.0
.TP
.B \-C, \-\-clf
.UNINDENT
.sp
Attempts to transform the input to Netscape Common format, if possible.
.INDENT 0.0
.TP
.B \-E, \-\-elf
.UNINDENT
.sp
Attempts to transform the input to Netscape Extended format, if possible.
.INDENT 0.0
.TP
.B \-S, \-\-squid
.UNINDENT
.sp
Attempts to transform the input to Squid format, if possible.
.INDENT 0.0
.TP
.B \-2, \-\-elf2
.UNINDENT
.sp
Attempt to transform the input to Netscape Extended\-2 format, if possible.
.INDENT 0.0
.TP
.B \-T, \-\-debug_tags
.UNINDENT
.INDENT 0.0
.TP
.B \-w, \-\-overwrite_output
.UNINDENT
.INDENT 0.0
.TP
.B \-h, \-\-help
Print usage information and exit.
.UNINDENT
.INDENT 0.0
.TP
.B \-V, \-\-version
Print version information and exit.
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
Use only one of the following options at any given time: \fB\-S\fP, \fB\-C\fP, \fB\-E\fP, or \fB\-2\fP\&.
.UNINDENT
.UNINDENT
.sp
If no input files are specified, then \fBtraffic_logcat\fP reads from the
standard input (\fBstdin\fP). If you do not specify an output file, then
\fBtraffic_logcat\fP writes to the standard output (\fBstdout\fP).
.sp
For example, to convert a binary log file to an ASCII file, you can use
the \fBtraffic_logcat\fP command with either of the following options
below:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
traffic_logcat binary_file > ascii_file
traffic_logcat \-o ascii_file binary_file
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
The binary log file is not modified by this command.
.SH SEE ALSO
.sp
\fItail(1)\fP
.SH COPYRIGHT
2015, dev@trafficserver.apache.org
.\" Generated by docutils manpage writer.
.