lsm_pool_list(3)

📦
version 1.10.3 · 3 versions
, in fedora 43, fedora 44

💖 lsm_pool_list — bestie edition 💖

okay so this is a page from the Libstoragemgmt C API Manual, and we're talking about lsm_pool_list(3), which is lowkey the moment you go "hey, what storage pools do we even have around here" 🦋

✨ NAME ✨

lsm_pool_list — Query the list of storage pools on this connection.

Like, all of them. The whole roster. 👑

🌸 SYNOPSIS 🌸

int lsm_pool_list (lsm_connect *conn, char *search_key, char
*search_value, lsm_pool **pool_array[], uint32_t *count, lsm_flag
flags);

🎀 ARGUMENTS 🎀

  • conn — a Valid lsm_connect pointer. Bestie, it has to be valid, we're not doing chaos today 💅
  • search_key — the search key. Pass NULL for all of them. The valid search keys are: "id", "system_id".
  • search_value — the search value. Yeah, it pairs with the key. Iconic duo fr fr.
  • pool_array[] — output pointer of lsm_pool array. Heads up bestie: it should be manually freed by lsm_pool_record_array_free. She does not clean up after herself, you gotta do it 😭
  • count — output pointer of uint32_t. Number of storage pools. The receipts. 🧾
  • flags — Reserved for future use, must be LSM_CLIENT_FLAG_RSVD. Like, must must. No freestyling here.

⭐ VERSION ⭐

1.0

🌈 DESCRIPTION 🌈

Query the list of storage pools on this connection. And okay, here's the tea: Pool is the only place a volume or a file system could created from. So like, pool is the main character and everything else is just living in her house 🏠✨

Pool properties could be retrieved by these functions:

  • lsm_pool_id_get
  • lsm_pool_name_get
  • lsm_pool_system_id_get
  • lsm_pool_free_space_get
  • lsm_pool_total_space_get
  • lsm_pool_status_get
  • lsm_pool_status_info_get
  • lsm_pool_unsupported_actions_get
  • lsm_pool_element_type_get

Nine little getters, all lined up, all serving looks 💜

💀 RETURN 💀

Error code as enumerated by 'lsm_error_number'.

  • LSM_ERR_OK
    • On success or searched value not found. Yeah, "not found" still counts as okay — she's not mad, she's just telling you it's not there 🫶
  • LSM_ERR_INVALID_ARGUMENT
    • When any argument is NULL or invalid flags or invalid search key. Basically when you show up with nonsense, she's gonna flag it. 🙈

and that's the whole page bestie!! no cap, you're now certified in pool listing 👑

signing off — this one came from the Libstoragemgmt C API Manual, page lsm_pool_list(3), dated February 2026 🌸🦋✨

📦 where this page comes from