klibc/klcc.1

   1 .\" $Id: klcc.1,v 1.2 2005/03/02 02:24:17 hpa Exp $
   2 .\" -----------------------------------------------------------------------
   3 .\"
   4 .\"   Copyright 2005 H. Peter Anvin - All Rights Reserved
   5 .\"
   6 .\"   Permission is hereby granted, free of charge, to any person
   7 .\"   obtaining a copy of this software and associated documentation
   8 .\"   files (the "Software"), to deal in the Software without
   9 .\"   restriction, including without limitation the rights to use,
  10 .\"   copy, modify, merge, publish, distribute, sublicense, and/or
  11 .\"   sell copies of the Software, and to permit persons to whom
  12 .\"   the Software is furnished to do so, subject to the following
  13 .\"   conditions:
  14 .\"
  15 .\"   The above copyright notice and this permission notice shall
  16 .\"   be included in all copies or substantial portions of the Software.
  17 .\"
  18 .\"   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  19 .\"   EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
  20 .\"   OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  21 .\"   NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
  22 .\"   HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
  23 .\"   WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  24 .\"   FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  25 .\"   OTHER DEALINGS IN THE SOFTWARE.
  26 .\"
  27 .\" -----------------------------------------------------------------------
  28
  29 .TH klcc "1" "1 March 2005" "klibc" "H. Peter Anvin"
  30 .SH NAME
  31 klcc \- compile a program against klibc
  32 .SH SYNOPSIS
  33 .B klcc
  34 [\fIgcc options\fP]
  35 [\fB\-o\fP \fIoutfile\fP]
  36 \fIinfile...\fP
  37 .SH DESCRIPTION
  38 .PP
  39 .B klcc
  40 is a wrapper around
  41 .BR gcc (1)
  42 to compile a program against the
  43 .B klibc
  44 tiny C library.  It supports most
  45 .B gcc
  46 options.
  47 .PP
  48 Unlike
  49 .BR gcc ,
  50 .B klcc
  51 compiles with optimization on by default.  Furthermore, the
  52 optimization level used depends on whether or not
  53 .B \-g
  54 is specified, since
  55 .B klcc
  56 frequently uses options in the normal case which makes debugging
  57 impossible.  Therefore, compile without
  58 .BR \-g ,
  59 .BR \-O ,
  60 .B \-f
  61 or
  62 .B \-m
  63 option to use the default optimization level; this will generally
  64 result in the smallest binaries.  You may want to use
  65 .B \-s
  66 when linking, however.
  67 .PP
  68 Use the
  69 .B \-shared
  70 or
  71 .B \-static
  72 option to compile for and link against shared or static klibc.  Note
  73 that shared klibc only supports running against the exact same klibc
  74 binary as the binary was linked with.
  75 .SH AUTHOR
  76 Written by H. Peter Anvin <hpa@zytor.com>.
  77 .SH COPYRIGHT
  78 Copyright \(co 2005 H. Peter Anvin.
  79 .SH "SEE ALSO"
  80 .BR gcc (1)
  81