.\" $Id: klcc.1,v 1.2 2005/03/02 02:24:17 hpa Exp $
.\" -----------------------------------------------------------------------
.\"   
.\"   Copyright 2005 H. Peter Anvin - All Rights Reserved
.\"
.\"   Permission is hereby granted, free of charge, to any person
.\"   obtaining a copy of this software and associated documentation
.\"   files (the "Software"), to deal in the Software without
.\"   restriction, including without limitation the rights to use,
.\"   copy, modify, merge, publish, distribute, sublicense, and/or
.\"   sell copies of the Software, and to permit persons to whom
.\"   the Software is furnished to do so, subject to the following
.\"   conditions:
.\"   
.\"   The above copyright notice and this permission notice shall
.\"   be included in all copies or substantial portions of the Software.
.\"   
.\"   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
.\"   EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
.\"   OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
.\"   NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
.\"   HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
.\"   WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
.\"   FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
.\"   OTHER DEALINGS IN THE SOFTWARE.
.\"
.\" -----------------------------------------------------------------------

.TH klcc "1" "1 March 2005" "klibc" "H. Peter Anvin"
.SH NAME
klcc \- compile a program against klibc
.SH SYNOPSIS
.B klcc
[\fIgcc options\fP]
[\fB\-o\fP \fIoutfile\fP]
\fIinfile...\fP
.SH DESCRIPTION
.PP
.B klcc
is a wrapper around
.BR gcc (1)
to compile a program against the
.B klibc
tiny C library.  It supports most
.B gcc
options.
.PP
Unlike
.BR gcc ,
.B klcc
compiles with optimization on by default.  Furthermore, the
optimization level used depends on whether or not
.B \-g
is specified, since
.B klcc
frequently uses options in the normal case which makes debugging
impossible.  Therefore, compile without
.BR \-g ,
.BR \-O ,
.B \-f
or
.B \-m
option to use the default optimization level; this will generally
result in the smallest binaries.  You may want to use
.B \-s
when linking, however.
.PP
Use the
.B \-shared
or
.B \-static
option to compile for and link against shared or static klibc.  Note
that shared klibc only supports running against the exact same klibc
binary as the binary was linked with.
.SH AUTHOR
Written by H. Peter Anvin <hpa@zytor.com>.
.SH COPYRIGHT
Copyright \(co 2005 H. Peter Anvin.
.SH "SEE ALSO"
.BR gcc (1)