libnvme_sed_discover(9)

📦 version 3.2, in arch rolling

💅 libnvme_sed_discover(9) — the libnvme API manual, bestie edition

okay so picture this: it's giving "libnvme API manual", it's giving TCG Level 0 Discovery energy, and the whole page is literally just one function. iconic honestly.

✨ NAME ✨

libnvme_sed_discover — say hi to your TCG Level 0 Discovery data 🎀 like it literally retrieves it for you

🌸 SYNOPSIS 🌸

int libnvme_sed_discover (struct libnvme_transport_handle *hdl , void
*buf , __u32 len );

that's the whole vibe. three args, one int, no notes 💅

🦋 ARGUMENTS 🦋

  • hdl — your transport handle 🫶 the lil passport that lets you actually talk to the thing
  • buf — the buffer where the Level 0 Discovery data is gonna land ✨ it's the empty plate, she's serving
  • len — size of buf, in bytes 📏 and yes bestie, bytes matter, don't be out here guessing

👑 DESCRIPTION 👑

so what actually happens? it issues a Security Receive for the Level 0 Discovery ComID. that's the move. that's the whole move 🔥

and here's the part where i need you to listen: the data comes back unparsed. raw. untouched. straight out the box 🍓 no cap, it is NOT gonna hand you neatly labeled feature descriptors, that is not her job.

so when you actually wanna look at what's inside — walk the feature descriptors and everything — you go grab libnvme_sed_l0_for_each or libnvme_sed_l0_find instead. those are the ones that do the walking 🧚 literally, walk the feature descriptors. iykyk.

💀 do not try to read the raw buffer like you know the layout. that's not this function's problem and it's not gonna be cute for you either.

🌈 RETURN 🌈

  • 0 — slay 💖 success, we ate, nothing else to say
  • the NVMe command status — if a response was actually received, you get this instead. and bestie if you're wondering which status, check enum nvme_status_field, that's where they all live 👀
  • a negative error code — for everything else. the "something went sideways and it wasn't the device talking back" situation 😭

🕐 a lil sign-off 🕐

made with love, libnvme_sed_discover, and stamped October 2026 🌸 the source/version line says libnvme_sed_discover and, yeah, the title up top said libnvme_sed_discover(9) again — she likes her name, let her have it 👑💜 mwah, go discover some data bestie 🫶

📦 where this page comes from