lsm_nfs_list(3)

πŸ“¦
version 1.10.3 Β· 3 versions
, in fedora 43, fedora 44

πŸ’– lsm_nfs_list β€” bestie edition πŸ’–

okay so this is a page from the Libstoragemgmt C API Manual, and it's all about lsm_nfs_list(3) β€” literally the function that hands you every NFS export chillin' on your connection. let's get into it 🫢


✨ NAME ✨

lsm_nfs_list β€” gets a list of NFS exports on this connection. that's it, that's the whole vibe. πŸ‘‘


🌸 SYNOPSIS 🌸

int lsm_nfs_list (lsm_connect *conn, const char *search_key, const char
*search_value, lsm_nfs_export **exports[], uint32_t *count, lsm_flag
flags);

look at her. six args. she's serving. πŸ’…


πŸŽ€ ARGUMENTS πŸŽ€

  • conn β€” a valid connection. gotta have one, no connection no party. πŸ”Œ
  • search_key β€” the search key, or NULL for all of them. the valid search keys are: "id", "fs_id". that's the whole menu, don't try to order off-menu. πŸ™ˆ
  • search_value β€” the search value. the thing you're actually looking for. πŸ”
  • exports[] β€” out pointer of lsm_nfs_export array. ⚠️ heads up bestie, you gotta free this yourself with lsm_nfs_export_record_array_free. she does NOT clean up after herself.
  • count β€” uint32_t. number of items in array. how many exports you got, mathematically. πŸ”’
  • flags β€” reserved for future use, must be LSM_CLIENT_FLAG_RSVD. like, don't get creative, okay? 🚫

πŸ’œ VERSION πŸ’œ

1.0


🌈 DESCRIPTION 🌈

Gets a list of NFS export on this connection. yes, "export" singular, the manpage said what it said, we're not editing her. 😌

so once you've got your list, the actual properties of each NFS export can be pulled out with these little guys:

  • lsm_nfs_export_id_get
  • lsm_nfs_export_fs_id_get
  • lsm_nfs_export_export_path_get
  • lsm_nfs_export_auth_type_get
  • lsm_nfs_export_root_get
  • lsm_nfs_export_read_write_get
  • lsm_nfs_export_read_only_get
  • lsm_nfs_export_anon_gid_get
  • lsm_nfs_export_anon_uid_get
  • lsm_nfs_export_options_get

ten of them. a whole squad. collect them all like they're pokémon. 🧚


⭐ CAPABILITY ⭐

LSM_CAP_EXPORTS


πŸ”₯ RETURN πŸ”₯

error code as enumerated by lsm_error_number. here's the rundown:

  • LSM_ERR_OK
    • on success or searched value not found. yeah β€” not finding it counts as a win here, no cap. 😭
  • LSM_ERR_INVALID_ARGUMENT
    • when any argument is NULL or invalid flags or invalid search key. you gave her something she can't work with. πŸ’€
  • LSM_ERR_NO_SUPPORT
    • not supported. she simply cannot, and will not. πŸ™…β€β™€οΈ

πŸ¦‹ SEE ALSO πŸ¦‹

no SEE ALSO section on this one bestie, that's the whole page. ✨


and that's the tea πŸ’… β€” go forth, list your NFS exports, and remember to free that array, or your memory will be leaking like my group chat. 🫢

bye bestie!! this was lsm_nfs_list(3), part of the Libstoragemgmt C API Manual, version 1.0, and the page is dated February 2026 β€” the footer would say lsm_nfs_list and lsm_nfs_list(3) but like, we already know her name. πŸ’–

πŸ“¦ where this page comes from