TSPLUGININIT(3ts)

💖 TSPLUGININIT 💖

okay bestie, pull up a chair because this is the main character of every Apache Traffic Server plugin page — it's TSPluginInit(3ts), straight out of the Apache Traffic Server manual, and honestly? she's iconic. 🌸

---

✨ NAME ✨

TSPluginInit — Traffic Server plugin loading and registration 🎀 (yes, that's the whole vibe: loading and registering, the two-step of plugin existence)

---

✨ SYNOPSIS ✨

#include <ts/ts.h>

void TSPluginInit(int argc, const char *argv[])

TSReturnCode TSPluginRegister(TSPluginRegistrationInfo *plugin_info)

---

✨ DESCRIPTION ✨

so here's the tea, bestie 🍓 — TSPluginInit() must be defined by all plugins. like, every single one. no exceptions, no cap. Traffic Server calls this initialization routine when it loads the plugin, and it 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. and listen — that count is at least one, because the first argument in the argument vector is the plugin's name, which must exist in order for the plugin to be loaded. literally the plugin has to have a name to get in the door, iykyk 💅

TSPluginRegister() registers the appropriate SDK version specified in sdk_version for your plugin. use this function to make sure that the version of Traffic Server your plugin is running on actually supports the plugin. it's giving vibe check for compatibility 🦋

---

✨ RETURN VALUES ✨

TSPluginRegister() returns TS_ERROR if the plugin registration failed. 😭 that's the bad ending, we don't want it.

---

✨ EXAMPLES ✨

here's a whole little hello-world situation, go off 👑

#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 = "ts-api-support@MyCompany.com";

   if (TSPluginRegister(&info) != TS_SUCCESS) {
      TSError("[%s] Plugin registration failed", PLUGIN_NAME);
   }
}

---

✨ SEE ALSO ✨

• TSAPI(3ts)
• TSInstallDirGet(3ts)

---

✨ COPYRIGHT ✨

2026, dev@trafficserver.apache.org 💜

---

lowkey important reminder: TSPluginInit() is not optional. no TSPluginInit(), no plugin. periodt. 🔥

---

and that's the whole page bestie!! 🫶 this was TSPLUGININIT(3ts) from Apache Traffic Server — version 9.2, dated Feb 12, 2026 — mwah, go register some plugins, you're gonna slay 💖✨🌈