TSPluginInit(3ts)

TSPluginInit3ts

Traffic server plugin loading and registration

Usage

#include <ts/ts.h>
void TSPluginInit(int argc, const char *argv[])
TSReturnCode TSPluginRegister(TSPluginRegistrationInfo *plugin_info)

Overview

TSPluginInit() must be defined by all plugins. Traffic Server calls this initialization routine when it loads the plugin and sets argc and argv appropriately based on the values in plugin.config.

argc is a count of the number of arguments in the argument vector, argv. The count is at least one because the first argument in the argument vector is the plugins name, which must exist in order for the plugin to be loaded.

TSPluginRegister() registers the appropriate SDK version specific in sdk_version for your plugin. Use this function to make sure that the version of Traffic Server on which your plugin is running supports the plugin.

Return values

TSPluginRegister() returns TS_ERROR if the plugin registration failed.

Examples

#include <ts/ts.h>
#define PLUGIN_NAME "hello_world"
void
TSPluginInit (int argc, const char * argv[])
{
   TSPluginRegistrationInfo info;
   info.plugin_name = PLUGIN_NAME;
   info.vendor_name = "MyCompany";
   info.support_email = "[email protected]";
   if (TSPluginRegister(&info) != TS_SUCCESS) {
      TSError("[%s] Plugin registration failed", PLUGIN_NAME);
   }
}

Releases

3 releases since Debian 10 (Buster); the text changed 2 times.

  1. 10
  2. 11
  3. 12

From trafficserver-dev 9.2.5+ds-0+deb12u4 in Debian 12 (Bookworm). Parsed by carta from the page's man source.