WebSVN – HelenOS-doc – Diff – /usrman/trunk/building/building.tex


\chapter{Building HelenOS}
\section{Requirements}
To build HelenOS, the following build tools must be installed:
\begin{itemize}
\item GCC 4.1.1 + binutils 2.16.1 cross compiler environment for target platform
\item python 2.3 or higher
\item GNU make
\item mkisofs
\end{itemize}
The GNU build environment is best downloaded, compiled and installed
automatically using the shell scripts located in the
{\em kernel/contrib/toolchain} directory.
 
\section{Building}
HelenOS features a user friendly configuration system. Once
a {\em make} command is run from the {\em boot/} directory, a
{\em dialog} driven application is started and the developer is asked several
questions regarding build configuration parameters. The answers are saved
in the file {\em Makefile.config} in the boot/, kernel/ and uspace/
directories and are automatically used for each subsequent build.
 
In order to modify the parameters, the user should change to the particular subsystem
directory and type {\em make config}. When the build configuration parameters
are changed, the whole subsystem should be completely rebuilt. The
configuration system offers to do this automatically for the user.
 

Subversion Repositories HelenOS-doc

(root)/usrman/trunk/building/building.tex – Rev 150 → 166

Rev 150		Rev 166
1	\chapter{Building HelenOS}	1	\chapter{Building HelenOS}
2	\section{Requirements}	2	\section{Requirements}
3	To build HelenOS, the following build tools must be installed:	3	To build HelenOS, the following build tools must be installed:
4	\begin{itemize}	4	\begin{itemize}
5	\item GCC 4.1.1 + binutils 2.16.1 cross compiler environment for target platform	5	\item GCC 4.1.1 + binutils 2.16.1 cross compiler environment for target platform
6	\item python 2.3 or higher	6	\item python 2.3 or higher
7	\item GNU make	7	\item GNU make
8	\item mkisofs	8	\item mkisofs
9	\end{itemize}	9	\end{itemize}
10	The GNU build environment is best downloaded, compiled and installed	10	The GNU build environment is best downloaded, compiled and installed
11	automatically using the shell scripts located in the	11	automatically using the shell scripts located in the
12	{\em kernel/contrib/toolchain} directory.	12	{\em kernel/contrib/toolchain} directory.
13		13
14	\section{Building}	14	\section{Building}
15	HelenOS features a user friendly configuration system. Once	15	HelenOS features a user friendly configuration system. Once
16	a {\em make} command is run from the {\em boot/} directory, a	16	a {\em make} command is run from the {\em boot/} directory, a
17	{\em dialog} driven application is started and the developer is asked several	17	{\em dialog} driven application is started and the developer is asked several
18	questions regarding build configuration parameters. The answers are saved	18	questions regarding build configuration parameters. The answers are saved
19	in the file {\em Makefile.config} in the boot/, kernel/ and uspace/	19	in the file {\em Makefile.config} in the boot/, kernel/ and uspace/
20	directories and are automatically used for each subsequent build.	20	directories and are automatically used for each subsequent build.
21		21
22	To change the parameters, the user should change to the particular subsystem	22	In order to modify the parameters, the user should change to the particular subsystem
23	directory and type {\em make config}. When the build configuration parameter	23	directory and type {\em make config}. When the build configuration parameters
24	are changed, the whole subsystem should be completely rebuilt. The	24	are changed, the whole subsystem should be completely rebuilt. The
25	configuration system offers user to do this automatically.	25	configuration system offers to do this automatically for the user.
26		26