nvme_init_m..._controllers(9)

πŸ“¦ version 3.2, in arch rolling

πŸ’… nvme_init_manage_export_nvms_send_associate_controllers ✨

okay bestie, so this is a page from the libnvme API manual, and the function we're stanning is nvme_init_manage_export_nvms_send_associate_controllers πŸŽ€ (yes it's a long name, yes it ate, we move).

🌸 NAME 🌸

nvme_init_manage_export_nvms_send_associate_controllers β€” Initialize passthru command for Manage Exported NVM Subsystem Send - Associate Controllers (memory-based transports only, iykyk πŸ‘€)


πŸ¦‹ SYNOPSIS πŸ¦‹

void nvme_init_manage_export_nvms_send_associate_controllers (struct
libnvme_passthru_cmd *cmd , __u16 esubid , struct
nvme_exported_ctrl_assoc_data *data , __u32 len );

like, that's the whole signature, no cap πŸ’€


⭐ ARGUMENTS ⭐

  • cmd β€” the passthru command you're gonna use, bestie. this is the buffer we're setting up ✨
  • esubid β€” the Exported NVM Subsystem Identifier (ESUBID) of the target Exported NVM Subsystem πŸ‘‘ that's a __u16, don't @ me
  • data β€” the Associate Controllers data buffer. literally see struct nvme_exported_ctrl_assoc_data 🫢
  • len β€” length of data. it's a __u32, periodt πŸ’…

πŸ’– DESCRIPTION πŸ’–

so what this icon does is initialize the passthru command buffer for the Manage Exported NVM Subsystem Send command πŸŽ€ β€” and specifically with the SEL value set to:

NVME_MANAGE_EXPORT_NVMS_SEND_SEL_ASSOCIATE_CONTROLLERS

that's the whole vibe 🌈. you hand it a command struct, an ESUBID, your data buffer, and a length, and it does the buffer setup so the command is ready to go. memory-based transports only tho β€” don't come for me if you're on something else πŸ™ˆ

fr fr the "memory-based transports only" part isn't a suggestion, it's the whole scope of this function. lowkey important πŸ’€

🧚 little sign-off 🧚

that's the whole page, bestie β€” courtesy of the libnvme API manual, dated October ... (the footer got a little cut off, the way that it does 😭), and yes the footer is out here spelling the function name as nvme_init_manage_export_nvms_send_associate_controllers in all its glorious 51-character entirety. slay. πŸ’…βœ¨πŸŽ€

πŸ“¦ where this page comes from