Commit Graph

486 Commits

Author SHA1 Message Date
David Bryant
ebecd08c05 Corrected grammar, spelling, and idiom in chapter 7. 2022-11-16 13:16:35 -06:00
Xi Ruoyao
2bf32ffa3a
kernfs: "device nodes" are in /dev, not "devices"
You cannot throw a NVIDIA GTX 690 into /dev :).
2022-10-01 15:27:19 +08:00
Xi Ruoyao
00588180ee
kernfs: modernize the explanation for bind mounting /dev
If you are using a "modern" distro (with devtmpfs and a modern udev
implementation), a bind mounting is actually not needed because you can
mount devtmpfs anyway.  The only reason for bind mounting is to be
compatible with old host distros where /dev is a directory containing
many static device nodes, or is a tmpfs (not same as devtmpfs) popluated
by bootscript or an old udev (modern udev implementations, including
eudev and systemd-udev used by LFS, strictly requires a devtmpfs on
/dev).

So update the explanation to match the status quo.
2022-10-01 15:14:22 +08:00
Xi Ruoyao
a8f3814a7b
kernfs: technically, they are not needed for chroot
Chroot command itself does not require kernel VFS mounted. You can mount
/proc, /sys, and /run after entering chroot with
"mount -v -t proc proc /proc" etc.  For /dev, if the host kernel
supports devtmpfs, you can also mount /dev in chroot with
"mount -v -t devtmpfs devtmpfs /dev".  Even if the host does not support
devtmpfs, it's still possible to mount /proc in chroot, then use
"mount --bind /proc/1/dev /dev".

It's just LFS editors decide to mount them before chroot.  So reword
some untrue assertions.
2022-10-01 13:35:59 +08:00
David Bryant
36cb08fbf0 Tweaked English idiom and edited for style. 2022-09-30 15:49:41 -05:00
David Bryant
29526d35ef Made grammatical corrections and stylistic changes to chapter 7.3.
Added clarification; the virtual file systems expose certain information
to programs in user space; chroot won't work without them.
2022-09-30 12:27:55 -05:00
David Bryant
52ddd6c033 Clarify some things in Intro to chroot; simplify some verbiage. 2022-09-30 11:24:14 -05:00
Bruce Dubbs
01ecba7b30 Fix unmounting instruction in 7.13.2. Backup 2022-09-22 10:44:47 -05:00
Bruce Dubbs
16cd09633e Adjust instructions for /dev/shm when creating virtual filesystems.
Some host create /dev/shm as a tmpfs.  Some have is as
a symlink to a location in another directory.  This
change handles both cases.

The change to the sysV bootscripts now creates /dev/shm
as a separate tmpfs from /run.  This makes LFS sysV and
systemd versions treat /dev/shm the same.
2022-09-20 12:20:58 -05:00
Xi Ruoyao
3d65730e22
cleanup: rephrase description for .la removal
Don't emphasis "static library" at all, to prevent anyone from thinking
"I need to use static libraries so I'll keep these .la files".  And warn
that .la files are known to break BLFS packages.
2022-09-19 14:12:17 +08:00
Xi Ruoyao
2e9e5b43c5
add <literal> to make commands for temp /etc/hosts and final /etc/pip3.conf looking better 2022-09-14 11:52:01 +08:00
Xi Ruoyao
fb66c4c583
some http -> https changes 2022-09-05 09:52:05 +08:00
Xi Ruoyao
b5a316b060
texinfo: remove unneeded sed
It works out of box with glibc-2.35.  I think this issue is already
fixed at glibc side, by the commit:

commit 0b5ca7c3e551e5502f3be3b06453324fe8604e82
Author: Paul Eggert <eggert@cs.ucla.edu>
Date:   Tue Sep 21 07:47:45 2021 -0700

    regex: copy back from Gnulib

    Copy regex-related files back from Gnulib, to fix a problem with
    static checking of regex calls noted by Martin Sebor.  This merges the
    following changes:

    * New macro __attribute_nonnull__ in misc/sys/cdefs.h, for use later
    when copying other files back from Gnulib.

    ... ... (unrelated things trimmed)
2022-07-02 11:31:13 +08:00
Xi Ruoyao
9b73f94474
revise the note about "already created" directories
Q: Why not just move the note after the creation of root-level
directories?
A: Root-level directories may be already created as well: if a
root-level directory is a mount point it should have been created in
section "Mounting the New Partition".

Reported-by: Vladimir Pertsev <info@linuxfromscratch.ru>
2022-05-30 18:30:50 +08:00
Xi Ruoyao
7c862eac22
GID 5 (for tty) is also special 2022-05-02 16:02:10 +08:00
Xi Ruoyao
0414633793
minor fix for 65534 explanation: it is also used for "unmapped" groups 2022-05-02 15:42:52 +08:00
Xi Ruoyao
8469f02115
make /etc/group sorted by GID 2022-05-02 15:39:45 +08:00
Xi Ruoyao
14de4552bf
explain the usage of 65534 2022-05-02 15:36:03 +08:00
Bruce Dubbs
8cab730a5b Merge branch 'trunk' of git.linuxfromscratch.org:lfs into trunk 2022-04-30 09:40:46 -05:00
Bruce Dubbs
813ab55675 Package updates and nobody uid change.
Change nobody/nogroup uid/git to 65534.
Update to meson-0.62.1.
Update to libpipeline-1.5.6.
Update to elfutils-0.187.
Update to Jinja2-3.1.2.
Update to vim-8.2.4814.
Update to sysvinit-3.03.
Update to linux-5.17.5.
Update to gcc-11.3.0.
Update to coreutils-9.1.
Update to bc-5.2.4.
2022-04-30 09:38:48 -05:00
Xi Ruoyao
e286d8db14
decorate the references to root and lfs user
The references already correctly decorated are not changed because "if
it's not broken don't fix it".
2022-04-21 14:12:43 +08:00
Bruce Dubbs
bcb20b4701 Speling 2022-03-24 12:11:57 -05:00
Bruce Dubbs
51a5442f16 Fix pdf presentation issues and some misc issues
Change pdf generation to use 9 point fonts for monospace
sections of the book.  Otherwise texy overflows, especially
in Chapter 8, Stripping.

Fix a minor spacing issue in the stripping issue.

MAke a minor grammar fix in creatingfiles.xml.
2022-03-14 13:08:40 -05:00
Xi Ruoyao
ac47b252fe
kernfs: "Udev" -> "the kernel and Udev"
devtmpfs already contains many device nodes created by the kernel once
it's mounted, and Udev creates or renames nodes based on kernel work.
2022-03-08 15:10:04 +08:00
Xi Ruoyao
940c8495ae
kernfs: remove static node creation, and update the text
This is to match the "new" way of device handling with devtmpfs (already
widely used in recent ten years).

In a normal booting process, the kernel mounts devtmpfs at very early
stage.  So the static nodes won't be used at all.  The only situation
where the kernel can't mount devtmpfs is "/dev is missing", but it means
those two static nodes can't exist anyway, and a normal LFS system
(without initramfs) won't boot in such a bad situation.

Removing static /dev/console and /dev/null may cause trouble for those
people or scripts chroot into LFS tree without mounting devtmpfs.  But
entering a chroot with only console and null in /dev is already
problematic.  For a reference, If a systemd service is started with
PrivateDevices=true, systemd will create 18 nodes and symlinks to form a
"minimal" /dev.
2022-03-08 01:25:06 +08:00
Xi Ruoyao
459d4936ae
fix GCC PR100017 and enable libstdc++ for pass 2
This is the issue preventing us from cross-compiling libstdc++ in
Chapter 6.  By fixing this issue we can remove a seperate pass 2 for
libstdc++ and simplify the instruction.

The upstream fix will be released in 11.3 and 12.0, so we can remove the
first sed upgrading gcc next time.
2022-02-27 23:36:55 +08:00
Bruce Dubbs
9904ecb1de Spelling/Typos 2022-02-18 14:49:40 -06:00
Bruce Dubbs
8dd179b044 Fix typos in glibc and for systemd-oom group syntax 2022-02-15 13:22:46 -06:00
Xi Ruoyao
0079acc87d
systemd: remove unneeded group "systemd-bus-proxy" 2022-02-05 22:16:25 +08:00
Xi Ruoyao
490dc15317
remove "+h" in bash commands in chroot (#4998)
In the new cross-compilation approach, the $PATH in chroot does not
contain '/tools/bin'.  So "+h" is useless in chroot as the newly
installed tools always replace the temporary counterpart at the same
location.

"+h" in chapter4/settingenviron.xml is kept deliberately.  Currently
$LFS/tools/bin only contains programs prefixed with
"x86_64-lfs-linux-gnu-", and it's highly unlikely that any distro will
ever ship a program named with such prefix.  So it may seems that we can
remove this "+h" as well.  However, the situation may change in future
and we can take this oppertunity to teach the advantage and disvantage
of bash hash feature.
2022-02-05 20:48:27 +08:00
Douglas R. Reno
0a75d62658 Minor tweaks to systemd 2022-02-04 19:54:13 -06:00
Pierre Labastie
7fba0753d1 Add a note telling to reenter chroot after making a backup 2022-01-09 19:18:24 +01:00
Pierre Labastie
095286b709 Revert the change /bin/bash->/usr/bin/bash
We are not sure what the interaction with /etc/shells is...
2021-11-02 14:23:41 +01:00
Bruce Dubbs
1f201845a3 Package updates
Update to gawk-5.1.1.
Update to meson-0.60.0.
Update to libcap-2.60.
Update to gdbm-1.22.
Update to file-5.41.
Update to linux-5.14.15.
Update to iana-etc-20211025.
Update to tzdata-2021e.

Change /bin to /usr/bin in passwd, and revisedchroot.
Fix systemd for new meson.
2021-10-31 14:00:21 -05:00
Pierre Labastie
2198b5efa0 Remove eol spaces not caught by merge 2021-09-22 23:23:06 +02:00
Pierre Labastie
784fdaed25 Remove all versiond entities 2021-09-22 23:17:28 +02:00
Pierre Labastie
9ee05b53be Remove merge conflicts marks in chapter07/cleanup.xml 2021-09-07 23:25:03 +02:00
Pierre Labastie
c6f58f47bd Merge branch 'trunk' of git.linuxfromscratch.org:lfs into trunk 2021-09-07 22:40:16 +02:00
Pierre Labastie
2c8fdfc165 Remove spaces at end o lines - chapter07 2021-09-07 22:35:55 +02:00
Bruce Dubbs
beb80e291d Update text in Chapter 7 Backup/Restore sections
Patch by Kevin Buckley.
Also made minor clarification to umount commands.
2021-09-06 09:32:47 -05:00
Bruce Dubbs
305c97068f Minor text changes 2021-09-03 19:43:45 -05:00
Xi Ruoyao
c92c9ab312
temp texinfo: remove outdated note about TestXS_la-TestXS.lo 2021-08-27 02:55:49 +08:00
Xi Ruoyao
efbd8873ac
chapter07: tcl/expect/dejagnu are now in chapter08 2021-08-25 13:13:32 +08:00
Pierre Labastie
b649e6b6d8 Typo (double "the") Spotted by Rainer Fiebig 2021-08-21 08:59:51 +02:00
Bruce Dubbs
8a269ec27e Touch up cleanup commands in Chapter 8
We moved the rm /tools from Chapter 8 to Chapter 7.
Some minor wording changes and file renaming.
2021-08-12 16:03:35 -05:00
Bruce Dubbs
02b26317cb Rework cleaning up section of Chapter 7
Renamed chapter07/stripping.xml to chapter07/cleanup.xml

Removed stripping from the end of Chapter 7.  We suggest a
10 GB or larger partition in Section 2.4 - Creating a New Partition
and the space used before cleaning up is only 3 GB.  Stripping
would free up about 300 MB more, but these files will soon be
overwritten anyway.

Remove /tools here to save about 1 GB.

General reorginization and rewording.

Chapter 8 stripping still needs to be updated after this change.
2021-08-12 15:33:11 -05:00
Bruce Dubbs
6a123d054e Merge branch 'trunk' of git.linuxfromscratch.org:lfs into trunk 2021-08-03 21:46:44 -05:00
Bruce Dubbs
d04ce158fe Wording 2021-08-03 21:45:54 -05:00
Bruce Dubbs
c649743dd6 Clarify chapter 7 stripping and backup
In chapter 7 we do not need to unmount file systems to strip binaries.
Move unmounting to the backup/restore sections.

Also make sure the stripping commands are valid.
2021-08-03 21:35:39 -05:00
Xi Ruoyao
887b02bd8c
fix temp hosts file
I think it may be related to Python 3 tests hang (?)
2021-08-04 00:12:51 +08:00