libnvme(9)

🦋 libnvme(9) — the API Manual, bestie edition 🦋

Okay so this page lives in the libnvme manual, section 9, and it's all about one very specific little struct. Grab a snack, we're doing a field-by-field tour 💅

---

✨ NAME ✨

struct nvmf_dim_data — Discovery Information Management (DIM) — Data. That's the whole vibe: it's the data blob for DIM. Iconic, honestly.

---

🌸 SYNOPSIS 🌸

Here's the shape of it, exactly as the header gods wrote it:

struct nvmf_dim_data {
    __le32 tdl;
    __u8 rsvd4[4];
    __le64 nument;
    __le16 entfmt;
    __le16 etype;
    __u8 portlcl;
    __u8 rsvd21;
    __le16 ektype;
    char eid[NVME_NQN_LENGTH];
    char ename[NVMF_ENAME_LEN];
    char ever[NVMF_EVER_LEN];
    __u8 rsvd600[424];
    union nvmf_die  die[];
};

Look at that trailing flexible array member at the end, she's literally built to grow 🧚✨

---

👑 Members 👑

Time for the meet-and-greet, one field at a time. No skipping, we don't do that here 🫶

• tdl — Total Data Length. The overall length of the data, in case you were wondering how much data the data is 🍓
• rsvd4 — Reserved. Nothing to see, move along, it's just vibing there taking up space 💀
• nument — Number of entries. How many die entries you're working with — remember this number, bestie, you'll need it later 🌈
• entfmt — Entry Format, and it's an enum nvmf_dim_entfmt. Fancy typed enum energy ✨
• etype — Entity Type, typed as enum nvmf_dim_etype. Yes there's two of these, no they're not the same thing, don't mix them up 🙈
• portlcl — Port Local. That's the field name, that's the whole description, we simply report the facts 💜
• rsvd21 — Reserved. Another reserved one. Reserved fields are having a whole moment on this struct, honestly 💅
• ektype — Entry Key Type. The type of the entry key, lowkey self-explanatory 🔥
• eid — Entity Identifier, e.g. Host NQN. It's a char array of NVME_NQN_LENGTH, and it holds stuff like your Host NQN ⭐
• ename — Entity Name, e.g. hostname. A char array sized NVMF_ENAME_LEN 🎀
• ever — Entity Version, e.g. OS Name/Version. A char array sized NVMF_EVER_LEN — yes, ever, not env, we're being careful here 😭
• rsvd600 — Reserved. A whole __u8 rsvd600[424], which is a lot of reserved. 424 bytes of pure "please ignore me" energy 🦋
• die — Discovery Information Entry (see nument above 👀). It's a union nvmf_die flexible array, so there are as many of these as nument says — that's the callback to the earlier field, iykyk 💖

Bestie note: those rsvd* fields are reserved — the manual just says "Reserved" and that's genuinely all the info there is. Don't go inventing meaning for them, that's not the move 🧚

---

🌟 cute sign-off 🌟

That's the whole page, and it's from October 2026, all about struct nvmf_dim_data, living in libnvme(9). Slay, go forth and parse your discovery data correctly, bestie 💅✨👑