| .\" $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) |
| |