LLAPI_PCCDEV_GET(3)

📦 version 2.17.58, in ubuntu stonking

💖 LLAPI_PCCDEV_GET 💖

okay bestie, so this is a page from the Lustre Library Functions manual (section 3, the "library calls" one, iykyk) and it's literally all about one lil function that spills the tea on your PCC backends. sit down, get comfy, we're doing this 🫶

✨ NAME ✨

llapi_pccdev_get — List all PCC backends on a client

✨ SYNOPSIS ✨

#include <lustre/lustreapi.h>

int llapi_pccdev_get(const char *path);

✨ DESCRIPTION ✨

so llapi_pccdev_get() does the thing where it lists every single PCC backend on the client, for the mount point that path points at 💅. and then — the moment you've all been waiting for — it dumps the results to stdout, formatted in YAML</> 🎀. yes bestie, YAML. structured. readable. iconic.

no cap, that's the whole job. one call, all the backends, YAML out the front door. ✨

✨ RETURN VALUES ✨

  • llapi_pccdev_get() returns 0 when it slays 🎉
  • or a negative errno value when it does not slay 😭

✨ ERRORS ✨

every possible heartbreak, laid out for you:

  • -ENOMEM — not enough memory to finish the operation. the vibe check failed, there's just no room 🥲
  • -EFAULT — the memory region is not properly mapped 🙈
  • -EINVAL — one or more of the arguments you passed are invalid. check ur inputs bestie 💀
  • -EOPNOTSUPP — the PCC backend operation is just not supported. it's giving "not today" 🚫

✨ AVAILABILITY ✨

llapi_pccdev_get() has been part of the lustre(7) user application interface library since release 2.13.0 🌈✨ so if you're on anything older… babe. upgrade.

✨ SEE ALSO ✨

k that's the whole page, you're officially educated 💜 this was Lustre User API, dated 2024-08-28, and honestly? iconic behavior from everyone involved. go forth and get those PCC backends, bestie 🦋🌸👑

📦 where this page comes from