NAME¶

nvme-fw-commit - Used to verify and commit a firmware image.

SYNOPSIS¶

nvme fw-commit <device> [--slot=<slot> | -s <slot>]


                    [--action=<action> | -a <action>]


                    [--bpid=<boot-partid> | -b <boot-partid> ]

DESCRIPTION¶

For the NVMe device given, send an nvme Firmware Commit admin command and provides the results.

The Firmware Commit command is used to verify that a valid firmware image has been downloaded and to commit that revision to a specific firmware slot. The host may select the firmware image to commit on the next controller reset (CC.EN transitions from ‘1’ to ‘0’, a PCI function level reset, and/or other Controller or NVM Subsystem Reset) as part of this command. The currently executing firmware revision may be determined from the Firmware Revision field of the Identify Controller data structure as indicated in the Firmware Slot Information log page.

No further action is automatically taken to reset the device, which is usually required to complete the activation process. If your kernel and driver are recent enough, you can commit the firmware by issuing a reset through Linux sysfs, for example:

 # echo 1 > /sys/class/nvme/nvme0/device/reset

If your kernel is not recent enough, you will need to remove and add the device some other way.

OPTIONS¶

-a <action>, --action=<action>

-s <slot>, --slot=<slot>

--bpid=<boot-partid>, -b <boot-partid>

EXAMPLES¶

# nvme fw-commit /dev/nvme0 --slot=1 --action=2

ALIAS¶

fw-activate

NVME¶

Part of the nvme-user suite