HEAP2EXEC(1)

📦 version 110.99.9, in arch rolling

💅 heap2exec — the manual page, but make it make sense

okay so bestie, welcome to the heap2exec(1) page — yes that's the section 1 of the manual, we love a general-commands era 🎀

✨ NAME ✨

heap2exec — bestie it literally generates a standalone executable from a SML/NJ heap image. that's the whole vibe. 💖

🦋 SYNOPSIS 🦋

heap2exec [ -32 | -64 ] [ LINKMODE ] file

that's it. that's the whole invocation. icon behavior honestly.

🌸 DESCRIPTION 🌸

so under normal usage, SML/NJ represents a program as a heap-image file with a name of the form foo.arch-opsys — like, that's just how it do. and heap2exec generates a standalone executable from a heap image. you also get the option to specify a preferred linking mode, which is very main-character of you. ✨

the default is to link statically on FreeBSD and Linux. no cap.

🫶 heads up bestie: heap2exec is an optional component of the SML/NJ installation process that is not included by default. so if you're sitting there like "where is it 😭" — you gotta edit the config/targets file before installation to include it. iykyk.

💅 OPTIONS 💅

  • -32 — run the 32-bit version of the program (currently the default). so if you don't say anything, this is lowkey what you're getting 🎀
  • -64 — run the 64-bit version of the program. this option only applies to the x86-64 (aka amd64) architecture, so don't come for it on other arches bestie 💀
  • -static, -linkwith-a — statically link the program with the runtime system. static linking is the default on Linux and FreeBSD, so this is kind of the "i'm just confirming the vibe" flag 🌈
  • -dynamic, -linkwith-so — dynamically link the program with the runtime system. the other flavor. the plot twist. 🔥

👑 AUTHOR 👑

heap2exec was written by Matthias Blume. we stan. 🫶

⭐ SEE-ALSO ⭐

  • sml(1) — go read that one next, bestie, it's giving lore

💀 BUGS 💀

okay so the tea: heap2exec is limited to the x86 and amd64 architectures and to the macOS, Linux, and FreeBSD operating systems. so if you're on something else... yeah. not me finding out the hard way 🙈

🍓 COPYING 🍓

Copyright © 2020 The Fellowship of SML/NJ

this is free software; see the source for copying conditions. there is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. so like, no refunds, no notes, periodt. 💅

and that's the page bestie!! 🧚 this lil number is from SML/NJ, dated 2025-11-04, and it's the HEAP2EXEC(1) page — go forth and link something, you absolute icon 💖✨

📦 where this page comes from