#
# 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/getting-started.en.rst:4
msgid "Getting Started"
msgstr ""

#: ../../sdk/getting-started.en.rst:30
msgid ""
"The Traffic Server API enables you to create plugins, using the C "
"programming language, that customize the behavior of your Traffic Server "
"installation. This chapter contains the following sections:"
msgstr ""

#: ../../sdk/getting-started.en.rst:49
msgid "Understanding Traffic Server Plugins"
msgstr ""

#: ../../sdk/getting-started.en.rst:51
msgid ""
"Traffic Server enables sophisticated caching and processing of web-related "
"traffic, such as DNS and HTTP requests and responses."
msgstr ""

#: ../../sdk/getting-started.en.rst:54
msgid ""
"Traffic Server itself consists of an event-driven loop that can be "
"simplified as follows:"
msgstr ""

#: ../../sdk/getting-started.en.rst:65
msgid "The Role of Plugins"
msgstr ""

#: ../../sdk/getting-started.en.rst:67
msgid ""
"You compile your plugin source code to create a shared library that Traffic "
"Server loads when it is started. Your plugin contains callback functions "
"that are registered for specific Traffic Server events. When Traffic Server "
"needs to process an event, it invokes any and all call-back functions "
"you've registered for that event type."
msgstr ""

#: ../../sdk/getting-started.en.rst:75
msgid ""
"Since plugins add object code to Traffic Server, programming errors in a "
"plugin can have serious implications. Bugs in your plugin, such as an out-"
"of-range pointer, can cause Traffic Server processes to crash and may "
"ultimately result in unpredictable behavior."
msgstr ""

#: ../../sdk/getting-started.en.rst:88
msgid "Plugin Process"
msgstr ""

#: ../../sdk/getting-started.en.rst:91
msgid "Possible Uses for Plugins"
msgstr ""

#: ../../sdk/getting-started.en.rst:93
msgid "Possible uses for plugins include the following:"
msgstr ""

#: ../../sdk/getting-started.en.rst:95
msgid ""
"HTTP processing: plugins can filter, blacklist, authorize users, transform "
"content"
msgstr ""

#: ../../sdk/getting-started.en.rst:98
msgid ""
"Protocol support: plugins can enable Traffic Server to proxy-cache new "
"protocol content"
msgstr ""

#: ../../sdk/getting-started.en.rst:101
msgid "Some examples of plugins include:"
msgstr ""

#: ../../sdk/getting-started.en.rst:103
msgid ""
"**Blacklisting plugin**: denies attempts to access web sites that are off-"
"limits."
msgstr ""

#: ../../sdk/getting-started.en.rst:106
msgid "**Append transform plugin**: adds text to HTTP response content."
msgstr ""

#: ../../sdk/getting-started.en.rst:108
msgid "**Image conversion plugin**: transforms JPEG images to GIF images."
msgstr ""

#: ../../sdk/getting-started.en.rst:110
msgid ""
"**Compression plugin**: sends response content to a compression server that "
"compresses the data (alternatively, a compression library local to the "
"Traffic Server host machine could do the compression)."
msgstr ""

#: ../../sdk/getting-started.en.rst:114
msgid ""
"**Authorization plugin**: checks a user's permissions to access particular "
"web sites. The plugin could consult a local authorization program or send "
"queries to an authorization server."
msgstr ""

#: ../../sdk/getting-started.en.rst:118
msgid ""
"**A plugin that gathers client information** from request headers and "
"enters this information in a database."
msgstr ""

#: ../../sdk/getting-started.en.rst:121
msgid ""
"**Protocol plugin**: listens for specific protocol requests on a designated "
"port and then uses Traffic Server's proxy server & cache to serve client "
"requests."
msgstr ""

#: ../../sdk/getting-started.en.rst:135
msgid "Possible Traffic Server Plugins"
msgstr ""

#: ../../sdk/getting-started.en.rst:137
msgid "You can find basic examples for many plugins in the SDK sample code:"
msgstr ""

#: ../../sdk/getting-started.en.rst:143
msgid ""
"The compression plugin in the figure communicates with the server that "
"actually does the compression. The ``server-transform.c`` plugin shows how "
"to open a connection to a transformation server, have the server do the "
"transformation, and send transformed data back to the client. Although the "
"transformation is null in ``server-transform.c``, a compression or image "
"translation plugin could be implemented in a similar way."
msgstr ""

#: ../../sdk/getting-started.en.rst:151
msgid "``basic-auth.c`` performs basic HTTP proxy authorization."
msgstr ""

#: ../../sdk/getting-started.en.rst:158
msgid "Plugin Loading"
msgstr ""

#: ../../sdk/getting-started.en.rst:167
msgid ""
"The path for each of these files is *<root_dir>*\\ ``/config/``, where "
"*<root_dir>* is where you installed Traffic Server."
msgstr ""

#: ../../sdk/getting-started.en.rst:170
msgid "Plugin Configuration"
msgstr ""

#: ../../sdk/getting-started.en.rst:172
msgid ""
"The sample ``plugin.config`` file below contains a comment line, a blank "
"line, and two plugin configurations:"
msgstr ""

#: ../../sdk/getting-started.en.rst:182
msgid ""
"Each plugin configuration in the ``plugin.config`` file resembles a UNIX or "
"DOS shell command; each line in ``plugin.config`` cannot exceed 1023 "
"characters."
msgstr ""

#: ../../sdk/getting-started.en.rst:186
msgid ""
"The first plugin configuration is for a plugin named ``my-plugin.so``. It "
"contains three arguments that are to be passed to that plugin's "
"initialization routine. The second configuration is for a plugin named "
"``some-plugin.so``; it contains three arguments. The last argument, *``"
"$proxy.config.http.cache.on``*, is actually a configuration variable. "
"Traffic Server will look up the specified configuration variable and "
"substitute its value."
msgstr ""

#: ../../sdk/getting-started.en.rst:194
msgid ""
"Plugins with global variables should not appear more than once in ``plugin."
"config``. For example, if you enter:"
msgstr ""

#: ../../sdk/getting-started.en.rst:202
msgid ""
"then the second global variable, ``header2``, will be used for both "
"instances. A simple workaround is to give different names to different "
"instances of the same plugin. For example:"
msgstr ""

#: ../../sdk/getting-started.en.rst:211
msgid "These entries will produce the desired result below:"
msgstr ""

#: ../../sdk/getting-started.en.rst:219
msgid "Configuration File Rules"
msgstr ""

#: ../../sdk/getting-started.en.rst:221
msgid "Comment lines begin with **#** and continue to the end of the line."
msgstr ""

#: ../../sdk/getting-started.en.rst:223
msgid "Blank lines are ignored."
msgstr ""

#: ../../sdk/getting-started.en.rst:225
msgid ""
"Plugins are loaded and initialized by Traffic Server in the order they "
"appear in the ``plugin.config`` file."
msgstr ""

#: ../../sdk/getting-started.en.rst:229
msgid "Plugin Initialization"
msgstr ""

#: ../../sdk/getting-started.en.rst:231
msgid ""
"Each plugin must define an initialization function named ``TSPluginInit`` "
"that Traffic Server invokes when the plugin is loaded. The ``TSPluginInit`` "
"function is commonly used to read configuration information and register "
"hooks for event notification."
msgstr ""

#: ../../sdk/getting-started.en.rst:236
msgid "The ``TSPluginInit`` function has two arguments:"
msgstr ""

#: ../../sdk/getting-started.en.rst:238
msgid ""
"The ``argc`` argument represents the number of arguments defined in the "
"``plugin.config`` file for that particular plugin"
msgstr ""

#: ../../sdk/getting-started.en.rst:241
msgid ""
"The ``argv`` argument is an array of pointers to the actual arguments "
"defined in the ``plugin.config`` file for that plugin"
msgstr ""

#: ../../sdk/getting-started.en.rst:34
msgid ""
"`Understanding Traffic Server Plugins`_ -- a brief introduction to plugins. "
"For more details, see :doc:`how-to-create-trafficserver-plugins.en`"
msgstr ""

#: ../../sdk/getting-started.en.rst:37
msgid ""
":doc:`getting-started/a-simple-plugin.en` -- walks through compiling and "
"loading an example ``hello world`` plugin."
msgstr ""

#: ../../sdk/getting-started.en.rst:40
msgid ""
":doc:`getting-started/plugin-registration-and-version-checking.en` -- shows "
"you how to register your plugin and make sure it's compatible with the "
"version of Traffic Server you're using."
msgstr ""

#: ../../sdk/getting-started.en.rst:44
msgid ""
":doc:`getting-started/naming-conventions.en` -- outlines Traffic Server API "
"naming conventions. For guidelines on creating plugin source code, see :doc:"
"`how-to-create-trafficserver-plugins.en`"
msgstr ""

#: ../../sdk/getting-started.en.rst:80
msgid "**Plugin Process**"
msgstr ""

#: ../../sdk/getting-started.en.rst:125
msgid ""
"The figure below, :ref:`possibleTSplugins`, illustrates several types of "
"plugins."
msgstr ""

#: ../../sdk/getting-started.en.rst:127
msgid "**Possible Traffic Server Plugins**"
msgstr ""

#: ../../sdk/getting-started.en.rst:139
msgid ""
"``append-transform.c`` adds text from a specified file to HTTP/text "
"responses. This plugin is explained in :doc:`http-transformation-plugin/"
"append-transform-plugin.en`"
msgstr ""

#: ../../sdk/getting-started.en.rst:153
msgid ""
"``blacklist-1.c`` reads blacklisted servers from a configuration file and "
"denies client access to these servers. This plugin is explained in :doc:"
"`header-based-plugin-examples/blacklist-plugin.en`."
msgstr ""

#: ../../sdk/getting-started.en.rst:160
msgid ""
"When Traffic Server is first started, it consults the ``plugin.config`` "
"file to determine the names of all shared plugin libraries that need to be "
"loaded. The ``plugin.config`` file also defines arguments that are to be "
"passed to each plugin's initialization function, ``TSPluginInit``. The :"
"file:`records.config` file defines the path to each plugin shared library, "
"as described in :ref:`specify-the-plugins-location`."
msgstr ""

#: ../../sdk/getting-started.en.rst:244
msgid "See :c:func:`TSPluginInit` for details about ``TSPluginInit``."
msgstr ""
