NVME-RPMB-WRITE-D(1) NVMe Manual NVME-RPMB-WRITE-D(1)

# [NAME](#NAME)

nvme-rpmb-write-data - Write authenticated data to an RPMB target

# [SYNOPSIS](#SYNOPSIS)

```
nvme [<global-options>] rpmb write-data <device>


                        [--msgfile=<data-file> | -f <data-file>]


                        [--msg=<data> | -d <data>]


                        [--keyfile=<key-file> | -g <key-file>]


                        [--key=<key> | -k <key>]


                        [--address=<offset>]


                        [--blocks=<512 byte sectors> | -b <sectors>]


                        [--target=<target-id> | -t <target-id>]
```

# [DESCRIPTION](#DESCRIPTION)

Supports authenticated data writing to the specified RPMB target, at the given sector offset, using the authentication key previously programmed with *nvme rpmb program-key* for that target.

If the requested size is not within the total size supported by the target, the request fails without being sent to the device.

The &lt;device&gt; parameter is mandatory and an NVMe character device (ex: /dev/nvme0) must be specified.

# [OPTIONS](#OPTIONS)

-t &lt;target&gt;, --target=&lt;target&gt;

RPMB target id. This should be one of the supported RPMB targets as reported by *nvme rpmb info*. If nothing is given, the default of 0 is used as the RPMB target.

--address=&lt;offset&gt;

The address (in 512 byte sector offset from 0) to write to on the specified RPMB target.

-b &lt;sectors&gt;, --blocks=&lt;sectors&gt;

The size in 512 byte sectors to write to the specified RPMB target.

-k &lt;key&gt;, --key=&lt;key&gt;, -g &lt;key-file&gt;, --keyfile=&lt;key-file&gt;

Authentication key previously programmed with *nvme rpmb program-key* for the given target. The key can be specified on the command line using --key or -k, or read from a file using --keyfile or -g.

-f &lt;data-file&gt;, --msgfile=&lt;data-file&gt;

Name of the file the data to be written is read from.

-d &lt;data&gt;, --msg=&lt;data&gt;

Provides the data to be written directly on the command line, instead of reading it from a file.

# [GLOBAL OPTIONS](#GLOBAL_OPTIONS)

The following options are defined at the top-level nvme command and are available to this subcommand:

--dry-run

Print the command that would be executed, but do not actually execute it.

--no-ioctl-probing

Disable probing for 64-bit IOCTL support.

--no-retries

Disable retry logic on transient errors.

-o &lt;fmt&gt;, --output-format=&lt;fmt&gt;

Set the reporting format to *normal*, *tabular, 'json*, or *binary*. Only one output format may be used at a time.

--output-format-version=&lt;version&gt;

Select the output format version. Version *1* uses the original field naming, while version *2* (default) provides more consistent and script-friendly field names. Other versions are rejected.

--quiet

Suppress informational messages. Errors are still reported, and --quiet cancels any --verbose for the library log level.

--set-options=&lt;key=value&gt;\[,&lt;key=value&gt;...]

Set libnvme library options for this invocation. Supported keys are *force-4k*, *mi-probe-enabled*, *test-base-dir* and *test-sysfs-dir*.

--timeout=&lt;ms&gt;

Set the timeout for the command in milliseconds. *infinite* or *-1* waits without a time limit (0xffffffff).

-v, --verbose

Increase the level of detail in the output. May be specified multiple times to further increase verbosity.

These options can also be set as machine-wide defaults in [nvme-cli.conf(5)](/man/os/nvme-cli/nvme-cli.conf.5). A command-line flag always overrides the file.

# [EXAMPLES](#EXAMPLES)

•Write 200 blocks of (512 bytes) from input.bin onto target 0

```
# nvme rpmb write-data /dev/nvme0 -t 0 -f input.bin -b 200 -k 'SecretKey'
```

# [NVME](#NVME)

Part of the nvme-user suite

10/30/2026 NVMe

---

Document: nvme-rpmb-write-data(1) from nvme-cli 3.2-r0 (Chainguard OS)
Source: https://github.com/linux-nvme/nvme-cli