#
# Licensed to the Apache Software Foundation (ASF) under one or more
# contributor license agreements.  See the NOTICE file distributed with
# this work for additional information regarding copyright ownership.
# The ASF licenses this file to You under the Apache License, Version 2.0
# (the "License"); you may not use this file except in compliance with
# the License.  You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
msgid ""
msgstr ""
"Project-Id-Version: Apache Traffic Server 4.1\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2013-11-08 17:57+0900\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:2
msgid "Adding Hooks"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:21
msgid "There are several ways to add hooks to your plugin."
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:23
msgid ""
"**Global HTTP hooks** HTTP transaction hooks are set on a global basis "
"using the function ``TSHttpHookAdd``. This means that the continuation "
"specified as the parameter to ``TSHttpHookAdd`` is called for every "
"transaction. ``TSHttpHookAdd`` must be used in ``TSPluginInit``."
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:29
msgid ""
"**Transaction hooks** Transaction hooks can be used to call plugins back "
"for a specific HTTP transaction. You cannot add transaction hooks in "
"``TSPluginInit``; you first need a handle to a transaction. See `Accessing "
"the Transaction Being Processed <../header-based-plugin-examples/blacklist-"
"plugin/accessing-the-transaction-being-processed>`__"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:35
msgid ""
"**Transformation hooks** Transformation hooks are a special case of "
"transaction hooks. See ```TSVConnCacheObjectSizeGet`` <http://people.apache."
"org/~amc/ats/doc/html/ts_8h.html#af5ca2c5b00e4859d2fa5dec466dfd058>`__ for "
"more information about transformation hooks. You add a transformation hook "
"using ``TSHttpTxnHookAdd``, as described in `HTTP Transactions "
"<HTTP_Transactions.html>`__."
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:42
msgid ""
"**Session hooks** An HTTP session starts when a client opens a connection "
"to Traffic Server and ends when the connection closes. A session can "
"consist of several transactions. Session hooks enable you to hook your "
"plugin to a particular point in every transaction within a specified "
"session (see `HTTP Sessions <HTTPSessions.html>`__). Session hooks are "
"added in a manner similar to transaction hooks (ie, you first need a handle "
"to an HTTP session)."
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:50
msgid ""
"**HTTP select alternate hook** Alternate selection hooks enable you to hook "
"on to the alternate selection state. These hooks must be added globally, "
"since Traffic Server does not have a handle to a transaction or session "
"when alternate selection is taking place. See `HTTP Alternate Selection "
"<HTTPAlternateSelection.html>`__ for information on the alternate selection "
"mechanism."
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:57
msgid ""
"All of the hook addition functions (```TSHttpHookAdd`` <http://people."
"apache.org/~amc/ats/doc/html/InkAPI_8cc."
"html#a19a663edd3ec439f66256fbbb26cc1db>`__, ```TSHttpSsnHookAdd`` "
"<HTTPSessionFunctions.html#TSHttpSsnHookAdd>`__, ```TSHttpSsnReenable`` "
"<HTTPSessionFunctions.html#TSHttpSsnReenable>`__) take ``TSHttpHookID`` "
"(identifies the hook to add on to) and ``TSCont`` (the basic callback "
"mechanism in Traffic Server). A single ``TSCont`` can be added to any "
"number of hooks at a time."
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:65
msgid ""
"An HTTP hook is identified by the enumerated type ``TSHttpHookID``. The "
"values for ``TSHttpHookID`` are:"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:68
msgid "**Values for TSHttpHookID**"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:74
msgid "``TS_HTTP_CACHE_LOOKUP_COMPLETE_HOOK``"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:71
msgid ""
"Called after the HTTP state machine has completed the cache lookup for the "
"document requested in the ongoing transaction. Register this hook via "
"``TSHttpTxnHookAdd`` or ``TSHttpHookAdd``. Corresponds to the event "
"``TS_EVENT_HTTP_CACHE_LOOKUP_COMPLETE``."
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:81
msgid "``TS_HTTP_OS_DNS_HOOK``"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:77
msgid ""
"Called immediately after the HTTP state machine has completed a DNS lookup "
"of the origin server. The HTTP state machine will know the origin server's "
"IP address at this point, which is useful for performing both "
"authentication and blacklisting. Corresponds to the event "
"``TS_EVENT_HTTP_OS_DNS``."
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:96
msgid "``TS_HTTP_READ_CACHE_HDR_HOOK``"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:93
msgid ""
"Called immediately after the request and response header of a previously-"
"cached object is read from cache. This hook is only called if the document "
"is being served from cache. Corresponds to the event "
"``TS_EVENT_HTTP_READ_CACHE_HDR``."
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:101
msgid "``TS_HTTP_READ_RESPONSE_HDR_HOOK``"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:99
msgid ""
"Called immediately after the response header is read from the origin server "
"or parent proxy. Corresponds to the event "
"``TS_EVENT_HTTP_READ_RESPONSE_HDR``."
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:106
msgid "``TS_HTTP_RESPONSE_TRANSFORM_HOOK``"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:104
#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:113
msgid ""
"See \"`\"Transformations\" <../http-transformation-"
"plugin#Transformations>`__ for information about transformation hooks."
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:110
msgid "``TS_HTTP_READ_REQUEST_HDR_HOOK``"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:109
msgid ""
"Called immediately after the request header is read from the client. "
"Corresponds to the event ``TS_EVENT_HTTP_READ_REQUEST_HDR``."
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:115
msgid "``TS_HTTP_REQUEST_TRANSFORM_HOOK``"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:119
msgid "``TS_HTTP_SELECT_ALT_HOOK``"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:118
msgid ""
"See `\"HTTP Alternate Selection\" <http-alternate-selection>`__ for "
"information about the alternate selection mechanism."
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:125
msgid "``TS_HTTP_SEND_RESPONSE_HDR_HOOK``"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:122
msgid ""
"Called immediately before the proxy's response header is written to the "
"client; this hook is usually used for modifying the response header. "
"Corresponds to the event ``TS_EVENT_HTTP_SEND_RESPONSE_HDR``."
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:132
msgid "``TS_HTTP_SEND_REQUEST_HDR_HOOK``"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:128
msgid ""
"Called immediately before the proxy's request header is sent to the origin "
"server or the parent proxy. This hook is not called if the document is "
"being served from cache. This hook is usually used for modifying the "
"proxy's request header before it is sent to the origin server or parent "
"proxy."
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:136
msgid "``TS_HTTP_SSN_CLOSE_HOOK``"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:135
msgid ""
"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"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:141
msgid "``TS_HTTP_SSN_START_HOOK``"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:139
msgid ""
"Called when an HTTP session is started. A session starts when a client "
"connects to Traffic Server. You can only add this hook as a global hook."
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:144
msgid "``TS_HTTP_TXN_CLOSE_HOOK``"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:144
msgid "Called when an HTTP transaction ends."
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:150
msgid "``TS_HTTP_TXN_START_HOOK``"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:147
msgid ""
"Called when an HTTP transaction is started. A transaction starts when "
"either a client connects to Traffic Server and data is available on the "
"connection, or a previous client connection that was left open for keep "
"alive has new data available."
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:152
msgid ""
"The function you use to add a global HTTP hook is ```TSHttpHookAdd`` "
"<http://people.apache.org/~amc/ats/doc/html/InkAPI_8cc."
"html#a19a663edd3ec439f66256fbbb26cc1db>`__."
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:85
msgid "``TS_HTTP_POST_REMAP_HOOK``"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:84
msgid ""
"Called immediately after remapping occurs, before cache lookup. Corresponds "
"to the event ``TS_EVENT_HTTP_POST_REMAP``."
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:90
msgid "``TS_HTTP_PRE_REMAP_HOOK``"
msgstr ""

#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:88
msgid ""
"Called after the request header is read from the client, before any "
"remapping of the headers occurs. Corresponds to the event "
"``TS_EVENT_HTTP_PRE_REMAP``."
msgstr ""
