---
name: "nvme_fw_download"
section: "2"
platform: "linux"
package: "libnvme-dev"
version: "1.13-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/nvme_fw_download"
---

# nvme\_fw\_download(2)

Download part or all of a firmware image to the controller

## NAME

nvme\_fw\_download - Download part or all of a firmware image to the controller

## SYNOPSIS

**int nvme\_fw\_download** **(struct nvme\_fw\_download\_args \*args** *);*

## ARGUMENTS

- args

  *struct nvme\_fw\_download\_args* argument structure

## DESCRIPTION

The Firmware Image Download command downloads all or a portion of an image for a future update to the controller. The Firmware Image Download command downloads a new image (in whole or in part) to the controller.

The image may be constructed of multiple pieces that are individually downloaded with separate Firmware Image Download commands. Each Firmware Image Download command includes a Dword Offset and Number of Dwords that specify a dword range.

The new firmware image is not activated as part of the Firmware Image Download command. Use the **nvme\_fw\_commit** to activate a newly downloaded image.

## RETURN

The nvme command status if a response was received (see *enum nvme\_status\_field*) or -1 with errno set otherwise.