~ubuntu-branches/ubuntu/hardy/klibc/hardy-updates

« back to all changes in this revision

Viewing changes to klcc/klcc.1

  • Committer: Bazaar Package Importer
  • Author(s): Jeff Bailey
  • Date: 2006-01-04 20:24:52 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20060104202452-ec4v3n829rymukuv
Tags: 1.1.15-0ubuntu1
* New upstream version.

* Patch to fix compilation on parisc64 kernels.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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