.\" Man page generated from reStructuredText.
.
.TH "TRAFFIC_CRASHLOG" "8" "Mar 08, 2019" "7.1" "Apache Traffic Server"
.SH NAME
traffic_crashlog \- Traffic Server crash log helper
.
.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_crashlog\fP [options]
.SH DESCRIPTION
.sp
\fBtraffic_crashlog\fP is a helper process that catches Traffic Server
crashes and writes a crash report log to the logging directory. Other than for
debugging or development purposes, \fBtraffic_crashlog\fP is not intended
for users to run directly.
.sp
When traffic_server starts, it will launch a \fBtraffic_crashlog\fP
process and keep it stopped, activating it only if a crash occurs.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-\-host TRIPLE
This option specifies the host triple for the process that
\fBtraffic_crashlog\fP should examine. If a supported host
triple is specified, \fBtraffic_crashlog\fP expects to
receive a \fBsiginfo_t\fP structure on it\(aqs standard input,
followed by a \fBucontext_t\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-target PID
Specifies the process ID of the crashing \fBtraffic_server\fP
process. If this option is not specified, \fBtraffic_crashlog\fP
assumes it should examine it\(aqs parent process.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-syslog
This option causes \fBtraffic_crashlog\fP to log the name
of the crash log it creates to the system log.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-debug
This option enables debugging mode. In this mode,
\fBtraffic_crashlog\fP emits the log to it\(aqs standard
output.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-wait
This option causes \fBtraffic_crashlog\fP to stop itself
immediately after it is launched. \fBtraffic_server\fP
will allow it to continue only when a crash occurs.
.UNINDENT
.SH CAVEATS
.sp
\fBtraffic_crashlog\fP makes use of various Traffic Server management
APIs. If traffic_manager is not available, the crash log will be
incomplete.
.sp
\fBtraffic_crashlog\fP may generate a crash log containing information you
would rather not share outside your organization. Please examine the crash log
carefully before posting it in a public forum.
.SH SEE ALSO
.sp
\fBrecords.config(5)\fP,
\fBtraffic_manager(8)\fP,
\fBtraffic_server(8)\fP
.SH COPYRIGHT
2019, dev@trafficserver.apache.org
.\" Generated by docutils manpage writer.
.