nvme_format_nvm(2)

✨ nvme_format_nvm ✨

okay bestie, welcome to the libnvme API manual 💖 this one's a little spicy so buckle up 🎀

🌸 NAME 🌸

nvme_format_nvm — Format nvme namespace(s) 💅

---

🦋 SYNOPSIS 🦋

int nvme_format_nvm (struct nvme_format_nvm_args *args );

🎀 ARGUMENTS 🎀

• args — this is your struct nvme_format_nvme_args argument structure, the little container that holds all the info the call needs 🫶

---

👑 DESCRIPTION 👑

so like, the Format NVM command does a low level format of the NVM media. it's giving "factory reset but make it firmware" 😭

the host uses this command to change the LBA data size and/or the metadata size. slay. very main character of it.

⚠️ okay but real talk — a low level format may destroy all data and metadata associated with all namespaces, or only the specific namespace associated with the command. it will not ask twice. so like, back up first or cry later 🙈

---

💀 RETURN 💀

it returns the nvme command status if a response was received (check out enum nvme_status_field for that 👀), or -1 with errno set otherwise. periodt.

---

that's the whole thing bestie, go format responsibly 🧚💜

xoxo, this was the nvme_format_nvm page, page nvme_format_nvm(2) of the libnvme API manual, dropped back in July 2026 🌈⭐