1h5cc(1)                     General Commands Manual                    h5cc(1)
2
3
4

NAME

6       h5cc - Helper script to compile HDF5 applications.
7

SYNOPSIS

9       h5cc [OPTIONS] <compile line>
10

DESCRIPTION

12       h5cc  can be used in much the same way MPIch is used to compile an HDF5
13       program. It takes care of specifying where the HDF5  header  files  and
14       libraries are on the command line.
15
16       h5cc  supercedes all other compiler scripts in that if you've used them
17       to compile the HDF5 library, then h5cc also  uses  those  scripts.  For
18       example,  when compiling an MPIch program, you use the mpicc script. If
19       you've built HDF5 using MPIch, then h5cc uses  the  MPIch  program  for
20       compilation.
21
22       Some programs use HDF5 in only a few modules. It isn't necessary to use
23       h5cc to compile those modules which don't use HDF5. In fact, since h5cc
24       is  only  a convenience script, you are still able to compile HDF5 mod‐
25       ules in the normal way. In that case, you will have to specify the HDF5
26       libraries and include paths yourself.
27
28       An  example  of  how to use h5cc to compile the program hdf_prog, which
29       consists of modules prog1.c  and  prog2.c  and  uses  the  HDF5  shared
30       library, would be as follows:
31              #  h5cc  -c  prog1.c # h5cc -c prog2.c # h5cc -shlib -o hdf_prog
32              prog1.o prog2.o
33

OPTIONS

35       -help  Prints a help message.
36
37       -echo  Show all the shell commands executed.
38
39       -prefix=DIR
40              Use the directory DIR to find the HDF5 lib/ and include/  subdi‐
41              rectories.  Default: prefix specified when configuring HDF5.
42
43       -show  Show the commands without executing them.
44
45       -shlib Compile using shared HDF5 libraries.
46
47       -noshlib
48              Compile using static HDF5 libraries [default].
49
50       <compile line>
51              The normal compile line options for your compiler. h5cc uses the
52              same compiler you used to compile HDF5.  Check  your  compiler's
53              manual for more information on which options are needed.
54

ENVIRONMENT

56       HDF5_CC
57              Use a different C compiler.
58
59       HDF5_CLINKER
60              Use a different linker.
61
62       HDF5_USE_SHLIB=[yes|no]
63              Use shared version of the HDF5 library [default: no].
64

SEE ALSO

66       h5fc(1), h5c++(1)
67
68
69
70
71                                                                       h5cc(1)
Impressum