]> hackdaworld.org Git - hdw-linux/hdw-linux.git/blob - doc/BUILD
implemented -create_cvs_list function
[hdw-linux/hdw-linux.git] / 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.