chapter06/tar.xml

   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-system-tar" role="wrap">
   9   <?dbhtml filename="tar.html"?>
  10
  11   <sect1info condition="script">
  12     <productname>tar</productname>
  13     <productnumber>&tar-version;</productnumber>
  14     <address>&tar-url;</address>
  15   </sect1info>
  16
  17   <title>Tar-&tar-version;</title>
  18
  19   <indexterm zone="ch-system-tar">
  20     <primary sortas="a-Tar">Tar</primary>
  21   </indexterm>
  22
  23   <sect2 role="package">
  24     <title/>
  25
  26     <para>The Tar package contains an archiving program.</para>
  27
  28     <segmentedlist>
  29       <segtitle>&buildtime;</segtitle>
  30       <segtitle>&diskspace;</segtitle>
  31
  32       <seglistitem>
  33         <seg>&tar-ch6-sbu;</seg>
  34         <seg>&tar-ch6-du;</seg>
  35       </seglistitem>
  36     </segmentedlist>
  37
  38   </sect2>
  39
  40   <sect2 role="installation">
  41     <title>Installation of Tar</title>
  42
  43     <para>Prepare Tar for compilation:</para>
  44
  45 <screen><userinput remap="configure">FORCE_UNSAFE_CONFIGURE=1 ./configure --prefix=/usr \
  46    --bindir=/bin --libexecdir=/usr/sbin</userinput></screen>
  47
  48     <variablelist>
  49       <title>The meaning of the configure options:</title>
  50
  51       <varlistentry>
  52         <term><envar>FORCE_UNSAFE_CONFIGURE=1</envar></term>
  53         <listitem>
  54           <para>This forces the test for <function>mknod</function> to be run
  55           as root.  It is generally considered dangerous to run this test as
  56           the root user, but as it is being run on an only partially built
  57           system, overriding it is OK.</para>
  58         </listitem>
  59       </varlistentry>
  60     </variablelist>
  61
  62     <para>Compile the package:</para>
  63
  64 <screen><userinput remap="make">make</userinput></screen>
  65
  66     <para>To test the results (about 1 SBU), issue:</para>
  67
  68 <screen><userinput remap="test">make check</userinput></screen>
  69
  70     <para>Install the package:</para>
  71
  72 <screen><userinput remap="install">make install
  73 make -C doc install-html docdir=/usr/share/doc/tar-&tar-version;</userinput></screen>
  74
  75   </sect2>
  76
  77
  78   <sect2 id="contents-tar" role="content">
  79     <title>Contents of Tar</title>
  80
  81     <segmentedlist>
  82       <segtitle>Installed programs</segtitle>
  83
  84       <seglistitem>
  85         <seg>rmt and tar</seg>
  86       </seglistitem>
  87     </segmentedlist>
  88
  89     <variablelist>
  90       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
  91       <?dbfo list-presentation="list"?>
  92       <?dbhtml list-presentation="table"?>
  93
  94       <varlistentry id="rmt">
  95         <term><command>rmt</command></term>
  96         <listitem>
  97           <para>Remotely manipulates a magnetic
  98           tape drive through an interprocess communication connection</para>
  99           <indexterm zone="ch-system-tar rmt">
 100             <primary sortas="b-rmt">rmt</primary>
 101           </indexterm>
 102         </listitem>
 103       </varlistentry>
 104
 105       <varlistentry id="tar">
 106         <term><command>tar</command></term>
 107         <listitem>
 108           <para>Creates, extracts files from, and lists the contents of archives,
 109           also known as tarballs</para>
 110           <indexterm zone="ch-system-tar tar">
 111             <primary sortas="b-tar">tar</primary>
 112           </indexterm>
 113         </listitem>
 114       </varlistentry>
 115
 116     </variablelist>
 117
 118   </sect2>
 119
 120 </sect1>