diff options
author | Bruce Dubbs <bdubbs@linuxfromscratch.org> | 2021-09-06 09:32:47 -0500 |
---|---|---|
committer | Bruce Dubbs <bdubbs@linuxfromscratch.org> | 2021-09-06 09:32:47 -0500 |
commit | beb80e291d09a6ca6f1855b42ae3178514b0a848 (patch) | |
tree | dc43a02f91a548df92a908f189fa48f36443f327 /chapter07 | |
parent | 6851fc8b2f9a2c681619c9cec630f6b75c1df248 (diff) |
Update text in Chapter 7 Backup/Restore sections
Patch by Kevin Buckley.
Also made minor clarification to umount commands.
Diffstat (limited to 'chapter07')
-rw-r--r-- | chapter07/cleanup.xml | 76 |
1 files changed, 42 insertions, 34 deletions
diff --git a/chapter07/cleanup.xml b/chapter07/cleanup.xml index 36af2cfaa..8e80bdc40 100644 --- a/chapter07/cleanup.xml +++ b/chapter07/cleanup.xml @@ -20,7 +20,7 @@ <para>Second, the libtool .la files are only useful when linking with static libraries. They are unneeded and potentially harmful when using dynamic - shared libraries, specially when using non-autotools build systems. + shared libraries, especially when using non-autotools build systems. While still in chroot, remove those files now:</para> <screen><userinput>find /usr/{lib,libexec} -name \*.la -delete</userinput></screen> @@ -37,6 +37,17 @@ <sect2> <title>Backup</title> + <para> + At this point the essential programs and libraries have been created + and your current LFS system is in a good state. Your system can now be + backed up for later reuse. In case of fatal failures in the subsequent + chapters, it often turns out that removing everything and starting over + (more carefully) is the best option to recover. Unfortunately, all the + temporary files will be removed, too. To avoid spending extra time to + redo something which has been built successfully, creating a backup of + the current LFS system may prove useful. + </para> + <note><para> All the remaining steps in this section are optional. Nevertheless, as soon as you begin installing packages in <xref @@ -56,47 +67,54 @@ safety reasons. </para> + <para> + If you have decided to make a backup, leave the chroot environment: + </para> + +<screen role="nodump"><userinput>exit</userinput></screen> + <important> - <para>All of the following instructions are executed by - <systemitem class="username">root</systemitem>. Take extra - care about the commands you're going to run as mistakes + <para> + All of the following instructions are executed by + <systemitem class="username">root</systemitem> on your host system. + Take extra care about the commands you're going to run as mistakes here can modify your host system. Be aware that the environment variable <envar>LFS</envar> is set for user <systemitem class="username">lfs</systemitem> by default but may <emphasis>not</emphasis> be set for - <systemitem class="username">root</systemitem>. Whenever - commands are to be executed by <systemitem class="username">root</systemitem>, + <systemitem class="username">root</systemitem>. + </para> + <para> + Whenever commands are to be executed by <systemitem class="username">root</systemitem>, make sure you have set <envar>LFS</envar>. + </para> + <para> This has been discussed in <xref linkend='ch-partitioning-aboutlfs'/>. </para> </important> - <para> - Now, if you are making a backup, leave the chroot environment: - </para> + <para>Before making a backup, unmount the virtual file systems:</para> -<screen role="nodump"><userinput>exit</userinput></screen> +<screen role="nodump"><userinput>umount $LFS/dev/pts +umount $LFS/{sys,proc,run,dev}</userinput></screen> <para> - At this point the essential programs and libraries have been created - and your current system is in a good state. Your system can now be - backed up for later reuse. In case of fatal failures in the subsequent - chapters, it often turns out that removing everything and starting over - (more carefully) is the best option to recover. Unfortunately, all the - temporary files will be removed, too. To avoid spending extra time to - redo something which has been built successfully, prepare a backup. + Make sure you have at least 1 GB free disk space (the source tarballs + will be included in the backup archive) on the filesystem containing + directory where you create the backup archive. </para> <para> - Make sure you have at least 1 GB free disk space (the source tarballs - will be included in the backup archive) in the home directory of user - <systemitem class="username">root</systemitem>. + Note that the instructions below specify the home directory of the host + system's <systemitem class="username">root</systemitem> user, which is + typically found on the root filesystem. </para> - <para>Before we make a backup, unmount the virtual file systems:</para> - -<screen role="nodump"><userinput>umount $LFS/dev{/pts,} -umount $LFS/{sys,proc,run}</userinput></screen> + <para> + Replace <envar>$HOME</envar> by a directory of your choice if you + do not want to have the backup stored in <systemitem + class="username">root</systemitem>'s home directory. + </para> <para> Create the backup archive by running the following command: @@ -107,11 +125,6 @@ umount $LFS/{sys,proc,run}</userinput></screen> Because the backup archive is compressed, it takes a relatively long time (over 10 minutes) even on a resonably fast system. </para> - - <para> - Also, ensure the <envar>LFS</envar> environment variable is set - for the root user. - </para> </note> <screen role="nodump" revision="sysv"><userinput>cd $LFS @@ -120,11 +133,6 @@ tar -cJpf $HOME/lfs-temp-tools-&version;.tar.xz .</userinput></screen> <screen role="nodump" revision="systemd"><userinput>cd $LFS tar -cJpf $HOME/lfs-temp-tools-&versiond;.tar.xz .</userinput></screen> - <para> - Replace <envar>$HOME</envar> by a directory of your choice if you - do not want to have the backup stored in <systemitem - class="username">root</systemitem>'s home directory. - </para> </sect2> <sect2> |