diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-29 04:41:05 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-29 04:41:05 +0000 |
commit | 1cc8413aaf5f8fa6595aece1933462c096e88639 (patch) | |
tree | e97b4f25c511372d73bdd96c389c5f468d99138a /Documentation/nvme-wdc-vs-fw-activate-history.txt | |
parent | Initial commit. (diff) | |
download | nvme-cli-upstream.tar.xz nvme-cli-upstream.zip |
Adding upstream version 2.4+really2.3.upstream/2.4+really2.3upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'Documentation/nvme-wdc-vs-fw-activate-history.txt')
-rw-r--r-- | Documentation/nvme-wdc-vs-fw-activate-history.txt | 76 |
1 files changed, 76 insertions, 0 deletions
diff --git a/Documentation/nvme-wdc-vs-fw-activate-history.txt b/Documentation/nvme-wdc-vs-fw-activate-history.txt new file mode 100644 index 0000000..30c6ede --- /dev/null +++ b/Documentation/nvme-wdc-vs-fw-activate-history.txt @@ -0,0 +1,76 @@ +nvme-wdc-vs-fw-activate-history(1) +================================== + +NAME +---- +nvme-wdc-vs-fw-activate-history - Execute NVMe WDC vs-fw-activate-history Vendor Unique Command, return result + +SYNOPSIS +-------- +[verse] +'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 <format>:: +--output-format=<format>:: + 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 +----------------------------------------------------------- +[cols="2*", frame="topbot", align="center", options="header"] +|=== +|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. |