Magellan Linux

  • Back to homepage
    • /[magellan-source]/trunk/mkinitrd-magellan/klibc/klcc/klcc.1

    Annotation of /trunk/mkinitrd-magellan/klibc/klcc/klcc.1

    Parent Directory Parent Directory | Revision Log Revision Log

    Revision 815 - (hide annotations) (download)
    Fri Apr 24 18:32:46 2009 UTC (15 years ago) by niro
    File size: 3939 byte(s) 
    -updated to klibc-1.5.15
    1 niro 815 .\" $Id: klcc.1,v 1.3 2005/04/19 23:27:46 hpa Exp $
    2 niro 532 .\" -----------------------------------------------------------------------
    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)