[ea1302c] | 1 | <sect1 id="ch02-install" xreflabel="Chapter 2 - How to install the software">
|
---|
[6370fa6] | 2 | <title>How to install the software</title>
|
---|
[04f5529] | 3 | <?dbhtml filename="install.html" dir="chapter02"?>
|
---|
[6370fa6] | 4 |
|
---|
[01afb9e] | 5 | <para>Before you start using the LFS book, we should point out that all
|
---|
| 6 | of the commands here assume that you are using the bash shell. If you
|
---|
[702997a] | 7 | aren't, the commands may work but we can't guarantee it. If you want a
|
---|
[01afb9e] | 8 | simple life, use bash.</para>
|
---|
| 9 |
|
---|
[b822811] | 10 | <para>Before you can actually start doing something with a package, you need
|
---|
[aff91c4] | 11 | to unpack it first. Often the package files are tar'ed and
|
---|
[fada431] | 12 | gzip'ed or bzip2'ed. We're not going to write down every time how to
|
---|
| 13 | unpack an archive. We'll explain how to do that once, in this
|
---|
[b822811] | 14 | section.</para>
|
---|
[6370fa6] | 15 |
|
---|
[b822811] | 16 | <para>To start with, change to the $LFS/usr/src directory by running:</para>
|
---|
[6370fa6] | 17 |
|
---|
[b822811] | 18 | <para><screen><userinput>cd $LFS/usr/src</userinput></screen></para>
|
---|
[6370fa6] | 19 |
|
---|
[b822811] | 20 | <para>If a file is tar'ed and gzip'ed, it is unpacked by
|
---|
[6370fa6] | 21 | running either one of the following two commands, depending on the
|
---|
[b822811] | 22 | filename:</para>
|
---|
| 23 |
|
---|
| 24 | <para><screen><userinput>tar xvzf filename.tar.gz</userinput>
|
---|
| 25 | <userinput>tar xvzf filename.tgz</userinput></screen></para>
|
---|
| 26 |
|
---|
| 27 |
|
---|
| 28 | <para>If a file is tar'ed and bzip2'ed, it is unpacked by
|
---|
| 29 | running:</para>
|
---|
| 30 |
|
---|
| 31 | <para><screen><userinput>bzcat filename.tar.bz2 | tar xv</userinput></screen></para>
|
---|
| 32 |
|
---|
| 33 | <para>Some tar programs (most of them nowadays but not all of them) are
|
---|
[6370fa6] | 34 | slightly modified to be able to use bzip2 files directly using either
|
---|
[c092a4a] | 35 | the I, the y or the j tar parameter, which works the same as the z tar
|
---|
| 36 | parameter to handle gzip archives. The above construction works no matter how
|
---|
[b822811] | 37 | your host system decided to patch bzip2.</para>
|
---|
[6370fa6] | 38 |
|
---|
[b822811] | 39 | <para>If a file is just tar'ed, it is unpacked by running:</para>
|
---|
[6370fa6] | 40 |
|
---|
[b822811] | 41 | <para><screen><userinput>tar xvf filename.tar</userinput></screen></para>
|
---|
[6370fa6] | 42 |
|
---|
[b822811] | 43 | <para>When an archive is unpacked, a new directory will be created under the
|
---|
[cc107b1] | 44 | current directory (and this book assumes that the archives are unpacked
|
---|
[ff9fe017] | 45 | under the $LFS/usr/src directory). Please enter that new directory
|
---|
| 46 | before continuing with the installation instructions. Again, every time
|
---|
| 47 | this book is going to install a package, it's up to you to unpack the source
|
---|
[b822811] | 48 | archive and cd into the newly created directory.</para>
|
---|
[ff9fe017] | 49 |
|
---|
[b822811] | 50 | <para>From time to time you will be dealing with single files such as patch
|
---|
[ff9fe017] | 51 | files. These files are generally gzip'ed or bzip2'ed. Before such files
|
---|
[b822811] | 52 | can be used they need to be uncompressed first.</para>
|
---|
| 53 |
|
---|
| 54 | <para>If a file is gzip'ed, it is unpacked by running:</para>
|
---|
| 55 |
|
---|
| 56 | <para><screen><userinput>gunzip filename.gz</userinput></screen></para>
|
---|
| 57 |
|
---|
| 58 | <para>If a file is bzip2'ed, it is unpacked by running:</para>
|
---|
| 59 |
|
---|
| 60 | <para><screen><userinput>bunzip2 filename.bz2</userinput></screen></para>
|
---|
| 61 |
|
---|
[fada431] | 62 | <para>After a package has been installed, two things can be done with
|
---|
| 63 | it: either the directory that contains the sources can be deleted, or it
|
---|
| 64 | can be kept. We highly recommend deleting it. If you don't do this and
|
---|
| 65 | try to re-use the same source later on in the book (for example re-using
|
---|
| 66 | the source trees from chapter 5 for use in chapter 6), it may not work
|
---|
| 67 | as you expect it to. Source trees from chapter 5 will have your host
|
---|
| 68 | distribution's settings, which don't always apply to the LFS system
|
---|
| 69 | after you enter the chroot'ed environment. Even running something like
|
---|
| 70 | <emphasis>make clean</emphasis> doesn't always guarantee a clean source
|
---|
| 71 | tree.</para>
|
---|
[6370fa6] | 72 |
|
---|
[b822811] | 73 | <para>So, save yourself a lot of hassle and just remove the source directory
|
---|
| 74 | immediately after you have installed it.</para>
|
---|
[b8cf8df] | 75 |
|
---|
[b822811] | 76 | <para>There is one exception; the kernel source tree. Keep it around as you
|
---|
[bea68d8] | 77 | will need it later in this book when building a kernel. Nothing will use
|
---|
[42f94e7] | 78 | the kernel tree so the source tree won't be in your way.</para>
|
---|
[bea68d8] | 79 |
|
---|
[6370fa6] | 80 | </sect1>
|
---|
| 81 |
|
---|