Contents of /trunk/mkinitrd-magellan/klibc/klcc/klcc.1
Parent Directory | Revision Log
Revision 815 -
(show annotations)
(download)
Fri Apr 24 18:32:46 2009 UTC (15 years, 5 months ago) by niro
File size: 3939 byte(s)
Fri Apr 24 18:32:46 2009 UTC (15 years, 5 months ago) by niro
File size: 3939 byte(s)
-updated to klibc-1.5.15
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) |