Linux From Scratch, Version 8.2

370 Pages·2018·1.728 MB·English

by  Gerard Beekmans, Bruce Dubbs

Linux From Scratch
Version 8.2
Created by Gerard Beekmans
Managing Editor: Bruce Dubbs
Linux From Scratch: Version 8.2
by Created by Gerard Beekmans and Managing Editor: Bruce Dubbs
Copyright © 1999-2018 Gerard Beekmans
Copyright © 1999-2018, Gerard Beekmans
All rights reserved.
This book is licensed under a Creative Commons License.
Computer instructions may be extracted from the book under the MIT License.
Linux® is a registered trademark of Linus Torvalds.
Linux From Scratch - Version 8.2
Table of Contents
Preface ......................................................................................................................................................................... viii
i. Foreword ............................................................................................................................................................ viii
ii. Audience ........................................................................................................................................................... viii
iii. LFS Target Architectures .................................................................................................................................. ix
iv. LFS and Standards ............................................................................................................................................. x
v. Rationale for Packages in the Book ................................................................................................................... xi
vi. Prerequisites ..................................................................................................................................................... xvi
vii. Typography .................................................................................................................................................... xvii
viii. Structure ...................................................................................................................................................... xviii
ix. Errata ............................................................................................................................................................. xviii
I. Introduction ................................................................................................................................................................. 1
1. Introduction .......................................................................................................................................................... 2
1.1. How to Build an LFS System .................................................................................................................... 2
1.2. What's new since the last release ............................................................................................................... 2
1.3. Changelog ................................................................................................................................................... 4
1.4. Resources .................................................................................................................................................... 8
1.5. Help ............................................................................................................................................................. 8
II. Preparing for the Build ........................................................................................................................................... 11
2. Preparing the Host System ................................................................................................................................ 12
2.1. Introduction ............................................................................................................................................... 12
2.2. Host System Requirements ....................................................................................................................... 12
2.3. Building LFS in Stages ............................................................................................................................ 15
2.4. Creating a New Partition .......................................................................................................................... 15
2.5. Creating a File System on the Partition ................................................................................................... 17
2.6. Setting The $LFS Variable ....................................................................................................................... 18
2.7. Mounting the New Partition ..................................................................................................................... 19
3. Packages and Patches ........................................................................................................................................ 20
3.1. Introduction ............................................................................................................................................... 20
3.2. All Packages ............................................................................................................................................. 20
3.3. Needed Patches ......................................................................................................................................... 28
4. Final Preparations .............................................................................................................................................. 30
4.1. Introduction ............................................................................................................................................... 30
4.2. Creating the $LFS/tools Directory ........................................................................................................... 30
4.3. Adding the LFS User ............................................................................................................................... 30
4.4. Setting Up the Environment ..................................................................................................................... 31
4.5. About SBUs .............................................................................................................................................. 32
4.6. About the Test Suites ............................................................................................................................... 33
5. Constructing a Temporary System .................................................................................................................... 35
5.1. Introduction ............................................................................................................................................... 35
5.2. Toolchain Technical Notes ....................................................................................................................... 35
5.3. General Compilation Instructions ............................................................................................................. 37
5.4. Binutils-2.30 - Pass 1 ............................................................................................................................... 38
5.5. GCC-7.3.0 - Pass 1 ................................................................................................................................... 40
5.6. Linux-4.15.3 API Headers ........................................................................................................................ 43
5.7. Glibc-2.27 ................................................................................................................................................. 44
iii
Linux From Scratch - Version 8.2
5.8. Libstdc++-7.3.0 ......................................................................................................................................... 47
5.9. Binutils-2.30 - Pass 2 ............................................................................................................................... 49
5.10. GCC-7.3.0 - Pass 2 ................................................................................................................................. 51
5.11. Tcl-core-8.6.8 .......................................................................................................................................... 54
5.12. Expect-5.45.4 .......................................................................................................................................... 56
5.13. DejaGNU-1.6.1 ....................................................................................................................................... 58
5.14. M4-1.4.18 ................................................................................................................................................ 59
5.15. Ncurses-6.1 .............................................................................................................................................. 60
5.16. Bash-4.4.18 ............................................................................................................................................. 61
5.17. Bison-3.0.4 .............................................................................................................................................. 62
5.18. Bzip2-1.0.6 .............................................................................................................................................. 63
5.19. Coreutils-8.29 .......................................................................................................................................... 64
5.20. Diffutils-3.6 ............................................................................................................................................. 65
5.21. File-5.32 .................................................................................................................................................. 66
5.22. Findutils-4.6.0 ......................................................................................................................................... 67
5.23. Gawk-4.2.0 .............................................................................................................................................. 68
5.24. Gettext-0.19.8.1 ....................................................................................................................................... 69
5.25. Grep-3.1 .................................................................................................................................................. 70
5.26. Gzip-1.9 ................................................................................................................................................... 71
5.27. Make-4.2.1 .............................................................................................................................................. 72
5.28. Patch-2.7.6 ............................................................................................................................................... 73
5.29. Perl-5.26.1 ............................................................................................................................................... 74
5.30. Sed-4.4 .................................................................................................................................................... 75
5.31. Tar-1.30 ................................................................................................................................................... 76
5.32. Texinfo-6.5 .............................................................................................................................................. 77
5.33. Util-linux-2.31.1 ...................................................................................................................................... 78
5.34. Xz-5.2.3 ................................................................................................................................................... 79
5.35. Stripping .................................................................................................................................................. 80
5.36. Changing Ownership .............................................................................................................................. 80
III. Building the LFS System ...................................................................................................................................... 81
6. Installing Basic System Software ...................................................................................................................... 82
6.1. Introduction ............................................................................................................................................... 82
6.2. Preparing Virtual Kernel File Systems .................................................................................................... 83
6.3. Package Management ............................................................................................................................... 84
6.4. Entering the Chroot Environment ............................................................................................................ 87
6.5. Creating Directories .................................................................................................................................. 88
6.6. Creating Essential Files and Symlinks ..................................................................................................... 88
6.7. Linux-4.15.3 API Headers ........................................................................................................................ 92
6.8. Man-pages-4.15 ......................................................................................................................................... 93
6.9. Glibc-2.27 ................................................................................................................................................. 94
6.10. Adjusting the Toolchain ....................................................................................................................... 101
6.11. Zlib-1.2.11 ............................................................................................................................................. 103
6.12. File-5.32 ................................................................................................................................................ 104
6.13. Readline-7.0 .......................................................................................................................................... 105
6.14. M4-1.4.18 .............................................................................................................................................. 107
6.15. Bc-1.07.1 ............................................................................................................................................... 108
6.16. Binutils-2.30 .......................................................................................................................................... 110
iv
Linux From Scratch - Version 8.2
6.17. GMP-6.1.2 ............................................................................................................................................. 113
6.18. MPFR-4.0.1 ........................................................................................................................................... 115
6.19. MPC-1.1.0 ............................................................................................................................................. 116
6.20. GCC-7.3.0 ............................................................................................................................................. 117
6.21. Bzip2-1.0.6 ............................................................................................................................................ 122
6.22. Pkg-config-0.29.2 .................................................................................................................................. 124
6.23. Ncurses-6.1 ............................................................................................................................................ 125
6.24. Attr-2.4.47 ............................................................................................................................................. 128
6.25. Acl-2.2.52 .............................................................................................................................................. 130
6.26. Libcap-2.25 ........................................................................................................................................... 132
6.27. Sed-4.4 .................................................................................................................................................. 133
6.28. Shadow-4.5 ............................................................................................................................................ 134
6.29. Psmisc-23.1 ........................................................................................................................................... 138
6.30. Iana-Etc-2.30 ......................................................................................................................................... 139
6.31. Bison-3.0.4 ............................................................................................................................................ 140
6.32. Flex-2.6.4 .............................................................................................................................................. 141
6.33. Grep-3.1 ................................................................................................................................................ 142
6.34. Bash-4.4.18 ........................................................................................................................................... 143
6.35. Libtool-2.4.6 .......................................................................................................................................... 145
6.36. GDBM-1.14.1 ....................................................................................................................................... 146
6.37. Gperf-3.1 ............................................................................................................................................... 147
6.38. Expat-2.2.5 ............................................................................................................................................ 148
6.39. Inetutils-1.9.4 ........................................................................................................................................ 149
6.40. Perl-5.26.1 ............................................................................................................................................. 151
6.41. XML::Parser-2.44 ................................................................................................................................. 154
6.42. Intltool-0.51.0 ........................................................................................................................................ 155
6.43. Autoconf-2.69 ....................................................................................................................................... 156
6.44. Automake-1.15.1 ................................................................................................................................... 158
6.45. Xz-5.2.3 ................................................................................................................................................. 159
6.46. Kmod-25 ............................................................................................................................................... 161
6.47. Gettext-0.19.8.1 ..................................................................................................................................... 163
6.48. Libelf 0.170 ........................................................................................................................................... 165
6.49. Libffi-3.2.1 ............................................................................................................................................ 166
6.50. OpenSSL-1.1.0g .................................................................................................................................... 167
6.51. Python-3.6.4 .......................................................................................................................................... 169
6.52. Ninja-1.8.2 ............................................................................................................................................. 171
6.53. Meson-0.44.0 ......................................................................................................................................... 172
6.54. Procps-ng-3.3.12 ................................................................................................................................... 173
6.55. E2fsprogs-1.43.9 ................................................................................................................................... 175
6.56. Coreutils-8.29 ........................................................................................................................................ 178
6.57. Check-0.12.0 ......................................................................................................................................... 183
6.58. Diffutils-3.6 ........................................................................................................................................... 184
6.59. Gawk-4.2.0 ............................................................................................................................................ 185
6.60. Findutils-4.6.0 ....................................................................................................................................... 186
6.61. Groff-1.22.3 ........................................................................................................................................... 188
6.62. GRUB-2.02 ........................................................................................................................................... 191
6.63. Less-530 ................................................................................................................................................ 193
v
Linux From Scratch - Version 8.2
6.64. Gzip-1.9 ................................................................................................................................................. 194
6.65. IPRoute2-4.15.0 .................................................................................................................................... 196
6.66. Kbd-2.0.4 ............................................................................................................................................... 198
6.67. Libpipeline-1.5.0 ................................................................................................................................... 200
6.68. Make-4.2.1 ............................................................................................................................................ 201
6.69. Patch-2.7.6 ............................................................................................................................................. 202
6.70. Sysklogd-1.5.1 ....................................................................................................................................... 203
6.71. Sysvinit-2.88dsf .................................................................................................................................... 205
6.72. Eudev-3.2.5 ........................................................................................................................................... 206
6.73. Util-linux-2.31.1 .................................................................................................................................... 208
6.74. Man-DB-2.8.1 ....................................................................................................................................... 213
6.75. Tar-1.30 ................................................................................................................................................. 216
6.76. Texinfo-6.5 ............................................................................................................................................ 217
6.77. Vim-8.0.586 .......................................................................................................................................... 219
6.78. About Debugging Symbols .................................................................................................................. 222
6.79. Stripping Again ..................................................................................................................................... 222
6.80. Cleaning Up .......................................................................................................................................... 224
7. System Configuration ...................................................................................................................................... 226
7.1. Introduction ............................................................................................................................................. 226
7.2. LFS-Bootscripts-20170626 ..................................................................................................................... 227
7.3. Overview of Device and Module Handling ........................................................................................... 229
7.4. Managing Devices .................................................................................................................................. 232
7.5. General Network Configuration ............................................................................................................. 235
7.6. System V Bootscript Usage and Configuration ..................................................................................... 237
7.7. The Bash Shell Startup Files .................................................................................................................. 247
7.8. Creating the /etc/inputrc File .................................................................................................................. 249
7.9. Creating the /etc/shells File .................................................................................................................... 251
8. Making the LFS System Bootable .................................................................................................................. 252
8.1. Introduction ............................................................................................................................................. 252
8.2. Creating the /etc/fstab File ...................................................................................................................... 252
8.3. Linux-4.15.3 ............................................................................................................................................ 254
8.4. Using GRUB to Set Up the Boot Process ............................................................................................. 258
9. The End ............................................................................................................................................................ 260
9.1. The End ................................................................................................................................................... 260
9.2. Get Counted ............................................................................................................................................ 260
9.3. Rebooting the System ............................................................................................................................. 260
9.4. What Now? ............................................................................................................................................. 262
IV. Appendices ........................................................................................................................................................... 263
A. Acronyms and Terms ..................................................................................................................................... 264
B. Acknowledgments ........................................................................................................................................... 267
C. Dependencies ................................................................................................................................................... 270
D. Boot and sysconfig scripts version-20170626 ............................................................................................... 281
D.1. /etc/rc.d/init.d/rc ...................................................................................................................................... 281
D.2. /lib/lsb/init-functions .............................................................................................................................. 285
D.3. /etc/rc.d/init.d/mountvirtfs ...................................................................................................................... 299
D.4. /etc/rc.d/init.d/modules ........................................................................................................................... 300
D.5. /etc/rc.d/init.d/udev ................................................................................................................................. 302
vi
Linux From Scratch - Version 8.2
D.6. /etc/rc.d/init.d/swap ................................................................................................................................ 303
D.7. /etc/rc.d/init.d/setclock ............................................................................................................................ 305
D.8. /etc/rc.d/init.d/checkfs ............................................................................................................................ 306
D.9. /etc/rc.d/init.d/mountfs ............................................................................................................................ 308
D.10. /etc/rc.d/init.d/udev_retry ..................................................................................................................... 310
D.11. /etc/rc.d/init.d/cleanfs ........................................................................................................................... 311
D.12. /etc/rc.d/init.d/console .......................................................................................................................... 313
D.13. /etc/rc.d/init.d/localnet .......................................................................................................................... 315
D.14. /etc/rc.d/init.d/sysctl .............................................................................................................................. 317
D.15. /etc/rc.d/init.d/sysklogd ........................................................................................................................ 318
D.16. /etc/rc.d/init.d/network .......................................................................................................................... 319
D.17. /etc/rc.d/init.d/sendsignals .................................................................................................................... 321
D.18. /etc/rc.d/init.d/reboot ............................................................................................................................ 322
D.19. /etc/rc.d/init.d/halt ................................................................................................................................. 323
D.20. /etc/rc.d/init.d/template ......................................................................................................................... 324
D.21. /etc/sysconfig/modules ......................................................................................................................... 325
D.22. /etc/sysconfig/createfiles ...................................................................................................................... 325
D.23. /etc/sysconfig/udev-retry ...................................................................................................................... 326
D.24. /sbin/ifup ............................................................................................................................................... 326
D.25. /sbin/ifdown .......................................................................................................................................... 329
D.26. /lib/services/ipv4-static ......................................................................................................................... 330
D.27. /lib/services/ipv4-static-route ............................................................................................................... 332
E. Udev configuration rules ................................................................................................................................. 335
E.1. 55-lfs.rules .............................................................................................................................................. 335
F. LFS Licenses ................................................................................................................................................... 336
F.1. Creative Commons License ................................................................................................................... 336
F.2. The MIT License .................................................................................................................................... 340
Index ........................................................................................................................................................................... 341
vii
Linux From Scratch - Version 8.2
Preface
Foreword
My journey to learn and better understand Linux began over a decade ago, back in 1998. I had just installed my first
Linux distribution and had quickly become intrigued with the whole concept and philosophy behind Linux.
There are always many ways to accomplish a single task. The same can be said about Linux distributions. A great many
have existed over the years. Some still exist, some have morphed into something else, yet others have been relegated
to our memories. They all do things differently to suit the needs of their target audience. Because so many different
ways to accomplish the same end goal exist, I began to realize I no longer had to be limited by any one implementation.
Prior to discovering Linux, we simply put up with issues in other Operating Systems as you had no choice. It was what
it was, whether you liked it or not. With Linux, the concept of choice began to emerge. If you didn't like something,
you were free, even encouraged, to change it.
I tried a number of distributions and could not decide on any one. They were great systems in their own right. It wasn't
a matter of right and wrong anymore. It had become a matter of personal taste. With all that choice available, it became
apparent that there would not be a single system that would be perfect for me. So I set out to create my own Linux
system that would fully conform to my personal preferences.
To truly make it my own system, I resolved to compile everything from source code instead of using pre-compiled
binary packages. This “perfect” Linux system would have the strengths of various systems without their perceived
weaknesses. At first, the idea was rather daunting. I remained committed to the idea that such a system could be built.
After sorting through issues such as circular dependencies and compile-time errors, I finally built a custom-built Linux
system. It was fully operational and perfectly usable like any of the other Linux systems out there at the time. But it
was my own creation. It was very satisfying to have put together such a system myself. The only thing better would
have been to create each piece of software myself. This was the next best thing.
As I shared my goals and experiences with other members of the Linux community, it became apparent that there was
a sustained interest in these ideas. It quickly became plain that such custom-built Linux systems serve not only to meet
user specific requirements, but also serve as an ideal learning opportunity for programmers and system administrators
to enhance their (existing) Linux skills. Out of this broadened interest, the Linux From Scratch Project was born.
This Linux From Scratch book is the central core around that project. It provides the background and instructions
necessary for you to design and build your own system. While this book provides a template that will result in a correctly
working system, you are free to alter the instructions to suit yourself, which is, in part, an important part of this project.
You remain in control; we just lend a helping hand to get you started on your own journey.
I sincerely hope you will have a great time working on your own Linux From Scratch system and enjoy the numerous
benefits of having a system that is truly your own.
--
Gerard Beekmans
[e-mail]
Audience
There are many reasons why you would want to read this book. One of the questions many people raise is, “why go
through all the hassle of manually building a Linux system from scratch when you can just download and install an
existing one?”
viii
Linux From Scratch - Version 8.2
One important reason for this project's existence is to help you learn how a Linux system works from the inside out.
Building an LFS system helps demonstrate what makes Linux tick, and how things work together and depend on each
other. One of the best things that this learning experience can provide is the ability to customize a Linux system to
suit your own unique needs.
Another key benefit of LFS is that it allows you to have more control over the system without relying on someone else's
Linux implementation. With LFS, you are in the driver's seat and dictate every aspect of the system.
LFS allows you to create very compact Linux systems. When installing regular distributions, you are often forced to
install a great many programs which are probably never used or understood. These programs waste resources. You
may argue that with today's hard drive and CPUs, such resources are no longer a consideration. Sometimes, however,
you are still constrained by size considerations if nothing else. Think about bootable CDs, USB sticks, and embedded
systems. Those are areas where LFS can be beneficial.
Another advantage of a custom built Linux system is security. By compiling the entire system from source code, you are
empowered to audit everything and apply all the security patches desired. It is no longer necessary to wait for somebody
else to compile binary packages that fix a security hole. Unless you examine the patch and implement it yourself, you
have no guarantee that the new binary package was built correctly and adequately fixes the problem.
The goal of Linux From Scratch is to build a complete and usable foundation-level system. If you do not wish to build
your own Linux system from scratch, you may nevertheless benefit from the information in this book.
There are too many other good reasons to build your own LFS system to list them all here. In the end, education is by
far the most powerful of reasons. As you continue in your LFS experience, you will discover the power that information
and knowledge truly bring.
LFS Target Architectures
The primary target architectures of LFS are the AMD/Intel x86 (32-bit) and x86_64 (64-bit) CPUs. On the other hand,
the instructions in this book are also known to work, with some modifications, with the Power PC and ARM CPUs.
To build a system that utilizes one of these CPUs, the main prerequisite, in addition to those on the next few pages, is
an existing Linux system such as an earlier LFS installation, Ubuntu, Red Hat/Fedora, SuSE, or other distribution that
targets the architecture that you have. Also note that a 32-bit distribution can be installed and used as a host system
on a 64-bit AMD/Intel computer.
Some other facts about 64-bit systems need to be added here. When compared to a 32-bit system, the sizes of executable
programs are slightly larger and the execution speeds of arbitrary programs are only slightly faster. For example, in a
test build of LFS-6.5 on a Core2Duo CPU based system, the following statistics were measured:
Architecture Build Time Build Size
32-bit 198.5 minutes 648 MB
64-bit 190.6 minutes 709 MB
As you can see, the 64-bit build is only 4% faster and is 9% larger than the 32-bit build. The gain from going to a 64-bit
system is relatively minimal. Of course, if you have more than 4GB of RAM or want to manipulate data that exceeds
4GB, the advantages of a 64-bit system are substantial.
Note
The above discussion is only appropriate when comparing builds on the same hardware. Modern 64-bit
systems are considerably faster than older 64-bit systems and the LFS authors recommend building on a 64-
bit system when given a choice.
ix
Linux From Scratch - Version 8.2
The default 64-bit build that results from LFS is considered a "pure" 64-bit system. That is, it supports 64-bit executables
only. Building a "multi-lib" system requires compiling many applications twice, once for a 32-bit system and once
for a 64-bit system. This is not directly supported in LFS because it would interfere with the educational objective
of providing the instructions needed for a straightforward base Linux system. You can refer to the Cross Linux From
Scratch project for this advanced topic.
LFS and Standards
The structure of LFS follows Linux standards as closely as possible. The primary standards are:
• POSIX.1-2008.
• Filesystem Hierarchy Standard (FHS) Version 3.0
• Linux Standard Base (LSB) Version 5.0
The LSB has four separate standards: Core, Desktop, Runtime Languages, and Imaging. In addition to generic
requirements there are also architecture specific requirements. There are also two areas for trial use: Gtk3 and
Graphics. LFS attempts to conform to the architectures discussed in the previous section.
Note
Many people do not agree with the requirements of the LSB. The main purpose of defining it is to ensure
that proprietary software will be able to be installed and run properly on a compliant system. Since LFS
is source based, the user has complete control over what packages are desired and many choose not to
install some packages that are specified by the LSB.
Creating a complete LFS system capable of passing the LSB certifications tests is possible, but not without many
additional packages that are beyond the scope of LFS. These additional packages have installation instructions in BLFS.
Packages supplied by LFS needed to satisfy the LSB Requirements
LSB Core: Bash, Bc, Binutils, Coreutils, Diffutils, File, Findutils, Gawk,
Grep, Gzip, M4, Man-DB, Ncurses, Procps, Psmisc, Sed,
Shadow, Tar, Util-linux, Zlib
LSB Desktop: None
LSB Runtime Languages: Perl
LSB Imaging: None
LSB Gtk3 and LSB Graphics (Trial Use): None
Packages supplied by BLFS needed to satisfy the LSB Requirements
LSB Core: At, Batch (a part of At), Cpio, Ed, Fcrontab, Initd-tools,
Lsb_release, NSPR, NSS, PAM, Pax, Sendmail (or Postfix or
Exim), time
LSB Desktop: Alsa, ATK, Cairo, Desktop-file-utils, Freetype, Fontconfig,
Gdk-pixbuf, Glib2, GTK+2, Icon-naming-utils, Libjpeg-turbo,
Libpng, Libtiff, Libxml2, MesaLib, Pango, Qt4, Xdg-utils,
Xorg
LSB Runtime Languages: Python, Libxml2, Libxslt
x