GAC(1)

📦
version 4.16.0 · 7 versions
, in ubuntu stonking

💅 GAC(1) — the GAP Compiler, but make it make sense

okay so real talk: this is GAC, aka the GAP Compiler, and it lives in the User Commands corner of section 1 of the manual. she compiles stuff. that's her whole personality and honestly? iconic. let's get into it 🫶

✨ SYNOPSIS ✨

gac [-c|-d] [-o <output>] {-f<option>} <input>...

that's the whole vibe check right there: some flags, an output name if you're feeling fancy, and then a whole pile of input files. periodt.

🌸 DESCRIPTION 🌸

bestie. GAC compiles the input files. that's the job. but like, not just any files — the inputs have rules, and the rules are:

  • GAP source code — suffix .g or .gap 🍓
  • C source code — suffix .c 🧚
  • compiled code files — suffix .o 💜

anything else? not invited to the party, sorry.

now the flags, and yes we're going through all of them because each one is a main character:

  • -c — compiles the input files into statically loadable object files, which then have to be linked together into a new kernel. ngl, that's the committed-relationship option.
  • -d — compiles the input files into dynamically loadable object files, which a kernel can load at runtime. lowkey the free-spirit option.
  • -C — only compiles the input files down to C code, which will still need compilation and linking before it's actually usable. it's giving "halfway there, bestie" 😭
  • -r — statically compiled files get assumed to be given by pathnames relative to the GAP root, and get compiled for automatic loading when files are sought relative to the GAP root. iykyk.
  • -o <output> — names the output file <output>. that's it, that's the whole flag. cute.
  • -save-temps — tells gac to not delete any intermediate files. the messy-girl option and we respect it 🙈
  • -p <option> — passes the option <option> to the C compiler.
  • -P <option> — passes the option <option> to the C linker.
  • -L <option> — tells gac to pass the option <option> to the C linker when linking dynamic modules. and here's the tea ☕ — contrary to -P, this option gets appended at the end of the link command, after the .o files to link. order matters, bestie, always has 💅

🦋 SEE ALSO 🦋

  • gap(1) — her sister, go say hi

also!! you can read the complete manual in /usr/share/gap/doc, or you can use the online help system. just type ?help inside GAP to access it. literally that easy bestie 🌈

👑 AUTHORS 👑

The GAP Group <https://www.gap-system.org> — the collective. the whole squad. we stan.

Copyright (1988--2024) by its authors.

GAP is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. no cap, free as in freedom 💖

ok that's the whole page, you're officially a GAP compiler girlie now. go compile something and slay ✨

— with love from The GAP team, April 2024, signing off 🫶💅

📦 where this page comes from