doc/BUILD

   1 # hdw - linux BUILD file
   2
   3 welcome to hdw-linux!
   4
   5 this is a short introduction on how to build hdw-linux. the latest stable
   6 release is supposed to build properly, well at least it works for me.
   7 please note that the scripts may fuckup your system, especially if you dont
   8 have any idea what this is all about after reading the files in ./doc.
   9 be warned, i mean it!
  10
  11 requirements:
  12 -------------
  13
  14 - working linux system, including gcc and other essential development tools
  15   (latest versions of automake, autoconf, m4 recommended)
  16 - wget, cvs
  17 - internet connection, or local server using -mirror option
  18 - kernel with devfs support for versions <= 0.2
  19 - a not used partition (900mb-3gb) for building. 250-900mb for sources
  20   depending on the selected target
  21 - x86 hardware for default users, any hardware for development ;)
  22
  23 what to do: (for the impatient)
  24 -------------------------------
  25
  26         build your distribution:
  27         ------------------------
  28
  29 - get the latest stable release of hdw-linux (much better: use cvs)
  30   from http://hackdaworld.dyndns.org/hdw-linux
  31
  32         example:
  33         mkdir -p /usr/src && cd /usr/src
  34         cvs -d:pserver:anonymous@cvs.hackdaworld.dyndns.org:/hdw-linux \
  35         co hdw-linux
  36         cd hdw-linux
  37
  38 - create a filesystem on the empty partition and mount it wherever you want to
  39
  40         example:
  41         mke2fs /dev/ide/host0/bus0/target0/lun0/part6
  42         mkdir -p /mnt/hdw-build
  43         mount /dev/ide/host0/bus0/target0/lun0/part6 /mnt/hdw-build
  44
  45 - edit ./Config: insert the above mountpoint to hdw_build_dir and select your
  46   prefered target
  47
  48         example:
  49
  50         vi Config
  51
  52         - modify the following line to read:
  53         export hdw_build_dir="/mnt/hdw-build"
  54
  55         - choose your target:
  56         export hdw_target="mobile"
  57
  58 - if you want to add targets/packages made by the hdw hackers & user community,
  59   run ./scripts/Update-Tree
  60   (this is optional - in fact it is maybe causing harm to your build!)
  61
  62         example:
  63         ./scripts/Update-Tree
  64
  65   (maybe you want to chose another target now in ./Config -- see 'ls ./targets')
  66
  67 - run ./scripts/Puzzle to create the target depending PKGS files
  68
  69         example:
  70         ./scripts/Puzzle
  71
  72 - run ./scripts/Download to fetch the sources needed to build that target,
  73   alternatively run ./scripts/Download -mirror <mirrorsite>
  74
  75         example:
  76         ./scripts/Download
  77         - after that, if you didnt get all the sources:
  78         ./scripts/Download -mirror http://we-have-no-mrror-by-now/hdw/
  79
  80 - you may now start building:
  81
  82         example:
  83          ./scripts/Build-Distro
  84
  85 - do not relax, do not get some drinks ... the build will fail and you have to
  86   hack the source! in case everything works fine, you may want to have binary
  87   packages of your builds. if not, skip the next part.
  88
  89 - create binaries:
  90
  91         example:
  92
  93         - create binary packages of all packages from the target
  94         ./scripts/Create-Binary all
  95
  96         - create single packages
  97         ./scripts/Create-Binary -package gcc
  98
  99 - your build is completed now, congrats!
 100
 101 for further information on how to install hdw-linux refer to the INSTALL file
 102 in ./doc directory.
 103
 104
 105 troubleshooting:
 106 ----------------
 107
 108 - visit: irc.hackdaworld.dyndns.org, #hackdaworld
 109 - visit: http://www.hackdaworld.dyndns.org/contents/mailing-list/
 110 - visit: www.linuxfromscratch.org, www.linuxdoc.org, www.rocklinux.org ;)
 111
 112
 113 regards, hackbard.