<html>
<head>
<link rel="stylesheet" type="text/css" href="http://www.splint.org/splint.css" title="style1">
<title>Splint - Source Code Installation</title>
</head>
<body>
<table border="0" rules="none" bgcolor="#FFFFFF" width="95%" align=center cellpadding=0 cellspacing=0>
<tr>
<td colspan=2 bgcolor="#FFFFFF"></td>
</tr>
<tr>
<td colspan=2 bgcolor="#FFFFFF"></td>
</tr>
<tr>
<td colspan=2 bgcolor="#FFFFFF"></td>
</tr>
<tr>
<td colspan=2 bgcolor="#FFFFFF"></td>
</tr>
<tr>
<td colspan=2 bgcolor="#FFFFFF"></td>
</tr>
<tr>
<td colspan=2 bgcolor="#FFFFFF"></td>
</tr>
<tr>
<td>
<font color="darkblue" face="arial,helvetica"><a href="http://www.splint.org/"><b>Splint</b> - Secure Programming Lint</a><br></font>
</td>
<td align=right>
<font face="arial,helvetica,sans-serif"><font color="darkblue">
<font size=-1>
<a href="mailto:info@splint.org">info@splint.org</a></font>
</font></font>
</td>
</tr>
<tr>
<td colspan=2 bgcolor="darkblue"></td>
</tr>
<tr>
<td colspan=2 bgcolor="darkblue"></td>
</tr>
<tr>
<td colspan=2 bgcolor="white"></td>
</tr>
<tr>
<td colspan=2 bgcolor="slate"></td>
</tr>
<tr>
<td>
<font face="arial,helvetica,sans-serif" size=-1>
<a
href="http://www.splint.org/download.html">Download</a>
- 
<A
HREF="http://www.splint.org/documentation/">Documentation</a>
-
<a href="http://www.splint.org/manual/">Manual</a>
-
<a
href="http://www.splint.org/links.html">Links</a>
</font>
</td>
<td align=right>
<font face="arial,helvetica,sans-serif" size=-1>
<a
href="http://www.splint.org/bugs.html">Reporting
Bugs</a> -
<a
href="http://www.splint.org/lists.html">Mailing
Lists</a> &nbsp;&nbsp;&nbsp;&nbsp;
<a
href="http://www.splint.org/sponsors.html">Sponsors</a>
-
<a
href="http://www.splint.org/credits.html">Credits</a>
</font>
</td>
</tr>
</table>

<p>
<blockquote>


<body>
<center><h2>
Source Code Installation
</h2></center>
<p>

<p>
Splint should compile effortlessly on standard Unix systems, and with
a bit of effort on non-Unix platforms.  If you produce a port for a
non-Unix platform, please let <a
href="mailto:splint@cs.virginia.edu"><em>splint@cs.virginia.edu</em></a>
know.  <p>

<p>
To build Splint you need:
<ul>
<li> a (hopefully ANSI-conforming) C compiler.  GNU <tt>gcc</tt> is recommended,
but most modern C compilers should work.
<li> <tt>make</tt>, the GNU make utility. If you don't have <tt>make</tt> installed on your system, download it from <tt>ftp.gnu.org</tt>.
<li> standard Unix tools: <tt>gzip</tt>, <tt>tar</tt>
</ul>

<p>
Instructions:
<ol>
  
<li> 
Download
<a href="http://www.splint.org/downloads/splint-3.1.0.src.tgz"><em>http://www.splint.org/downloads/splint-3.1.0.tgz</em></a>.
 
</a> (the latest stable release).  
<p>
Copy this package to the directory where you want to build Spint.  When
the tar file is extracted, it will create a splint-3.1.0 subdirectory. 
<p>
<li><tt>tar xzf splint-3.1.0.src.tgz</tt> (extract files from the archive)
<p>
<li><tt>cd splint-3.1.0</tt> (enter the extracted directory)
<p>
<li><tt>configure</tt>
  <blockquote>
   This will create a Makefile with settings for your system.  Use
   <tt>configure --prefix=<em>directory</em></tt> if you want to install
   Splint in prefix directory <em>directory</em>. 
</blockquote>
<p>
<li><tt>make</tt> 
<blockquote>
GNU's make utility is required; it may be named
<tt>gmake</tt> or <tt>gnumake</tt> on your system.
   It is best to do this in an emacs shell or a buffered terminal,
   so you can scroll through the output.
<p>
This builds Splint.  While it is building, subscribe to the
lclint-announce mailing list by sending a message to <a
href="mailto:majordomo@virginia.edu"><em>majordomo@virginia.edu</em></a>
containing the body:
<pre>
     subscribe lclint-announce
     </pre>
<p>
If the build was successful, it then runs the test
suite.  You should see:
<blockquote>
<pre>
Testing splint 3.1.0...

Version Info:
Splint 3.1.0 --- 11 Feb 2002

Maintainer: splint-bug@splint.org

<em>... (about 100 lines of test output elided)</em>

Checking manual...
Checking tests2.2...
Checking tests2.4...
Checking tests2.5...
Checking db1...
Checking db2...
Checking db3...
</pre>
</blockquote>

Examine the test output. If there are errors, send a bug report to <a
href="mailto:splint-bug@cs.virginia.edu"><em>splint-bug@cs.virginia.edu</em></a>.
</blockquote>
<blockquote>
Note: If possible do not built splint in a directory under /usr/.  If the test suite is run in a directory under /usr/ for example /usr/src/, it will report errors even if Splint was built correctly.
</blockquote>
<p>
</ol>

The remaining steps are only necessary if you want to install the Splint
binary and libraries in a different directory (set when you ran
configure).
<p>
<blockquote>
<ol start = 6>

<li> <tt>make install</tt>

<li>Set environment variables:
<blockquote>
<tt>LARCH_PATH</tt> - path to search for splint libraries and
initializations files. If you are using the standard directories, this
should be <tt>.:<em>base-directory</em>/splint-3.1.0/lib</tt>.
<p>
<tt>LCLIMPORTDIR</tt> - directory containing lcl imports files. If you are using
the standard directories, this is <tt><em>base-directory</em>/splint-3.1.0/imports</tt>.
</blockquote>
Put the commands to set these variables (the actual commands will depend
on the shell you are using) in one of your initialization dotfiles
(usually <tt>~/.environment</tt>). 
<p>
Set up your <tt>PATH</tt> to include the directory containing
<tt>splint-3.1.0/bin/splint</tt>, or move the binary to a directory on
your command path.
<p>
</blockquote>

<p>
</blockquote>

<table border="0" rules="none" bgcolor="#FFFFFF" width="95%" align=center cellpadding=0 cellspacing=0>

<tr valign=top>
<td colspan=2 bgcolor="darkblue"></td>
<tr valign=top>
<td colspan=2 bgcolor="darkblue"></td>
<tr valign=top>
<td colspan=2 bgcolor="white"></td>
</tr>
<tr valign=top>
<td width=135 >
<a href="http://www.splint.org"><img src="http://www.splint.org/glowingwall-narrows.jpg"
width=132 height=65 border=0 alt=""></a>
</td>
<td>
<table cellpadding=0 cellspacing=0 width="100%">
<tr>
<td colspan=2 bgcolor="slate"></td>
</tr>
<tr>
<td>
<font color="darkblue" face="arial,helvetica"><a href="http://www.splint.org/"><b>Splint</b> - Secure Programming Lint</a></font>
</td>
<td align=right>
<font face="arial,helvetica,sans-serif"><font color="darkblue">
<font size=-1>
<a href="mailto:info@splint.org">info@splint.org</a></font>
</font></font>
</td>
</tr>

<tr>
<td>
<font face="arial,helvetica,sans-serif" size=-1>
<a
href="http://www.splint.org/download.html">Download</a>
- 
<A
HREF="http://www.splint.org/documentation/">Documentation</a>
-
<a href="http://www.splint.org/manual/">Manual</a>
-
<a
href="http://www.splint.org/links.html">Links</a><br>

<a
href="http://www.splint.org/source.html">Source</a>
- 
<A
HREF="http://www.splint.org/linux.html">Linux</a>
-
<a href="http://www.splint.org/pubs.html">Publications</a>
-
<a
href="http://www.splint.org/talks.html">Talks</a><br>

</font>

</td>
<td align=right valign=top>

<font face="arial,helvetica,sans-serif" size=-1>
<a
href="http://www.splint.org/bugs.html">Reporting
Bugs</a> -
<a
href="http://www.splint.org/lists.html">Mailing
Lists</a> &nbsp;&nbsp;<IMG src="http://sourceforge.net/sflogo.php?group_id=9538" width="0" height="0" alt="">

&nbsp;&nbsp;
<a
href="http://www.splint.org/sponsors.html">Sponsors</a>
-
<a
href="http://www.splint.org/credits.html">Credits</a>
</font>
</td>
</tr>

</table>

</td>
</tr>
</table>

</body>
</html>











