# hdw - linux BUILD file
-welcome to hdw-linux-0.3-dev
+welcome to hdw-linux!
-this is a short introduction on how to build hdw-linux. it is supposed to work
-at least for me. though this is dev and may hurt your baby, be warned. i mean
-it!
+this is a short introduction on how to build hdw-linux. the latest stable
+release is supposed to build properly, well at least it works for me.
+please note that the scripts may fuckup your system, especially if you dont
+have any idea what this is all about after reading the files in ./doc.
+be warned, i mean it!
requirements:
-------------
-- working linux system, including gcc and other essential development tools.
- ( latest versions of automake, autoconf, m4 recommended )
+- working linux system, including gcc and other essential development tools
+ (latest versions of automake, autoconf, m4 recommended)
- wget, cvs
- internet connection, or local server using -mirror option
-- devfs supporting kernel.
-- an empty partition (1.5 gb) for building, and 650 mb for sources.
- (the default target is smaller (900mb & ~200mb)
+- kernel with devfs support for versions <= 0.2
+- a not used partition (900mb-3gb) for building. 250-900mb for sources
+ depending on the selected target
+- x86 hardware for default users, any hardware for development ;)
what to do: (for the impatient)
-------------------------------
build your distribution:
------------------------
-- get the hdw-linux source from http://hackdaworld.dyndns.org/hdw-linux
+- get the latest stable release of hdw-linux (much better: use cvs)
+ from http://hackdaworld.dyndns.org/hdw-linux
example:
- mkdir -p /mnt/hdw && cd /mnt/hdw
- wget http://hackdaworld.dyndns.org/hdw-linux/hdw-linux-0.3-dev-*.tar.bz2
- tar xvfI hdw-linux-0.3-dev-*.tar.bz2
-
-- create a filesystem on the empty partition and mount it wherever you want to.
+ mkdir -p /usr/src && cd /usr/src
+ cvs -d:pserver:anonymous@cvs.hackdaworld.dyndns.org:/hdw-linux \
+ co hdw-linux
+ cd hdw-linux
+
+- create a filesystem on the empty partition and mount it wherever you want to
example:
mke2fs /dev/ide/host0/bus0/target0/lun0/part6
- mkdir /mnt/hdw/hdw-build
- mount /dev/ide/host0/bus0/target0/lun0/part6 /mnt/hdw/hdw-build
+ mkdir -p /mnt/hdw-build
+ mount /dev/ide/host0/bus0/target0/lun0/part6 /mnt/hdw-build
-- edit ./Config and insert the above mountpoint to hdw_build_dir and
- chose a target.
+- edit ./Config: insert the above mountpoint to hdw_build_dir and select your
+ prefered target
example:
- cd hdw-linux*
+
vi Config
- modify the following line to read:
- export hdw_build_dir="/mnt/hdw/hdw-build"
+ export hdw_build_dir="/mnt/hdw-build"
- choose your target:
export hdw_target="mobile"
-- if you want to add targets/packages made by the hdw hackers & users community
- run: (this is optional - in fact it is maybe causing harm to your build)
+- if you want to add targets/packages made by the hdw hackers & user community,
+ run ./scripts/Update-Tree
+ (this is optional - in fact it is maybe causing harm to your build!)
example:
./scripts/Update-Tree
(maybe you want to chose another target now in ./Config -- see 'ls ./targets')
-- run ./scripts/Puzzle to create the target depending PKGS files.
+- run ./scripts/Puzzle to create the target depending PKGS files
example:
./scripts/Puzzle
-- run ./scripts/Download to fetch the sources needed to build that target.
+- run ./scripts/Download to fetch the sources needed to build that target,
alternatively run ./scripts/Download -mirror <mirrorsite>
example:
- after that, if you didnt get all the sources:
./scripts/Download -mirror http://we-have-no-mrror-by-now/hdw/
-- make Build-Distro executable (only needed in some dev snapshots afaik)
-
- example:
- chmod 700 scripts/Build-Distro
-
- you may now start building:
- example ./scripts/Build-Distro > build.log. 2>&1;
- tail -f ./build.log
-
-
- optional: create binaries:
- --------------------------
+ example:
+ ./scripts/Build-Distro
- you have the possibility to create binary tar.bz2 packages. in that way
- you can easily install the created system even on other computers. it is
- also possible to install them on a running system, package installations
- via net, etc...
+- do not relax, do not get some drinks ... the build will fail and you have to
+ hack the source! in case everything works fine, you may want to have binary
+ packages of your builds. if not, skip the next part.
- create binaries:
./scripts/Create-Binary all
- create single packages
- ./scripts/Create-Binary -package gcc (-tar-name gcc2)
-
- (where arguments in the brackets are optional, default is package name)
-
- after that you can install the packages. you can even use a minimal
- rescue disk from another distribution (it should have tar and bzip
- on it) and install your hdw-linux distribution. in the future dev
- snapshots of hdw, a hdw rescue-disk pseudo package will be available.
-
-- install packages from another non hdw system:
-
- example:
- . ./misc/hdw-tools/hdw-get install /mnt/hdw-target gcc
+ ./scripts/Create-Binary -package gcc
+- your build is completed now, congrats!
for further information on how to install hdw-linux refer to the INSTALL file
-in doc/ directory.
+in ./doc directory.
troubleshooting:
- visit: www.linuxfromscratch.org, www.linuxdoc.org, www.rocklinux.org ;)
-regards hackbard
+regards, hackbard.
projects / hdw-linux / hdw-linux.git / commitdiff