klibc/klcc.1

   1 .\" $Id: klcc.1,v 1.3 2005/04/19 23:27:46 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 and
  43 .BR ld (1)
  44 which compiles and links a program against the
  45 .B klibc
  46 tiny C library.  It supports most
  47 .B gcc
  48 options.
  49 .PP
  50 Unlike
  51 .BR gcc ,
  52 .B klcc
  53 compiles with optimization on by default.  Furthermore, the
  54 optimization level used depends on whether or not
  55 .B \-g
  56 is specified, since
  57 .B klcc
  58 frequently uses options in the normal case which makes debugging
  59 impossible.  Therefore, compile without
  60 .BR \-g ,
  61 .BR \-O ,
  62 .B \-f
  63 or
  64 .B \-m
  65 option to use the default optimization level; this will generally
  66 result in the smallest binaries.  You may want to use
  67 .B \-s
  68 when linking, however.  Use
  69 .B \-O0
  70 to compile without any optimization whatsoever; this may not work depending
  71 on the version of
  72 .B gcc
  73 used.
  74 .PP
  75 Use the
  76 .B \-shared
  77 or
  78 .B \-static
  79 option to compile for and link against shared or static klibc.  Note
  80 that shared klibc only supports running against the exact same klibc
  81 binary as the binary was linked with.
  82 .PP
  83 In addition to standard
  84 .B gcc
  85 options,
  86 .B klcc
  87 supports options of the form \fB\-print-klibc-\fP\fIoption\fP,
  88 which prints the corresponding klibc configuration option.
  89 .SH AUTHOR
  90 Written by H. Peter Anvin <hpa@zytor.com>.
  91 .SH COPYRIGHT
  92 Copyright \(co 2005 H. Peter Anvin \- All Rights Reserved
  93 .PP
  94 Permission is hereby granted, free of charge, to any person
  95 obtaining a copy of this software and associated documentation
  96 files (the "Software"), to deal in the Software without
  97 restriction, including without limitation the rights to use,
  98 copy, modify, merge, publish, distribute, sublicense, and/or
  99 sell copies of the Software, and to permit persons to whom
 100 the Software is furnished to do so, subject to the following
 101 conditions:
 102 .PP
 103 The above copyright notice and this permission notice shall
 104 be included in all copies or substantial portions of the Software.
 105 .PP
 106 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 107 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
 108 OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 109 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
 110 HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
 111 WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
 112 FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 113 OTHER DEALINGS IN THE SOFTWARE.
 114 .SH "SEE ALSO"
 115 .BR gcc (1)
 116