iscsi_nodes_get(3)

💖 iscsi_nodes_get(3) — the "gimme ALL ur nodes" page 💖

okay bestie, welcome to iscsi_nodes_get(3) from the API Manual — yes that's the section-3 libopeniscsiusr girlies, we're in the library docs now, iykyk 🫶

---

🌸 NAME 🌸

iscsi_nodes_get — literally retrieve all iSCSI nodes. all of them. periodt.

---

✨ SYNOPSIS ✨

int iscsi_nodes_get (struct iscsi_context *ctx, struct iscsi_node
***nodes, uint32_t *node_count);

look at that triple pointer bestie, it's giving main character energy 💅 (do not be scared, we'll get through it together)

---

🎀 ARGUMENTS 🎀

• ctx — pointer of struct iscsi_context. and listen. if this pointer is NULL, your program will be terminated by assert 😭 like literally executed on the spot, no vibes, no mercy. so check it, okay? 🙈
• nodes — output pointer of struct iscsi_node pointer array. its memory should be freed by iscsi_nodes_free (yes queen, you gotta clean up after yourself 🧹✨). if this pointer is NULL, your program will be terminated by assert too 💀 same deal.
• node_count — output pointer of uint32_t. Will store the size of

fr fr the original page just ends there mid-sentence 😭 "the size of" WHAT. the size of the array obviously, but i'm not gonna make stuff up on a manpage, so here it stays, exactly like the source. slay i guess 💀

---

🦋 DESCRIPTION 🦋

Retrieves all iSCSI nodes. that's it. that's the whole vibe. 👑

For the properties of struct iscsi_node, please refer to the functions defined in the libopeniscsiusr_node.h file — go read that header bestie, it's where the lore lives 📖✨

The returned results contains iSCSI nodes configured in "/etc/iscsi/nodes/". yes, that directory. that's where they live. 🏠

Illegal configuration file will be skipped and warned — so like, sketchy configs get ghosted AND get a warning, we don't just silently ignore them, we're polite about it 🫶🙈

The returned struct iscsi_node pointer array is sorted by target name, connection address, connection port and interface. in that order, no cap, very organized of them 🌈⭐

---

🔥 RETURN 🔥

int. Valid error codes are:

• LIBISCSI_OK ✅ (the slay outcome)
• LIBISCSI_ERR_BUG 🐛
• LIBISCSI_ERR_NOMEM 😭 (bestie is out of memory)
• LIBISCSI_ERR_ACCESS 🔒
• LIBISCSI_ERR_SYSFS_LOOKUP 🔍
• LIBISCSI_ERR_IDBM 💀

Error number could be converted to string by iscsi_strerror. use it, it turns the cryptic number into actual words, so iconic of it 💜

⚠️ reminder boo: those assert terminations are real. NULL in ctx or nodes = program go bye-bye. no error code, no warning, just gone. 🪦

---

and that's the page!! mwah 💋 this was pulled straight from the API Manual, dated September 2026, for iscsi_nodes_get — go forth and get those nodes, bestie, you're gonna eat 🍓🧚💜