Devil-Linux Developer Documentation

$Revision: 1.3 $ $Date: 2001/12/24 03:27:22 $ Dave Roper, Heiko Zuerker

This document is still in a very early state and is missing a lot of information.


Contents

Introduction

This document describes how to create a Devil-Linux version from the source code and how to write extensions.

The main web site for Devil Linux is at: http://www.devil-linux.org and the Sourceforge site for project files is at: http://sourceforge.net/project/devil-linux .

Preperation

Downloading the necessary files

The first step is to download a file that contains a compressed Linux filesystem. The project uses a filesystem created with from the Linux From Scratch project. This system is used, to ensure the correct working environment.

Goto ftp://ftp.de.devil-linux.org/src and download the file that starts with lfssystem.

Download all files from the subdirectory of version you want to build, at the time this document was written, it is 0.5beta.

Unpack the lfssystem file in a directory, such as /usr/src or any other directory you prefer.

Copy the cvs files to /usr/src/lfssystem/data, and copy the source files to /usr/src/lfssystem/data/build/src .

Make your life easier

Create an alias in your /.bashrc file:

alias cr='chroot /usr/src/lfssystem /usr/bin/env -i HOME=/root TERM=$TERM /bin/bash -login '

You will need this command every time you create a DL system.

Rename /usr/scr/lfssystem/usr/include/linux to /usr/scr/lfssystem/usr/include/linux2

All files can be edited within your normal environment.

Goto the directory /usr/src/lfssystem/data/build .

Makefile commands

make unpack

This unpacks all source files.

Details

All files in build/src will be unpacked to build/tmp .

make menuconfig

A menu will appear that is used to select the packages to be compiled. Save the desired results when finished.

Details

The script looks in the directory build/scripts/install and gets all the filenames. The order of the files is defined by the leading number.

The name after the number is exactly the same name as the script in the build/script directory.

Each script is called with the parameter 'config'.

The configuration is saved in the file build/.config

make build

This will compile all source code, which could take several hours, depending on your system.

On my Notebook with a 1.2 GHz CPU, a fast Harddisk and 512 MB RAM it takes over 1 hour.

Details

The script looks in the directory build/scripts/build and gets all the filenames. The order of the files is defined by the leading number.

The name after the number is exactly the same name as the script in the build/script directory.

Each script is called with the parameter 'build'.

make install

This will install all the files in build/tmp/ISO and build/tmp/etc

Details

The script looks in the directory build/scripts/install and gets all the filenames. The order of the files is defined by the leading number.

The name after the number is exactly the same name as the script in the build/script directory.

Each script is called with the parameter 'install'.

make iso

This will generate a final ISO image called bootcd.iso in build/tmp.

Details

The script looks in the directory build/scripts/iso and gets all the filenames. The order of the files is defined by the leading number.

The name after the number is exactly the same name as the script in the build/script directory.

Each script is called with the parameter 'iso'.

make dist

Creates all the necessary files to distribute DL in the directory build/dist.

make clean

Cleans everything which was created by 'make install'

Details

Deletes the directory build/tmp/ISO and build/tmp/etc

make mrproper

Cleans everything created by 'make build' and 'make install'.

Details

Deletes the complete build/tmp directory.

left over

The etc.tar.gz file needed for the floppy disc is made from the files in the /usr/src/lfssystem/data/build/tmp/etc directory. Make the etc.tar.gz file with the command tar -czf etc.tar.gz Programs can be added to the Devil Linux CD not included with the base package. Directions for this will be covered in the next revision of this how-to guide.

If you write extensions to the Devil Linux scripts, routines, etc, please send them to the project team, so it can be included in the official release.

About this document ...

Devil-Linux Developer Documentation

This document was generated using the LaTeX2HTML translator Version 2K.1beta (1.48)

Copyright © 1993, 1994, 1995, 1996, Nikos Drakos, Computer Based Learning Unit, University of Leeds.
Copyright © 1997, 1998, 1999, Ross Moore, Mathematics Department, Macquarie University, Sydney.

The command line arguments were:
latex2html -no_footnode -no_navigation -html_version 3.2 -split 1 -no_subdir DEVELOPER.tex

The translation was initiated by root on 2003-01-27


root 2003-01-27