source: chapter07/cleanup.xml@ 9904ecb

11.1 11.2 11.2-rc1 arm multilib s6-init trunk xry111/arm64 xry111/clfs-ng xry111/lfs-next xry111/pip3 xry111/queue-11.3 xry111/rust-wip-20221008
Last change on this file since 9904ecb was 9904ecb, checked in by Bruce Dubbs <bdubbs@…>, 10 months ago

Spelling/Typos

  • Property mode set to 100644
File size: 6.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../general.ent">
5 %general-entities;
6]>
7
8<sect1 id="ch-tools-cleanup">
9 <?dbhtml filename="cleanup.html"?>
10
11 <title>Cleaning up and Saving the Temporary System</title>
12
13 <sect2>
14 <title>Cleaning</title>
15
16 <para>First, remove the currently installed documentation to prevent them
17 from ending up in the final system, and to save about 35 MB:</para>
18
19<screen><userinput>rm -rf /usr/share/{info,man,doc}/*</userinput></screen>
20
21 <para>Second, the libtool .la files are only useful when linking with static
22 libraries. They are unneeded and potentially harmful when using dynamic
23 shared libraries, especially when using non-autotools build systems.
24 While still in chroot, remove those files now:</para>
25
26<screen><userinput>find /usr/{lib,libexec} -name \*.la -delete</userinput></screen>
27
28 <para>
29 The current system size is now about 3 GB, however
30 the /tools directory is no longer needed. It uses about
31 1 GB of disk space. Delete it now:
32 </para>
33
34<screen><userinput>rm -rf /tools</userinput></screen>
35 </sect2>
36
37 <sect2>
38 <title>Backup</title>
39
40 <para>
41 At this point the essential programs and libraries have been created
42 and your current LFS system is in a good state. Your system can now be
43 backed up for later reuse. In case of fatal failures in the subsequent
44 chapters, it often turns out that removing everything and starting over
45 (more carefully) is the best option to recover. Unfortunately, all the
46 temporary files will be removed, too. To avoid spending extra time to
47 redo something which has been built successfully, creating a backup of
48 the current LFS system may prove useful.
49 </para>
50
51 <note><para>
52 All the remaining steps in this section are optional. Nevertheless,
53 as soon as you begin installing packages in <xref
54 linkend="chapter-building-system"/>, the temporary files will be
55 overwritten. So it may be a good idea to do a backup of the current
56 system as described below.
57 </para></note>
58
59 <para>
60 The following steps are performed from outside the chroot
61 environment. That means, you have to leave the chroot environment
62 first before continuing. The reason for that is to
63 get access to file system locations outside of the chroot
64 environment to store/read the backup archive which should
65 not be placed within the
66 <filename class="directory">$LFS</filename> hierarchy for
67 safety reasons.
68 </para>
69
70 <para>
71 If you have decided to make a backup, leave the chroot environment:
72 </para>
73
74<screen role="nodump"><userinput>exit</userinput></screen>
75
76 <important>
77 <para>
78 All of the following instructions are executed by
79 <systemitem class="username">root</systemitem> on your host system.
80 Take extra care about the commands you're going to run as mistakes
81 here can modify your host system. Be aware that the
82 environment variable <envar>LFS</envar>
83 is set for user <systemitem class="username">lfs</systemitem> by default
84 but may <emphasis>not</emphasis> be set for
85 <systemitem class="username">root</systemitem>.
86 </para>
87 <para>
88 Whenever commands are to be executed by <systemitem class="username">root</systemitem>,
89 make sure you have set <envar>LFS</envar>.
90 </para>
91 <para>
92 This has been discussed in <xref linkend='ch-partitioning-aboutlfs'/>.
93 </para>
94 </important>
95
96 <para>Before making a backup, unmount the virtual file systems:</para>
97
98<screen role="nodump"><userinput>umount $LFS/dev/pts
99umount $LFS/{sys,proc,run,dev}</userinput></screen>
100
101 <para>
102 Make sure you have at least 1 GB free disk space (the source tarballs
103 will be included in the backup archive) on the filesystem containing
104 directory where you create the backup archive.
105 </para>
106
107 <para>
108 Note that the instructions below specify the home directory of the host
109 system's <systemitem class="username">root</systemitem> user, which is
110 typically found on the root filesystem.
111 </para>
112
113 <para>
114 Replace <envar>$HOME</envar> by a directory of your choice if you
115 do not want to have the backup stored in <systemitem
116 class="username">root</systemitem>'s home directory.
117 </para>
118
119 <para>
120 Create the backup archive by running the following command:
121 </para>
122
123 <note>
124 <para>
125 Because the backup archive is compressed, it takes a relatively
126 long time (over 10 minutes) even on a resonably fast system.
127 </para>
128 </note>
129
130<screen role="nodump"><userinput>cd $LFS
131tar -cJpf $HOME/lfs-temp-tools-&version;.tar.xz .</userinput></screen>
132
133 <note>
134 <para>
135 If continuing to chapter 8, don't forget to reenter the chroot
136 environment as explained in the <quote>Important</quote> box below.
137 </para>
138 </note>
139
140 </sect2>
141
142 <sect2>
143 <title>Restore</title>
144
145 <para>
146 In case some mistakes have been made and you need to start over, you can
147 use this backup to restore the system and save some recovery time.
148 Since the sources are located under
149 <filename class="directory">$LFS</filename>, they are included in the
150 backup archive as well, so they do not need to be downloaded again. After
151 checking that <envar>$LFS</envar> is set properly,
152 restore the backup by executing the following commands:
153 </para>
154
155<!-- Make the following look different so users don't blindly run the
156 restore when they don't need to. -->
157
158 <warning><para>The following commands are extremely dangerous. If
159 you run <command>rm -rf ./*</command> as the root user and you
160 do not change to the $LFS directory or the <envar>LFS</envar>
161 environment variable is not set for the root user, it will destroy
162 your entire host system. YOU ARE WARNED.</para></warning>
163
164<screen role="nodump"><computeroutput>cd $LFS
165rm -rf ./*
166tar -xpf $HOME/lfs-temp-tools-&version;.tar.xz</computeroutput></screen>
167
168 <para>
169 Again, double check that the environment has been setup properly
170 and continue building the rest of the system.
171 </para>
172
173 <important>
174 <para>
175 If you left the chroot environment to create a backup or restart
176 building using a restore, remember to check that the virtual
177 filesystems are still mounted (<command>findmnt | grep
178 $LFS</command>). If they are not mounted, remount them now as
179 described in <xref linkend='ch-tools-kernfs'/> and re-enter the chroot
180 environment (see <xref linkend='ch-tools-chroot'/>) before continuing.
181 </para>
182 </important>
183
184 </sect2>
185
186</sect1>
Note: See TracBrowser for help on using the repository browser.