MESCC(1)

📦
version 0.27 · 3 versions
, in ubuntu questing

💖 MESCC 💖

okay bestie, so you know how the GNU system had to bootstrap itself from basically nothing?? this is the compiler that did it — a C99 compiler written in Scheme, and she's serving main character energy in the manual pages under section 1 (User Commands). pull up a chair, we're getting into it 🫶

✨ NAME ✨

mescc — a C99 compiler in Scheme, and her whole job is bootstrapping the GNU system. iconic behaviour, honestly 💅

🌸 SYNOPSIS 🌸

mescc [OPTION]... FILE...

like. give her some options, give her some files, she'll handle it 💖

🦋 DESCRIPTION 🦋

mescc is a C99 compiler written in Scheme, and its purpose — its entire why — is bootstrapping the GNU system. that's it. that's the vibe. no cap. 🔥

👑 OPTIONS 👑

okay so here's the whole menu, no skips, no "oh you probably won't need that one" — we're listing every single one because you deserve the full picture 🎀

  • --align=SYMBOL — align SYMBOL. your choices are {functions,globals,none}, and the default is [functions].
  • --arch=ARCH — compile for ARCH, default [x86_64].
  • --kernel=ARCH — compile for KERNEL, default [linux].
  • -dumpmachine — display the compiler's target machine. she's telling you who she is today ✨
  • --base-address=ADDRESS — use BaseAddress ADDRESS, default [0x1000000].
  • -D DEFINE[=VALUE] — define DEFINE, and if you don't hand her a value, [VALUE=1] is what you get.
  • -E — preprocess only. do not compile, do not assemble, do not link. just preprocess and chill 🙈
  • -g — add debug info (call stack in GDB). lowkey essential when things go sideways.
  • -h, --help — display this help and exit. the classic escape hatch 💜
  • -I DIR — append DIR to the include path.
  • -L DIR — append DIR to the library path.
  • -l LIBNAME — link with LIBNAME.
  • -m BITS — compile for BITS bits, default [32].
  • -nodefaultlibs — do not use libc.o nor libmescc.a when linking.
  • -nostartfiles — do not use crt1.o when linking.
  • -nostdlib — do not use crt1.o or libc.o or libmescc.a when linking. full bare-metal moment, we love a minimalist queen ⭐
  • -o FILE — write output to FILE.
  • -O LEVEL — use optimizing LEVEL.
  • -S — preprocess and compile only; do not assemble or link.
  • --std=STANDARD — assume that the input sources are for STANDARD.
  • -V, --version — display version and exit.
  • -w, --write=TYPE — dump Nyacc AST using TYPE, and TYPE is one of {pretty-print,write}.
  • -x LANGUAGE — specify LANGUAGE of the following input files.

💀 Ignored for GCC compatibility 💀

these ones are just here so that things expecting GCC don't get their feelings hurt. they exist, they're accepted, they do nothing:

  • -fno-builtin
  • -fno-stack-protector
  • -no-pie
  • -nostdinc
  • -static

🌈 Environment variables 🌈

because sometimes the vibe is set from outside the command line, yk?

  • MES=BINARY — run on mes-executable BINARY, and your options are {mes,guile}.
  • MES_DEBUG=LEVEL — show debug output with verbosity LEVEL, which ranges {0..5}. crank it up when you're lost, no shame 🫶
  • NYACC_TRACE=1 — show Nyacc progress. set it to 1 and watch her narrate her own life ✨

🎀 REPORTING BUGS 🎀

found something cursed? tell the humans, they wanna know:

📚 SEE ALSO 📚

the full documentation for mescc is maintained as a Texinfo manual. if the info and mescc programs are properly installed at your site, this command

info mescc

should give you access to the complete manual. go read it, bestie, she has layers 💅

and that's the whole page, fr fr 🌸 — this was GNU Mes 0.27, dated January 1970 (yes really, that date is doing its own thing and we respect it 💖). stay bootstrapping, stay slaying. periodt. 👑🦋

📦 where this page comes from