libnvme(9)

💖 libnvme(9) — API Manual 💖

okay bestie, sit DOWN, we're doing libnvme(9) today and it's giving ✨kernel-adjacent✨ in the best way. This page is all about one lil struct, no cap.

---

🌸 NAME 🌸

struct nvme_zns_append_args — Arguments for the NVMe ZNS Append command 🦋

like literally the whole page is just this one struct's whole deal. iconic behavior.

---

✨ SYNOPSIS ✨

struct nvme_zns_append_args {
    __u64 zslba;
    __u64 *result;
    void *data;
    void *metadata;
    int args_size;
    int fd;
    __u32 timeout;
    __u32 nsid;
    __u32 ilbrt;
    __u32 data_len;
    __u32 metadata_len;
    __u16 nlb;
    __u16 control;
    __u16 lbat;
    __u16 lbatm;
    __u8 rsvd1[4];
    __u64 ilbrt_u64;
 };

look at her. so many fields. she's serving structure, she's serving layout, she's serving alignment. we love her 💅

---

👑 Members 👑

okay so here's the field-by-field breakdown, and yes I'm doing every single one, because every single one matters, fr fr.

• zslba — the Zone start logical block address 🎀 where the zone begins, bestie.
• result — the command completion result from CQE dword0. that's where the answer to "how did it go" comes home to roost.
• data — userspace address of the data 📦
• metadata — userspace address of the metadata 🗂️
• args_size — size of struct nvme_zns_append_args. yes she knows her own size. self-aware queen.
• fd — file descriptor of nvme device 🔌 the doorway to the actual hardware.
• timeout — timeout in ms ⏳ measured in milliseconds, don't get it twisted.
• nsid — Namespace ID. which namespace are we talking to? this one.
• ilbrt — Initial logical block reference tag 🏷️
• data_len — length of data 📏
• metadata_len — length of metadata 📏
• nlb — number of logical blocks. how many blocks we're appending, periodt.
• control — (no description given in the original, so I'm not making one up, bestie 🫶 it's just control and we respect her privacy)
• lbat — logical block application tag 🏷️
• lbatm — logical block application tag mask 🎭 the mask, not the tag. different girls, different jobs.
• rsvd1 — Reserved. it's a __u8 rsvd1[4], hands off, don't touch, it's reserved for a reason 🙈
• ilbrt_u64 — Initial logical block reference tag — 8 byte version required for enhanced protection info 🔥 note that "8 byte version" part, it's important, it's the whole point of having this separate field from the __u32 ilbrt up top.

---

ok real talk for one sec: rsvd1 is Reserved. do not write into it, do not get creative with it. reserved means reserved. slay responsibly 💖

---

and that's the whole page, bestie!! every field accounted for, nothing skipped, we ate and left no crumbs 🍓🧚

this was from the libnvme API Manual, dated August 2026, and the page you're holding is struct nvme_zns_append_args from libnvme(9) 🌈

mwah, go append some zones 💜✨