source: postlfs/filesystems/parted.xml@ 200bac18

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 200bac18 was 200bac18, checked in by Xi Ruoyao <xry111@…>, 17 months ago

parted: adjust test scripts to use Python 3

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

  • Property mode set to 100644
File size: 8.2 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 "090655d05f3c471aa8e15a27536889ec">
10 <!ENTITY parted-size "1.7 MB">
11 <!ENTITY parted-buildsize "34 MB (additional 3 MB for the tests and additional 1 MB for optional PDF and Postscript documentation)">
12 <!ENTITY parted-time "0.3 SBU (additional 1.7 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 &lfs91_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&parted-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&parted-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &parted-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &parted-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &parted-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &parted-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72 <!--
73 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
74 <itemizedlist spacing="compact">
75 <listitem>
76 <para>
77 Optional, to fix build without device mapper support: <ulink
78 url="&patch-root;/parted-&parted-version;-devmapper-1.patch"/>
79 </para>
80 </listitem>
81 </itemizedlist>
82 This seems to be unneeded now. The fix was merged. -->
83 <bridgehead renderas="sect3">Parted Dependencies</bridgehead>
84
85 <bridgehead renderas="sect4">Recommended</bridgehead>
86 <para role="recommended">
87 <xref linkend="lvm2"/> (device-mapper, required if building
88 <application>udisks</application>)
89 </para>
90
91 <bridgehead renderas="sect4">Optional</bridgehead>
92 <para role="optional">
93 <xref linkend="dosfstools"/>,
94 <xref linkend="pth"/>,
95 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>), and
96 <ulink url="https://metacpan.org/pod/Digest::CRC">Digest::CRC</ulink> (for tests)
97 </para>
98
99 <para condition="html" role="usernotes">
100 User Notes: <ulink url="&blfs-wiki;/parted"/>
101 </para>
102 </sect2>
103
104 <sect2 role="installation">
105 <title>Installation of parted</title>
106 <!--
107 <para>
108 If you want to build without device mapper support, a fix is necessary:
109 </para>
110
111<screen><userinput>patch -Np1 -i ../parted-&parted-version;-devmapper-1.patch</userinput></screen>
112 -->
113 <para>
114 Install <application>Parted</application> by running the following
115 commands:
116 </para>
117
118<screen><userinput>./configure --prefix=/usr --disable-static &amp;&amp;
119make &amp;&amp;
120
121make -C doc html &amp;&amp;
122makeinfo --html -o doc/html doc/parted.texi &amp;&amp;
123makeinfo --plaintext -o doc/parted.txt doc/parted.texi</userinput></screen>
124
125 <para>
126 If you have <xref linkend="texlive"/> installed and wish to create
127 PDF and Postcript documentation issue the following commands:
128 </para>
129
130<screen remap="doc"><userinput>texi2pdf -o doc/parted.pdf doc/parted.texi &amp;&amp;
131texi2dvi -o doc/parted.dvi doc/parted.texi &amp;&amp;
132dvips -o doc/parted.ps doc/parted.dvi</userinput></screen>
133
134 <para>
135 If you wish to run the test suite, first remove a couple of tests
136 that are known to fail in a BLFS environment. And, adjust two Python
137 scripts to use Python 3, in case Python 2 is not installed:
138 </para>
139 <!-- One of these is due to a C locale, and another is a problem in LVM. -->
140<screen remap="test"><userinput>sed -i '/t0251-gpt-unicode.sh/d' tests/Makefile &amp;&amp;
141sed -i '/t6002-dm-busy.sh/d' tests/Makefile &amp;&amp;
142sed -i '1s/python/&amp;3/' tests/{gpt-header-move,msdos-overlap}
143</userinput></screen>
144
145 <para>
146 To test the results, issue, as the <systemitem
147 class="username">root</systemitem> user:
148 </para>
149
150<screen role="root"
151 remap="test"><userinput>make check</userinput></screen>
152
153 <note>
154 <para>
155 Many tests are skipped if not run as the <systemitem
156 class="username">root</systemitem> user.
157 </para>
158 </note>
159
160 <para>
161 Now, as the <systemitem class="username">root</systemitem> user:
162 </para>
163
164<screen role="root"><userinput>make install &amp;&amp;
165install -v -m755 -d /usr/share/doc/parted-&parted-version;/html &amp;&amp;
166install -v -m644 doc/html/* \
167 /usr/share/doc/parted-&parted-version;/html &amp;&amp;
168install -v -m644 doc/{FAT,API,parted.{txt,html}} \
169 /usr/share/doc/parted-&parted-version;</userinput></screen>
170
171 <para>
172 Install the optional PDF and Postscript documentation by issuing the
173 following command as the <systemitem class="username">root</systemitem>
174 user:
175 </para>
176
177<screen role="root"
178 remap="doc"><userinput>install -v -m644 doc/FAT doc/API doc/parted.{pdf,ps,dvi} \
179 /usr/share/doc/parted-&parted-version;</userinput></screen>
180 </sect2>
181
182 <sect2 role="commands">
183 <title>Command Explanations</title>
184
185 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
186 href="../../xincludes/static-libraries.xml"/>
187
188 <para>
189 <option>--disable-device-mapper</option>: This option disables device
190 mapper support. Add this parameter if you have not installed
191 <application>LVM2</application>.
192 </para>
193 </sect2>
194
195 <sect2 role="content">
196 <title>Contents</title>
197
198 <segmentedlist>
199 <segtitle>Installed Programs</segtitle>
200 <segtitle>Installed Libraries</segtitle>
201 <segtitle>Installed Directories</segtitle>
202
203 <seglistitem>
204 <seg>
205 parted and
206 partprobe
207 </seg>
208 <seg>
209 libparted.so and
210 libparted-fs-resize.so</seg>
211 <seg>
212 /usr/include/parted and
213 /usr/share/doc/parted-&parted-version;</seg>
214 </seglistitem>
215 </segmentedlist>
216
217 <variablelist>
218 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
219 <?dbfo list-presentation="list"?>
220 <?dbhtml list-presentation="table"?>
221
222 <varlistentry id="parted-prog">
223 <term><command>parted</command></term>
224 <listitem>
225 <para>
226 is a partition manipulation program.
227 </para>
228 <indexterm zone="parted parted-prog">
229 <primary sortas="b-parted">parted</primary>
230 </indexterm>
231 </listitem>
232 </varlistentry>
233
234 <varlistentry id="partprobe">
235 <term><command>partprobe</command></term>
236 <listitem>
237 <para>
238 informs the OS of partition table changes.
239 </para>
240 <indexterm zone="parted partprobe">
241 <primary sortas="b-partprobe">partprobe</primary>
242 </indexterm>
243 </listitem>
244 </varlistentry>
245
246 <varlistentry id="libparted">
247 <term><filename class='libraryfile'>libparted.so</filename></term>
248 <listitem>
249 <para>
250 contains the <application>Parted</application> API functions.
251 </para>
252 <indexterm zone="parted libparted">
253 <primary sortas="c-libparted">libparted.so</primary>
254 </indexterm>
255 </listitem>
256 </varlistentry>
257 </variablelist>
258 </sect2>
259</sect1>
Note: See TracBrowser for help on using the repository browser.