pkgmgt.xml 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
  3. "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  4. <!ENTITY % general-entities SYSTEM "../general.ent">
  5. %general-entities;
  6. ]>
  7. <sect1 id="ch-system-pkgmgt">
  8. <?dbhtml filename="pkgmgt.html"?>
  9. <title>Package Management</title>
  10. <para>Package Management is an often requested addition to the LFS Book. A
  11. Package Manager allows tracking the installation of files making it easy to
  12. remove and upgrade packages. Before you begin to wonder, NO&mdash;this section
  13. will not talk about nor recommend any particular package manager. What it
  14. provides is a roundup of the more popular techniques and how they work. The
  15. perfect package manager for you may be among these techniques or may be a
  16. combination of two or more of these techniques. This section briefly mentions
  17. issues that may arise when upgrading packages.</para>
  18. <para>Some reasons why no package manager is mentioned in LFS or BLFS
  19. include:</para>
  20. <itemizedlist>
  21. <listitem>
  22. <para>Dealing with package management takes the focus away from the goals
  23. of these books&mdash;teaching how a Linux system is built.</para>
  24. </listitem>
  25. <listitem>
  26. <para>There are multiple solutions for package management, each having
  27. its strengths and drawbacks. Including one that satisfies all audiences
  28. is difficult.</para>
  29. </listitem>
  30. </itemizedlist>
  31. <para>There are some hints written on the topic of package management. Visit
  32. the <ulink url="&hints-root;">Hints subproject</ulink> and see if one of them
  33. fits your need.</para>
  34. <sect2>
  35. <title>Upgrade Issues</title>
  36. <para>A Package Manager makes it easy to upgrade to newer versions when they
  37. are released. Generally the instructions in the LFS and BLFS Book can be
  38. used to upgrade to the newer versions. Here are some points that you should
  39. be aware of when upgrading packages, especially on a running system.</para>
  40. <itemizedlist>
  41. <listitem>
  42. <para>If one of the toolchain packages (Glibc, GCC or Binutils) needs
  43. to be upgraded to a newer minor version, it is safer to rebuild LFS.
  44. Though you <emphasis>may</emphasis> be able to get by rebuilding all
  45. the packages in their dependency order, we do not recommend it. For
  46. example, if glibc-2.2.x needs to be updated to glibc-2.3.x, it is safer
  47. to rebuild. For micro version updates, a simple reinstallation usually
  48. works, but is not guaranteed. For example, upgrading from glibc-2.3.4
  49. to glibc-2.3.5 will not usually cause any problems.</para>
  50. </listitem>
  51. <listitem>
  52. <para>If a package containing a shared library is updated, and if the
  53. name of the library changes, then all the packages dynamically linked
  54. to the library need to be recompiled to link against the newer library.
  55. (Note that there is no correlation between the package version and the
  56. name of the library.) For example, consider a package foo-1.2.3 that
  57. installs a shared library with name
  58. <filename class='libraryfile'>libfoo.so.1</filename>. Say you upgrade
  59. the package to a newer version foo-1.2.4 that installs a shared library
  60. with name <filename class='libraryfile'>libfoo.so.2</filename>. In this
  61. case, all packages that are dynamically linked to
  62. <filename class='libraryfile'>libfoo.so.1</filename> need to be
  63. recompiled to link against
  64. <filename class='libraryfile'>libfoo.so.2</filename>. Note that you
  65. should not remove the previous libraries until the dependent packages
  66. are recompiled.</para>
  67. </listitem>
  68. <listitem>
  69. <para>If you are upgrading a running system, be on the lookout for
  70. packages that use <command>cp</command> instead of
  71. <command>install</command> to install files. The latter command is
  72. usually safer if the executable or library is already loaded in memory.
  73. </para>
  74. </listitem>
  75. </itemizedlist>
  76. </sect2>
  77. <sect2>
  78. <title>Package Management Techniques</title>
  79. <para>The following are some common package management techniques. Before
  80. making a decision on a package manager, do some research on the various
  81. techniques, particularly the drawbacks of the particular scheme.</para>
  82. <sect3>
  83. <title>It is All in My Head!</title>
  84. <para>Yes, this is a package management technique. Some folks do not find
  85. the need for a package manager because they know the packages intimately
  86. and know what files are installed by each package. Some users also do not
  87. need any package management because they plan on rebuilding the entire
  88. system when a package is changed.</para>
  89. </sect3>
  90. <sect3>
  91. <title>Install in Separate Directories</title>
  92. <para>This is a simplistic package management that does not need any extra
  93. package to manage the installations. Each package is installed in a
  94. separate directory. For example, package foo-1.1 is installed in
  95. <filename class='directory'>/usr/pkg/foo-1.1</filename>
  96. and a symlink is made from <filename>/usr/pkg/foo</filename> to
  97. <filename class='directory'>/usr/pkg/foo-1.1</filename>. When installing
  98. a new version foo-1.2, it is installed in
  99. <filename class='directory'>/usr/pkg/foo-1.2</filename> and the previous
  100. symlink is replaced by a symlink to the new version.</para>
  101. <para>Environment variables such as <envar>PATH</envar>,
  102. <envar>LD_LIBRARY_PATH</envar>, <envar>MANPATH</envar>,
  103. <envar>INFOPATH</envar> and <envar>CPPFLAGS</envar> need to be expanded to
  104. include <filename>/usr/pkg/foo</filename>. For more than a few packages,
  105. this scheme becomes unmanageable.</para>
  106. </sect3>
  107. <sect3>
  108. <title>Symlink Style Package Management</title>
  109. <para>This is a variation of the previous package management technique.
  110. Each package is installed similar to the previous scheme. But instead of
  111. making the symlink, each file is symlinked into the
  112. <filename class='directory'>/usr</filename> hierarchy. This removes the
  113. need to expand the environment variables. Though the symlinks can be
  114. created by the user to automate the creation, many package managers have
  115. been written using this approach. A few of the popular ones include Stow,
  116. Epkg, Graft, and Depot.</para>
  117. <para>The installation needs to be faked, so that the package thinks that
  118. it is installed in <filename class="directory">/usr</filename> though in
  119. reality it is installed in the
  120. <filename class="directory">/usr/pkg</filename> hierarchy. Installing in
  121. this manner is not usually a trivial task. For example, consider that you
  122. are installing a package libfoo-1.1. The following instructions may
  123. not install the package properly:</para>
  124. <screen role="nodump"><userinput>./configure --prefix=/usr/pkg/libfoo/1.1
  125. make
  126. make install</userinput></screen>
  127. <para>The installation will work, but the dependent packages may not link
  128. to libfoo as you would expect. If you compile a package that links against
  129. libfoo, you may notice that it is linked to
  130. <filename class='libraryfile'>/usr/pkg/libfoo/1.1/lib/libfoo.so.1</filename>
  131. instead of <filename class='libraryfile'>/usr/lib/libfoo.so.1</filename>
  132. as you would expect. The correct approach is to use the
  133. <envar>DESTDIR</envar> strategy to fake installation of the package. This
  134. approach works as follows:</para>
  135. <screen role="nodump"><userinput>./configure --prefix=/usr
  136. make
  137. make DESTDIR=/usr/pkg/libfoo/1.1 install</userinput></screen>
  138. <para>Most packages support this approach, but there are some which do not.
  139. For the non-compliant packages, you may either need to manually install the
  140. package, or you may find that it is easier to install some problematic
  141. packages into <filename class='directory'>/opt</filename>.</para>
  142. </sect3>
  143. <sect3>
  144. <title>Timestamp Based</title>
  145. <para>In this technique, a file is timestamped before the installation of
  146. the package. After the installation, a simple use of the
  147. <command>find</command> command with the appropriate options can generate
  148. a log of all the files installed after the timestamp file was created. A
  149. package manager written with this approach is install-log.</para>
  150. <para>Though this scheme has the advantage of being simple, it has two
  151. drawbacks. If, during installation, the files are installed with any
  152. timestamp other than the current time, those files will not be tracked by
  153. the package manager. Also, this scheme can only be used when one package
  154. is installed at a time. The logs are not reliable if two packages are
  155. being installed on two different consoles.</para>
  156. </sect3>
  157. <sect3>
  158. <title>LD_PRELOAD Based</title>
  159. <para>In this approach, a library is preloaded before installation. During
  160. installation, this library tracks the packages that are being installed by
  161. attaching itself to various executables such as <command>cp</command>,
  162. <command>install</command>, <command>mv</command> and tracking the system
  163. calls that modify the filesystem. For this approach to work, all the
  164. executables need to be dynamically linked without the suid or sgid bit.
  165. Preloading the library may cause some unwanted side-effects during
  166. installation. Therefore, it is advised that one performs some tests to
  167. ensure that the package manager does not break anything and logs all the
  168. appropriate files.</para>
  169. </sect3>
  170. <sect3>
  171. <title>Creating Package Archives</title>
  172. <para>In this scheme, the package installation is faked into a separate
  173. tree as described in the Symlink style package management. After the
  174. installation, a package archive is created using the installed files.
  175. This archive is then used to install the package either on the local
  176. machine or can even be used to install the package on other machines.</para>
  177. <para>This approach is used by most of the package managers found in the
  178. commercial distributions. Examples of package managers that follow this
  179. approach are RPM (which, incidentally, is required by the <ulink
  180. url="http://lsbbook.gforge.freestandards.org/package.html#RPM">Linux
  181. Standard Base Specification</ulink>), pkg-utils, Debian's apt, and
  182. Gentoo's Portage system. A hint describing how to adopt this style of
  183. package management for LFS systems is located at <ulink
  184. url="&hints-root;/fakeroot.txt"/>.</para>
  185. </sect3>
  186. <sect3>
  187. <title>User Based Management</title>
  188. <para>This scheme, unique to LFS, was devised by Matthias Benkmann, and is
  189. available from the <ulink url="&hints-root;">Hints Project</ulink>. In
  190. this scheme, each package is installed as a separate user into the
  191. standard locations. Files belonging to a package are easily identified by
  192. checking the user ID. The features and shortcomings of this approach are
  193. too complex to describe in this section. For the details please see the
  194. hint at <ulink url="&hints-root;/more_control_and_pkg_man.txt"/>.</para>
  195. </sect3>
  196. </sect2>
  197. </sect1>