FLENGBUNDLE(1)

📦 version 23, in nixos 26.05, nixpkgs unstable

💅 FLENGBUNDLE(1) — the flengbundle page, but make it make sense

okay so bestie, welcome to flengbundle(1) from the General Commands Manual — yes we're in the big-girl manual section today, pop off 🎀

✨ NAME ✨

flengbundle — a tool that integrates raw data into programs written in FGHC, Strand, PCN or FLENG 🌈

🦋 SYNOPSIS 🦋

flengbundle [-c] [-n NAME] [-o OUTFILE] [FILENAME]

💖 DESCRIPTION 💖

flengbundle is that girl who builds linkable object files out of raw data. Iconic behaviour, honestly.

It takes input from FILENAME if you gave it one — and if you didn't, or if you literally typed "-", it reads from standard input instead 🫶 — and it produces a C file that gets compiled into an object file. That object file can then be linked into an executable or a library. slay.

The data is accessible as an immutable array of type "char", and it's provided by a C function named NAME_1. You use it from FGHC or PCN code by calling the entry point like this:

foreign_call(NAME(A))

where "NAME" is whatever you set with the -n option (defaults to "bundle", cute). The single argument you hand to the foreign entry point gets unified with a read-only character array holding the data. no cap, that's the whole vibe 💫

OUTFILE defaults to "bundle.o". And if you pass the -c option? Then the generated C file does not get compiled — it just gets stored in OUTFILE. important distinction, bestie, don't skip it 🙈

🌸 ENVIRONMENT 🌸

These environment variables change how flengbundle behaves:

  • FLENG_PREFIX — holds the directory where the default FLENG tools are installed. If this variable isn't set, the tools live in the path that was specified during installation. iykyk ✨
  • TMPDIR — the directory used for creating temporary files. Defaults to "/tmp" if you never set it. very chill of it 💜

🔥 EXIT STATUS 🔥

flengbundle exits 0 on success, and >0 if an error occurs. that's it, that's the whole story 💀

👑 SEE ALSO 👑

More information can be found in the User's Manual and at http://www.call-with-current-continuation.org/fleng/fleng.html 🌐

🎀 AUTHORS 🎀

Felix L. Winkelmann — king behaviour, we stan 🫡

Submit bug reports by e-mail to felix@call-with-current-continuation.org 📬

ngl if something's broken, email Felix. don't just suffer in silence, bestie 😭

and that's the page!! brought to you by Debian, dated Dec 20, 2022 — mwah, go bundle some data 💅🍓

📦 where this page comes from