h5c++(1)

💖 h5c++ — the helper script that compiles your HDF5 C++ apps 💖

okay bestie, welcome to h5c++(1), a General Commands Manual page, and honestly? she's a supportive queen. let's get into it 🫶

---

✨ NAME ✨

h5c++ — Helper script to compile HDF5 C++ applications.

like, that's her whole job. she helps. she compiles. she slays 💅

---

🌸 SYNOPSIS 🌸

h5c++ [OPTIONS] <compile line>

---

🦋 DESCRIPTION 🦋

so here's the vibe: you can use h5c++ in much the same way MPIch is used to compile an HDF5 program. she handles the annoying part — specifying where the HDF5 header files and libraries go on the command line. you just. don't have to think about it. iconic behavior, no cap ✨

h5c++ supercedes all other compiler scripts in that if you've used one set of compiler scripts to compile the HDF5 C++ library, then h5c++ uses those same scripts. for example, when compiling an MPIch program, you use the mpiCC script. she remembers. she's loyal. 💜

some programs use HDF5 in only a few modules. and here's the tea — it isn't necessary to use h5c++ to compile those modules which don't use HDF5. in fact, since h5c++ is only a convenience script, you are still able to compile HDF5 C++ modules in the normal way. but bestie, in that case you will have to specify the HDF5 libraries and include paths yourself. your problem now, not hers 🙈

an example of how to use h5c++ to compile the program hdf_prog, which consists of modules prog1.cpp and prog2.cpp and uses the HDF5 C++ library, would be as follows:

# h5c++ -c prog1.cpp
# h5c++ -c prog2.cpp
# h5c++ -o hdf_prog prog1.o prog2.o

look at that. three lines. so clean. so demure. 🎀

---

okay now the options, one bullet each, no skipping, we don't do that here:

• -help — Prints a help message. she's helpful like that 💖
• -echo — Show all the shell commands executed. like a little receipts printer for your terminal 🧾✨
• -prefix=DIR — Use the directory DIR to find the HDF5 lib/ and include/ subdirectories. Default: prefix specified when configuring HDF5. so if you configured it with a prefix, that's the default, periodt 👑
• -show — Show the commands without executing them. window shopping only. no buying. 🛍️
• <compile line> — The normal compile line options for your compiler. h5c++ uses the same compiler you used to compile HDF5. Check your compiler's manual for more information on which options are needed. iykyk — go read the manual, bestie, she's not gonna guess for you 📖

---

🌈 ENVIRONMENT 🌈

• HDF5_CXX — Use a different C++ compiler. swap her out, she won't take it personally 💅
• HDF5_CXXLINKER — Use a different linker. linkin' with somebody new 🔗

---

⭐ SEE ALSO ⭐

• h5cc(1)
• h5fc(1)

the whole friend group. go say hi 🫶

---

and that's the page, bestie!! this was h5c++(1) from the General Commands Manual — no version number, no date stamped on it, just vibes and a helper script that carries the whole build. mwah. go compile something gorgeous. 💖✨🎀🦋🌸💅