143 lines
6.1 KiB
HTML
143 lines
6.1 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<title>Haiku Network Kit</title>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
|
<style type="text/css">
|
|
body
|
|
{
|
|
text-indent: 0in;
|
|
font-stretch: normal;
|
|
text-align: left;
|
|
font-weight: normal;
|
|
text-decoration: none;
|
|
font-variant: normal;
|
|
color: #000000;
|
|
font-size: 12pt;
|
|
font-style: normal;
|
|
widows: 2;
|
|
font-family: "Century Gothic", "Trebuchet MS", "Trebuchet", "Arial", "Helvetica";
|
|
background-color: #ffffff;
|
|
}
|
|
</style>
|
|
</head>
|
|
|
|
<body text=#000000 vLink=#0000a0 aLink=#0000ff link=#0000c0 bgColor=#ffffff>
|
|
<h1>Haiku Network Kit: Build & installation instructions</h1>
|
|
<p>Although the stack isn't quite finished, you can already test some basics. <br>
|
|
You'll have to get the code, build it, install it and run it. <br>
|
|
There isn't yet an easier way of getting the network stack, we're far from ready to release
|
|
a binary package. </p>
|
|
<p>So, if you accept your mission :</p>
|
|
|
|
<ol>
|
|
<li><b>Get familiar</b>
|
|
<p>First, go to <a href="http://open-beos.sourceforge.net/tms/team.php?id=7">team
|
|
web page</a>.<br>
|
|
Have a look around and see the current status of the stack. Have a glance
|
|
over the jobs, perhaps there's something that interests you?
|
|
</p>
|
|
</li>
|
|
|
|
<li><b>Furbish your tools</b>
|
|
<p>Get the <a href="http://open-beos.sourceforge.net/dev.php">build tools
|
|
suite</a>.<br>
|
|
You'll need CVS, JAM, the fixed LD linker
|
|
</p>
|
|
</li>
|
|
|
|
<li><b>May the code be with you</b>
|
|
<p>For dark reason, you should have the source code to build.<br>
|
|
So, you must checkout (anonymously) the full OBOS CVS:
|
|
<ul>
|
|
<li>Using CVS tool: follow the SourceForge <a href="http://sourceforge.net/cvs/?group_id=33869">information
|
|
on CVS</a>.
|
|
<li>If you don't want to fight with 'cvs' command line syntax, I recommand
|
|
you using <a href="http://www.bebits.com/app/3407">CheckItOut</a> tool, with these settings values:
|
|
<p>
|
|
<table border=0 cellspacing=4>
|
|
<tr><td align="right"><i>Project Name:</i></td><td><tt>open-beos</tt></td></tr>
|
|
<tr><td align="right"><i>Location:</i></td><td><tt>/path/to/where/you/want/to/store/OBOS/cvs/tree/locally</tt></td></tr>
|
|
<tr><td aligb="right"><i>Module Name:</i></td><td><tt>current</tt></td></tr>
|
|
</table>
|
|
</p>
|
|
|
|
<p>Only check <em>"Open Tracker once Completed"</em> option, if you
|
|
want. <br>
|
|
There, click "<em>Go</em>". Patience, it take time (and bandwidth!)</p>
|
|
|
|
<li>Other solution: download and unzip the current CVS <a href="http://cvs.sourceforge.net/cvstarballs/open-beos-cvsroot.tar.gz%20">snapshot
|
|
tarball</a> from SourceForge. <br>
|
|
Beware, it's huge, expect around 13MB.
|
|
</ul>
|
|
</p>
|
|
</li>
|
|
|
|
<li><b>Build</b>
|
|
<p>Building the whole Networking Kit stuffs was made easy by Jam rules.<BR>
|
|
Simply run these commands from a Terminal:</p>
|
|
<p>
|
|
<TABLE cellpadding=6 bgcolor=#E5E5E5 border=0>
|
|
<TR>
|
|
<TD><TT>$ cd /path/to/your/local/openbeos/current<BR>
|
|
$ ./configure<BR>
|
|
$ jam NetworkingKit</TT>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
</p>
|
|
<p>It should build all networking kit stuffs. If you encount any compile or
|
|
link errors, report it to the network team mailing list.</p>
|
|
</li>
|
|
|
|
<li><b>Install</b>
|
|
<p>There are basically two ways to install the networking kit. The first way is to do it manually, as is described below. The second way
|
|
is easier, as you won't have to do anything manually. If you want to use the second way, use the command <tt>jam install-networking</tt>.
|
|
This way you can skip all the manual steps described below. Please note that the Haiku provided utilities like ping, are located
|
|
under your local <tt>current/tests/kits/net/</tt>, where you can execute them as often as you like.</p>
|
|
<p>However, if you are the manual type of person, you can find the networking kit binaries now under your local <tt>current/distro/x86.R1/*</tt><br>
|
|
To install:
|
|
<ul>
|
|
<li>open your <tt>current/distro/x86.R1/beos/system/add-ons/kernel/drivers/bin</tt> folder<br>
|
|
</li>
|
|
<li>copy the <tt>net_stack_driver</tt> and <tt>net_server_driver</tt> into
|
|
your <tt>/boot/home/config/add-ons/kernel/drivers/bin</tt><br>
|
|
</li>
|
|
<li>create in your <tt>/boot/home/config/add-ons/kernel/drivers/dev/net</tt>
|
|
two symlinks <tt>"net_stack_driver"</tt> and <tt>"net_server_driver"</tt>,
|
|
targetting the ones in <tt>../../bin/net_{stack|server}_driver</tt> (create this 'dev/net'
|
|
directory if it don't exists yet)
|
|
</li>
|
|
<li>copy the whole <tt>current/distro/x86.R1/beos/system/add-ons/kernel/</tt>
|
|
network folder to your <tt>/boot/home/config/add-ons/kernel</tt><br>
|
|
<font color="red">BEWARE</font>: BONE users, you should disabled BONE own <tt>/boot/beos/system/add-ons/kernel/network</tt>
|
|
modules folder, as our stack try to load these modules too, which currently throw you into KDL heaven...<br>
|
|
So, rename this folder into anything that make sense, like <tt>network.bone</tt>. It'll disabled BONE after a reboot, which is required
|
|
anyway to test the OBOS stack...
|
|
</li>
|
|
<li>copy the <tt>libnet.so</tt> and <tt>libnetapi.so</tt> libraries from your <tt>current/distro/x86.R1/beos/system/lib</tt>
|
|
to a <tt>lib</tt> folder you should create into your <tt>current/distro/x86.R1/beos/bin</tt>, where the command line
|
|
OBOS networking kit apps are located.<br>
|
|
</li>
|
|
</ul>
|
|
</p>
|
|
</li>
|
|
|
|
<li><b>Test, test, test</b>
|
|
<p>You should free one of your /dev/net/*/0 network card (by disable in BONEyard,
|
|
or by disabling in Network for net_server) Then, run the OBOS ifconfig tool from
|
|
Terminal to see (and start) the stack detected interface(s) Last, play with
|
|
ping, arp, traceroute, etc. Also check out the details on the <a href="http://philippe.houdoin.free.fr/phil/beos/openbeos/network_kit/">stack
|
|
design.</a></p>
|
|
</li>
|
|
|
|
</ol>
|
|
|
|
<hr>
|
|
<h6>This document is written by <a href="mailto:philippe_[DOT]_houdoin_[AT]_free_[DOT]_fr">Philippe
|
|
Houdoin</a> and edited by <a href="mailto:n_[DOT]_reedijk_[AT]_planet_[DOT]_nl">Niels Reedijk</a>.
|
|
Last updated on July 30th, 2004</h6>
|
|
|
|
</body>
|
|
</html>
|