hdf images hdf images

HOME

Frequently asked Questions about HDF5

List of Information organized by level of HDF5 expertise

Contents

How do I build HDF5 from source?

If need be, specify the compilers to use. For example: 
    setenv CC /<path_to_compiler>/gcc 
    setenv F9X /<path_to_compiler>/f90
The simple instructions are: 
    cd <top HDF5 source code directory>
    ./configure --prefix=<location for HDF5 software> 
    make >& make.out
    make check >& check.out
    make install
Other common options that can be used with configure are: 
 --enable-parallel
 --enable-fortran 
 --enable-cxx 
 --with-zlib=INSTALLDIR
 --with-szlib=INSTALLDIR
 --disable-shared --enable-static
 --disable-hl
Review the check.out file to be sure everything was built and tested properly.

For more detailed instructions refer to the INSTALL file in the release_docs/ directory of the HDF5 source code.

How can I build the tests and ignore any errors?

You can use the environment variable $HDF5_Make_Ignore to tell the hdf5 Makefile to ignore test errors and continue on. For example: 
    env HDF5_Make_Ignore=yes gmake check
If a test fails, make will print a message (echo "*** Error ignored") and continue. Therefore, you can search the output for the string "Error ignored" to see if any tests failed.

We need the Export Control Classification Number (ECCN) for your software.

An ECCN is not required for our software, because of the nature of the software and its distribution. Our software is available for download without restriction, and is designed for installation by the user without further substantial support by the supplier. Refer to Supplement 2 to Part 774 (page 1), Export Administration Regulations: 
    http://www.access.gpo.gov/bis/ear/ear_data.html
It is also not controlled by the Cryptography Note in Category 5 part 2, Note 3.

How do you access the ftp server from a command line prompt ?

Sometimes users have problems accessing the THG ftp server through our web pages. (See NOTE for one example explaining why this could happen.)

Accessing the THG ftp server directly may work better. Here are the instructions for doing so: 

   Go to a command line prompt.

   Type:
     ftp ftp.hdfgroup.org

   You will be prompted for a name and password.  Enter
   "anonymous" for the name, and your email address for the
   password.

   You will then be put at an ftp prompt:
      ftp>

   Then you need to enter ftp commands to get
   to the location of our software and download it.

   Enter "bin" to be put in binary mode:
      bin

   Enter "pwd" to see where you are located:
      pwd

   Go the location of the software you need:
      cd /HDF/HDF_Current       (for HDF4)
      cd /HDF5/current          (for HDF5)

   You will see:
      bin/
      src/

   The source code is under the src/ directory.
   The pre-compiled binaries for the platforms we support are
   under bin/.

   To see what is in a directory type:
       dir

   To obtain a file xxx, type:
       get xxx

   To obtain more than one file beginning with "xx", type:
       prompt
       mget xx*

   (The "prompt" keeps it from prompting before copying each file.)

   To exit ftp:
       quit
NOTE: One reason you might not be able to download files is that your browser setting is incorrect. For example if you are on Windows using Internet Explorer and the Internet Explorer ftp mode is NOT set to passive, this could cause problems with a firewall, if one is set up. Change the ftp mode to passive as follows: 
    Tools -> Internet Options -> Advanced -> Use Passive FTP (for firewall and DSL modem compatibility)

How do I contribute my software to the HDF user community?

There are two ways that you can do this:

If you have developed or ported something you think would be helpful to other users, please contact the THG Helpdesk indicating that you would like to contribute your software to the HDF user community.

If you wish to have it placed on the THG ftp server, then for other users' convenience, your contribution package should include the software itself, a Makefile if possible, a man-page, test programs and input data files for testing. A README file is required. It should describe briefly the purpose, function and limitation of the software, on which platforms and operating systems it runs, how to compile, install, and test it, and who and where to contact for comments, suggestions, or bug reports.

How do I make a bug report?

All bug reports, comments, suggestions and questions should go to the helpdesk.

Attached below is a bug report template. It is not necessary to use this template, but it shows what is helpful to us in reproducing a problem. 

       ------------------  Template for bug report  ------------------------
       To: help@hdfgroup.org
       Subject: [VERSION]: [SYNOPSIS]

       VERSION:
          HDF5-1.6.2

       USER:
              [Name, phone number and address of person reporting the bug.]

       SYNOPSIS:
              [Brief description of the problem.] 

       MACHINE / OPERATING SYSTEM:
              [e.g. Solaris 2.8,  HP-UX 11.00 ...
              On Unix platforms, please include the output from
              "uname -a".]

       COMPILER:
              [e.g. native cc, native ANSI cc, gcc 2.95.3, MPW, ...]

       DESCRIPTION:
              [Detailed description of problem.]

       REPEAT BUG BY:
              [What you did to get the error; include test program or session
               transcript if at all possible.  If you include a program, make
               sure it depends only on libraries in the HDF distribution, not
               on any vendor or third-party libraries.  Please be specific;
               if we can't reproduce it, we can't fix it. Tell us exactly what
               we should see when the program is run.  NOTE:  It helps us a
               LOT if the example program is written in C and can be run
               easily on Unix.]

       SAMPLE FIX:
              [Fix or patch, if you have one. ]

       ------------------  End of Bug Report Template  ----------------------

- - Last modified:December 14th 2007