HDFLS(1)						      General Commands Manual							  HDFLS(1)

NAME

       hdfls - list basic information about an HDF file

SYNOPSIS

       hdfls [-o] [-l] [-d] [-v] [-g] [-s] [-h] [-t n] hdf_file

DESCRIPTION

       hdfls provides general information about the tags, reference numbers, and if requested, lengths of the data elements.

OPTIONS

       -o     display the reference numbers in ascending order.

       -l     long format.  Display more information about the file.

       -d     Display offset and length information for each element in the file.

       -v     verbose.	Display annotation and label text, along with the format triggered by the -l flag.

       -g     Group.  List items by group.

       -s     Special elements.  Display detailed information about special elements.

       -d     Display offset and length information for each element in the file.

       -h     Dump DD block information.

       -t n   Tag.  Only list information about the specified tag. Must be followed by a tag number.

EXAMPLES

       A  file called "aa.hdf" contains three items associated with a raster image; the image dimensions, a palette, and the raster image. To dis-
       play information about the contents of this file, the following command is used.

       hdfls aa.hdf

       The following output is displayed:

	       aa.hdf:

       Image Dimensions-8:		       (Raster-8): (tag 200)

	       Ref nos: 1

       Image Palette-8: 		       (Raster-8): (tag 201)

	       Ref nos: 3

       Raster Image-8:		       (Raster-8): (tag 202)

	       Ref nos: 1

       The following displays the same information with the length of each data element:

       hdfls -l aa.hdf

       This would result in the following information being displayed:

	       aa.hdf:

	       Image Dimensions-8:	       (Raster-8)      : (tag 200)

	       Ref no 1 	       4 bytes

	       Image Palette-8: 	       (Raster-8)      : (tag 201)

	       Ref no 3 	       768 bytes

	       Raster Image-8:	       (Raster-8)      : (tag 202)

	       Ref no 1 	       120000 bytes

SEE ALSO

       hdf(5)

								 October 31, 1999							  HDFLS(1)