[Top] [Prev] [Next]

15.15 Displaying Data Contained in and General Information About the Contents of an HDF File: hdp

15.15.1 General Description

The hdp utility provides quick and general information about all objects in the specified HDF file. It can list the contents of HDF files at various levels with different details. It can also dump the data of one or more specific objects in the file.

15.15.2 Command-Line Syntax

hdp [-H command] filename

-H Help

Displays usage information about the specified command. If no command is listed, information about all commands are displayed.

Like hdfed, hdp provides a set of commands that allow the user to determine what kind of information is to be displayed.

TABLE 15C - The hdp Command Set

Name
Description
list Displays the contents of the HDF files in the specified format.

dumpsds Displays the contents of the SDSs in the listed files.

dumpvd Displays the contents of the vdata objects in the listed files.

dumpvg Displays the contents of the vgroup objects in the listed files.

dumprig Displays the contents of the RIGs in the listed files.

The list command

Syntax:	list [-s|-l|-d] [-n|-c|-a] [-g|-t number name] [-ot|-of|-og|-on] message
Flags:	-s	Short format.
	-l	Long format.
	-d	Debug format.
	-n	Display the object name.
	-c	Display the object class.
	-a	Display the object description.
	-g	Display groups only.
	-t	Display objects with the specified tag number or name.
	-ot	Sort by tag.
	-of	Sort by position in the data descriptor list.
	-og	Sort by group.
	-on	Sort by name.

Description:	Display the contents of the HDF files in the specified format. As with the 'info' command, the listing for special elements will contain a special tag value (for DFTAG_VS it's 18347) and the text "Unknown Tag".
The dumpsds command

Syntax:	dumpsds [-i index | -r ref-list | -n name-list | -a] [-v|-h|-d] [-o filename | -b | -t]
Flags:	-i	Dump SDSs with the specified index.
	-r	Dump SDSs with the specified reference numbers.
	-n	Dump SDSs with the specified names.
	-a	Dump all SDSs.
	-v	Display all SDS contents including annotations.
	-h	Display the SDS header only.
	-d	Display the SDS data only.
	-o	Print information to the specified file.
	-b	Specify output file as binary.
	-t	Specify output file as text.
Description:	Displays SDS information in the specified format.
The dumpvd command

Syntax:	dumpvd [-i index | -r ref-list | -n name-list | -c class | [-a] [-v|-h|-f|-d] [-o filename | -b | -t]
Flags:	-i	Dump vdatas with the specified index.
	-r	Dump vdatas with the specified reference numbers.
	-c	Dump vdatas with the specified class.
	-n	Dump vdatas with the specified names.
	-a	Dump all vdatas.
	-v	Display all vdata contents including annotations.
	-h	Display the vdata header only.
	-d	Display the vdata data only.
	-f	Display the vdata field data only.
	-o	Print information to the specified file.
	-b	Specify output file as binary.
	-t	Specify output file as text.

Description:	Displays vdata information in the specified format.
The dumpvg command

Syntax: 	dumpvg [-i index | -r ref-list | -n name-list | -c class | [-a] [-v|-h|-d] [-o filename | -b | -t]
Flags: 	-i	Dump vgroups with the specified index.
	-r	Dump vgroups with the specified reference numbers.
	-c	Dump vgroups with the specified class.
	-n	Dump vgroups with the specified names.
	-a	Dump all vgroups.
	-v	Display all vgroup contents including annotations.
	-h	Display the vgroup header only.
	-d	Display the vgroup data only.
	-o	Print information to the specified file.
	-b	Specify output file as binary.
	-t	Specify output file as text.
Description:	Displays vgroup information in the specified format.
The dumprig command

Syntax:	dumprig [-i index | -r ref-list | -m <8, 24> | [-a] [-v|-h|-d] [-o filename | -b | -t]
Flags:	-i	Dump RIGs with the specified index.
	-r	Dump RIGs with the specified reference numbers.
	-m	Dump RIGs with the specified data length - 8- or 24-bit.
	-a	Dump all RIGs.
	-v	Display RIG contents including annotations.
	-h	Display the RIG header only.
	-d	Display the RIG data only.
	-o	Print information to the specified file.
	-b	Specify output file as binary.
	-t	Specify output file as text.
Description:	Displays RIG information in the specified format.


[Top] [Prev] [Next]

hdfhelp@ncsa.uiuc.edu
HDF User's Guide - 07/21/98, NCSA HDF Development Group.