LLAPI_LAYOUT_COMP_FLAGS_GET(3)

🦋 LLAPI_LAYOUT_COMP_FLAGS_CLEAR(3) — the flags trilogy, bestie edition ✨

okay so this is a Lustre Library Functions page, and the header's honestly giving ✨mystery✨ because it says LLAPI_LAYO...P_FLAGS_GET(3) with the little dots and everything. it's the llapi_layout_comp_flags_* family, and today we're doing all three of them together because they're a package deal, fr fr. 💅

---

💖 NAME

llapi_layout_comp_flags_get, llapi_layout_comp_flags_set, llapi_layout_comp_flags_clear — get, set or clear the flags of a layout component.

like. the whole squad. getting, setting, clearing. it's giving full-service. 🫶

---

✨ SYNOPSIS

#include <lustre/lustreapi.h>

int llapi_layout_comp_flags_get(const struct llapi_layout *layout,
                                uint32_t *flags);

int llapi_layout_comp_flags_set(struct llapi_layout *layout,
                                uint32_t flags);

int llapi_layout_comp_flags_clear(struct llapi_layout *layout,
                                  uint32_t flags);

note the const on the get version btw, because reading is a chill, non-destructive activity and the compiler knows. character development. 😌

---

🌸 DESCRIPTION

so what even ARE these flags? they're there to tell you the status of the component. and here's the tea: right now only LCME_FL_INIT is supported, which means the OST objects of that component have been initialized. that's it. that's the whole flag buffet. one (1) flag. no cap. 🎀

on to the three icons themselves:

• llapi_layout_comp_flags_get(3) — grabs the flags off the layout and tucks them safely into flags. reading, not touching. the respectful one. 💖
• llapi_layout_comp_flags_set(3) — sets the flags you specify onto the layout. main character energy, it's making changes. 🔥
• llapi_layout_comp_flags_clear(3) — clears the flags you specify from the layout. not me removing things with absolutely zero remorse. 💀

---

🌈 RETURN VALUES

• 0 — slay. success. everything worked. 👑
• -1 — an error occurred (and in that case, errno gets set appropriately, so go peek at it if you want the receipts).

bestie, always check the return value. -1 is a vibe check failure, okay? don't ignore the errno. 😭

---

💜 ERRORS

• EINVAL — an invalid argument was specified. somebody handed these functions something nonsense and they're not about it. 🙈

---

⭐ AVAILABILITY

llapi_layout_comp_flags_get(), llapi_layout_comp_flags_set() and llapi_layout_comp_flags_clear() are part of the lustre(7) user application interface library since release 2.10.0. so if you're on something older… yeah. upgrade era. 🧚

---

🍓 SEE ALSO

• llapi_layout_alloc(3)
• llapi_layout_file_open(3)
• llapi_layout(7)
• lustreapi(7)

go read those next, i promise it's worth it. ✨

---

and that's the page, babes 💖 this one's from the Lustre User API and it's dated 2024-08-27 — congrats on finishing, you're literally so smart for reading a whole manpage, periodt. 🎀🦋🌟