LLAPI_LAYOUT_STRIPE_COUNT_GET(3)

📦 version 2.17.58, in ubuntu stonking

💖 llapi_layout_stripe_count_get — bestie edition 💖

okay so this is a page from the Lustre Library Functions manual, section 3, and it's about two lil functions: llapi_layout_stripe_count_get and llapi_layout_stripe_count_set. their whole job? getting and setting the stripe count of a Lustre file. iconic, honestly. ✨

🌸 NAME 🌸

llapi_layout_stripe_count_get, llapi_layout_stripe_count_set — get or set the stripe count of a Lustre file 🦋

✨ SYNOPSIS ✨

#include <lustre/lustreapi.h>

int llapi_layout_stripe_count_get(const struct llapi_layout *layout,
                                  uint64_t *stripe_count);

int llapi_layout_stripe_count_set(struct llapi_layout *layout,
                                  uint64_t stripe_count);

💅 DESCRIPTION 💅

so like. the stripe count of a Lustre file is literally the number of OSTs that get used to store the file. that's it, that's the whole vibe. it's giving "how many places are we spreading this data across". 💖

llapi_layout_stripe_count_get() does exactly what the name says bestie — it stores into *stripe_count the stripe count of layout. no cap. 🫶

llapi_layout_stripe_count_set() sets the stripe count of layout to stripe_count. matching set, slay. 👑

and now for the special little values, because these are important:

  • a stripe_count value of LLAPI_LAYOUT_DEFAULT means that the default stripe count will be used. let the system cook. 🍓
  • a stripe_count value of LLAPI_LAYOUT_WIDE means that the file will be striped as widely as possible. go big or go home energy fr fr. 🌈

🎀 RETURN VALUES 🎀

llapi_layout_stripe_count_get() and llapi_layout_stripe_count_set() return 0 on success, or -1 if an error occurred (and in that case, errno is set appropriately). so like, check that return value, bestie, don't just ignore it 😭

💀 ERRORS 💀

  • EINVAL — an invalid argument was specified. yeah. you gotta pass valid stuff. we don't do that here. 🙈

⭐ AVAILABILITY ⭐

llapi_layout_stripe_count_get() and llapi_layout_stripe_count_set() is part of the lustre(7) user application interface library since release 2.7.0. so it's been around, it's established, it's not new-new. 🧚

👑 SEE ALSO 👑

okay that's the whole page, no notes, you're gonna do amazing with your stripe counts babe 🫶 this was the Lustre User API, dated 2024-08-27 — and yes the header/footer were doing that little truncation thing (LLAPI_LAYO...E_COUNT_GET(3)) because even manpages gotta be mysterious sometimes 💜 mwah, go stripe something ✨🌸

📦 where this page comes from