---
name: "libnvmf_config_emit_install-libnvme3"
section: "2"
platform: "linux"
package: "nvme-cli"
version: "3.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/libnvmf_config_emit_install-libnvme3"
---

# libnvmf\_config\_emit\_install-libnvme3(2)

Write a configuration to disk.

## NAME

libnvmf\_config\_emit\_install - Write a configuration to disk.

## SYNOPSIS

**int libnvmf\_config\_emit\_install** **(struct libnvmf\_config\_emitter \*emitter** *,* **const char \*file** *,* **bool force** *);*

## ARGUMENTS

- emitter

  Configuration emitter.

- file

  Destination configuration file, or NULL to use the default configuration file.

- force

  Overwrite an existing configuration if true.

## DESCRIPTION

The default persona is written to the main configuration file. Each named persona is written to a separate drop-in file.

The generated configuration is validated by reading it back through the standard parser before it is installed. Files are written atomically (temporary file followed by rename). If any step fails, no configuration is installed.

## RETURN

\* 0 on success. \* -EEXIST if a configuration already exists and *force* is false. \* -EINVAL if *emitter* is NULL. \* A negative errno value on other failures.