sg_rep_density: new utility for decoding the response of Report density support command [ssc (tape)]

git-svn-id: https://svn.bingwo.ca/repos/sg3_utils/trunk@932 6180dd3e-e324-4e3e-922d-17de1ae2f315

6 files changed, 105 insertions, 3 deletions

diff --git a/inhex/README b/inhex/README
index 42337e02..d1a50b19 100644
--- a/inhex/README
+++ b/inhex/README
@@ -4,8 +4,8 @@
 The files in this folder contain hexadecimal data (in ASCII) and associated
 comments (prefixed with the hash mark symbol: '#' ).
 
-The utility that each hex file is associated with can be determined by
-prepending "sg_" to these filenames then going to the 'src' folder (a
+The utility that each hex file is associated with can be determined in most
+case by prepending "sg_" to these filenames. Then go to the 'src' folder (a
 sibling folder to this one) and look for a match or partial match on
 the name.
 
@@ -41,6 +41,10 @@ Device Identification VPD page:
       SCSI name string:
       naa.5000C5003011CB28
 
+Not all the hex files follow the "prepend sg_" pattern. Those hex files
+starting with 'nvme_' are examples of invoking NVMe commands with the
+sg_raw utility.
+
 Binary <--> Hexadecimal
 -----------------------
 The vpd_zbdc.raw file is binary and was created by:
@@ -79,4 +83,4 @@ that support --inhex and don't have hex data already. Special cases are
 also welcome. They help the author test this code.
 
 Douglas Gilbert
-20th November 2021
+21st January 2022
diff --git a/inhex/inq_standard.hex b/inhex/inq_standard.hex
new file mode 100644
index 00000000..0c793fed
--- /dev/null
+++ b/inhex/inq_standard.hex
@@ -0,0 +1,23 @@
+# This file contains the ASCII hex of a SCSI INQUIRY command
+# 'standard' response. In this case non-standard responses refers
+# to responses contain VPD page that are also fetched with the
+# SCSI INQUIRY command.
+
+# The response in this file can be decoded with:
+#     sg_inq --inhex=sg_inq_standard.hex
+# or
+#     sg_vpd --inhex=sg_inq_standard.hex --page=sinq
+#
+# The sg_inq utility defaults to the 'standard' INQUIRY while the
+# sg_vpd utility defaults to the "Supported VPD pages" VPD page.
+# Hence sg_vpd needs the extra option '--page=sinq' which says the
+# VPD page is the standard inquiry. Strictly speaking the standard
+# INQUIRY is not a VPD page but probably would be if SCSI was not
+# 40 years old and highly values backward compatibility.
+
+00 00 07 02 5b 00 10 0a  4c 69 6e 75 78 20 20 20
+73 63 73 69 5f 64 65 62  75 67 20 20 20 20 20 20
+30 31 39 31 32 30 32 31  30 35 32 30 00 00 00 00
+00 00 00 00 00 00 00 00  00 00 00 c0 05 c0 06 00
+21 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00
+00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00
diff --git a/inhex/rep_density.hex b/inhex/rep_density.hex
new file mode 100644
index 00000000..0aba1b50
--- /dev/null
+++ b/inhex/rep_density.hex
@@ -0,0 +1,18 @@
+#
+# This file contains the response to SCSI REPORT DENSITY SUPPORTED command
+# using the sg_rep_density utility. This file was generated with:
+#      sg_rep_density -HHH /dev/sg4 > rep_density.hex
+# where /dev/sg4 was a LTO-4 tape drive. To decode that file containing
+# hexadecimal in ASCII use:
+#      sg_rep_density --inhex=rep_density.hex
+
+00 9e 00 00 44 44 00 00  00 00 25 a6 00 7f 02 c0
+00 06 1a 80 4c 54 4f 2d  43 56 45 20 55 2d 33 31
+36 20 20 20 55 6c 74 72  69 75 6d 20 33 2f 31 36
+54 20 20 20 20 20 20 20  46 46 80 00 00 00 31 b5
+00 7f 03 80 00 0c 35 00  4c 54 4f 2d 43 56 45 20
+55 2d 34 31 36 20 20 20  55 6c 74 72 69 75 6d 20
+34 2f 31 36 54 20 20 20  20 20 20 20 58 58 a0 00
+00 00 3b 26 00 7f 05 00  00 16 e3 60 4c 54 4f 2d
+43 56 45 20 55 2d 35 31  36 20 20 20 55 6c 74 72
+69 75 6d 20 35 2f 31 36  54 20 20 20 20 20 20 20
diff --git a/inhex/rep_density_media.hex b/inhex/rep_density_media.hex
new file mode 100644
index 00000000..22312fdf
--- /dev/null
+++ b/inhex/rep_density_media.hex
@@ -0,0 +1,13 @@
+#
+# This file contains the response to SCSI REPORT DENSITY SUPPORTED command
+# using the sg_rep_density utility. This file was generated with:
+#      sg_rep_density --media -HHH /dev/sg4 > rep_density_media.hex
+# where /dev/sg4 was a LTO-4 tape drive. To decode that file containing
+# hexadecimal in ASCII use:
+#      sg_rep_density --inhex=rep_density_media.hex
+# The --media option is not needed in the decode invocation.
+
+00 36 00 00 58 58 a0 00  00 00 3b 26 00 7f 05 00
+00 17 85 3e 4c 54 4f 2d  43 56 45 20 55 2d 35 31
+36 20 20 20 55 6c 74 72  69 75 6d 20 35 2f 31 36
+54 20 20 20 20 20 20 20
diff --git a/inhex/rep_density_media_typem.hex b/inhex/rep_density_media_typem.hex
new file mode 100644
index 00000000..57918fe8
--- /dev/null
+++ b/inhex/rep_density_media_typem.hex
@@ -0,0 +1,13 @@
+#
+# This file contains the response to SCSI REPORT DENSITY SUPPORTED command
+# using the sg_rep_density utility. This file was generated with:
+#      sg_rep_density -M -t -HHH /dev/sg4 > rep_density_media_typem.hex
+# where /dev/sg4 was a LTO-4 tape drive. To decode that file containing
+# hexadecimal in ASCII use:
+#      sg_rep_density --typem -i rep_density_media_typem.hex
+# The --typem option is required in the decode invocation.
+
+00 3a 00 00 00 00 00 34  01 58 00 00 00 00 00 00
+00 00 00 7f 03 4e 00 00  48 50 20 20 20 20 20 20
+4c 54 4f 35 44 61 74 61  55 6c 74 72 69 75 6d 20
+35 20 44 61 74 61 20 54  61 70 65 20
diff --git a/inhex/rep_density_typem.hex b/inhex/rep_density_typem.hex
new file mode 100644
index 00000000..315d6907
--- /dev/null
+++ b/inhex/rep_density_typem.hex
@@ -0,0 +1,31 @@
+#
+# This file contains the response to SCSI REPORT DENSITY SUPPORTED command
+# using the sg_rep_density utility. This file was generated with:
+#      sg_rep_density --typem -HHH /dev/sg4 > rep_density_typem.hex
+# where /dev/sg4 was a LTO-4 tape drive. To decode that file containing
+# hexadecimal in ASCII use:
+#      sg_rep_density --typem -i rep_density_typem.hex
+# The --typem option is required in the decode invocation.
+
+01 52 00 00 00 00 00 34  01 44 00 00 00 00 00 00
+00 00 00 7f 02 a8 00 00  48 50 20 20 20 20 20 20
+4c 54 4f 33 44 61 74 61  55 6c 74 72 69 75 6d 20
+33 20 44 61 74 61 20 54  61 70 65 20 00 00 00 34
+01 46 00 00 00 00 00 00  00 00 00 7f 03 34 00 00
+48 50 20 20 20 20 20 20  4c 54 4f 34 44 61 74 61
+55 6c 74 72 69 75 6d 20  34 20 44 61 74 61 20 54
+61 70 65 20 00 00 00 34  01 58 00 00 00 00 00 00
+00 00 00 7f 03 4e 00 00  48 50 20 20 20 20 20 20
+4c 54 4f 35 44 61 74 61  55 6c 74 72 69 75 6d 20
+35 20 44 61 74 61 20 54  61 70 65 20 01 00 00 34
+01 44 00 00 00 00 00 00  00 00 00 7f 02 a8 00 00
+48 50 20 20 20 20 20 20  4c 54 4f 33 57 4f 52 4d
+55 6c 74 72 69 75 6d 20  33 20 57 4f 52 4d 20 54
+61 70 65 20 01 00 00 34  01 46 00 00 00 00 00 00
+00 00 00 7f 03 34 00 00  48 50 20 20 20 20 20 20
+4c 54 4f 34 57 4f 52 4d  55 6c 74 72 69 75 6d 20
+34 20 57 4f 52 4d 20 54  61 70 65 20 01 00 00 34
+01 58 00 00 00 00 00 00  00 00 00 7f 03 4e 00 00
+48 50 20 20 20 20 20 20  4c 54 4f 35 57 4f 52 4d
+55 6c 74 72 69 75 6d 20  35 20 57 4f 52 4d 20 54
+61 70 65 20