h4cc(1)

📦 version 4.3.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💅 h4cc — compiles an HDF4 C program

okay bestie, welcome to h4cc(1), the manual page for the little script that makes your HDF4 C program go brrr. sit down, grab a strawberry, we're doing this 🍓✨

✨ SYNOPSIS ✨

h4cc [OPTIONS] <compile line>

that's it. that's the whole vibe. options, then your normal compile line, and boom 💥

🦋 DESCRIPTION 🦋

h4cc compiles an HDF4 C program. that's literally the job. it takes your C code and turns it into a program that can talk to HDF4, and it handles all the include paths and libraries so you don't have to sit there googling "where is my libmfhdf" at 2am 😭 iconic behaviour honestly.

🎀 OPTIONS 🎀

  • -help — shows you the usage info. the "hello, what do i even do" button 🫶
  • -echo — prints out every single shell command it runs. it's giving let me show you my work, and honestly we love the transparency 👑
  • -prefix=DIR — the prefix directory where it goes looking for the HDF4 lib/ and include/ subdirectories. default is /usr 🌸
  • -show — shows you the commands but does not execute them. window shopping. no cap, nothing actually happens 💀
  • -shlib — compile against the shared HDF4 libraries. this is the default when HDF4 was built without static libraries ✨
  • -noshlib — compile against the static HDF4 libraries. this is the default when HDF4 was built with static libraries 🧱
  • <compile line> — the totally normal compile line options for your compiler. and here's the cute part: h4cc uses the same compiler you used to compile HDF4. check your compiler's man pages for more info on which options are needed 📖

🌈 ENVIRONMENT VARIABLES 🌈

you can also override the compiler, the linker, and whether you're doing static or shared libraries, just by setting these bad boys:

  • HDF4_CC — use a different C compiler 🛠️
  • HDF4_CLINKER — use a different linker 🔗
  • HDF4_USE_SHLIB=[yes|no] — use the shared or static version of the HDF4 library. default is no 💖
reminder bestie: those defaults for -shlib / -noshlib depend on how HDF4 itself was built — if it was built without static libraries, shared is your default; if it was built with static libraries, static is your default. check before you assume, iykyk 🙈

that's the whole page, and honestly? it ate. 💅 this was h4cc(1) from 28 May 2016 — go compile something gorgeous, main character. bye bestie! 💜🦋✨

📦 where this page comes from