source: postlfs/filesystems/parted.xml@ 06908bf6

10.0 10.1 11.0 9.0 9.1 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 06908bf6 was 06908bf6, checked in by Pierre Labastie <pieere@…>, 2 years ago

Add remap="doc", remap="test", or just realign them

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21946 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 7.7 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 <!ENTITY parted-download-http "&gnu-http;/parted/parted-&parted-version;.tar.xz">
8 <!ENTITY parted-download-ftp "&gnu-ftp;/parted/parted-&parted-version;.tar.xz">
9 <!ENTITY parted-md5sum "0247b6a7b314f8edeb618159fa95f9cb">
10 <!ENTITY parted-size "1.6 MB">
11 <!ENTITY parted-buildsize "27 MB (additional 2 MB for the tests and additional 1 MB for optional PDF and Postscript documentation)">
12 <!ENTITY parted-time "0.4 SBU (additional 0.6 SBU for the tests)">
13]>
14
15<sect1 id="parted" xreflabel="parted-&parted-version;">
16 <?dbhtml filename="parted.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>parted-&parted-version;</title>
24
25 <indexterm zone="parted">
26 <primary sortas="a-parted">Parted</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to parted</title>
31
32 <para>
33 The <application>Parted</application> package is a disk partitioning and
34 partition resizing tool.
35 </para>
36
37 &lfs84_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>Download (HTTP): <ulink url="&parted-download-http;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download (FTP): <ulink url="&parted-download-ftp;"/></para>
46 </listitem>
47 <listitem>
48 <para>Download MD5 sum: &parted-md5sum;</para>
49 </listitem>
50 <listitem>
51 <para>Download size: &parted-size;</para>
52 </listitem>
53 <listitem>
54 <para>Estimated disk space required: &parted-buildsize;</para>
55 </listitem>
56 <listitem>
57 <para>Estimated build time: &parted-time;</para>
58 </listitem>
59 </itemizedlist>
60
61 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
62 <itemizedlist spacing="compact">
63 <listitem>
64 <para>
65 Optional, to fix build without device mapper support:
66 <ulink url="&patch-root;/parted-&parted-version;-devmapper-1.patch"/>
67 </para>
68 </listitem>
69 </itemizedlist>
70
71 <bridgehead renderas="sect3">Parted Dependencies</bridgehead>
72
73 <bridgehead renderas="sect4">Recommended</bridgehead>
74 <para role="recommended">
75 <xref linkend="lvm2"/> (device-mapper, required if building
76 <application>udisks</application>)
77 </para>
78
79 <bridgehead renderas="sect4">Optional</bridgehead>
80 <para role="optional">
81 <xref linkend="pth"/> and
82 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
83 </para>
84
85 <para condition="html" role="usernotes">
86 User Notes: <ulink url="&blfs-wiki;/parted"/>
87 </para>
88 </sect2>
89
90 <sect2 role="installation">
91 <title>Installation of parted</title>
92
93 <para>
94 If you want to build without device mapper support, a fix is necessary:
95 </para>
96
97<screen><userinput>patch -Np1 -i ../parted-&parted-version;-devmapper-1.patch</userinput></screen>
98
99 <para>
100 Install <application>Parted</application> by running the following
101 commands:
102 </para>
103
104<screen><userinput>sed -i '/utsname.h/a#include &lt;sys/sysmacros.h&gt;' libparted/arch/linux.c &amp;&amp;
105
106./configure --prefix=/usr --disable-static &amp;&amp;
107make &amp;&amp;
108
109make -C doc html &amp;&amp;
110makeinfo --html -o doc/html doc/parted.texi &amp;&amp;
111makeinfo --plaintext -o doc/parted.txt doc/parted.texi</userinput></screen>
112
113 <para>If you have <xref linkend="texlive"/> installed and wish to create
114 PDF and Postcript documentation issue the following commands:</para>
115
116<screen remap="doc"><userinput>texi2pdf -o doc/parted.pdf doc/parted.texi &amp;&amp;
117texi2dvi -o doc/parted.dvi doc/parted.texi &amp;&amp;
118dvips -o doc/parted.ps doc/parted.dvi</userinput></screen>
119
120 <para>If you wish to run the test suite, first remove a test that normally
121 fails in BLFS (because it needs a locale C.UTF-8):</para>
122
123<screen remap="test"><userinput>sed -i '/t0251-gpt-unicode.sh/d' tests/Makefile</userinput></screen>
124
125 <para>
126 To test the results, issue, as the <systemitem
127 class="username">root</systemitem> user:
128 </para>
129
130<screen role="root"
131 remap="test"><userinput>make check</userinput></screen>
132
133 <note>
134 <para>
135 Many tests are skipped if not run as the <systemitem
136 class="username">root</systemitem> user.
137 </para>
138 </note>
139
140 <para>
141 Now, as the <systemitem class="username">root</systemitem> user:
142 </para>
143
144<screen role="root"><userinput>make install &amp;&amp;
145install -v -m755 -d /usr/share/doc/parted-&parted-version;/html &amp;&amp;
146install -v -m644 doc/html/* \
147 /usr/share/doc/parted-&parted-version;/html &amp;&amp;
148install -v -m644 doc/{FAT,API,parted.{txt,html}} \
149 /usr/share/doc/parted-&parted-version;</userinput></screen>
150
151 <para>Install the optional PDF and Postscript documentation by issuing
152 the following command as the <systemitem class="username">root</systemitem>
153 user:</para>
154
155<screen role="root"
156 remap="doc"><userinput>install -v -m644 doc/FAT doc/API doc/parted.{pdf,ps,dvi} \
157 /usr/share/doc/parted-&parted-version;</userinput></screen>
158 </sect2>
159
160 <sect2 role="commands">
161 <title>Command Explanations</title>
162
163 <para>
164 <command>sed ...</command>: Add a header to allow building with glibc-2.28
165 or later.
166 </para>
167
168 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
169 href="../../xincludes/static-libraries.xml"/>
170
171 <para>
172 <option>--disable-device-mapper</option>: This option disables device
173 mapper support. Add this parameter if you have not installed
174 <application>LVM2</application>.
175 </para>
176 </sect2>
177
178 <sect2 role="content">
179 <title>Contents</title>
180
181 <segmentedlist>
182 <segtitle>Installed Programs</segtitle>
183 <segtitle>Installed Libraries</segtitle>
184 <segtitle>Installed Directories</segtitle>
185
186 <seglistitem>
187 <seg>
188 parted and
189 partprobe
190 </seg>
191 <seg>
192 libparted.so and
193 libparted-fs-resize.so</seg>
194 <seg>
195 /usr/include/parted and
196 /usr/share/doc/parted-&parted-version;</seg>
197 </seglistitem>
198 </segmentedlist>
199
200 <variablelist>
201 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
202 <?dbfo list-presentation="list"?>
203 <?dbhtml list-presentation="table"?>
204
205 <varlistentry id="parted-prog">
206 <term><command>parted</command></term>
207 <listitem>
208 <para>is a partition manipulation program.</para>
209 <indexterm zone="parted parted-prog">
210 <primary sortas="b-parted">parted</primary>
211 </indexterm>
212 </listitem>
213 </varlistentry>
214
215 <varlistentry id="partprobe">
216 <term><command>partprobe</command></term>
217 <listitem>
218 <para>informs the OS of partition table changes.</para>
219 <indexterm zone="parted partprobe">
220 <primary sortas="b-partprobe">partprobe</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225 <varlistentry id="libparted">
226 <term><filename class='libraryfile'>libparted.so</filename></term>
227 <listitem>
228 <para>
229 contains the <application>Parted</application> API functions.
230 </para>
231 <indexterm zone="parted libparted">
232 <primary sortas="c-libparted">libparted.so</primary>
233 </indexterm>
234 </listitem>
235 </varlistentry>
236 </variablelist>
237 </sect2>
238</sect1>
Note: See TracBrowser for help on using the repository browser.