nvme-wdc-vs-fw-activate-history

NVME-WDC-VS-FW-A(1) NVMe Manual NVME-WDC-VS-FW-A(1)

NAME

   nvme-wdc-vs-fw-activate-history - Execute NVMe WDC vs-fw-activate-history Vendor Unique Command, return result

SYNOPSIS

   nvme wdc vs-fw-activate-history <device> [--output-format=<normal|json> -o <normal|json>]

DESCRIPTION

   For the NVMe device given, read a Vendor Unique WDC log page that returns the firmware activation history.

   The <device> parameter is mandatory and must be the NVMe character device (ex: /dev/nvme0).

   This will only work on WDC devices supporting this feature. Results for any other device are undefined.

   On success it returns 0, error code otherwise.

OPTIONS

   -o <fmt>, --output-format=<fmt>
       Set the reporting format to normal, or json. Only one output format can be used at a time. Default is normal.

FIRMWARE ACTIVATE HISTORY LOG PAGE DATA OUTPUT EXPLANATION

   ┌────────────────────┬────────────────────────────────────────────────────────────────┐
   │ Field              │ Description                                                    │
   ├────────────────────┼────────────────────────────────────────────────────────────────┤
   │                    │                                                                │
   │ Entry Number       │ The number of fw activate entry. The most recent 20 entries    │
   │                    │ will be displayed.                                             │
   ├────────────────────┼────────────────────────────────────────────────────────────────┤
   │                    │                                                                │
   │ Power on Hour      │ The time since the power on in hours:minutes:seconds.          │
   ├────────────────────┼────────────────────────────────────────────────────────────────┤
   │                    │                                                                │
   │ Power Cycle Count  │ The power cycle count that the firmware activation occurred.   │
   ├────────────────────┼────────────────────────────────────────────────────────────────┤
   │                    │                                                                │
   │ Current Firmware   │ The firmware level currently running on the SSD before the     │
   │                    │ activation took place.                                         │
   ├────────────────────┼────────────────────────────────────────────────────────────────┤
   │                    │                                                                │
   │ New Firmware       │ The new firmware level running on the SSD after the activation │
   │                    │ took place.                                                    │
   ├────────────────────┼────────────────────────────────────────────────────────────────┤
   │                    │                                                                │
   │ Slot Number        │ The slot that the firmware is being activated from.            │
   ├────────────────────┼────────────────────────────────────────────────────────────────┤
   │                    │                                                                │
   │ Commit Action Type │ The commit action type associated with the firmware activation │
   │                    │ event                                                          │
   ├────────────────────┼────────────────────────────────────────────────────────────────┤
   │                    │                                                                │
   │ Result             │ The result of the firmware activation event. The output shall  │
   │                    │ be in the format: Pass or Failed + error code                  │
   └────────────────────┴────────────────────────────────────────────────────────────────┘

EXAMPLES

   •   Has the program issue WDC vs-fw-activate-history Vendor Unique Command :

           # nvme wdc vs-fw-activate-history /dev/nvme0

NVME

   Part of the nvme-user suite.

NVMe 05/02/2025 NVME-WDC-VS-FW-A(1)