LLAPI_PROJECT_GET(3)

📦 version 2.17.58, in ubuntu stonking

💖 LLAPI_PROJECT_GET — bestie edition ✨

okay so you wanna know about llapi_project_get from the Lustre library functions?? say less, we're doing this 🫶 it lives in the llapi_project_get(3) era of your life and it's lowkey one of the most useful little gremlins in the lustreapi family 💅

✨ NAME ✨

llapi_project_get — read project information to a buffer 📖💖

🌸 SYNOPSIS 🌸

#include <lustre/lustreapi.h>

int llapi_project_get(struct ll_project_handle *hdl, ll_project *lprj);

🦋 DESCRIPTION 🦋

okay so here's the vibe: llapi_project_get() reads through the contents of the file that hdl->lph_file points at, and it keeps going until it hits an entry that matches the info you handed it in lprj. 👀 once it finds that match, it fills in the remaining space with the information from that file. that's it, that's the whole job, no cap.

🎀 heads up bestie: the buffer should be preallocated. do that first, king/queen/monarch. don't make it guess.

💫 RETURN VALUES 💫

  • 0 — slay, it worked. success. 💅
  • -ve — a negative error code when things go sideways, and it sets errno appropriately. not iconic, but informative. 😭

🔥 ERRORS 🔥

  • -EINVAL — thrown when both lprj->lprj_projname and lprj->lprj_projid are NULL. the check happens through lprj->lprj_valid. so basically, if you gave it zero identifying info, it's gonna clock that and refuse. periodt.
  • -ENOENT — no entry was found in hdl->lph_file that matched the information you specified in lprj. she looked. she searched. nothing. 💀

🌈 AVAILABILITY 🌈

llapi_project_get() is part of the lustre(7) user application interface library, and it's been here since release 2.17.0. so it's not new-new, but it's not ancient either. main character energy since day one 👑

👑 SEE ALSO 👑

and that's the whole page bestie 💜 brought to you by the Lustre User API, dated 2025-07-01, and it's giving LLAPI_PROJECT_GET(3) in every way. go preallocate that buffer and get your project info. mwah 🎀✨

📦 where this page comes from