wdc: Add support for cu_smart-log command on SN861

This change will add support parsing the CA log page
via the cu-smart-log command on SN861 drives
Add documentation for wdc cu-smart-log command

Signed-off-by: jeff-lien-wdc <[email protected]>

Author: jeff-lien-sndk

Documentation/cmd-plugins.txt

@@ -178,6 +178,9 @@ linknvme:nvme-wdc-clear-pcie-correctable-errors[1]::
 linknvme:nvme-wdc-cloud-SSD-plugin-version[1]::
 	Display WDC plugin Cloud SSD Plugin Version
 
+linknvme:nvme-wdc-cu-smart-log[1]::
+	Display WDC plugin Customer Unique Log Page
+
 linknvme:nvme-wdc-drive-essentials[1]::
 	Retrieve WDC device's drive essentials bin files
 

Documentation/meson.build

@@ -206,6 +206,7 @@ adoc_sources = [
   'nvme-wdc-clear-pcie-correctable-errors',
   'nvme-wdc-cloud-SSD-plugin-version',
   'nvme-wdc-cloud-boot-SSD-version',
+  'nvme-wdc-cu-smart-log',
   'nvme-wdc-drive-essentials',
   'nvme-wdc-drive-log',
   'nvme-wdc-drive-resize',

Documentation/nvme-wdc-cu-smart-log.txt

@@ -0,0 +1,49 @@
+nvme-wdc-cu-smart-log(1)
+========================
+
+NAME
+----
+nvme-wdc-cu-smart-log - Send NVMe WDC cu-smart-log Vendor Unique Command, return result
+
+SYNOPSIS
+--------
+[verse]
+'nvme wdc cu-smart-log' <device> [--output-format=<normal|json> -o <normal|json>]
+			[--uuid-index=<uuid-index> | -u <uuid-index>]
+
+DESCRIPTION
+-----------
+For the NVMe device given, retrieves and formats the Vendor Unique WDC 0xCA log page.
+
+The <device> parameter is mandatory and may be either the NVMe character
+device (ex: /dev/nvme0) or block device (ex: /dev/nvme0n1).
+
+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.
+
+-u <uuid-index>::
+--uuid-index=<uuid-index>::
+	Sets the uuid-index of the log page to be retrieved. Defaults to
+	0 if not given.
+
+EXAMPLES
+--------
+* Has the program issue WDC cu-smart-log plugin Command :
++
+------------
+# nvme wdc cu-smart-log /dev/nvme0
+------------
+
+NVME
+----
+Part of the nvme-user suite.