libnvmf_tid_from_fields(9)

💅 libnvmf_tid_from_fields 💅

okay so this is a page straight out of the libnvme API manual, and the star of the show is libnvmf_tid_from_fields(9) — the little constructor that builds you a whole TID out of a pile of strings. bestie, it's giving assembly instructions but make it NVMe. 🎀

---

✨ NAME ✨

libnvmf_tid_from_fields — allocate a TID from individual field strings. that's it, that's the whole job. 🫶

---

🌸 SYNOPSIS 🌸

int libnvmf_tid_from_fields (const char *transport , const char *traddr
, const char *trsvcid , const char *subsysnqn , const char *host_traddr
, const char *host_iface , const char *hostnqn , const char *hostid ,
struct libnvmf_tid **out );

nine parameters. yes, nine. she's highkey thorough and honestly? respect. 👑

---

🦋 ARGUMENTS 🦋

• transport — the transport type, like "tcp", "rdma", or "fc". this is the vibe check of how we're talking. ✨
• traddr — the transport address. where we're headed, fr fr.
• trsvcid — the transport service ID, e.g. "8009". the door number, not the street. 🚪
• subsysnqn — the subsystem NQN. iconic identifier energy.
• host_traddr — the host transport address, or NULL if you're not about that life.
• host_iface — the host interface name, or NULL.
• hostnqn — the host NQN, or NULL.
• hostid — the Host Identifier, or NULL.
• out — the allocated TID on success; NULL on error. lowkey the most important one — this is where your shiny new TID lands. 💖

---

💜 DESCRIPTION 💜

so this is a convenience constructor. that's the whole mood: convenience. you hand it strings, it hands you back a TID. 🎁

NULL fields are stored as NULL — no surprises, no drama, it keeps them exactly as the void they are. 🕳️

for an IP transport (tcp, rdma) a numeric traddr/host_traddr is canonicalized — meaning it gets tidied up into its proper form. but a hostname? nope. rejected. 💀 because resolving it is the caller's job, not libnvme's. read it again, bestie: your job. not hers. she doesn't do DNS, she's not that kind of library. 🙈

---

⭐ RETURN ⭐

• 0 — slay, success. *out is the allocated TID. 👑
• -EINVAL — if out is NULL, or if traddr/host_traddr is not numeric on an IP transport. that's the invalid-argument special. 😭
• -ENOMEM — allocation failure. the memory said no. 💀

ngl, if you're getting -EINVAL on a tcp or rdma transport, go look at your traddr and host_traddr — she told you numeric only. and if out is NULL... bestie. that's the output pointer. come on. 🫶

---

🌈 SEE ALSO 🌈

no SEE ALSO section on this one — she's short, sweet, and self-contained. periodt. 💅

---

and that's the whole page!! 🦋 this glorious little API page is the libnvmf_tid_from_fields page from the libnvme API manual, dated October 2026 — and oh my god, the header and footer literally both say libnvmf_tid_from_fields(9) too, so we're bookended by her name. iconic. mwah. 💖🎀✨