CPROC(1)

💅 CPROC — the C11 compiler bestie 💅

okay so this is the manual page for cproc, a section 1 (General Commands) page from the Debian corner of the internet. Buckle up, we're compiling 🧚✨

🌸 NAME 🌸

cproc — a C11 compiler. That's it, that's the girl. 👑

✨ SYNOPSIS ✨

cproc [options] sources...

💖 DESCRIPTION 💖

cproc is a C11 compiler that uses QBE as its backend. It supports ISO C11, plus some features from the upcoming C23, plus some GNU C extensions. Versatile queen. 💅

When you invoke it with, like, no options at all, cproc will preprocess, compile, and link your sources..., and generate an executable a.out file. Full pipeline, main character energy. 🌈

The following options are available:

• -c — Compile the sources to object files instead of linking them. (So close to a full executable, but not quite — it's giving "almost". 😌)
• -D macro[=value] — Define macro to value, as if you did a preprocessor #define. If value isn't given, macro gets defined to 1. Defaults, slay. 🎀
• -E — Preprocess the input files and print the output, instead of compiling. Just the preprocessing part, no compiling. 🦋
• -I path — Append path to the list of directories searched for headers. 📂
• -L path — Append path to the list of directories searched for libraries. 📚
• -l library — Link library into the executable. If library is a relative path, it'll be searched through the compiler search paths. 🔍
• -o output — Write the output to output. By default, output goes to a.out. Or, if -c is used, the output file is determined by replacing the source file extension with .o. Or, if -E or -emit-qbe is used, the output is written to standard output. So many vibes, so many destinations. 🌟
• -s — Strip the symbol table from the generated executable. Bye bye symbols 👋
• -U macro — Undefine a pre-defined macro. The reverse of -D, iconic duo. 💜
• -v — Print the commands run as part of the compile pipeline. Nosy? Yes. Useful? Also yes. 👀
• -x format — Force cproc to interpret subsequent source files as format. By default, cproc determines the source code language from the known file extensions. This option forces a different format, and it can be one of none, c, c-header, cpp-output, qbe, assembler, assembler-with-cpp. Pick your fighter. ⭐
• -Wa,args..., -Wl,args..., -Wp,args... — For each of these options, pass additional args... to the assembler, linker, or preprocessor respectively. The list of arguments is delimited by commas. 🔥

For example, -Wl,--gc-sections will forward the option --gc-sections to the linker. See? Comma-delimited, no cap.

• -static — Link the executable statically. 🗿
• -nostdlib — Do not use standard library and startup files when linking. Going feral, no standard library. 💀
• -nostdinc — Do not search default compiler include paths when compiling. 🙈
• -pthread — This is a short hand of -lpthread. Threads, bestie. 🧵
• -g, -O, -pipe, -pedantic — These options are available for compatibility with most common compilers, but they are currently ineffective. They're there for the vibes, fr fr. They don't actually do anything right now. 🫶

👑 AUTHORS 👑

cproc was written by Michael Forney <mforney@mforney.org>. King behavior. 💖

And that's the whole page, bestie — this was the CPROC(1) manual from the Debian General Commands Manual, dated $Mdocdate$. Go forth and compile something iconic. ✨💅🌈