.\" Man page generated from reStructuredText.
.
.TH "TSHTTPTXNINTERCEPT" "3ts" "Mar 08, 2019" "7.1" "Apache Traffic Server"
.SH NAME
TSHttpTxnIntercept \- allows a plugin take over the servicing of the request as though it was the
origin server
.
.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
\fI#include <ts/ts.h>\fP
.INDENT 0.0
.TP
.B void TSHttpTxnIntercept(TSCont\fI\ contp\fP, TSHttpTxn\fI\ txnp\fP)
.UNINDENT
.SH DESCRIPTION
.sp
\fIcontp\fP will be sent \fBTS_EVENT_NET_ACCEPT\fP\&. The edata passed
with \fBTS_EVENT_NET_ACCEPT\fP is an \fBTSVConn\fP just as it
would be for a normal accept. The plugin must act as if it is an HTTP
server and read the HTTP request and body off the \fBTSVConn\fP
and send an HTTP response header and body.
.sp
\fI\%TSHttpTxnIntercept()\fP must be called be called from only
\fBTS_HTTP_READ_REQUEST_HDR_HOOK\fP\&.  Using
\fI\%TSHttpTxnIntercept\fP will bypass the Traffic Server cache.  If
response sent by the plugin should be cached, use
\fBTSHttpTxnServerIntercept()\fP instead.
\fI\%TSHttpTxnIntercept()\fP primary use is allow plugins to serve
data about their functioning directly.
.sp
\fI\%TSHttpTxnIntercept()\fP must only be called once per transaction.
.SH COPYRIGHT
2019, dev@trafficserver.apache.org
.\" Generated by docutils manpage writer.
.