doc/BUILD

   1 # hdw - linux BUILD file
   2
   3 welcome to hdw-linux-0.3-dev
   4
   5 this is a short introduction on how to build hdw-linux. it is supposed to work
   6 at least for me. though this is dev and may hurt your baby, be warned. i mean
   7 it!
   8
   9 requirements:
  10 -------------
  11
  12 - working linux system, including gcc and other essential development tools.
  13   ( latest versions of automake, autoconf, m4 recommended )
  14 - wget, cvs
  15 - internet connection, or local server using -mirror option
  16 - devfs supporting kernel.
  17 - an empty partition (1.5 gb) for building, and 650 mb for sources.
  18   (the default target is smaller (900mb & ~200mb)
  19
  20 what to do: (for the impatient)
  21 -------------------------------
  22
  23         build your distribution:
  24         ------------------------
  25
  26 - get the hdw-linux source from http://hackdaworld.dyndns.org/hdw-linux
  27
  28         example:
  29         mkdir -p /mnt/hdw && cd /mnt/hdw
  30         wget http://hackdaworld.dyndns.org/hdw-linux/hdw-linux-0.3-dev-*.tar.bz2
  31         tar xvfI hdw-linux-0.3-dev-*.tar.bz2
  32
  33 - create a filesystem on the empty partition and mount it wherever you want to.
  34
  35         example:
  36         mke2fs /dev/ide/host0/bus0/target0/lun0/part6
  37         mkdir /mnt/hdw/hdw-build
  38         mount /dev/ide/host0/bus0/target0/lun0/part6 /mnt/hdw/hdw-build
  39
  40 - edit ./Config and insert the above mountpoint to hdw_build_dir and
  41   chose a target.
  42
  43         example:
  44         cd hdw-linux*
  45         vi Config
  46
  47         - modify the following line to read:
  48         export hdw_build_dir="/mnt/hdw/hdw-build"
  49
  50         - choose your target:
  51         export hdw_target="mobile"
  52
  53 - if you want to add targets/packages made by the hdw hackers & users community
  54   run: (this is optional - in fact it is maybe causing harm to your build)
  55
  56         example:
  57         ./scripts/Update-Tree
  58
  59   (maybe you want to chose another target now in ./Config -- see 'ls ./targets')
  60
  61 - run ./scripts/Puzzle to create the target depending PKGS files.
  62
  63         example:
  64         ./scripts/Puzzle
  65
  66 - run ./scripts/Download to fetch the sources needed to build that target.
  67   alternatively run ./scripts/Download -mirror <mirrorsite>
  68
  69         example:
  70         ./scripts/Download
  71         - after that, if you didnt get all the sources:
  72         ./scripts/Download -mirror http://we-have-no-mrror-by-now/hdw/
  73
  74 - make Build-Distro executable (only needed in some dev snapshots afaik)
  75
  76         example:
  77         chmod 700 scripts/Build-Distro
  78
  79 - you may now start building:
  80
  81         example ./scripts/Build-Distro > build.log. 2>&1;
  82         tail -f ./build.log
  83
  84
  85         optional: create binaries:
  86         --------------------------
  87
  88         you have the possibility  to create binary tar.bz2 packages. in that way
  89         you can easily install the created system even on other computers. it is
  90         also possible to install them on a running system, package installations
  91         via net, etc...
  92
  93 - create binaries:
  94
  95         example:
  96
  97         - create binary packages of all packages from the target
  98         ./scripts/Create-Binary all
  99
 100         - create single packages
 101         ./scripts/Create-Binary -package gcc (-tar-name gcc2)
 102
 103   (where arguments in the brackets are optional, default is package name)
 104
 105         after that you can install the packages. you can even use a minimal
 106         rescue disk from another distribution (it should have tar and bzip
 107         on it) and install your hdw-linux distribution. in the future dev
 108         snapshots of hdw, a hdw rescue-disk pseudo package will be available.
 109
 110 - install packages from another non hdw system:
 111
 112         example:
 113         . ./misc/hdw-tools/hdw-get install /mnt/hdw-target gcc
 114
 115
 116 for further information on how to install hdw-linux refer to the INSTALL file
 117 in doc/ directory.
 118
 119
 120 troubleshooting:
 121 ----------------
 122
 123 - visit: irc.hackdaworld.dyndns.org, #hackdaworld
 124 - visit: http://www.hackdaworld.dyndns.org/contents/mailing-list/
 125 - visit: www.linuxfromscratch.org, www.linuxdoc.org, www.rocklinux.org ;)
 126
 127
 128 regards hackbard