LLAPI_LAYOUT_COMP_USE(3)

✨ LLAPI_LAYOUT_COMP_USE(3) ✨

okay bestie so we're deep in the Lustre Library Functions section of the manual and this one is chef's kiss — it's all about moving your cursor around inside a layout like it's a lil carousel of components 🎠

---

💖 NAME 💖

llapi_layout_comp_use — change current component to relative position

like, it slides the "you are here" sticker on your layout to a different component, and it does it relatively, so it depends on where you already are. iykyk 🫶

---

🌸 SYNOPSIS 🌸

#include <lustre/lustreapi.h>

int llapi_layout_comp_use(struct llapi_layout *layout,
                          enum llapi_layout_comp_use *pos);

---

🦋 DESCRIPTION 🦋

so basically it changes the currently active component of layout to the relative position given by pos. think of layout as your lil component lineup and pos as the vibe direction you wanna scoot in 💅

these are the possible values for pos, and yes you have to pick one of them, no freestyling:

• LLAPI_LAYOUT_COMP_USE_FIRST — the first component of the layout. jump to the front of the line, main character energy 👑
• LLAPI_LAYOUT_COMP_USE_LAST — the last component of the layout. end of the queue, but make it iconic 🌈
• LLAPI_LAYOUT_COMP_USE_NEXT — the next component after the current one. one lil step forward 🚶♀️
• LLAPI_LAYOUT_COMP_USE_PREV — the previous component before the current one. one lil step back, no shame 🙈

---

⭐ RETURN VALUES ⭐

• returns 0 on success — slay, you moved 💖
• returns 1 when there is no next or previous component — like bestie, you're already at the edge, there's nothing there 😭
• otherwise, if an error occurred, it returns -1 and errno is set appropriately. yep, the classic -1 + errno combo 💀

---

💜 ERRORS 💜

• EINVAL — an invalid argument was specified. you handed it something it cannot work with, and it said absolutely not 🚫
• ENOENT — no such component ID exists. that component? never heard of her. doesn't exist 🕵️♀️

---

🎀 AVAILABILITY 🎀

llapi_layout_comp_use() is part of the lustre(7) user application interface library since release 2.10.0 — so she's been around since 2.10.0 and she's still serving ✨

---

🔥 SEE ALSO 🔥

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

---

and that's the whole page bestie, no cap 🫶 this was Lustre User API, dated 2024-08-27, and it lives at the very bottom of the manpage as LLAPI_LAYOUT_COMP_USE(3). go move some components around, you got this 💅🎀🦋