source: chapter08/tar.xml@ c2d2342

11.0 11.0-rc1 11.0-rc2 11.0-rc3 11.1 11.1-rc1 arm ml-11.0 multilib s6-init trunk xry111/clfs-ng xry111/glibc-2.34 xry111/lfs-next
Last change on this file since c2d2342 was c2d2342, checked in by Bruce Dubbs <bdubbs@…>, 13 months ago

Update test results for several packages.

Most of the changes were removing documentation of failed tests
that no longer fail.

  • Property mode set to 100644
File size: 3.5 KB
Line 
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 provides the ability to create tar archives as well
27 as perform various other kinds of archive manipulation. Tar can be used on
28 previously created archives to extract files, to store additional files, or
29 to update or list files which were already stored. </para>
30
31 <segmentedlist>
32 <segtitle>&buildtime;</segtitle>
33 <segtitle>&diskspace;</segtitle>
34
35 <seglistitem>
36 <seg>&tar-fin-sbu;</seg>
37 <seg>&tar-fin-du;</seg>
38 </seglistitem>
39 </segmentedlist>
40
41 </sect2>
42
43 <sect2 role="installation">
44 <title>Installation of Tar</title>
45
46 <para>Prepare Tar for compilation:</para>
47
48<screen><userinput remap="configure">FORCE_UNSAFE_CONFIGURE=1 \
49./configure --prefix=/usr</userinput></screen>
50
51 <variablelist>
52 <title>The meaning of the configure option:</title>
53
54 <varlistentry>
55 <term><envar>FORCE_UNSAFE_CONFIGURE=1</envar></term>
56 <listitem>
57 <para>This forces the test for <function>mknod</function> to be run
58 as <systemitem class="username">root</systemitem>.
59 It is generally considered dangerous to run this test as
60 the <systemitem class="username">root</systemitem> user, but as it
61 is being run on a system that has only been
62 partially built, overriding it is OK.</para>
63 </listitem>
64 </varlistentry>
65 </variablelist>
66
67 <para>Compile the package:</para>
68
69<screen><userinput remap="make">make</userinput></screen>
70
71 <para>To test the results, issue:</para>
72
73<screen><userinput remap="test">make check</userinput></screen>
74
75 <para>One test, capabilities: binary store/restore, is known to fail if it is
76 run (LFS lacks selinux), but will be skipped if the host kernel does
77 not support extended attributes on the filesystem used for building LFS.</para>
78
79 <para>Install the package:</para>
80
81<screen><userinput remap="install">make install
82make -C doc install-html docdir=/usr/share/doc/tar-&tar-version;</userinput></screen>
83
84 </sect2>
85
86
87 <sect2 id="contents-tar" role="content">
88 <title>Contents of Tar</title>
89
90 <segmentedlist>
91 <segtitle>Installed programs</segtitle>
92 <segtitle>Installed directory</segtitle>
93
94 <seglistitem>
95 <seg>tar</seg>
96 <seg>/usr/share/doc/tar-&tar-version;</seg>
97 </seglistitem>
98 </segmentedlist>
99
100 <variablelist>
101 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
102 <?dbfo list-presentation="list"?>
103 <?dbhtml list-presentation="table"?>
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>
Note: See TracBrowser for help on using the repository browser.