Provided by: hdf4-tools_4.1r4-22_i386 bug

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)