This is an automated email from the ASF dual-hosted git repository.
zwoop pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/trafficserver.git
The following commit(s) were added to refs/heads/master by this push:
new adb998c Documented more detail about
TS_HTTP_SEND_REQUEST_HDR_HOOK hook
adb998c is described below
commit adb998cb0dc2032132edf74f89ffdd4c1aabeb43
Author: scw00 <[email protected]>
AuthorDate: Wed May 31 10:59:26 2017 +0800
Documented more detail about TS_HTTP_SEND_REQUEST_HDR_HOOK hook
---
.../plugins/continuations/writing-handler-functions.en.rst | 6 ++++++
.../plugins/hooks-and-transactions/adding-hooks.en.rst | 6 ++++++
2 files changed, 12 insertions(+)
diff --git
a/doc/developer-guide/plugins/continuations/writing-handler-functions.en.rst
b/doc/developer-guide/plugins/continuations/writing-handler-functions.en.rst
index 901e46a..5384fe8 100644
--- a/doc/developer-guide/plugins/continuations/writing-handler-functions.en.rst
+++ b/doc/developer-guide/plugins/continuations/writing-handler-functions.en.rst
@@ -67,6 +67,12 @@ it receives:
continuation before you make sure that all incoming events, such as
those sent because of :func:`TSHttpTxnHookAdd`, have been handled.
+.. caution::
+
+ TS_HTTP_SEND_REQUEST_HDR_HOOK may callback several times when the
+ OS crashed. Be careful to use functions such as TSContDestroy in
+ TS_HTTP_SEND_REQUEST_HDR_HOOK hook.
+
The following table lists events and the corresponding type of
`void* data` passed to handler functions:
diff --git
a/doc/developer-guide/plugins/hooks-and-transactions/adding-hooks.en.rst
b/doc/developer-guide/plugins/hooks-and-transactions/adding-hooks.en.rst
index 3b6e004..c1e0e1d 100644
--- a/doc/developer-guide/plugins/hooks-and-transactions/adding-hooks.en.rst
+++ b/doc/developer-guide/plugins/hooks-and-transactions/adding-hooks.en.rst
@@ -132,6 +132,12 @@ values for ``TSHttpHookID`` are:
modifying the proxy's request header before it is sent to the origin
server or parent proxy.
+.. caution::
+
+ TS_HTTP_SEND_REQUEST_HDR_HOOK may callback several times when the
+ OS crashed. Be careful to use functions such as TSContDestroy in
+ TS_HTTP_SEND_REQUEST_HDR_HOOK hook.
+
``TS_HTTP_SSN_CLOSE_HOOK``
Called when an HTTP session ends. A session ends when the client
connection is closed. You can only add this hook as a global hook
--
To stop receiving notification emails like this one, please contact
['"[email protected]" <[email protected]>'].
