LLAPI_PROJECT_GETNAM(3)

📦 version 2.17.58, in ubuntu stonking

💖 LLAPI_PROJECT_GETNAM 💖

okay bestie, so this one lives in the Lustre Library Functions section of the manual, and it's literally the glow-up you need when you've got a project name and you want the actual project data. let's get into it 🎀

✨ NAME ✨

llapi_project_getnam — read project matching a name to a buffer 🦋

✨ SYNOPSIS ✨

#include <lustre/lustreapi.h>

int llapi_project_getnam(struct ll_project *lprj, const char *name);

✨ DESCRIPTION ✨

so here's the tea ☕ — llapi_project_getnam() goes digging through the contents of the LIBLUSTREAPI_PROJECT file until it finds an entry that matches the name you handed it. then it takes everything the file has to say about that entry and fills up the rest of your space with it. 🫶

heads up, babe: the buffer should be preallocated — she is not going to do that part for you, you have to come prepared. 💅

✨ RETURN VALUES ✨

  • 0 — slay, it worked, success ✨
  • -ve — an error code came back, and errno gets set appropriately to match. 😭

✨ ERRORS ✨

  • -EINVAL — thrown when opening the file fails, or when lprj is NULL, or when lprj->lprj_size is invalid. basically: bad inputs, bad vibes. 💀
  • -ENOENT — no entry was found in LIBLUSTREAPI_PROJECT with information matching *name. she looked everywhere and came back empty-handed 🙈

✨ AVAILABILITY ✨

llapi_project_getnam() is part of the lustre(7) user application interface library, and it's been serving looks since release 2.17.0 👑

✨ SEE ALSO ✨

lfs_project(1), llapi_project_close(3), llapi_project_fgetnam(3), llapi_project_fgetprjid(3), llapi_project_get(3), llapi_project_getprjid(3), llapi_project_open(3), llapi_project_put(3), projid(5), lustreapi(7)

and that's the whole page, bestie 🌈 this lil gem comes to you from the Lustre User API, dated 2025-07-01. go forth and get those project names, no cap. 💜🌸

📦 where this page comes from