1 | $Id$
|
---|
2 |
|
---|
3 | 1. INTRODUCTION::
|
---|
4 |
|
---|
5 | This collection of scripts, known as jhalfs-X, strives to create
|
---|
6 | accurate makefiles from the Linux From Scratch book series XML files.
|
---|
7 | This software is an evolution of the original "jhalfs" code.
|
---|
8 |
|
---|
9 | The usage of this script assumes you have read and are familiar with
|
---|
10 | the book(s) and, therefore, the configuration variables found in config
|
---|
11 | files will have meaning to you. There are a number of command line switches
|
---|
12 | which, if used, will override the config file settings.
|
---|
13 |
|
---|
14 | NOTES::
|
---|
15 | *. The resulting Makefile takes considerable time to run to completion.
|
---|
16 | Lay in a supply of caffeine beverages.
|
---|
17 |
|
---|
18 | *. It is recommended that you temporarily unpack your linux kernel,
|
---|
19 | run <make menuconfig>, configure the kernal as per the book and save
|
---|
20 | the resulting .config file. This suggestion also applies to the
|
---|
21 | configuration of the uClibc package when building a HLFS system using
|
---|
22 | uClibc rather than glibc.
|
---|
23 |
|
---|
24 | 2. INSTALLATION::
|
---|
25 | No installation is required. System-wide installation is not allowed
|
---|
26 | for now.
|
---|
27 |
|
---|
28 | 3. CONFIGURATION FILES::
|
---|
29 | Each book in the LFS series has its own set of configurable parameters
|
---|
30 | as well as the common parameters file.
|
---|
31 |
|
---|
32 | 4. RUNNING::
|
---|
33 | The script master.sh cannot be invoked directly but only via the
|
---|
34 | supplied symlinks. After editing the config file for the project you wish
|
---|
35 | to build, run the script.
|
---|
36 |
|
---|
37 | The term <symlink> refers to the 1 of 4 package symlinks, lfs,hlfs,clfs,blfs.
|
---|
38 | Replace <symlink> with your choice of packages; i.e.: ./lfs
|
---|
39 |
|
---|
40 | ./<symlink>
|
---|
41 | Create a makefile based on the settings found in the config files.
|
---|
42 | You must enter the build partition/jhalfs directory and manually run <make>
|
---|
43 |
|
---|
44 | ./<symlink> -G
|
---|
45 | Download the packages and patches necessary to build <symlink>
|
---|
46 |
|
---|
47 | ./<symlink> -G -M
|
---|
48 | Download the packages, create and automatically run the Makefile
|
---|
49 |
|
---|
50 | ./<symlink> --help will give you a context sensitive list of command
|
---|
51 | line switches.
|
---|
52 |
|
---|
53 | 5. LAYOUT::
|
---|
54 |
|
---|
55 | blfs --+ /BLFS config ---+ /common/config
|
---|
56 | | master.sh -+ /common_functions
|
---|
57 | | xxxx.xsl -+ /makefile_functions
|
---|
58 | | /func_check_versions.sh
|
---|
59 | clfs --+ /CLFS config ---+ /func_validate_configs.sh
|
---|
60 | | master.sh -+
|
---|
61 | | xxxx.xsl -+
|
---|
62 | |
|
---|
63 | +--------------------- master.sh --------------->>>
|
---|
64 | +--README
|
---|
65 | |
|
---|
66 | hlfs --+ /HLFS config ---+
|
---|
67 | | master.sh -+
|
---|
68 | | xxxx.xsl -+
|
---|
69 | |
|
---|
70 | lfs --+ /LFS config ---+
|
---|
71 | master.sh -+
|
---|
72 | xxxx.xsl -+
|
---|
73 |
|
---|
74 |
|
---|
75 | 6. FAQ::
|
---|
76 | Q. "It doesn't work"
|
---|
77 | A. Yes it does..
|
---|
78 |
|
---|
79 | Q. "What is the function of the SRC_ARCHIVE variable
|
---|
80 | A. When the makefile runs it creates a local copy of the necessary packages
|
---|
81 | in BUILDDIR/sources by downloading the files. If the variable SRC_ARCHIVE
|
---|
82 | is defined the software will first look in this location for the file and,
|
---|
83 | if found, will copy it to BUILDDIR/sources. If the files are not found in
|
---|
84 | SRC_ARCHIVE _and_ you have write priv to the directory any downloaded
|
---|
85 | files will be mirrored there.
|
---|
86 |
|
---|
87 | Q. "Why have 2 copies of the files."
|
---|
88 | A. The package files must be visible during the chroot phase and this is a
|
---|
89 | simple and reliable method of doing so. This method also handles the CLFS
|
---|
90 | build method where the final build may be done on a separate machine.
|
---|
91 |
|
---|
92 | Authors:
|
---|
93 | George Boudreau
|
---|
94 | Manuel Canales Esparcia
|
---|
95 | Jeremy Huntwork
|
---|