TSMGMTSOURCEGET(3ts)

📦
version 9.2.5 · 4 versions
, in ubuntu noble, ubuntu questing

💖 TSMGMTSOURCEGET 💖

okay bestie so this is a page from the Apache Traffic Server manual, section 3ts — the library function girlies. and today's main character is literally TSMgmtSourceGet. she's an API function and she's here to tell you where a config value came from. like, who set it? was it the core? a plugin? you? the environment?? she knows. 🕵️♀️✨

🌸 NAME 🌸

TSMgmtSourceGet — the TSMgmtSourceGet API function. that's it, that's the whole name, no cap. 💅

✨ SYNOPSIS ✨

#include <ts/ts.h>

TSReturnCode TSMgmtSourceGet(const char *var_name, TSMgmtSource *result)

like, that's the whole vibe. include the header, call the function, get the tea. 🎀

🦋 DESCRIPTION 🦋

so basically she gets the source of a value for a configuration variable. the way that works is: var_name is the name of the variable, and it's gotta be a nul terminated string (yes bestie, terminated, respect the nul 💀). the source value gets stored in result — she writes it there for you.

and heads up: the function can return failure if var_name is not found. so if you typo the variable name it's not gonna be cute, it's gonna fail. 😭

👑 TYPES 👑

type TSMgmtSource

the source of the current value for a management (configuration) value. she's an enum, she's got range, let's meet the girls:

  • TS_MGMT_SOURCE_NULL — invalid value, no source available. this one is primarily used as an initialization or error value and should be returned only when the API call fails. so if you see her, something went wrong, periodt. 🚩
  • TS_MGMT_SOURCE_DEFAULT — the default value provided by the Traffic Server core. the og, untouched, factory settings energy. 🌱
  • TS_MGMT_SOURCE_PLUGIN — the configuration variable was created by a plugin, and the value is the default value provided by that plugin. plugin made it, plugin owns it. 🧚
  • TS_MGMT_SOURCE_EXPLICIT — the value has been set in records.config. and note: this value is returned even if the variable was explicitly set to the default value. so like, if you deliberately typed the same thing as the default, she still knows you did that. she's watching. she's proud of you. 💖
  • TS_MGMT_SOURCE_ENV — the value was retrieved from the process environment, overriding the default value. env var said "not today, default" and took over. 🌈

🔥 RETURN VALUES 🔥

  • TS_SUCCESS if the var_name was found 🎉
  • TS_ERROR if not 💀

that's it. binary. no in-between. slay.

2026, dev@trafficserver.apache.org

and that's the whole page bestie!! tysm for reading, you ate that fr fr 💅✨

Apache Traffic Server 9.2 — Feb 12, 2026 — version girlies and date girlies, this one's for you 🎀🦋💜

📦 where this page comes from