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 display 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)