libnvmf_exclusion_write(9)    libnvme API manual    libnvmf_exclusion_write(9)

NAME
       libnvmf_exclusion_write - atomically replace a list's contents.

SYNOPSIS
       int libnvmf_exclusion_write (struct libnvme_global_ctx *ctx , const
       char *name , const char *text , uint64_t version );

ARGUMENTS
       ctx         libnvme global context; must not be NULL

       name        list name

       text        full replacement contents (every "exclusion = ..." line is
                   validated and must sit inside the [exclusions] section;
                   invalid entries cause -EINVAL and no write)

       version     token from a prior libnvmf_exclusion_read.  The write
                   proceeds only if the on-disk list still matches version;
                   otherwise it returns -ESTALE and leaves the file untouched,
                   so a concurrent editor's changes are never silently
                   overwritten.

DESCRIPTION
       The replacement is installed atomically (temp file + rename) with mode
       0644.

RETURN
       0 on success, -ESTALE if the list changed since version was read,
       -EINVAL for an invalid entry or name, negative errno otherwise.

October 2026                libnvmf_exclusion_write libnvmf_exclusion_write(9)