tar.xml 3.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119
  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. <sect1 id="ch-system-tar" role="wrap">
  8. <?dbhtml filename="tar.html"?>
  9. <sect1info condition="script">
  10. <productname>tar</productname>
  11. <productnumber>&tar-version;</productnumber>
  12. <address>&tar-url;</address>
  13. </sect1info>
  14. <title>Tar-&tar-version;</title>
  15. <indexterm zone="ch-system-tar">
  16. <primary sortas="a-Tar">Tar</primary>
  17. </indexterm>
  18. <sect2 role="package">
  19. <title/>
  20. <para>The Tar package provides the ability to create tar archives as well
  21. as perform various other kinds of archive manipulation. Tar can be used on
  22. previously created archives to extract files, to store additional files, or
  23. to update or list files which were already stored. </para>
  24. <segmentedlist>
  25. <segtitle>&buildtime;</segtitle>
  26. <segtitle>&diskspace;</segtitle>
  27. <seglistitem>
  28. <seg>&tar-fin-sbu;</seg>
  29. <seg>&tar-fin-du;</seg>
  30. </seglistitem>
  31. </segmentedlist>
  32. </sect2>
  33. <sect2 role="installation">
  34. <title>Installation of Tar</title>
  35. <para>Prepare Tar for compilation:</para>
  36. <screen><userinput remap="configure">FORCE_UNSAFE_CONFIGURE=1 \
  37. ./configure --prefix=/usr \
  38. --bindir=/bin</userinput></screen>
  39. <variablelist>
  40. <title>The meaning of the configure option:</title>
  41. <varlistentry>
  42. <term><envar>FORCE_UNSAFE_CONFIGURE=1</envar></term>
  43. <listitem>
  44. <para>This forces the test for <function>mknod</function> to be run
  45. as root. It is generally considered dangerous to run this test as
  46. the root user, but as it is being run on a system that has only been
  47. partially built, overriding it is OK.</para>
  48. </listitem>
  49. </varlistentry>
  50. </variablelist>
  51. <para>Compile the package:</para>
  52. <screen><userinput remap="make">make</userinput></screen>
  53. <para>To test the results (about 3 SBU), issue:</para>
  54. <screen><userinput remap="test">make check</userinput></screen>
  55. <!-- Seems to pass for version 1.31. Keeping as a comment just in case...
  56. <para>One test, link mismatch, is known to fail.</para>
  57. -->
  58. <para>Install the package:</para>
  59. <screen><userinput remap="install">make install
  60. make -C doc install-html docdir=/usr/share/doc/tar-&tar-version;</userinput></screen>
  61. </sect2>
  62. <sect2 id="contents-tar" role="content">
  63. <title>Contents of Tar</title>
  64. <segmentedlist>
  65. <segtitle>Installed programs</segtitle>
  66. <segtitle>Installed directory</segtitle>
  67. <seglistitem>
  68. <seg>tar</seg>
  69. <seg>/usr/share/doc/tar-&tar-version;</seg>
  70. </seglistitem>
  71. </segmentedlist>
  72. <variablelist>
  73. <bridgehead renderas="sect3">Short Descriptions</bridgehead>
  74. <?dbfo list-presentation="list"?>
  75. <?dbhtml list-presentation="table"?>
  76. <varlistentry id="tar">
  77. <term><command>tar</command></term>
  78. <listitem>
  79. <para>Creates, extracts files from, and lists the contents of archives,
  80. also known as tarballs</para>
  81. <indexterm zone="ch-system-tar tar">
  82. <primary sortas="b-tar">tar</primary>
  83. </indexterm>
  84. </listitem>
  85. </varlistentry>
  86. </variablelist>
  87. </sect2>
  88. </sect1>