h5cc(1)

💅 h5cc — the compile-bestie you didn't know you needed

okay so first things first: this is h5cc, living in the General Commands Manual, section 1 (the one for user commands, iykyk). She's a helper script and her whole job is making HDF5 apps actually compile without you crying. 🫶

✨ NAME ✨

h5cc — Helper script to compile HDF5 applications. 💖

🌸 SYNOPSIS 🌸

h5cc [OPTIONS] <compile line>

that's it. that's the whole vibe. 🎀

🦋 DESCRIPTION 🦋

So bestie, think of h5cc like MPIch but for compiling an HDF5 program. She handles telling your compiler where the HDF5 header files and libraries are, so you don't have to type out a whole novel of paths on the command line. She just does it. main character energy, honestly. ✨

Not me about to tell you the most iconic part: h5cc supercedes all other compiler scripts. Like, if you used other scripts to compile the HDF5 library, h5cc uses those scripts too. Example time: when you're compiling an MPIch program you'd normally use the mpicc script. And if you built HDF5 using MPIch? Then h5cc uses the MPIch program for compilation. She's not replacing them, she's networking. 👑

Also lowkey important: some programs only use HDF5 in a few modules, and it is not necessary to use h5cc to compile the modules that don't use HDF5. And fr fr, since h5cc is only a convenience script, you can absolutely still compile HDF5 modules the normal way. Just know that in that case, you will have to specify the HDF5 libraries and include paths yourself. no hand-holding, bestie. 😭

Okay now the glow-up example. Say you wanna compile the program hdf_prog, which is made of the modules prog1.c and prog2.c, and it uses the HDF5 shared library. Here's how:

# h5cc -c prog1.c # h5cc -c prog2.c # h5cc -shlib -o hdf_prog prog1.o prog2.o

slay. compile, compile, link. 💅

🎀 OPTIONS 🎀

• -help — Prints a help message. (she's helpful AND pretty 🌸)
• -echo — Show all the shell commands executed. so you can see exactly what she's doing behind the scenes. 🙈
• -prefix=DIR — Use the directory DIR to find the HDF5 lib/ and include/ subdirectories. Default: the prefix specified when configuring HDF5. 📁
• -show — Show the commands without executing them. peek but don't touch. 👀
• -shlib — Compile using shared HDF5 libraries. 🫶
• -noshlib — Compile using static HDF5 libraries [default]. the default! don't forget it! ⭐
• <compile line> — The normal compile line options for your compiler. h5cc uses the same compiler you used to compile HDF5. Check your compiler's manual for more info on which options are needed. 📖

🌈 ENVIRONMENT 🌈

• HDF5_CC — Use a different C compiler. go off, switch it up. 🔥
• HDF5_CLINKER — Use a different linker. link differently, bestie. 🔗
• HDF5_USE_SHLIB=[yes|no] — Use shared version of the HDF5 library [default: no]. ⭐

💜 SEE ALSO 💜

• h5fc(1)
• h5c++(1)

go say hi to her siblings, they're iconic too. 🧚

💀 reminder that h5cc is a convenience script and nothing more — if you skip her, the libraries and include paths are your problem, not hers. no cap.

and that's the whole page, bestie!! this was the h5cc(1) manual page from the General Commands Manual, and it's officially a wrap. 🍓 stay compiling, stay hydrated, and may your linker never betray you. mwah. 💖✨