source: README@ 4edbc92

experimental
Last change on this file since 4edbc92 was fed9756, checked in by Manuel Canales Esparcia <manuel@…>, 19 years ago

Merged r2481:2485 from trunk.

  • Property mode set to 100644
File size: 3.7 KB
RevLine 
[e58c70fd]1$Id$
2
31. INTRODUCTION::
4
[86e1d17]5 This collection of scripts, known as jhalfs-X, strives to create
[fcf5226]6 accurate makefiles from the Linux From Scratch book series XML files.
[854cde2]7 This software is an evolution of the original "jhalfs" code.
[e58c70fd]8
9 The usage of this script assumes you have read and are familiar with
[854cde2]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
[e58c70fd]12 which, if used, will override the config file settings.
13
14 NOTES::
[854cde2]15 *. The resulting Makefile takes considerable time to run to completion.
16 Lay in a supply of caffeine beverages.
[e58c70fd]17
[67e3bc3]18 *. It is recommended that you temporarily unpack your linux kernel,
[b051b90]19 run <make menuconfig>, configure the kernal as per the book and save
[854cde2]20 the resulting .config file. This suggestion also applies to the
[86e1d17]21 configuration of the uClibc package when building a HLFS system using
22 uClibc rather than glibc.
[e58c70fd]23
242. INSTALLATION::
[1a97861]25 No installation is required. System-wide installation is not allowed
[86e1d17]26 for now.
[e58c70fd]27
283. CONFIGURATION FILES::
[854cde2]29 Each book in the LFS series has its own set of configurable parameters
[8ca21dc]30 as well as the common parameters file.
[e58c70fd]31
324. RUNNING::
[854cde2]33 The script master.sh cannot be invoked directly but only via the
[b051b90]34 supplied symlinks. After editing the config file for the project you wish
[854cde2]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
[fcf5226]39
40 ./<symlink>
[67e3bc3]41 Create a makefile based on the settings found in the config files.
[854cde2]42 You must enter the build partition/jhalfs directory and manually run <make>
[fcf5226]43
[67e3bc3]44 ./<symlink> -G
[fcf5226]45 Download the packages and patches necessary to build <symlink>
[67e3bc3]46
[fcf5226]47 ./<symlink> -G -M
48 Download the packages, create and automatically run the Makefile
[67e3bc3]49
[8ca21dc]50 ./<symlink> --help will give you a context sensitive list of command
51 line switches.
[e58c70fd]52
535. LAYOUT::
54
[7b56cfc]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
[86e1d17]60 | master.sh -+
[7b56cfc]61 | xxxx.xsl -+
[86e1d17]62 |
63 +--------------------- master.sh --------------->>>
[7b56cfc]64 +--README
[86e1d17]65 |
[7b56cfc]66 hlfs --+ /HLFS config ---+
67 | master.sh -+
68 | xxxx.xsl -+
69 |
70 lfs --+ /LFS config ---+
71 master.sh -+
72 xxxx.xsl -+
[86e1d17]73
74
[e58c70fd]756. FAQ::
[7b56cfc]76 Q. "It doesn't work"
77 A. Yes it does..
78
[aaa4612]79 Q. "What is the function of the SRC_ARCHIVE variable
[fed9756]80 A. When then symlinked master.sh runs it creates a local copy of the
81 necessary packages in BUILDDIR/sources by downloading the files. If
82 the variable SRC_ARCHIVE is defined the software will first look in
83 this location for the file and, if found, will copy it to BUILDDIR/sources.
84 If the files are not found in SRC_ARCHIVE _and_ you have write priv to
85 the directory any downloaded files will be mirrored there.
[aaa4612]86
87 Q. "Why have 2 copies of the files."
[466b5cc]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.
[fcf5226]91
92Authors:
[67e3bc3]93 George Boudreau
[fcf5226]94 Manuel Canales Esparcia
[67e3bc3]95 Jeremy Huntwork
Note: See TracBrowser for help on using the repository browser.