Difference between revisions of "Building From Source"

From NST Wiki
Jump to navigationJump to search
(Roughing in an outline)
 
(Getting the NST Source Code)
Line 2: Line 2:
  
 
= Getting the NST Source Code =
 
= Getting the NST Source Code =
 +
 +
There are several ways to acquire the source code for '''NST''' developement (one can find an entire section related to this in the [http://nst.sourceforge.net/nst/docs/faq/index.html NST FAQ]).
 +
 +
For our purposes we will choose the ''anonymous CVS'' approach. This permits one to build a current snapshot of the '''NST''' distribution as it is being developed.
 +
 +
The following demonstrates how one can create a: ''nst'' sub-directory on a Fedora Core 6 based system, and then populate it with the current '''NST''' source code (NOTE: Just press the ''Enter'' key when prompted for the password as there is no password required for anonymous access):
 +
 +
<div class="screen">
 +
  <div class="screenTitle">''Checking Out The Current Source Code''</div>
 +
  <div class="userInput"><span class="prompt">[root@localhost ~]# </span>mkdir $HOME/nst</div>
 +
  <div class="userInput"><span class="prompt">[root@localhost ~]# </span>cd $HOME/nst</div>
 +
  <div class="userInput"><span class="prompt">[root@localhost nst]# </span>CVSROOT=":pserver:anonymous@nst.cvs.sourceforge.net:/cvsroot/nst"</div>
 +
  <div class="userInput"><span class="prompt">[root@localhost nst]# </span>export CVSROOT</div>
 +
  <div class="userInput"><span class="prompt">[root@localhost nst]# </span>cvs login</div>
 +
<pre class="computerOutput">
 +
Logging in to :pserver:anonymous@nst.cvs.sourceforge.net:2401/cvsroot/nst
 +
CVS password:
 +
</pre>
 +
  <div class="userInput"><span class="prompt">[root@localhost nst]# </span>cvs co .</div>
 +
<pre class="computerOutput">
 +
 +
  ... You should see file names streaming by in your
 +
      console window - it may take several moments to
 +
      download all of the source files ...
 +
 +
</pre>
 +
  <div class="userInput"><span class="prompt">[root@localhost nst]# </span></div>
 +
</div>
 +
 +
As time goes on, you may want to ''update'' your source files (the '''NST''' developers check in new code quite frequently). Use the following commands:
 +
 +
<div class="screen">
 +
  <div class="screenTitle">''Updating The Source Code''</div>
 +
  <div class="userInput"><span class="prompt">[root@localhost ~]# </span>cd $HOME/nst</div>
 +
  <div class="userInput"><span class="prompt">[root@localhost nst]# </span>CVSROOT=":pserver:anonymous@nst.cvs.sourceforge.net:/cvsroot/nst"</div>
 +
  <div class="userInput"><span class="prompt">[root@localhost nst]# </span>export CVSROOT</div>
 +
  <div class="userInput"><span class="prompt">[root@localhost nst]# </span>cvs update -Pd</div>
 +
<pre class="computerOutput">
 +
 +
  ... You should see directory names streaming by in your
 +
      console window as CVS searches for updated files ...
 +
 +
</pre>
 +
  <div class="userInput"><span class="prompt">[root@localhost nst]# </span></div>
 +
</div>
 +
 +
As setting the '''CVSROOT''' variable can be quite tedious, it is recommended that you include its definition in your: "'''~/.bashrc'''" file. Add the following lines to the end of: "'''~/.bashrc'''".
 +
 +
<div class="programListing">
 +
CVSROOT=":pserver:anonymous@nst.cvs.sourceforge.net:/cvsroot/nst";
 +
export CVSROOT;
 +
</div>
  
 
= Installing Packages =
 
= Installing Packages =

Revision as of 08:10, 3 August 2007

Preparing The Build Machine

Getting the NST Source Code

There are several ways to acquire the source code for NST developement (one can find an entire section related to this in the NST FAQ).

For our purposes we will choose the anonymous CVS approach. This permits one to build a current snapshot of the NST distribution as it is being developed.

The following demonstrates how one can create a: nst sub-directory on a Fedora Core 6 based system, and then populate it with the current NST source code (NOTE: Just press the Enter key when prompted for the password as there is no password required for anonymous access):

Checking Out The Current Source Code
[root@localhost ~]# mkdir $HOME/nst
[root@localhost ~]# cd $HOME/nst
[root@localhost nst]# CVSROOT=":pserver:anonymous@nst.cvs.sourceforge.net:/cvsroot/nst"
[root@localhost nst]# export CVSROOT
[root@localhost nst]# cvs login
Logging in to :pserver:anonymous@nst.cvs.sourceforge.net:2401/cvsroot/nst
CVS password:
[root@localhost nst]# cvs co .

   ... You should see file names streaming by in your
       console window - it may take several moments to
       download all of the source files ...

[root@localhost nst]#

As time goes on, you may want to update your source files (the NST developers check in new code quite frequently). Use the following commands:

Updating The Source Code
[root@localhost ~]# cd $HOME/nst
[root@localhost nst]# CVSROOT=":pserver:anonymous@nst.cvs.sourceforge.net:/cvsroot/nst"
[root@localhost nst]# export CVSROOT
[root@localhost nst]# cvs update -Pd

   ... You should see directory names streaming by in your
       console window as CVS searches for updated files ...

[root@localhost nst]#

As setting the CVSROOT variable can be quite tedious, it is recommended that you include its definition in your: "~/.bashrc" file. Add the following lines to the end of: "~/.bashrc".

CVSROOT=":pserver:anonymous@nst.cvs.sourceforge.net:/cvsroot/nst"; export CVSROOT;

Installing Packages

Building a ISO Image

Tweaking The Configure/Build Process

The Magic "${HOME}/.nst" Directory

"${HOME}/.nst/configure.sh"

"${HOME}/.nst/disable.txt"

"${HOME}/.nst/post_install.sh"