From dc597ce8df5ae6efd2728a2d7ba7d92486028f79 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Fri, 2 Jul 2021 22:40:30 +0200 Subject: Adding upstream version 1.12. Signed-off-by: Daniel Baumann --- Documentation/nvme-wdc-vs-fw-activate-history.txt | 76 +++++++++++++++++++++++ 1 file changed, 76 insertions(+) create mode 100644 Documentation/nvme-wdc-vs-fw-activate-history.txt (limited to 'Documentation/nvme-wdc-vs-fw-activate-history.txt') 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..1ef20a6 --- /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' [--output-format= -o ] + +DESCRIPTION +----------- +For the NVMe device given, read a Vendor Unique WDC log page that returns the firmware actiation +history. + +The 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 :: +--output-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 tht 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 ouput 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. -- cgit v1.2.3