LLAPI_PCCDEV_SET(3)

💖 LLAPI_PCCDEV_SET 💖

okay bestie, welcome to the Lustre Library Functions corner of the manual, where we're talking about llapi_pccdev_set — the little function that bosses your PCC backends around on a client. she's giving main character energy and honestly? obsessed. 🎀

---

✨ NAME ✨

llapi_pccdev_set — add or delete a PCC backend on a client. that's it, that's the whole vibe. 🦋

---

🌸 SYNOPSIS 🌸

#include <lustre/lustreapi.h>

int llapi_pccdev_set(const char *path, const char *cmd);

look at her. two arguments. so clean. so iconic. 💅

---

🫶 DESCRIPTION 🫶

so llapi_pccdev_set() does the thing: it adds or deletes a PCC backend on the client, and it finds that client through the mount point that path is pointing at. yes, path is your little map to the mount. 🌈

and then there's cmd, which is the input argument that tells her what to actually do. cmd can show up in these forms, no cap:

• "add $PCCPATH $PARAM" — add a PCC backend that's referenced by the HSM root path $PCCPATH. new backend, who dis ✨
• "del $PCCPATH" — delete a PCC backend that's referenced by the HSM root path $PCCPATH. bye girl 💀
• "clear" — clear AND remove all PCC backends on a client. like, every single one. nuclear option fr fr 😭

---

⭐ RETURN VALUES ⭐

llapi_pccdev_set() comes back with 0 when everything slays, or a negative errno value when it doesn't. no in-between, periodt. 👑

---

💀 ERRORS 💀

here's the mood-board of ways she can be like "nope":

• -ENOMEM — not enough memory to complete the operation. brain empty, no thoughts, no RAM. 😭
• -EFAULT — the memory region is not properly mapped. it's giving lost in the sauce. 🙈
• -EINVAL — one or more invalid arguments were handed over. check ur inputs bestie, she's judging (lovingly). 💅
• -EOPNOTSUPP — the PCC backend operation is just not supported. she simply cannot, and won't. 🚫

---

🧚 AVAILABILITY 🧚

llapi_pccdev_set() has been part of the lustre(7) user application interface library since release 2.13.0. so she's been here. she's got history. she's a veteran. 👑

---

🔥 SEE ALSO 🔥

• lustreapi(7)

go read it, iykyk 🫶

---

real talk tho: if cmd is malformed or path doesn't point at a real mount, expect a negative errno back — she does not do silent failures, and she does not do vibes-based parsing. 🌸

---

and that's the whole page, bestie!! this was written by the Lustre User API, dated 2024-08-28, and it's the LLAPI_PCCDEV_SET(3) page — so go forth, set those PCC backends, and slay 💖✨🎀