LLAPI_LAYO...E_COMP_DEL(3)

📦 version 2.17.58, in ubuntu stonking

✨ llapi_layout_file_comp_del — bestie edition ✨

okay so this is a Lustre library function, manual section 3, and it lives in the Lustre Library Functions family. its whole job? deleting a layout component off a file that already exists. iconic behavior honestly 💅

🌸 NAME 🌸

llapi_layout_file_comp_del — delete the specified layout component from an existing file.

🎀 SYNOPSIS 🎀

#include <lustre/lustreapi.h>

int llapi_layout_file_comp_del(const char *path,
                               uint32_t id, uint32_t flags);

💖 DESCRIPTION 💖

So here's the tea: this function deletes the layout component(s) from a file that already exists. you point at them either by id or by flags, not both, okay? 🫶

Rules of the road, no cap:

  • id has to be a real unique component ID. like, an actual one. not vibes.
  • if you're passing flags instead, then id must be set to zero. periodt.
  • path is the file you're doing this to.

The flags you can use are:

  • LCME_FL_INIT — deletes the instantiated components in the layout.
  • LCME_FL_NEG|LCME_FL_INIT — deletes the uninstantiated components in the layout.

that's the whole menu, bestie. two options. choose wisely 🦋

🌈 RETURN VALUES 🌈

  • Returns 0 on success. slay. ✅
  • Returns -1 if an error occurred — and in that case, errno is set appropriately. 😭

💀 ERRORS 💀

  • EINVAL — an invalid argument was specified. you handed it something it cannot work with, bestie.
  • ENOENT — path doesn't exist, or the specified component isn't found in the file. it's giving "not here, never was" 🙈

⭐ AVAILABILITY ⭐

llapi_layout_file_comp_del() is part of the lustre(7) user application interface library, and it's been in there since release 2.10.0. so if you're on something older… yeah, no. 👑

👑 SEE ALSO 👑

and that's the whole page, bestie 💖 this one's from the Lustre User API, dated 2024-08-27, filed under LLAPI_LAYO...E_COMP_DEL(3). go delete some components responsibly 🎀✨

📦 where this page comes from