NAME

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

SYNOPSIS

       nvme fw-activate <device> [--slot=<slot> | -s <slot>]
                           [--action=<action> | -a <action>]

DESCRIPTION

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

       The Firmware Activate 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 activate 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 activate the firmware by issuing
       a reset through Linux sysfs, for example:

            # echo 1 > /sys/class/misc/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>
           Activate Action: This field specifies the action that is taken on the image downloaded with the
           Firmware Image Download command or on a previously downloaded and placed image.
           ┌───────┬───────────────────────────────────────┐
           │ Value │ Definition                            │
           ├───────┼───────────────────────────────────────┤
           │ 0     │ Downloaded image replaces the image   │
           │       │ indicated by the Firmware Slot field. │
           │       │ This image is not activated.          │
           ├───────┼───────────────────────────────────────┤
           │ 1     │ Downloaded image replaces the image   │
           │       │ indicated by the Firmware Slot field. │
           │       │ This image is activated at the next   │
           │       │ reset.                                │
           ├───────┼───────────────────────────────────────┤
           │ 2     │ The image indicated by the Firmware   │
           │       │ Slot field is activated at the next   │
           │       │ reset.                                │
           ├───────┼───────────────────────────────────────┤
           │ 3     │ Reserved.                             │
           └───────┴───────────────────────────────────────┘

       -s <slot>, --slot=<slot>
           Firmware Slot: Specifies the firmware slot that shall be used for the Activate Action, if applicable.
           If the value specified is 0h, then the controller shall choose the firmware slot (slot 1 – 7) to use
           for the operation.

EXAMPLES

       •   Activate the last downloaded fw to slot 1.

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

NVME

       Part of the nvme-user suite

NVMe                                               06/08/2015                                NVME-FW-ACTIVATE(1)