How to Use This Book¶

This book has the following basic components:

• Introduction and overview
• Tutorials about writing specific kinds of plugins: HTTP header-based plugins, content transformation plugins, and protocol plugins
• Guides about specific interfaces
• Reference material

If you’re new to writing Traffic Server plugins, then read Getting Started and How to Create Traffic Server Plugins, and use the remaining chapters as needed. Header-Based Plugin Examples provides details about plugins that work on HTTP headers, while HTTP Transformation Plugins explains how to write a plugin that transforms or scans the body of an HTTP response. New Protocol Plugins provides essential information if you want to support your own protocol on Traffic Server.

You can look up information in the following reference sections:

• Index: lists information by subject
• Function Index: Doxygen reference
• Type Index
• Sample Source Code
• Deprecated Functions

Below is a section-by-section breakdown of this guide:

• Getting Started How to compile and load plugins. Walks through a simple “hello world” example; explains how to initialize and register plugins.
• How to Create Traffic Server Plugins Basic structures that all plugins use: events, continuations, and how to hook on to Traffic Server processes. Detailed explication of a sample blacklisting plugin.
• Remap Plugin This chapter demonstrates on a practical example how you can exploit the Traffic Server remap API for your plugins.
• Header-Based Plugin Examples Detailed explanation about writing plugins that work on HTTP headers; discusses sample blacklisting and basic authorization plugins.
• HTTP Transformation Plugins Detailed explanation of the null-transform example; also discusses VConnections, VIOs, and IO buffers.
• New Protocol Plugins Detailed explanation of a sample protocol plugin that supports a synthetic protocol. Discusses VConnections and mutexes, as well as the new NetConnection, DNS lookup, logging, and cache APIs.

The remaining sections comprise the API function reference and are organized by function type:

• Miscellaneous Interface Guide Details error-writing and tracing functions, thread functions, and Traffic Server API versions of the malloc and fopen families. The Traffic Server API versions overcome various C library limitations.
• HTTP Hooks and Transactions Functions in this chapter hook your plugin to Traffic Server HTTP processes.
• HTTP Headers Contains instructions for implementing performance enhancements for all plugins that manipulate HTTP headers. These functions examine and modify HTTP headers, MIME headers, URLs, and the marshal buffers that contain header information. If you are working with headers, then be sure to read this chapter.
• Mutex Guide
• Continuations Continuations provide the basic callback mechanism and data abstractions used in Traffic Server.
• Plugin Configurations
• Actions Guide Describes how to use TSActions and the TSDNSLookup API.
• IO Guide Describes how to use the Traffic Server IO interfaces: TSVConnection, TSVIO, TSIOBuffer, TSNetVConnection, the Cache API.
• Plugin Management These functions enable you to set up a configuration interface for plugins, access installed plugin files, and set up plugin licensing.
• Adding Statistics These functions add statistics to your plugin.
• Function Index Doxygen generated Traffic Server API Documentation