summaryrefslogtreecommitdiffstats
path: root/tools/h5dump/h5dump.c
diff options
context:
space:
mode:
authorJonathan Kim <jkm@hdfgroup.org>2012-03-22 16:21:00 (GMT)
committerJonathan Kim <jkm@hdfgroup.org>2012-03-22 16:21:00 (GMT)
commitd6f8aa5c53fb890730befcbf985a7fa9aa38c0ec (patch)
treeed37763a67a1f644cccd194c039828c746fb72d0 /tools/h5dump/h5dump.c
parent5c0ed1b304967c5df569cef8d0b884938e595f5b (diff)
downloadhdf5-d6f8aa5c53fb890730befcbf985a7fa9aa38c0ec.zip
hdf5-d6f8aa5c53fb890730befcbf985a7fa9aa38c0ec.tar.gz
hdf5-d6f8aa5c53fb890730befcbf985a7fa9aa38c0ec.tar.bz2
[svn-r22121] Purpose:
update for HDFFV-7523 JPSS: h5dump fails to open an attribute when using the -a option to specify an attribute with a slash in the name Description: Added capability for "-a" option to show attributes containing "/" by using an escape character. For example, for a dataset "/dset" containing attribute "speed(m/h)", use "h5dump -a "/dset/speed(\/h)" to show the content of the attribute. Merged from HDF5 trunk r22052, r22063, r22108 Tested: jam (linux32-LE), koala (linux64-LE), ostrich (linuxppc64-BE), tejeda (mac32-LE), Windows (32-LE cmake), Cmake (jam)
Diffstat (limited to 'tools/h5dump/h5dump.c')
-rw-r--r--tools/h5dump/h5dump.c7
1 files changed, 7 insertions, 0 deletions
diff --git a/tools/h5dump/h5dump.c b/tools/h5dump/h5dump.c
index 650846a..2799d95 100644
--- a/tools/h5dump/h5dump.c
+++ b/tools/h5dump/h5dump.c
@@ -243,6 +243,9 @@ usage(const char *prog)
HDfprintf(rawoutstream, " -e, --escape Escape non printing characters\n");
HDfprintf(rawoutstream, " -V, --version Print version number and exit\n");
HDfprintf(rawoutstream, " -a P, --attribute=P Print the specified attribute\n");
+ HDfprintf(rawoutstream, " If an attribute name contains a slash (/), escape the\n");
+ HDfprintf(rawoutstream, " slash with a preceding backslash (\\).\n");
+ HDfprintf(rawoutstream, " (See example section below.)\n");
HDfprintf(rawoutstream, " -d P, --dataset=P Print the specified dataset\n");
HDfprintf(rawoutstream, " -y, --noindex Do not print array indices with the data\n");
HDfprintf(rawoutstream, " -p, --properties Print dataset filters, storage layout and fill value\n");
@@ -316,6 +319,10 @@ usage(const char *prog)
HDfprintf(rawoutstream, "\n");
HDfprintf(rawoutstream, " h5dump -a /bar_none/foo quux.h5\n");
HDfprintf(rawoutstream, "\n");
+ HDfprintf(rawoutstream, " Attribute \"high/low\" of the group /bar_none in the file quux.h5\n");
+ HDfprintf(rawoutstream, "\n");
+ HDfprintf(rawoutstream, " h5dump -a \"/bar_none/high\\/low\" quux.h5\n");
+ HDfprintf(rawoutstream, "\n");
HDfprintf(rawoutstream, " 2) Selecting a subset from dataset /foo in file quux.h5\n");
HDfprintf(rawoutstream, "\n");
HDfprintf(rawoutstream, " h5dump -d /foo -s \"0,1\" -S \"1,1\" -c \"2,3\" -k \"2,2\" quux.h5\n");