lsm_access_group_list(3)

✨ lsm_access_group_list ✨

okay so bestie, we're in the Libstoragemgmt C API Manual today and the star of the show is lsm_access_group_list(3) — she retrieves a list of access groups 💖 no cap, that's literally her whole job.

---

🌸 NAME 🌸

lsm_access_group_list — Retrieves a list of access groups.

---

🎀 SYNOPSIS 🎀

int lsm_access_group_list (lsm_connect *conn, const char *search_key,
const char *search_value, lsm_access_group **groups[], uint32_t
*group_count, lsm_flag flags);

---

🦋 ARGUMENTS 🦋

• conn — a valid lsm_connect pointer. Like, she has to be real, not NULL, bestie 🙈
• search_key — the search key. Pass NULL if you want all of them, no filter, we're just vibing. The valid search keys are: "id" and "system_id". That's it, that's the list 💅
• search_value — the search value. The thing you're searching for. Iconic pairing with search_key, fr fr.
• groups[] — output pointer of an lsm_access_group array. Heads up: you gotta free this yourself with lsm_access_group_record_array_free. She does not clean up after herself, that's on you 🫶
• group_count — output pointer of uint32_t. Number of access groups. So you know how many you got.
• flags — reserved for future use, must be LSM_CLIENT_FLAG_RSVD. Not me telling you to not get creative with this one 😭

---

💜 VERSION 💜

1.0

---

🌈 DESCRIPTION 🌈

Gets a list of access group on this connection. Okay so real talk — an access group is also known as a host group on some storage systems, so if you see that name floating around, it's the same girl, different outfit ✨. What she does is define a group of initiators that all share the same access to the volume. Group chat but for initiators, honestly.

The access group properties could be retrieved by these functions:

• lsm_access_group_id_get
• lsm_access_group_name_get
• lsm_access_group_system_id_get
• lsm_access_group_initiator_id_get

---

👑 CAPABILITY 👑

LSM_CAP_ACCESS_GROUPS

---

🔥 RETURN 🔥

Returns an error code as enumerated by lsm_error_number. The possibilities, bestie:

• LSM_ERR_OK — on success 💖 we ate, no crumbs.
• LSM_ERR_INVALID_ARGUMENT — when any argument is NULL or there's invalid flags or an invalid search key. Basically you handed her something cursed and she's not about it.
• LSM_ERR_NO_SUPPORT — not supported. She simply cannot, and she said so respectfully 💀

ngl if you're getting anything other than LSM_ERR_OK, double check your args first, that's usually the culprit 🙈

---

okay that's the whole page, you're so welcome 💅 mwah. this was lsm_access_group_list(3) from the Libstoragemgmt C API Manual, version 1.0, dated February 2026 — periodt, take care of her and she'll take care of your access groups 🦋💖✨