Developer’s Guide

This documentation is a work in progress. It was originally written for a previous, commercially-available version of Traffic Server that supported different operating systems and more functions than the current version. As a result, some of the sections may refer to functionality that no longer exists.

If you find any such issues, you may want to submit a bug or a patch. We also have a Wiki page explaining how to create useful bug reports. We encourage everyone to file tickets, early and often. Looking for existing, duplicate bugs is encouraged, but not required.

• Introduction
• Release Process
  • Requirements
  • Release Candidate
  • Document
  • Build
  • Distribute
  • Official Release
• Contributing to Traffic Server
• Using Vagrant to Test Traffic Server
  • Installing Vagrant and Dependencies
  • Managing Virtual Machines
  • Building Traffic Server Inside Vagrant
• Debugging and Analysis
  • Debug Builds
  • SystemTap and DTrace support
  • Using TSAssert
  • Debug Tags
  • Core Dump Analysis
  • Profiling
  • Memory Leaks
• Threads and Event Processing
  • Threads
  • Types
• Cache Architecture
  • Cache Architecture
  • Cache Initialization
  • Core Cache
  • Data Structures
  • API functions
  • Cache Tools
  • Topics to be done
  • Cache Consistency
  • Volume Tagging
  • RAM Cache
  • Cache Tool
  • Tiered Storage
• Logging Architecture
  • A gentle introduction to ATS logging internals
• Internal libraries
  • TextView
  • MemSpan
  • TS.Scalar
  • Definition
  • Usage
  • BufferWriter
  • IntrusiveDList
  • Definition
  • Usage
  • Design Notes
  • IntrusiveHashMap
  • Usage
  • Details
  • Design Notes
  • MemArena
  • AcidPtr & AcidCommitPtr
  • Extendible
  • ArgParser
• Plugin Development
  • Plugin Development Introduction
  • Getting Started
  • Building Plugins
  • Plugin Configuration
  • Plugin Management
  • Actions
  • Hooks and Transactions
  • Continuations
  • Mutexes
  • IO
  • HTTP Headers
  • HTTP Transformations
  • Remap Plugins
  • New Protocol Plugins
  • Plugin Interfaces
  • Adding Statistics
  • Example Plugins
• Configuration Variable Implementation
  • Defining the Variable
  • Variable Infrastructure
• API Reference
  • API Types
  • API Functions
• Continuous Integration
• Documentation
  • Conventions
  • Structure
  • Building the Documentation
  • reStructuredText and Sphinx
  • Traffic Server Specific Markup
  • Creating New Domains
  • Documenting Plugins
• Host Resolution Proposal
  • Introduction
  • Goals
  • Basics
  • Required Resolvers
  • Configuration
  • Examples
  • Issues
• An Overview Client Sessions and Transactions
  • Classes
  • Session Object Relationships
  • Transaction and Session Shutdown
• Core Architecture
  • Header Heap
  • HostDB
  • URL Rewrite Architecture
• Design Documents
  • Reloading Plugins
• Layout
  • Runroot
• Testing Traffic Server
  • Traffic Server Blackbox Testing
• JSONRPC
  • Architecture
  • API
  • JSONRPC Endpoint
  • JSON RPC errors
  • Handler implementation
  • Traffic Server JSONRPC Node C++ Client Implementation
  • Traffic Control Development Guide
  • API Handler error codes