lsm_acces..._to_volume(3)

✨ NAME ✨

lsm_access_groups_granted_to_volume — the lil bestie that pulls up every access group that's got access to a volume 💅

It lives in the libstoragemgmt C API Manual, section 3, and it's here to spill the tea on who's allowed in.

---

🌸 SYNOPSIS 🌸

int lsm_access_groups_granted_to_volume (lsm_connect *conn, lsm_volume
*volume, lsm_access_group **groups[], uint32_t *group_count, lsm_flag
flags);

okay so it takes a whole lil friend group of arguments and hands you back an array. iconic behavior fr fr 🫶

---

🎀 ARGUMENTS 🎀

• conn — a valid connection. gotta be the real thing, no imposters 💖
• volume — a pointer to lsm_volume. the volume in question, the main character of this whole operation 👑
• groups[] — output pointer to an lsm_access_group array. heads up bestie: the value you get back must be freed with a call to lsm_access_group_record_array_free. don't just leave it hanging, that's not slay, that's a memory leak 😭
• group_count — uint32_t. the number of access groups. like, how many besties showed up to the party 🎉
• flags — reserved for future use, must be LSM_CLIENT_FLAG_RSVD. it's giving "not yet, but someday" ⭐

---

🦋 VERSION 🦋

1.0 — baby's first version, and she ate 💅

---

🌈 DESCRIPTION 🌈

Returns a list of volumes which is accessible by the specified access group.

yes this is literally what the page says and yes we are keeping it, no cap 🙈 the function name says "access groups granted to a volume" and the description says "volumes accessible by the specified access group" — we just report, we don't editorialize ✨

---

💜 CAPABILITY 💜

LSM_CAP_ACCESS_GROUPS_GRANTED_TO_VOLUME

if your thing supports this capability, you're in business. if not... vibe check failed, sorry babe 😔

---

⭐ RETURN ⭐

error code, as enumerated by lsm_error_number. the whole roster:

• LSM_ERR_OK — on success. we love to see it 🥳
• LSM_ERR_INVALID_ARGUMENT — when any argument is NULL, or not a valid lsm_connect pointer, or invalid flags, or invalid lsm_volume pointer. basically when somebody handed you garbage 🙈
• LSM_ERR_NOT_FOUND_VOLUME — when the volume is not found. it's not here, she's not coming 💀
• LSM_ERR_NO_SUPPORT — not supported. it's giving "we don't do that here" 🚫

---

that's the whole page bestie, every flag, every error code, every pointer, all of it — nothing dropped, nothing invented, we keep it fr fr 🫶

signing off from the Libstoragemgmt C API Manual, February 2026 edition 💖 stay hydrated, free your arrays, and slay ✨