flcrun(1)

💖 NAME 💖

hii bestie 💖 welcome to flcrun(1) from the Falcon User Manuals — yes, the manual name is folded in right here like a little name tag 🎀

flcrun — The Falcon command line execution tool. That's the name, and it's literally here to run your stuff. Slay.

---

✨ SYNOPSIS ✨

This is the exact shape of the command, no cap:

falrun [options] [main_script] [script_options]

The synopsis spells it falrun — keep that spelling exactly, bestie, because that's what the page says 🫶

---

🌸 DESCRIPTION 🌸

okay so falrun is a subset of the falcon(1) command line interpreter, and its whole thing is executing pre-compiled falcon scripts in .fam module files. Only those. It's meant to launch Falcon-based applications that were compiled on a different system, where the source is not shipped. So: you've got the compiled app, not the source, and this tool is the one that runs it. periodt 💅

---

🔥 OPTIONS 🔥

• -e <enc> — sets the given encoding as the default for VM I/O. Unless the scripts select a different I/O encoding, the streams that are provided to the Falcon VM (like the output stream for printf) are encoded using the given ISO encoding. This overrides the default encoding that is detected by reading the environment settings. In example, if your system uses iso-8859-1 encoding by default, but you want your script to read and write utf-8 files, use the option -e utf-8 💖
• -h or -? — prints a brief help on stdout and exits. Cute and done ✨
• -L <path> — changes the default load path. This overrides both the internal built-in settings and the contents of environment variable FALCON_LOAD_PATH. Each directory in the path should be separated by ";" and use forward slashes, like this:

falrun -L ./;/usr/share/falcon_mod;./myapp

• -p <module> — preloads the given module as if it were loaded by the main script 🎀
• -P — ignores default load paths and uses only the paths set via the -L switch.
• -v — prints copyright notice and version and exits.

---

🎀 FILES 🎀

• /usr/lib/libfalcon_engine.so — default location of the Falcon Engine loadable module.
• /usr/lib/falcon — default directory containing Falcon binary modules.

---

🦋 ENVIRONMENT 🦋

• FALCON_LOAD_PATH — default search path for modules loaded by the scripts.
• FALCON_SRC_ENCODING — default encoding for the source scripts loaded by falcon (when different from the system default).
• FALCON_VM_ENCODING — default encoding for the VM I/O streams (when different from the system default).

---

👑 AUTHOR 👑

Giancarlo Niccolai <gc@falconpl.org> — iconic 💜

---

🌈 SEE ALSO 🌈

also check falcon(1) and faldisass(1) — they're in the SEE ALSO squad, bestie 💫

---

💜 LICENSE 💜

This document is released under the "GNU Free Documentation License, version 1.2". On Debian systems, the complete text of the Free Documentation License, version 1.2, can be found in /usr/share/common-licenses/.

---

okay that's the whole page 🫶 this one comes from the Falcon toolset, dated April 2007, and it's signing off as flcrun(1) 💖✨