'\" t
.\"     Title: FAUCC
.\"    Author: FAUcc Team
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 07/20/2012
.\"    Manual: [FIXME: manual]
.\"    Source: FAUcc Team
.\"  Language: English
.\"
.TH "FAUCC" "1" "07/20/2012" "FAUcc Team" "[FIXME: manual]"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
faucc \- C compiler generating Intel code for 16 bit/32 bit CPUs\&.
.SH "SYNOPSIS"
.HP \w'\fBfaucc\fR\ 'u
\fBfaucc\fR [\fB\ \-B\ \fR\fB\fIpath\fR\fR\fB\ \fR] [\fB\ \-D\ \fR\fB\fIMACRO\fR\fR\ [\fB=\fR\fB\fIdef\fR\fR]] [\fB\ \-E\ \fR] [\fB\ \-I\ \fR\fB\fIpath\fR\fR\fB\ \fR] [\fB\ \-L\ \fR\fB\fIpath\fR\fR\fB\ \fR] [\fB\ \-MD\ \fR] [\fB\-MF\ \fR\fB\fIfile\fR\fR\fB\ \fR] [\fB\ \-MP\ \fR] [\fB\ \-MT\ \fR\fB\fItarget\fR\fR\fB\ \fR] [\fB\ \-O\ \fR\fB\fIlevel\fR\fR\fB\ \fR] [\fB\ \-S\ \fR] [\fB\ \-T\ \fR\fB\fIscript\fR\fR\fB\ \fR] [\fB\ \-U\ \fR\fB\fImacro\fR\fR\fB\ \fR] [\fB\ \-Wl,\fR\fB\fIarg\fR\fR\fB\ \fR] [\fB\ \-Xlinker\ \fR\fB\fIarg\fR\fR\fB\ \fR] [\fB\ \-b\ \fR\fB\fIarch\fR\fR\fB\ \fR] [\fB\ \-c\ \fR] [\fB\ \-f\ \fR\fB\fIarg\fR\fR\fB\ \fR] [\fB\ \-m\ \fR\fB\fIarch\fR\fR\fB\ \fR] [\fB\ \-nostdlib\ \fR] [\fB\ \-o\ \fR\fB\fIoutput\fR\fR\fB\ \fR] [\fB\ \-print\-lib\-faucc\-file\-name\ \fR] [\fB\ \-\-freestanding\ \fR] [\fB\ \-\-no\-stack\-protector\ \fR] {\fB\ \fR\fB\fIfile\fR\fR\fB\ \fR...}
.SH "DESCRIPTION"
.PP

\fBfaucc\fR
is a C compiler, that can generate Intel 16 bit or 32 bit Code\&.
.SH "OPTIONS"
.PP

\fBfaucc\fR
tries to mimic the options of
\fBgcc\fR\&. A number of options will be passed to the C preprocessor
\fBcpp\fR
or to the linker (done via a call to the c\-compiler
\fBgcc\fR) in unmodified form\&.
.PP
\fB\-B\fR \fIpath\fR
.RS 4
Override the directory prefix where
\fBcc1\fR
is looked up with
\fIpath\fR\&.
.RE
.PP
\fB\-D\fR \fIMACRO\fR, \fB\-D \fR\fB\fIMACRO\fR\fR\fB=\fR\fB\fIdef\fR\fR\fB \fR
.RS 4
Define
\fIMACRO\fR
with the optional initial definition
\fIdef\fR\&. If
\fIdef\fR
is omitted, it defaults to
\fB1\fR\&.
.RE
.PP
\fB\-E\fR
.RS 4
Only perform preprocessing, but do not run the compiler\&.
.RE
.PP
\fB\-I\fR \fIpath\fR
.RS 4
Add
\fIpath\fR
to the include path in which header files are searched\&.
.RE
.PP
\fB\-L\fR \fIpath\fR
.RS 4
Add
\fIpath\fR
to the library search path, in which the linker will look for libraries\&.
.RE
.PP
\fB\-MD\fR
.RS 4
Output dependency information while preprocessing\&.
.RE
.PP
\fB\-MF\fR, \fIfile\fR
.RS 4
Output dependency information while preprocessing to
\fIfile\fR\&.
.RE
.PP
\fB\-MP\fR,
.RS 4
When the preprocessor should output dependency information, it will generate PHONY targets for each dependency\&.
.RE
.PP
\fB\-MT\fR \fItarget\fR
.RS 4
When the preprocessor should output dependency information, use
\fItarget\fR
as the dependency rule target\&.
.RE
.PP
\fB\-O\fR \fIlevel\fR
.RS 4
Currently ignored\&.
.RE
.PP
\fB\-S\fR
.RS 4
Output assembly code\&.
.RE
.PP
\fB\-T\fR \fIscript\fR
.RS 4
Use
\fIscript\fR
as linker script\&.
.RE
.PP
\fB\-U\fR \fImacro\fR
.RS 4
Undefine a previously defined
\fImacro\fR\&.
.RE
.PP
\fB\-Wl,\fR\fIarg\fR, \fB\-Xlinker\fR \fIarg\fR
.RS 4
Pass
\fIarg\fR
to the linker\&.
.RE
.PP
\fB\-b\fR \fIarch\fR
.RS 4
Generate code for
\fIarch\fR
(either
\fBi286\fR
or
\fBi386\fR)
.RE
.PP
\fB\-c\fR
.RS 4
Perform compilation, but do not link\&.
.RE
.PP
\fB\-f\fR \fIarg\fR
.RS 4
Pass code generation argument
\fIarg\fR
to the compiler\&. See the
\fBcc1\fR
man page for possible arguments\&.
.RE
.PP
\fB\-m\fR \fIarch\fR
.RS 4
Currently ignored\&.
.RE
.PP
\fB\-nostdlib\fR
.RS 4
With this option, the linker will only search for libraries that are passed as command line arguments\&.
.RE
.PP
\fB\-o\fR \fIfile\fR
.RS 4
Write output to
\fIfile\fR\&.
.RE
.PP
\fB\-print\-libfaucc\-file\-name\fR
.RS 4
Print the full path of the internal compiler library
libfaucc\&.a\&.
.RE
.PP
\fB\-static\fR
.RS 4
Perform static linking\&.
.RE
.PP
\fB\-\-freestanding\fR, \fB\-\-no\-stack\-protector\fR
.RS 4
Currently ignored\&.
.RE
.SH "EXAMPLES"
.PP
\fB faucc \-c hello\-world\&.c \-o hello\-world\&.o \fR
.RS 4
Compile the program
hello\-world\&.c
and output the object as
hello\-wolrd\&.o\&.
.RE
.PP
\fB faucc \-S \-b i286 \-o test\&.s test\&.c \fR
.RS 4
Compile the program
test\&.c
to 16 bit code and output the assembly listing to
test\&.s, but do not assemble or link the result yet\&.
.RE
.SH "SEE ALSO"
.PP

\fBcc1\fR(1) , \fBcpp\fR(1) , \fBgcc\fR(1) , \fBld\fR(1)
.SH "CONTACT"
.PP
Please report all bugs to FAUcc Team
info@faumachine\&.org\&.
\m[blue]\fBFAUcc Homepage\fR\m[]\&\s-2\u[1]\d\s+2\&.
.SH "AUTHOR"
.PP
\fBFAUcc Team\fR
.SH "COPYRIGHT"
.br
Copyright \(co 2009 FAUcc Team. Developed at Friedrich Alexander University Erlangen-Nuremberg.
.br
.PP
FAUcc comes with ABSOLUTELY NO WARRANTY\&. FAUcc 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\&. See COPYING for details\&.
.sp
.SH "NOTES"
.IP " 1." 4
FAUcc Homepage
.RS 4
\%http://www.faumachine.org
.RE