LLAPI_PROJECT_FGETNAM(3)

📦 version 2.17.58, in ubuntu stonking

✨ LLAPI_PROJECT_FGETNAM ✨

okay bestie, welcome to the lustre library corner of the manual — this one lives in section 3 of the Lustre Library Functions, and it's about pulling a project out of a file by its name. let's get into it 💖

🌸 NAME 🌸

llapi_project_fgetnam — read a project that matches a name from a specified file, straight into a buffer 🫶

🎀 SYNOPSIS 🎀

#include <lustre/lustreapi.h>

int llapi_project_fgetnam(struct ll_project_handle *hdl, struct ll_project *lprj,
                          const char *name);

🦋 DESCRIPTION 🦋

so here's the vibe: llapi_project_fgetnam() reads through the contents of the file that you pointed at with hdl->lph_file, and it just keeps going until it finds an entry that matches the *name you handed it. once it snags that match, it fills in the rest of the space with the info from that file. that's the whole main character moment. 👑

and like — the buffer needs to be preallocated, no cap. you gotta bring your own space, this function is not out here doing that for you 💅

🔥 RETURN VALUES 🔥

  • 0 — slay, it worked, success ✨
  • -ve — nope, that's an error code, and it sets errno appropriately so you can find out what went wrong 😭

💀 ERRORS 💀

  • -EINVAL — thrown when either lprj is NULL, or when lprj->lprj_size is invalid. like, one of those two things is off, bestie, check both 🙈

🌈 AVAILABILITY 🌈

llapi_project_fgetnam() has been part of the lustre(7) user application interface library since release 2.17.0 — she's been around since then, iconic behavior ⭐

👑 SEE ALSO 👑

okay that's the whole page, bestie, you're basically a lustre project-handling expert now 🧚 this one came out of the Lustre User API with a date stamp of 2025-07-01 — go forth and match those names 💜🍓

📦 where this page comes from