Reshaped doc's
[fw/sdcc] / doc / sdccman.html / node14.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2
3 <!--Converted with LaTeX2HTML 99.1 release (March 30, 1999)
4 original version by:  Nikos Drakos, CBLU, University of Leeds
5 * revised and updated by:  Marcus Hennecke, Ross Moore, Herb Swan
6 * with significant contributions from:
7   Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
8 <HTML>
9 <HEAD>
10 <TITLE>2.4 Install Trouble-shooting</TITLE>
11 <META NAME="description" CONTENT="2.4 Install Trouble-shooting">
12 <META NAME="keywords" CONTENT="sdccman">
13 <META NAME="resource-type" CONTENT="document">
14 <META NAME="distribution" CONTENT="global">
15
16 <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
17 <META NAME="Generator" CONTENT="LaTeX2HTML v99.1 release">
18 <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
19
20 <LINK REL="STYLESHEET" HREF="sdccman.css">
21
22 <LINK REL="next" HREF="node15.html">
23 <LINK REL="previous" HREF="node13.html">
24 <LINK REL="up" HREF="node10.html">
25 <LINK REL="next" HREF="node15.html">
26 </HEAD>
27
28 <BODY >
29 <!--Navigation Panel-->
30 <A NAME="tex2html412"
31  HREF="node15.html">
32 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next_motif.gif"></A> 
33 <A NAME="tex2html406"
34  HREF="node10.html">
35 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up_motif.gif"></A> 
36 <A NAME="tex2html400"
37  HREF="node13.html">
38 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="previous_motif.gif"></A> 
39 <A NAME="tex2html408"
40  HREF="node1.html">
41 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents_motif.gif"></A> 
42 <A NAME="tex2html410"
43  HREF="node61.html">
44 <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index_motif.gif"></A> 
45 <BR>
46 <B> Next:</B> <A NAME="tex2html413"
47  HREF="node15.html">2.5 Additional Information for</A>
48 <B> Up:</B> <A NAME="tex2html407"
49  HREF="node10.html">2. Installation</A>
50 <B> Previous:</B> <A NAME="tex2html401"
51  HREF="node13.html">2.3 Testing out the</A>
52  &nbsp <B>  <A NAME="tex2html409"
53  HREF="node1.html">Contents</A></B> 
54  &nbsp <B>  <A NAME="tex2html411"
55  HREF="node61.html">Index</A></B> 
56 <BR>
57 <BR>
58 <!--End of Navigation Panel-->
59 <!--Table of Child-Links-->
60 <A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
61
62 <UL>
63 <LI><A NAME="tex2html414"
64  HREF="node14.html#SECTION00034100000000000000">2.4.1 SDCC cannot find libraries or header files.</A>
65 <LI><A NAME="tex2html415"
66  HREF="node14.html#SECTION00034200000000000000">2.4.2 SDCC does not compile correctly.</A>
67 <LI><A NAME="tex2html416"
68  HREF="node14.html#SECTION00034300000000000000">2.4.3 What the ''./configure'' does</A>
69 <LI><A NAME="tex2html417"
70  HREF="node14.html#SECTION00034400000000000000">2.4.4 What the ''make'' does.</A>
71 <LI><A NAME="tex2html418"
72  HREF="node14.html#SECTION00034500000000000000">2.4.5 What the ''make install'' command does.</A>
73 </UL>
74 <!--End of Table of Child-Links-->
75 <HR>
76
77 <H2><A NAME="SECTION00034000000000000000">
78 2.4 Install Trouble-shooting</A>
79 </H2>
80
81 <P>
82
83 <H3><A NAME="SECTION00034100000000000000">
84 2.4.1 SDCC cannot find libraries or header files.</A>
85 </H3>
86
87 <P>
88 The default installation assumes the libraries and header files are
89 located at ``/usr/local/share/sdcc/lib'' and ``/usr/local/share/sdcc/include''.
90 An alternative is to specify these locations as compiler options like
91 this: <I><B>&#34;sdcc&nbsp;-L&nbsp;/usr/local/sdcc/lib/small&nbsp;-I&nbsp;/usr/local/sdcc/include&nbsp;test.c&#34;</B></I>.
92
93 <P>
94
95 <H3><A NAME="SECTION00034200000000000000">
96 2.4.2 SDCC does not compile correctly.</A>
97 </H3>
98
99 <P>
100 A thing to try is starting from scratch by unpacking the .tgz source
101 package again in an empty directory. Confure it again and build like:
102 <BR>
103
104 <BR>
105 <I><B>make 2SPMamp;&gt;1 | tee make.log</B></I>
106 <BR>
107
108 <BR>
109 After this you can review the make.log file to locate the problem.
110 Or a relevant part of this be attached to an email that could be helpful
111 when requesting help from the mailing list.
112
113 <P>
114
115 <H3><A NAME="SECTION00034300000000000000">
116 2.4.3 What the ''./configure'' does</A>
117 </H3>
118
119 <P>
120 The ''./configure'' command is a script that analyzes your system
121 and performs some configuration to ensure the source package compiles
122 on your system. It will take a few minutes to run, and will compile
123 a few tests to determine what compiler features are installed.
124
125 <P>
126
127 <H3><A NAME="SECTION00034400000000000000">
128 2.4.4 What the ''make'' does.</A>
129 </H3>
130
131 <P>
132 This runs the GNU make tool, which automatically compiles all the
133 source packages into the final installed binary executables.
134
135 <P>
136
137 <H3><A NAME="SECTION00034500000000000000">
138 2.4.5 What the ''make install'' command does.</A>
139 </H3>
140
141 <P>
142 This will install the compiler, other executables and libraries in
143 to the appropriate system directories. The default is to copy the
144 executables to /usr/local/bin and the libraries and header files to
145 /usr/local/share/sdcc/lib and /usr/local/share/sdcc/include.
146
147 <P>
148 <HR>
149 <!--Navigation Panel-->
150 <A NAME="tex2html412"
151  HREF="node15.html">
152 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next_motif.gif"></A> 
153 <A NAME="tex2html406"
154  HREF="node10.html">
155 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up_motif.gif"></A> 
156 <A NAME="tex2html400"
157  HREF="node13.html">
158 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="previous_motif.gif"></A> 
159 <A NAME="tex2html408"
160  HREF="node1.html">
161 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents_motif.gif"></A> 
162 <A NAME="tex2html410"
163  HREF="node61.html">
164 <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index_motif.gif"></A> 
165 <BR>
166 <B> Next:</B> <A NAME="tex2html413"
167  HREF="node15.html">2.5 Additional Information for</A>
168 <B> Up:</B> <A NAME="tex2html407"
169  HREF="node10.html">2. Installation</A>
170 <B> Previous:</B> <A NAME="tex2html401"
171  HREF="node13.html">2.3 Testing out the</A>
172  &nbsp <B>  <A NAME="tex2html409"
173  HREF="node1.html">Contents</A></B> 
174  &nbsp <B>  <A NAME="tex2html411"
175  HREF="node61.html">Index</A></B> 
176 <!--End of Navigation Panel-->
177 <ADDRESS>
178 <I>Johan Knol</I>
179 <BR><I>2001-07-13</I>
180 </ADDRESS>
181 </BODY>
182 </HTML>