mirror/hdf5
2
0
Fork 0
mirror of https://github.com/HDFGroup/hdf5.git synced 2025-01-30 15:32:37 +08:00
Code Issues Packages Projects Releases Wiki Activity

[svn-r22581] HDFFV-588: hdump restrictions on filename for split files. Added text and example to usage.

Browse Source 
Tested: local linux
This commit is contained in:
Allen Byrne 2012-07-16 13:21:05 -05:00
parent d06dd11291
commit 2e3ab09a52
10 changed files with 181 additions and 54 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
CMakeLists.txt
View File

@ -984,6 +984,7 @@ IF (NOT HDF5_EXTERNALLY_CONFIGURED AND NOT HDF5_NO_PACKAGES)
SET (CPACK_NSIS_PACKAGE_NAME "HDF5 ${HDF5_PACKAGE_VERSION}")
ELSE (WIN32)
SET (CPACK_PACKAGING_INSTALL_PREFIX "/usr")
SET (CPACK_ARCHIVE_COMPONENT_INSTALL ON)
SET (CPACK_COMPONENTS_ALL_IN_ONE_PACKAGE ON)
SET (CPACK_DEBIAN_PACKAGE_SECTION "Libraries")

26
tools/h5dump/h5dump.c
View File

@ -297,10 +297,20 @@ usage(const char *prog)
HDfprintf(rawoutstream, " number of dimensions in the dataspace being queried\n");
HDfprintf(rawoutstream, "\n");
HDfprintf(rawoutstream, " D - is the file driver to use in opening the file. Acceptable values\n");
HDfprintf(rawoutstream, " are \"sec2\", \"family\", \"split\", \"multi\", \"direct\", and \"stream\". Without\n");
HDfprintf(rawoutstream, " the file driver flag, the file will be opened with each driver in\n");
HDfprintf(rawoutstream, " turn and in the order specified above until one driver succeeds\n");
HDfprintf(rawoutstream, " in opening the file.\n");
HDfprintf(rawoutstream, " are \"sec2\", \"family\", \"split\", \"multi\", \"direct\", and \"stream\". Without\n");
HDfprintf(rawoutstream, " the file driver flag, the file will be opened with each driver in\n");
HDfprintf(rawoutstream, " turn and in the order specified above until one driver succeeds\n");
HDfprintf(rawoutstream, " in opening the file.\n");
HDfprintf(rawoutstream, " These are the letters that are appended to the file name(without .h5) when opening\n");
HDfprintf(rawoutstream, " names for the split(m,r) and multi(s,b,r,g,l,o) drivers. They are:\n");
HDfprintf(rawoutstream, " m: All meta data when using the split driver.\n");
HDfprintf(rawoutstream, " s: The userblock, superblock, and driver info block\n");
HDfprintf(rawoutstream, " b: B-tree nodes\n");
HDfprintf(rawoutstream, " r: Dataset raw data\n");
HDfprintf(rawoutstream, " g: Global heap\n");
HDfprintf(rawoutstream, " l: local heap (object names)\n");
HDfprintf(rawoutstream, " o: object headers\n");
HDfprintf(rawoutstream, "\n");
HDfprintf(rawoutstream, " F - is a filename.\n");
HDfprintf(rawoutstream, " P - is the full path from the root group to the object.\n");
HDfprintf(rawoutstream, " N - is an integer greater than 1.\n");
@ -337,9 +347,13 @@ usage(const char *prog)
HDfprintf(rawoutstream, "\n");
HDfprintf(rawoutstream, " h5dump -d /dset -M 0,1,4,3 quux.h5\n");
HDfprintf(rawoutstream, "\n");
HDfprintf(rawoutstream, " 5) Dataset foo in files multi1.h5 multi2.h5 multi3.h5\n");
HDfprintf(rawoutstream, " 5) Dataset foo in files file1.h5 file2.h5 file3.h5\n");
HDfprintf(rawoutstream, "\n");
HDfprintf(rawoutstream, " h5dump -d /foo multi1.h5 multi2.h5 multi3.h5\n");
HDfprintf(rawoutstream, " h5dump -d /foo file1.h5 file2.h5 file3.h5\n");
HDfprintf(rawoutstream, "\n");
HDfprintf(rawoutstream, " 6) Dataset foo in split files splitfile-m.h5 splitfile-r.h5\n");
HDfprintf(rawoutstream, "\n");
HDfprintf(rawoutstream, " h5dump -d /foo -f split splitfile\n");
HDfprintf(rawoutstream, "\n");
}

26
tools/testfiles/h5dump-help.txt
View File

@ -62,10 +62,20 @@ usage: h5dump [OPTIONS] files
number of dimensions in the dataspace being queried
D - is the file driver to use in opening the file. Acceptable values
are "sec2", "family", "split", "multi", "direct", and "stream". Without
the file driver flag, the file will be opened with each driver in
turn and in the order specified above until one driver succeeds
in opening the file.
are "sec2", "family", "split", "multi", "direct", and "stream". Without
the file driver flag, the file will be opened with each driver in
turn and in the order specified above until one driver succeeds
in opening the file.
These are the letters that are appended to the file name(without .h5) when opening
names for the split(m,r) and multi(s,b,r,g,l,o) drivers. They are:
m: All meta data when using the split driver.
s: The userblock, superblock, and driver info block
b: B-tree nodes
r: Dataset raw data
g: Global heap
l: local heap (object names)
o: object headers
F - is a filename.
P - is the full path from the root group to the object.
N - is an integer greater than 1.
@ -102,7 +112,11 @@ usage: h5dump [OPTIONS] files
h5dump -d /dset -M 0,1,4,3 quux.h5
5) Dataset foo in files multi1.h5 multi2.h5 multi3.h5
5) Dataset foo in files file1.h5 file2.h5 file3.h5
h5dump -d /foo multi1.h5 multi2.h5 multi3.h5
h5dump -d /foo file1.h5 file2.h5 file3.h5
6) Dataset foo in split files splitfile-m.h5 splitfile-r.h5
h5dump -d /foo -f split splitfile

26
tools/testfiles/tnofilename-with-packed-bits.ddl
View File

@ -62,10 +62,20 @@ usage: h5dump [OPTIONS] files
number of dimensions in the dataspace being queried
D - is the file driver to use in opening the file. Acceptable values
are "sec2", "family", "split", "multi", "direct", and "stream". Without
the file driver flag, the file will be opened with each driver in
turn and in the order specified above until one driver succeeds
in opening the file.
are "sec2", "family", "split", "multi", "direct", and "stream". Without
the file driver flag, the file will be opened with each driver in
turn and in the order specified above until one driver succeeds
in opening the file.
These are the letters that are appended to the file name(without .h5) when opening
names for the split(m,r) and multi(s,b,r,g,l,o) drivers. They are:
m: All meta data when using the split driver.
s: The userblock, superblock, and driver info block
b: B-tree nodes
r: Dataset raw data
g: Global heap
l: local heap (object names)
o: object headers
F - is a filename.
P - is the full path from the root group to the object.
N - is an integer greater than 1.
@ -102,8 +112,12 @@ usage: h5dump [OPTIONS] files
h5dump -d /dset -M 0,1,4,3 quux.h5
5) Dataset foo in files multi1.h5 multi2.h5 multi3.h5
5) Dataset foo in files file1.h5 file2.h5 file3.h5
h5dump -d /foo multi1.h5 multi2.h5 multi3.h5
h5dump -d /foo file1.h5 file2.h5 file3.h5
6) Dataset foo in split files splitfile-m.h5 splitfile-r.h5
h5dump -d /foo -f split splitfile
h5dump error: missing file name

26
tools/testfiles/tpbitsIncomplete.ddl
View File

@ -62,10 +62,20 @@ usage: h5dump [OPTIONS] files
number of dimensions in the dataspace being queried
D - is the file driver to use in opening the file. Acceptable values
are "sec2", "family", "split", "multi", "direct", and "stream". Without
the file driver flag, the file will be opened with each driver in
turn and in the order specified above until one driver succeeds
in opening the file.
are "sec2", "family", "split", "multi", "direct", and "stream". Without
the file driver flag, the file will be opened with each driver in
turn and in the order specified above until one driver succeeds
in opening the file.
These are the letters that are appended to the file name(without .h5) when opening
names for the split(m,r) and multi(s,b,r,g,l,o) drivers. They are:
m: All meta data when using the split driver.
s: The userblock, superblock, and driver info block
b: B-tree nodes
r: Dataset raw data
g: Global heap
l: local heap (object names)
o: object headers
F - is a filename.
P - is the full path from the root group to the object.
N - is an integer greater than 1.
@ -102,8 +112,12 @@ usage: h5dump [OPTIONS] files
h5dump -d /dset -M 0,1,4,3 quux.h5
5) Dataset foo in files multi1.h5 multi2.h5 multi3.h5
5) Dataset foo in files file1.h5 file2.h5 file3.h5
h5dump -d /foo multi1.h5 multi2.h5 multi3.h5
h5dump -d /foo file1.h5 file2.h5 file3.h5
6) Dataset foo in split files splitfile-m.h5 splitfile-r.h5
h5dump -d /foo -f split splitfile
h5dump error: Bad mask list(0,2,2,1,0,2,2,)

26
tools/testfiles/tpbitsLengthExceeded.ddl
View File

@ -62,10 +62,20 @@ usage: h5dump [OPTIONS] files
number of dimensions in the dataspace being queried
D - is the file driver to use in opening the file. Acceptable values
are "sec2", "family", "split", "multi", "direct", and "stream". Without
the file driver flag, the file will be opened with each driver in
turn and in the order specified above until one driver succeeds
in opening the file.
are "sec2", "family", "split", "multi", "direct", and "stream". Without
the file driver flag, the file will be opened with each driver in
turn and in the order specified above until one driver succeeds
in opening the file.
These are the letters that are appended to the file name(without .h5) when opening
names for the split(m,r) and multi(s,b,r,g,l,o) drivers. They are:
m: All meta data when using the split driver.
s: The userblock, superblock, and driver info block
b: B-tree nodes
r: Dataset raw data
g: Global heap
l: local heap (object names)
o: object headers
F - is a filename.
P - is the full path from the root group to the object.
N - is an integer greater than 1.
@ -102,8 +112,12 @@ usage: h5dump [OPTIONS] files
h5dump -d /dset -M 0,1,4,3 quux.h5
5) Dataset foo in files multi1.h5 multi2.h5 multi3.h5
5) Dataset foo in files file1.h5 file2.h5 file3.h5
h5dump -d /foo multi1.h5 multi2.h5 multi3.h5
h5dump -d /foo file1.h5 file2.h5 file3.h5
6) Dataset foo in split files splitfile-m.h5 splitfile-r.h5
h5dump -d /foo -f split splitfile
h5dump error: Packed Bit offset+length value(65) too large. Max is 64

26
tools/testfiles/tpbitsLengthPositive.ddl
View File

@ -62,10 +62,20 @@ usage: h5dump [OPTIONS] files
number of dimensions in the dataspace being queried
D - is the file driver to use in opening the file. Acceptable values
are "sec2", "family", "split", "multi", "direct", and "stream". Without
the file driver flag, the file will be opened with each driver in
turn and in the order specified above until one driver succeeds
in opening the file.
are "sec2", "family", "split", "multi", "direct", and "stream". Without
the file driver flag, the file will be opened with each driver in
turn and in the order specified above until one driver succeeds
in opening the file.
These are the letters that are appended to the file name(without .h5) when opening
names for the split(m,r) and multi(s,b,r,g,l,o) drivers. They are:
m: All meta data when using the split driver.
s: The userblock, superblock, and driver info block
b: B-tree nodes
r: Dataset raw data
g: Global heap
l: local heap (object names)
o: object headers
F - is a filename.
P - is the full path from the root group to the object.
N - is an integer greater than 1.
@ -102,8 +112,12 @@ usage: h5dump [OPTIONS] files
h5dump -d /dset -M 0,1,4,3 quux.h5
5) Dataset foo in files multi1.h5 multi2.h5 multi3.h5
5) Dataset foo in files file1.h5 file2.h5 file3.h5
h5dump -d /foo multi1.h5 multi2.h5 multi3.h5
h5dump -d /foo file1.h5 file2.h5 file3.h5
6) Dataset foo in split files splitfile-m.h5 splitfile-r.h5
h5dump -d /foo -f split splitfile
h5dump error: Packed Bit length value(0) must be positive.

26
tools/testfiles/tpbitsMaxExceeded.ddl
View File

@ -62,10 +62,20 @@ usage: h5dump [OPTIONS] files
number of dimensions in the dataspace being queried
D - is the file driver to use in opening the file. Acceptable values
are "sec2", "family", "split", "multi", "direct", and "stream". Without
the file driver flag, the file will be opened with each driver in
turn and in the order specified above until one driver succeeds
in opening the file.
are "sec2", "family", "split", "multi", "direct", and "stream". Without
the file driver flag, the file will be opened with each driver in
turn and in the order specified above until one driver succeeds
in opening the file.
These are the letters that are appended to the file name(without .h5) when opening
names for the split(m,r) and multi(s,b,r,g,l,o) drivers. They are:
m: All meta data when using the split driver.
s: The userblock, superblock, and driver info block
b: B-tree nodes
r: Dataset raw data
g: Global heap
l: local heap (object names)
o: object headers
F - is a filename.
P - is the full path from the root group to the object.
N - is an integer greater than 1.
@ -102,8 +112,12 @@ usage: h5dump [OPTIONS] files
h5dump -d /dset -M 0,1,4,3 quux.h5
5) Dataset foo in files multi1.h5 multi2.h5 multi3.h5
5) Dataset foo in files file1.h5 file2.h5 file3.h5
h5dump -d /foo multi1.h5 multi2.h5 multi3.h5
h5dump -d /foo file1.h5 file2.h5 file3.h5
6) Dataset foo in split files splitfile-m.h5 splitfile-r.h5
h5dump -d /foo -f split splitfile
h5dump error: Too many masks requested (max. 8). Mask list(0,1,0,1,1,1,2,1,3,1,4,1,5,1,6,1,7,1)

26
tools/testfiles/tpbitsOffsetExceeded.ddl
View File

@ -62,10 +62,20 @@ usage: h5dump [OPTIONS] files
number of dimensions in the dataspace being queried
D - is the file driver to use in opening the file. Acceptable values
are "sec2", "family", "split", "multi", "direct", and "stream". Without
the file driver flag, the file will be opened with each driver in
turn and in the order specified above until one driver succeeds
in opening the file.
are "sec2", "family", "split", "multi", "direct", and "stream". Without
the file driver flag, the file will be opened with each driver in
turn and in the order specified above until one driver succeeds
in opening the file.
These are the letters that are appended to the file name(without .h5) when opening
names for the split(m,r) and multi(s,b,r,g,l,o) drivers. They are:
m: All meta data when using the split driver.
s: The userblock, superblock, and driver info block
b: B-tree nodes
r: Dataset raw data
g: Global heap
l: local heap (object names)
o: object headers
F - is a filename.
P - is the full path from the root group to the object.
N - is an integer greater than 1.
@ -102,8 +112,12 @@ usage: h5dump [OPTIONS] files
h5dump -d /dset -M 0,1,4,3 quux.h5
5) Dataset foo in files multi1.h5 multi2.h5 multi3.h5
5) Dataset foo in files file1.h5 file2.h5 file3.h5
h5dump -d /foo multi1.h5 multi2.h5 multi3.h5
h5dump -d /foo file1.h5 file2.h5 file3.h5
6) Dataset foo in split files splitfile-m.h5 splitfile-r.h5
h5dump -d /foo -f split splitfile
h5dump error: Packed Bit offset value(64) must be between 0 and 63

26
tools/testfiles/tpbitsOffsetNegative.ddl
View File

@ -62,10 +62,20 @@ usage: h5dump [OPTIONS] files
number of dimensions in the dataspace being queried
D - is the file driver to use in opening the file. Acceptable values
are "sec2", "family", "split", "multi", "direct", and "stream". Without
the file driver flag, the file will be opened with each driver in
turn and in the order specified above until one driver succeeds
in opening the file.
are "sec2", "family", "split", "multi", "direct", and "stream". Without
the file driver flag, the file will be opened with each driver in
turn and in the order specified above until one driver succeeds
in opening the file.
These are the letters that are appended to the file name(without .h5) when opening
names for the split(m,r) and multi(s,b,r,g,l,o) drivers. They are:
m: All meta data when using the split driver.
s: The userblock, superblock, and driver info block
b: B-tree nodes
r: Dataset raw data
g: Global heap
l: local heap (object names)
o: object headers
F - is a filename.
P - is the full path from the root group to the object.
N - is an integer greater than 1.
@ -102,8 +112,12 @@ usage: h5dump [OPTIONS] files
h5dump -d /dset -M 0,1,4,3 quux.h5
5) Dataset foo in files multi1.h5 multi2.h5 multi3.h5
5) Dataset foo in files file1.h5 file2.h5 file3.h5
h5dump -d /foo multi1.h5 multi2.h5 multi3.h5
h5dump -d /foo file1.h5 file2.h5 file3.h5
6) Dataset foo in split files splitfile-m.h5 splitfile-r.h5
h5dump -d /foo -f split splitfile
h5dump error: Bad mask list(-1,1)