Compiling dslinux
From WiiLi
domvitr This guide was originally written by pepsiman.
Contents |
[edit] Prerequisites
[edit] Operating System
DSLinux can be compiled on any modern Linux distribution.
DSLinux can also be built on FreeBSD, NetBSD, and probably other BSDs. See this page for details.
If you are running Windows on your box you can get the VMWare Player and a preconfigured Debian or Ubuntu image to do the build. Note that the build may take quite a long time this way! The VMWare Player can be downloaded at http://www.vmware.com/products/player/ , a preconfigured Ubuntu image can be found at http://www.vmware.com/vmtn/appliances/ubuntu.html (password for sudo is ubuntu).
[edit] Tools and Libraries
You must install all of the tools and libraries mentioned below before you start to compile DSLinux.
You need the following standard development tools installed:
- make (GNU make)
- gcc (C compiler)
- binutils (assembler and linker)
They should be part of any major Linux distribution, and are often installed by default.
You also need ncurses development libraries on your system. They should be packaged with any major Linux distribution. The package is usually called either of
- ncurses-dev
- ncurses-devel
- libncurses-dev
- libncurses-devel
or something similar. It is called libncurses5-dev on Debian.
You also need zlib development libraries on your system. This should also be packaged with your distribution, and should be called
- zlib-dev
- zlib-devel
or something similar.
Also, make sure your system uses the GNU implementation of awk (commonly called gawk).
[edit] Getting the DSLinux Sources
The DSLinux sources are stored in a Subversion repository hosted by IN-Berlin. This repository is not for public use. Only developers can access it directly.
For everyone else, there is an anonymous Subversion (aka "anonsvn") repository.
[edit] Getting the source tree for the first time
[edit] Download a snapshot
This is the recommended method for getting the source tree for the first time. Download this tarball containing a recent anonsvn checkout: http://stsp.spline.de/dslinux/dslinux-snapshot.tar.gz
This file is a standard UNIX tar archive, zipped with gzip. Use this command on Linux/UNIX to extract it:
tar -zxvf dslinux-snapshot.tar.gz
It can also be opened with Winzip and probably other archivers on Windows.
Please contact Stefan Sperling if there are any problems with the snapshot.
[edit] Checking out from anonymous SVN ("anonsvn")
To get the DSLinux source tree from anonymous SVN (only do this if the snapshot is unavailable for some reason), run:
svn checkout svn://dslinux.spline.de/dslinux/trunk dslinux
Note that it may take a while for the svn checkout commands above to produce any output. The checkout will create a directory called "dslinux" containing the DSLinux source tree in the current working directory.
[edit] Updating your source tree
IMPORTANT: You have to read [http://www.dslinux.org/index.php?s=
