TSIPSTRINGTOADDR(3ts)

✨ TSIpStringToAddr ✨

okay bestie, welcome to the TSIpStringToAddr glow-up — this is a lil function from the Apache Traffic Server 3ts manual, and it's giving "I turn your messy IP string into a real address" energy 💅

---

🌸 NAME 🌸

TSIpStringToAddr — literally the TSIpStringToAddr API function, that's the whole vibe 🎀

---

🦋 SYNOPSIS 🦋

#include <ts/experimental.h>

TSReturnCode TSIpStringToAddr(const char *str, int str_len, sockaddr *addr)

---

💖 DESCRIPTION 💖

okay so, str is expected to be an explicit address, not a hostname. No hostname resolution is done — none, zero, not a crumb, don't even ask 🙈

It attempts to recognize and process a port value if there is one present. That port gets set appropriately… or it gets set to zero if no port was found, or if the port was malformed. It's giving "we tried our best, bestie" 💀

The whole reason this function exists is to deal with the brackets that can optionally surround an IP address (usually IPv6), which in turn are used to differentiate between an address and an attached port. Like, for example:

[FE80:9312::192:168:1:1]:80

see? bracket, address, bracket, colon, port. iconic. 🌈

---

👑 RETURN VALUES 👑

It returns TS_SUCCESS on success, or TS_ERROR on failure. that's it, that's the whole story, slay ✨

---

💅 NOTES 💅

This API may be changed in the future version since it is experimental. so like, enjoy it, but don't get too attached 🥲

---

⭐ COPYRIGHT ⭐

2026, dev@trafficserver.apache.org

---

and that's a wrap, my love 🫶 this was the 3ts page, version 9.2, dated Feb 12, 2026, brought to you by the Apache Traffic Server girlies. go forth and parse responsibly 💜🦋✨