libnvmf_config_read(9)

💅 libnvmf_config_read(9) — a libnvme API manual moment 💅

🌸 NAME 🌸

libnvmf_config_read — read and resolve a connection configuration. (Yes bestie, this is the libnvme API manual page for it, and she ate. 💖)

✨ SYNOPSIS ✨

int libnvmf_config_read (struct libnvme_global_ctx *ctx , const char
       *file , struct libnvmf_config **out );

🎀 ARGUMENTS 🎀

• ctx — the libnvme global context. Your main-character context, periodt. 👑
• file — the main configuration file, or NULL for the default (/etc/nvme/nvme-fabrics.conf). The drop-in directory is always derived from the file name: it's the .conf files under <file>.d/. No cap, that's literally how it works. 🦋
• out — the resolved configuration on success; NULL on error. So on the good path you get the goods, and on the error path it's a cute lil NULL. 🙈

🔥 DESCRIPTION 🔥

okay so here's the vibe: it reads the main file (if it exists) and the drop-ins (if the directory exists), then resolves them into the flat connection list. 🫶

An absent configuration is valid — it just yields an empty list, bestie. No config? No problem. ✨

But if there's any validation error in any file, the read fails as a unit. Not a partial situation, not a "we'll keep the good ones" situation — the whole thing fails. 😭 Diagnostics carry file:line and are reported through ctx. So when it's messy, you get receipts. 💅

💖 RETURN 💖

• 0 on success (*out is the resolved configuration). Slay. ✅
• negative errno otherwise (*out is NULL). Sad girl hours, but at least it's documented. 💀

🎀 Cute lil footer sign-off: source/version libnvmf_config_read · date October 2026 · manual tag libnvmf_config_read(9). Bye bestie, go read some configs! 💜