LLAPI_POOL_NAME_VALIDATE(3)

💖 LLAPI_POOL_NAME_VALIDATE(3) — Lustre Library Functions 💖

okay bestie, so this is a page from section 3 of the Lustre Library Functions manual, and it's literally all about checking that a pool name is not a mess 💅

---

✨ NAME ✨

llapi_pool_name_validate() — the lil vibe check that makes sure your pool name only has valid characters in it 🎀

---

✨ SYNOPSIS ✨

#include <lustre/lustreapi.h>

int llapi_pool_name_validate(const char **pool_name);

---

🌸 DESCRIPTION 🌸

so <pink>llapi_pool_name_validate() is the function you call when you need to verify that every character in *pool_name* is alphanumeric, or a '-', or an '_'— that's it, that's the whole guest list, no plus-ones 🚫 and it also has to be **not longer than**LOV_MAXPOOLNAME` (15) bytes in length, not counting the NUL terminator. like, fifteen bytes bestie, that's the limit, periodt ✋

here's the tea though 🍓: if pool_name is in the form fsname.pool_name, then the leading fsname. part gets removed, and when the function returns, the pool_name pointer will only point at the pool name itself. why? because that makes pool_name suitable for use in filesystem pool identifiers, duh 💁‍♀️

and if losing that leading fsname. component is not the move for you, if it's giving "please don't touch my string," then you should use llapi_name_validate(3) to verify the pool name instead. iykyk 🦋

---

⭐ RETURN VALUE ⭐

llapi_pool_name_validate() returns 0 on success 🎉 — or a negative errno value on failure 😭

---

🔥 ERRORS 🔥

• EINVAL — the name you handed over had an illegal character in it. rude. 💀
• ENAMETOOLONG — the name went past LOV_MAXPOOLNAME characters with no NUL terminator to save it. it simply would not stop. 😭
• ENXIO — the name was NULL or empty. nothing. a void. an empty plate. 🙈

---

💜 EXAMPLES 💜

checking if pool_name can actually be used as a pool identifier, let's go 👑

#include <string.h>
#include <lustre/lustreapi.h>

int main(int argc, char *argv[])
{
        char pool_name[] = "newfs123.testpool";

        rc = llapi_pool_name_validate(&pool_name);
        if (rc < 0) {
                fprintf(stderr, "%s: pool name '%s' invalid: %s\n",
                        argv[1], pool_name, strerror(errno));
                return rc;
        }
}

---

🌈 AVAILABILITY 🌈

llapi_pool_name_validate has been part of the lustre(7) filesystem package since release 2.18.0 — so it's been serving looks for a minute now 👑

---

🫶 SEE ALSO 🫶

llapi_name_validate(3), lustreapi(7)

---

and that's the whole page bestie, no cap 🧚 this lil rewrite came to you from the Lustre User API, dated 2026-08-23 — original LLAPI_POOL_NAME_VALIDATE(3) energy, just with way more sparkle ✨ mwah, go validate those pool names 💖