NAME

       klcc - compile a program against klibc

SYNOPSIS

       klcc [gcc options] [-o outfile] infile...

DESCRIPTION

       klcc  is  a wrapper around gcc(1) and ld(1) which compiles and links a program against the
       klibc tiny C library.  It supports most gcc options.

       Unlike gcc, klcc compiles with optimization on by default.  Furthermore, the  optimization
       level  used  depends on whether or not -g is specified, since klcc frequently uses options
       in the normal case which makes debugging impossible.  Therefore, compile without  -g,  -O,
       -f  or  -m option to use the default optimization level; this will generally result in the
       smallest binaries.  You may want to use -s when linking,  however.   Use  -O0  to  compile
       without  any  optimization  whatsoever;  this may not work depending on the version of gcc
       used.

       -nostdinc
              allows to turn off klibc include files.

       Use the -shared or -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.

       In addition to standard gcc options, klcc  supports  options  of  the  form  -print-klibc-
       option, which prints the corresponding klibc configuration option.

AUTHOR

       Written by H. Peter Anvin <hpa@zytor.com>.

COPYRIGHT

       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.

SEE ALSO

       gcc(1)