libnvme(9)

💖 libnvme(9) — API Manual 💖

okay bestie, welcome to the libnvme glow-up tour, section 9, API Manual edition. today's main character is a struct, and she is serving. let's get into it 🫶

---

✨ NAME ✨

struct nvme_resv_acquire_args — the args you hand over for the NVMe Reservation Acquire Command. that's it, that's the whole vibe. no cap.

---

🌸 SYNOPSIS 🌸

struct nvme_resv_acquire_args {
    __u64 crkey;
    __u64 nrkey;
    __u32 *result;
    int args_size;
    int fd;
    __u32 timeout;
    __u32 nsid;
    enum nvme_resv_rtype rtype;
    enum nvme_resv_racqa racqa;
    bool iekey;
 };

look at her. ten fields. absolutely iconic ✨

---

🎀 Members 🎀

she's got a whole roster, so let's meet the cast one by one, no skipping, we do not skip in this house 💅

• crkey — the current reservation key that's chillin' with the host. the one you already have, basically.
• nrkey — the reservation key that gets unregistered from the namespace, but ONLY if the action is preempt. not preempting? then this one's just sitting there. 🙈
• result — the command completion result, straight outta CQE dword0. the receipts, fr fr.
• args_size — the size of struct nvme_resv_acquire_args. she knows her own measurements 💅
• fd — file descriptor of the nvme device. your ticket in.
• timeout — timeout in ms. patience, but make it measurable ⏳
• nsid — namespace identifier. which namespace are we talking to? be specific bestie.
• rtype — the type of reservation to be create, see enum nvme_resv_rtype. (the original says "create", we're keeping it, it's part of her charm 😭)
• racqa — the action that is performed by the command, see enum nvme_resv_racqa. the "what are we actually doing here" field.
• iekey — set this to ignore the existing key. yes, ignore it. she said what she said. 💀

lowkey important: rtype and racqa are enums, so go read enum nvme_resv_rtype and enum nvme_resv_racqa before you start guessing values. don't freestyle a reservation command, bestie, that's not the move 🙏

---

that's the whole page, and you ate it. go forth and acquire those reservations responsibly 🦋

signing off with love from the libnvme crew — API Manual, page struct nvme_resv_acquire_args, dated August 2026. mwah 💖