logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

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

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.

Examples

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

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

Firmware Activate History Log Page Data Output Explanation

       ┌────────────────────┬───────────────────────────────────────┐
       │ FieldDescription                           │
       ├────────────────────┼───────────────────────────────────────┤
       │                    │                                       │
       │ EntryNumber       │ The number of fw activate entry. The  │
       │                    │ most recent 20 entries will be        │
       │                    │ displayed.                            │
       ├────────────────────┼───────────────────────────────────────┤
       │                    │                                       │
       │ PoweronHour      │ The time since the power on in        │
       │                    │ hours:minutes:seconds.                │
       ├────────────────────┼───────────────────────────────────────┤
       │                    │                                       │
       │ PowerCycleCount  │ The power cycle count that the        │
       │                    │ firmware activation occurred.         │
       ├────────────────────┼───────────────────────────────────────┤
       │                    │                                       │
       │ CurrentFirmware   │ The firmware level currently running  │
       │                    │ on the SSD before the activation took │
       │                    │ place.                                │
       ├────────────────────┼───────────────────────────────────────┤
       │                    │                                       │
       │ NewFirmware       │ The new firmware level running on the │
       │                    │ SSD after the activation took place.  │
       ├────────────────────┼───────────────────────────────────────┤
       │                    │                                       │
       │ SlotNumber        │ The slot that the firmware is being   │
       │                    │ activated from.                       │
       ├────────────────────┼───────────────────────────────────────┤
       │                    │                                       │
       │ CommitActionType │ 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   │
       └────────────────────┴───────────────────────────────────────┘

Name

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

Nvme

       Part of the nvme-user suite.

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

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.

Synopsis

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

See Also