H5PFC(1)

🦋 h5pfc — your lil bestie for compiling HDF5 Fortran apps 🦋

okay so, first things first: this is the manual page for h5pfc, a User Commands situation, filed under H5PFC(1). She's a helper script, she's lowkey iconic, and she exists for one reason: to compile your HDF5 Fortran applications without you losing your mind. 💖

✨ NAME ✨

h5pfc — helper script to compile HDF5 Fortran applications 🫶

🌸 DESCRIPTION 🌸

so the vibe is:

usage: h5pfc [OPTIONS] <compile line>

that's it, that's the whole thing. you give her options, you give her a compile line, she handles the rest. main character energy fr fr. 👑

🎀 OPTIONS 🎀

• -help — prints this help message. she's literally telling you how to use her. help her help you. 💅
• -echo — shows you all the shell commands that get executed. very "not me being transparent about everything I do" of her. ✨
• -prefix=DIR — the prefix directory where HDF5's lib/ and include/ subdirectories live. default is /usr. she will go looking there, no cap.
• -show — shows you the commands without actually executing them. it's giving preview mode, it's giving window shopping, it's giving look-don't-touch. 🙈
• -showconfig — shows the HDF5 library configuration summary. the receipts, if you will. 🧾
• -shlib — compile with shared HDF5 libraries. this is the default for hdf5 built without static libraries. 💫
• -noshlib — compile with static HDF5 libraries. this is the default for hdf5 built with static libraries. 🌈
• <compile line> — the normal compile line options for your compiler. just, y'know, your usual stuff. 💜

👑 a lil heads up about your compiler 👑

h5pfc uses the same compiler you used to compile HDF5. like, she's loyal, she's not switching up on you. check with your compiler's man pages for more info on which options are needed — that's a you-and-your-compiler conversation, bestie. 😭

you can override the compiler and linker to compile your program by setting these environment variables accordingly:

• HDF5_FC — use a different Fortran 90 or 95 compiler 🔥
• HDF5_FLINKER — use a different linker 🔗
• HDF5_USE_SHLIB=[yes|no] — use the shared or static version of the HDF5 library. default: no, except when built with only shared libraries. ⭐

🧚 paths and flags: you can customize too 🧚

you can also add or change paths and flags to the compile line using the following environment variables, or by assigning them to their counterparts in the 'Things You Can Modify to Override...' section of h5pfc. yes she really named a section that, she's dramatic like that. 💅

here's the little mapping — Variable → Current value to be replaced:

• HDF5_FCFLAGS — ""
• HDF5_LDFLAGS — ""
• HDF5_LIBS — ""

⚠️ okay important one, pay attention bestie: note that adding library paths to HDF5_LDFLAGS where another hdf5 version is located may link your program with that other hdf5 library version. like, she'll do it, but you might not get the hdf5 you thought you were getting. be careful out there. 💀

and that's the whole page, bestie!! this one's from h5pfc (hdf5 1.8.12), dated May 2014, and it's chillin' in the H5PFC(1) section. slay, go compile something cute. 💖✨🎀