settingenviron.xml 3.8 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  3. <!ENTITY % general-entities SYSTEM "../general.ent">
  4. %general-entities;
  5. ]>
  6. <sect1 id="ch-tools-settingenviron">
  7. <title>Setting up the environment</title>
  8. <?dbhtml filename="settingenvironment.html"?>
  9. <para>We're going to set up a good working environment by creating two new
  10. startup files for the <command>bash</command> shell. While logged in as
  11. user <emphasis>lfs</emphasis>, issue the following command to create a new
  12. <filename>.bash_profile</filename>:</para>
  13. <screen><userinput>cat &gt; ~/.bash_profile &lt;&lt; "EOF"
  14. exec env -i HOME=$HOME TERM=$TERM PS1='\u:\w\$ ' /bin/bash
  15. EOF</userinput></screen>
  16. <para>Normally, when you log on as user <emphasis>lfs</emphasis>,
  17. the initial shell is a <emphasis>login</emphasis> shell which reads the
  18. <filename>/etc/profile</filename> of your host (probably containing some
  19. settings of environment variables) and then <filename>.bash_profile</filename>.
  20. The <command>exec env -i ... /bin/bash</command> command in the latter file
  21. replaces the running shell with a new one with a completely empty environment,
  22. except for the HOME, TERM and PS1 variables. This ensures that no unwanted and
  23. potentially hazardous environment variables from the host system leak into our
  24. build environment. The technique used here is a little strange, but it achieves
  25. the goal of enforcing a clean environment.</para>
  26. <para>The new instance of the shell is a <emphasis>non-login</emphasis> shell,
  27. which doesn't read the <filename>/etc/profile</filename> or
  28. <filename>.bash_profile</filename> files, but reads the
  29. <filename>.bashrc</filename> file instead. Create this latter file now:</para>
  30. <screen><userinput>cat &gt; ~/.bashrc &lt;&lt; "EOF"
  31. set +h
  32. umask 022
  33. LFS=/mnt/lfs
  34. LC_ALL=POSIX
  35. PATH=/tools/bin:/bin:/usr/bin
  36. export LFS LC_ALL PATH
  37. EOF</userinput></screen>
  38. <para>The <command>set +h</command> command turns off
  39. <command>bash</command>'s hash function. Normally hashing is a useful
  40. feature: <command>bash</command> uses a hash table to remember the
  41. full pathnames of executable files to avoid searching the PATH time and time
  42. again to find the same executable. However, we'd like the new tools to be
  43. used as soon as they are installed. By switching off the hash function, our
  44. <quote>interactive</quote> commands (<command>make</command>,
  45. <command>patch</command>, <command>sed</command>,
  46. <command>cp</command> and so forth) will always use
  47. the newest available version during the build process.</para>
  48. <para>Setting the user file-creation mask to 022 ensures that newly created
  49. files and directories are only writable for their owner, but readable and
  50. executable for anyone.</para>
  51. <para>The LFS variable should of course be set to the mount point you
  52. chose.</para>
  53. <para>The LC_ALL variable controls the localization of certain programs,
  54. making their messages follow the conventions of a specified country. If your
  55. host system uses a version of Glibc older than 2.2.4,
  56. having LC_ALL set to something other than <quote>POSIX</quote> or
  57. <quote>C</quote> during this chapter may cause trouble if you exit the chroot
  58. environment and wish to return later. By setting LC_ALL to <quote>POSIX</quote>
  59. (or <quote>C</quote>, the two are equivalent) we ensure that
  60. everything will work as expected in the chroot environment.</para>
  61. <para>We prepend <filename class="directory">/tools/bin</filename> to the standard PATH so
  62. that, as we move along through this chapter, the tools we build will get used
  63. during the rest of the building process.</para>
  64. <para>Finally, to have our environment fully prepared for building the
  65. temporary tools, source the just-created profile:</para>
  66. <screen><userinput>source ~/.bash_profile</userinput></screen>
  67. </sect1>