[svn-r8644] Purpose: h5dump new features

Description:

added the code for print strings with new line and display the path of references (new source files h5tools_ref.c and .h )
added a test suite in testh5dump.sh.in for
( note : to create testh5dump.sh , one must redo ./configure; this detects the availability of filters
and generates  testh5dump.sh accordingly)
1) storage layout
2) fill value
3) print reference with path
4) print strings with new lines
5) filters

Solution:

Platforms tested:
linux
solaris
AIX

Misc. update:

15 files changed, 184 insertions, 0 deletions

diff --git a/tools/testfiles/tchunked.ddl b/tools/testfiles/tchunked.ddl
new file mode 100644
index 0000000..27cdbf8
--- /dev/null
+++ b/tools/testfiles/tchunked.ddl
@@ -0,0 +1,8 @@
+#############################
+Expected output for 'h5dump -H -p -d chunked tfilters.h5'
+#############################
+HDF5 "tfilters.h5" {
+DATASET "chunked" {
+   }
+}
+h5dump error: unable to open dataset "chunked"
diff --git a/tools/testfiles/tcompact.ddl b/tools/testfiles/tcompact.ddl
new file mode 100644
index 0000000..8c47e36
--- /dev/null
+++ b/tools/testfiles/tcompact.ddl
@@ -0,0 +1,18 @@
+#############################
+Expected output for 'h5dump -H -p -d compact tfilters.h5'
+#############################
+HDF5 "tfilters.h5" {
+DATASET "compact" {
+COMMENT "This is a dataset with compact storage"
+   DATATYPE  H5T_STD_I32LE
+   DATASPACE  SIMPLE { ( 20, 10 ) / ( 20, 10 ) }
+   STORAGE_LAYOUT COMPACT {
+      SIZE 800
+   }
+   FILLVALUE {
+      FILL_TIME IFSET
+      ALLOC_TIME EARLY
+      VALUE  0   
+   }
+}
+}
diff --git a/tools/testfiles/tcontiguos.ddl b/tools/testfiles/tcontiguos.ddl
new file mode 100644
index 0000000..7c26099
--- /dev/null
+++ b/tools/testfiles/tcontiguos.ddl
@@ -0,0 +1,8 @@
+#############################
+Expected output for 'h5dump -H -p -d contiguos tfilters.h5'
+#############################
+HDF5 "tfilters.h5" {
+DATASET "contiguos" {
+   }
+}
+h5dump error: unable to open dataset "contiguos"
diff --git a/tools/testfiles/tdeflate.ddl b/tools/testfiles/tdeflate.ddl
new file mode 100644
index 0000000..2423c47
--- /dev/null
+++ b/tools/testfiles/tdeflate.ddl
@@ -0,0 +1,20 @@
+#############################
+Expected output for 'h5dump -H -p -d deflate tfilters.h5'
+#############################
+HDF5 "tfilters.h5" {
+DATASET "deflate" {
+   DATATYPE  H5T_STD_I32LE
+   DATASPACE  SIMPLE { ( 20, 10 ) / ( 20, 10 ) }
+   STORAGE_LAYOUT CHUNKED {
+      SIZE 385 ( 10, 5 )
+   }
+   FILTERS {
+      COMPRESSION DEFLATE { LEVEL 9 }
+   }
+   FILLVALUE {
+      FILL_TIME IFSET
+      ALLOC_TIME INCR
+      VALUE  0   
+   }
+}
+}
diff --git a/tools/testfiles/texternal.ddl b/tools/testfiles/texternal.ddl
new file mode 100644
index 0000000..511bd4f
--- /dev/null
+++ b/tools/testfiles/texternal.ddl
@@ -0,0 +1,18 @@
+#############################
+Expected output for 'h5dump -H -p -d external tfilters.h5'
+#############################
+HDF5 "tfilters.h5" {
+DATASET "external" {
+   DATATYPE  H5T_STD_I32LE
+   DATASPACE  SIMPLE { ( 100 ) / ( 100 ) }
+   STORAGE_LAYOUT CONTIGUOUS EXTERNAL {
+      FILENAME ext1.bin SIZE 200 OFFSET 0
+      FILENAME ext2.bin SIZE 200 OFFSET 0
+   }
+   FILLVALUE {
+      FILL_TIME IFSET
+      ALLOC_TIME LATE
+      VALUE  0   
+   }
+}
+}
diff --git a/tools/testfiles/tfillearly.ddl b/tools/testfiles/tfillearly.ddl
new file mode 100644
index 0000000..95f89ae
--- /dev/null
+++ b/tools/testfiles/tfillearly.ddl
@@ -0,0 +1,8 @@
+#############################
+Expected output for 'h5dump -H -p -d fill_early tfilters.h5'
+#############################
+HDF5 "tfilters.h5" {
+DATASET "fill_early" {
+   }
+}
+h5dump error: unable to open dataset "fill_early"
diff --git a/tools/testfiles/tfillifset.ddl b/tools/testfiles/tfillifset.ddl
new file mode 100644
index 0000000..79e748c
--- /dev/null
+++ b/tools/testfiles/tfillifset.ddl
@@ -0,0 +1,8 @@
+#############################
+Expected output for 'h5dump -H -p -d fill_ifset tfilters.h5'
+#############################
+HDF5 "tfilters.h5" {
+DATASET "fill_ifset" {
+   }
+}
+h5dump error: unable to open dataset "fill_ifset"
diff --git a/tools/testfiles/tfillnever.ddl b/tools/testfiles/tfillnever.ddl
new file mode 100644
index 0000000..38be076
--- /dev/null
+++ b/tools/testfiles/tfillnever.ddl
@@ -0,0 +1,8 @@
+#############################
+Expected output for 'h5dump -H -p -d fill_never tfilters.h5'
+#############################
+HDF5 "tfilters.h5" {
+DATASET "fill_never" {
+   }
+}
+h5dump error: unable to open dataset "fill_never"
diff --git a/tools/testfiles/tfletcher32.ddl b/tools/testfiles/tfletcher32.ddl
new file mode 100644
index 0000000..1b128cb
--- /dev/null
+++ b/tools/testfiles/tfletcher32.ddl
@@ -0,0 +1,20 @@
+#############################
+Expected output for 'h5dump -H -p -d fletcher32 tfilters.h5'
+#############################
+HDF5 "tfilters.h5" {
+DATASET "fletcher32" {
+   DATATYPE  H5T_STD_I32LE
+   DATASPACE  SIMPLE { ( 20, 10 ) / ( 20, 10 ) }
+   STORAGE_LAYOUT CHUNKED {
+      SIZE 816 ( 10, 5 )
+   }
+   FILTERS {
+      CHECKSUM FLETCHER32
+   }
+   FILLVALUE {
+      FILL_TIME IFSET
+      ALLOC_TIME INCR
+      VALUE  0   
+   }
+}
+}
diff --git a/tools/testfiles/tnofilename.ddl b/tools/testfiles/tnofilename.ddl
index 5e9dcaa..56dd4b9 100644
--- a/tools/testfiles/tnofilename.ddl
+++ b/tools/testfiles/tnofilename.ddl
@@ -10,6 +10,7 @@ usage: h5dump [OPTIONS] file
      -A                   Print the header and value of attributes; data of datasets is not displayed
      -i, --object-ids     Print the object ids
      -r, --string         Print 1-byte integer datasets as ASCII
+     -e,                  Interpret carriage return (\n) as new line
      -V, --version        Print version number and exit
      -a P, --attribute=P  Print the specified attribute
      -d P, --dataset=P    Print the specified dataset
diff --git a/tools/testfiles/treference.ddl b/tools/testfiles/treference.ddl
new file mode 100644
index 0000000..817bbaf
--- /dev/null
+++ b/tools/testfiles/treference.ddl
@@ -0,0 +1,12 @@
+#############################
+Expected output for 'h5dump -d reference tfilters.h5'
+#############################
+HDF5 "tfilters.h5" {
+DATASET "reference" {
+   DATATYPE  H5T_REFERENCE
+   DATASPACE  SIMPLE { ( 2 ) / ( 2 ) }
+   DATA {
+        (0) DATASET 36216 /char , DATASET 35944 /string 
+   }
+}
+}
diff --git a/tools/testfiles/tshuffle.ddl b/tools/testfiles/tshuffle.ddl
new file mode 100644
index 0000000..aa80f6f
--- /dev/null
+++ b/tools/testfiles/tshuffle.ddl
@@ -0,0 +1,20 @@
+#############################
+Expected output for 'h5dump -H -p -d shuffle tfilters.h5'
+#############################
+HDF5 "tfilters.h5" {
+DATASET "shuffle" {
+   DATATYPE  H5T_STD_I32LE
+   DATASPACE  SIMPLE { ( 20, 10 ) / ( 20, 10 ) }
+   STORAGE_LAYOUT CHUNKED {
+      SIZE 800 ( 10, 5 )
+   }
+   FILTERS {
+      PREPROCESSING SHUFFLE
+   }
+   FILLVALUE {
+      FILL_TIME IFSET
+      ALLOC_TIME INCR
+      VALUE  0   
+   }
+}
+}
diff --git a/tools/testfiles/tstring.ddl b/tools/testfiles/tstring.ddl
new file mode 100644
index 0000000..9d15f17
--- /dev/null
+++ b/tools/testfiles/tstring.ddl
@@ -0,0 +1,18 @@
+#############################
+Expected output for 'h5dump -e -d string tfilters.h5'
+#############################
+HDF5 "tfilters.h5" {
+DATASET "string" {
+   DATATYPE  H5T_STRING {
+         STRSIZE 12;
+         STRPAD H5T_STR_NULLTERM;
+         CSET H5T_CSET_ASCII;
+         CTYPE H5T_C_S1;
+      }
+   DATASPACE  SIMPLE { ( 1 ) / ( 1 ) }
+   DATA {
+        (0) "string
+            new"
+   }
+}
+}
diff --git a/tools/testfiles/tszip.ddl b/tools/testfiles/tszip.ddl
new file mode 100644
index 0000000..02a5fd3
--- /dev/null
+++ b/tools/testfiles/tszip.ddl
@@ -0,0 +1,8 @@
+#############################
+Expected output for 'h5dump -H -p -d szip tfilters.h5'
+#############################
+HDF5 "tfilters.h5" {
+DATASET "szip" {
+   }
+}
+h5dump error: unable to open dataset "szip"
diff --git a/tools/testfiles/tuserfilter.ddl b/tools/testfiles/tuserfilter.ddl
new file mode 100644
index 0000000..c262fb6
--- /dev/null
+++ b/tools/testfiles/tuserfilter.ddl
@@ -0,0 +1,9 @@
+#############################
+Expected output for 'h5dump -H -d myfilter tfilters.h5'
+#############################
+HDF5 "tfilters.h5" {
+DATASET "myfilter" {
+   DATATYPE  H5T_STD_I32LE
+   DATASPACE  SIMPLE { ( 20, 10 ) / ( 20, 10 ) }
+}
+}