nvme_identify_domain_list(2)

πŸ’– nvme_identify_domain_list β€” bestie's guide to the domain list ✨

okay so welcome to the libnvme API manual, page for nvme_identify_domain_list β€” yes that's the whole name, it's giving "I could not be shorter" energy but honestly? iconic. anyway this lil function is about Domain list data, and we're gonna get you fluent in it, no cap πŸ’…


🌸 NAME 🌸

nvme_identify_domain_list β€” Domain list data πŸ¦‹

no fr that's literally what it is. domain. list. data. slay.


✨ SYNOPSIS ✨

int nvme_identify_domain_list (int fd , __u16 domid , struct
nvme_id_domain_list *list );

look at her. three lil args, one int coming back out. structured. clean. main character energy fr πŸ’…


πŸŽ€ ARGUMENTS πŸŽ€

  • fd β€” File descriptor of nvme device. this is your lil VIP pass to the device bestie, you need it or nothing happens πŸ™ˆ
  • domid β€” Domain ID. the one you're querying about, the starting point, the "from here onward" kinda vibe.
  • list β€” User space destination address to transfer data. this is where the goodies land β€” you hand over the address, the kernel/device fills it up 🫢

πŸ¦‹ DESCRIPTION πŸ¦‹

okay so here's the tea πŸ“

A list of 31 domain IDs is returned to the host, and that list contains domain attributes in increasing order that are greater than the value you specified in the domid field. so basically: "give me everything after this number, sorted, thank you very much" πŸ’–

See struct nvme_identify_domain_attr for the definition of the returned structure. that's where the actual shape of the thing lives, don't skip it, iykyk 🌈


πŸ”₯ RETURN πŸ”₯

The nvme command status if a response was received β€” like, go check enum nvme_status_field for the details, it's all in there πŸ‘‘

or

-1 with errno set otherwise. so if things go sideways and no response ever came home? -1, and errno is gonna tell you why. periodt πŸ’€

ngl, always check that return value bestie. the difference between a happy status and a -1 with errno drama is the entire plot 😭

and that's the whole page, you ate it πŸ’…βœ¨

cute lil sign-off before you go: this one comes from the libnvme API manual, dated July 2026 β€” so yeah, future-dated and still serving πŸ’œ 🌸 πŸŽ€ take care of your file descriptors and your domids, mwah 🫢

πŸ“¦ where this page comes from