lsm_acces...iator_add(3)

💖 lsm_access_group_initiator_add(3) 💖

okay bestie, welcome to the Libstoragemgmt C API Manual ✨ (yes the page header likes to truncate the name into little bits like lsm_acces...iator_add — that's just the title being dramatic, the real function is right here 🫶)

---

🌸 NAME 🌸

lsm_access_group_initiator_add — adds an initiator to the access group. that's it, that's the whole job, and she does it flawlessly 💅

---

✨ SYNOPSIS ✨

int lsm_access_group_initiator_add (lsm_connect *conn, lsm_access_group
*access_group, const char *init_id, lsm_access_group_init_type
init_type, lsm_access_group **updated_access_group, lsm_flag flags);

---

🎀 ARGUMENTS 🎀

• conn — a valid lsm_connect pointer. like, it has to actually be valid, no fake ones 🙈
• access_group — pointer of lsm_access_group to modify. this is the group getting the glow-up.
• init_id — string. the initiator id to be added to the group. 💫
• init_type — lsm_access_group_init_type. the valid initiator types are, and I cannot stress this enough, exactly these:
  • LSM_ACCESS_GROUP_INIT_TYPE_ISCSI_IQN — iSCSI IQN. 🌐
  • LSM_ACCESS_GROUP_INIT_TYPE_WWPN — FC WWPN. 🔥
• updated_access_group — output pointer of the updated lsm_access_group. ⚠️ the returned value must be freed with lsm_access_group_record_free. don't leave her hanging, free her.
• flags — reserved for future use, must be LSM_CLIENT_FLAG_RSVD. no improvising, bestie.

---

⭐ VERSION ⭐

1.0 — vintage but iconic, iykyk 👑

---

🦋 DESCRIPTION 🦋

Add an initiator to the specified access group. literally what it says on the tin, and it eats every single time. 🍓

---

🌈 CAPABILITY 🌈

• LSM_CAP_ACCESS_GROUP_INITIATOR_ADD_WWPN
• LSM_CAP_ACCESS_GROUP_INITIATOR_ADD_ISCSI_IQN

---

💀 RETURN 💀

error code as enumerated by lsm_error_number. the whole roster:

• LSM_ERR_OK — on success. slay!! 🎉
• LSM_ERR_INVALID_ARGUMENT — when any argument is NULL or not a valid lsm_connect pointer, or invalid flags, or invalid lsm_access_group pointer, or illegal initiator, or invalid init_type. so basically: check ur inputs, girl.
• LSM_ERR_NOT_FOUND_ACCESS_GROUP — when the access group is not found. she's not here. 😭
• LSM_ERR_EXISTS_INITIATOR — when the specified initiator is in another access group. not me being two places at once 💀
• LSM_ERR_NO_STATE_CHANGE — when the specified initiator is already in the specified access group. no change, no notes, no drama. 🙈
• LSM_ERR_NO_SUPPORT — not supported. 🚫

lowkey reminder: LSM_ERR_INVALID_ARGUMENT catches a lot of sins — NULL stuff, bad lsm_connect, bad flags, bad lsm_access_group, illegal initiator, bad init_type. so if something's misbehaving, bestie, look there first 👀

---

okay that's the whole page, you ate it up 💖

sign-off moment: this was brought to you by the Libstoragemgmt C API Manual, and the footer stamp says February 2026. take care of urself, free ur lsm_access_group records, and go be the main character of ur own storage array 👑✨🫶