source: xsoft/other/gparted.xml@ 0b05bda

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 0b05bda was 0b05bda, checked in by Douglas R. Reno <renodr@…>, 2 years ago

Fix gparted dependencies to match those in #12110

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

  • Property mode set to 100644
File size: 10.9 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 gparted-download-http "&sourceforge-dl;/gparted/gparted-&gparted-version;.tar.gz">
8 <!ENTITY gparted-download-ftp " ">
9 <!ENTITY gparted-md5sum "025160c642b64148818761a1a4f599eb">
10 <!ENTITY gparted-size "3.8 MB">
11 <!ENTITY gparted-buildsize "88 MB">
12 <!ENTITY gparted-time "0.4 SBU (using parallelism=4)">
13]>
14
15<sect1 id="gparted" xreflabel="Gparted-&gparted-version;">
16 <?dbhtml filename="gparted.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Gparted-&gparted-version;</title>
24
25 <indexterm zone="gparted">
26 <primary sortas="a-Gparted">Gparted</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Gparted</title>
31
32 <para>
33 Gparted is the Gnome Partition Editor, a Gtk 2 GUI for other command line
34 tools that can create, reorganise or delete disk partitions.
35 </para>
36
37 &lfs84_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&gparted-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&gparted-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &gparted-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &gparted-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &gparted-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &gparted-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">Gparted Dependencies</bridgehead>
74
75 <bridgehead renderas="sect4">Required</bridgehead>
76 <para role="required">
77 <!-- GTKMM2 is no longer used since 1.0.0, see #12110 -->
78 <xref linkend="gtkmm3"/> and
79 <xref linkend="parted"/>
80 </para>
81
82 <bridgehead renderas="sect4">Optional</bridgehead>
83 <para role="optional">
84 <xref linkend="btrfs-progs"/> (if using a btrfs filesystem) and
85 <!-- These dependencies were obsoleted in version 1.0.0, see #12110 -->
86 <!-- <xref linkend="rarian"/>,
87 <ulink url="&gnome-download-http;/gnome-doc-utils/">GNOME Doc Utils</ulink> -->
88 <ulink url="https://github.com/pali/udftools">udftools</ulink>
89 </para>
90
91 <para condition="html" role="usernotes">
92 User Notes: <ulink url="&blfs-wiki;/gparted"/>
93 </para>
94 </sect2>
95
96 <sect2 role="installation">
97 <title>Installation of Gparted</title>
98
99 <para>
100 Install <application>Gparted</application> by running the following
101 commands:
102 </para>
103
104<screen><userinput>./configure --prefix=/usr \
105 --disable-doc \
106 --disable-static &amp;&amp;
107make</userinput></screen>
108
109 <para>
110 This package does not come with a testsuite.
111 </para>
112
113 <para>
114 Now, as the <systemitem class="username">root</systemitem> user:
115 </para>
116
117<screen role="root"><userinput>make install</userinput></screen>
118
119 </sect2>
120
121 <sect2 role="commands">
122 <title>Command Explanations</title>
123
124 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
125 href="../../xincludes/static-libraries.xml"/>
126
127 <para>
128 <parameter>--disable-doc</parameter>: This switch disables building of
129 the optional documentation. Remove it if you have installed
130 <application>GNOME Doc Utils</application>.
131 </para>
132
133 <para>
134 <parameter>--enable-xhost-root</parameter>: This switch provides an
135 interim workaround to allow GParted to run under Wayland by using xhost
136 to grant and revoke root access to the X11 display.
137 </para>
138
139 </sect2>
140
141 <sect2 role="using">
142 <title>Using Gparted</title>
143
144 <para>
145 To manipulate file systems Gparted has a run time dependency on various
146 file system tools (you only need to install the tools for file systems you
147 actually use):
148 <xref linkend="hdparm"/>
149 (required for optionally displaying serial number device information),
150 <xref linkend="btrfs-progs"/>,
151 <xref role="runtime" linkend="dosfstools"/>,
152 e2fsprogs (installed as part of LFS),
153 <xref linkend="jfsutils"/>,
154 <xref linkend="ntfs-3g"/>,
155 <xref linkend="reiserfs"/>,
156 <xref linkend="xfsprogs"/>,
157 <ulink url="http://ftp.gnu.org/pub/gnu/mtools/">mtools</ulink> (required
158 to read and write FAT16/32 volume labels and UUIDs),
159 <ulink url="ftp://ftp.mars.org/pub/hfs/">hfsutils</ulink>,
160 <ulink url="https://packages.debian.org/sid/hfsprogs/">hfsprogs</ulink>,
161 <ulink url="http://www.nilfs.org/download/">nilfs-utils</ulink> and
162 <ulink url="https://reiser4.wiki.kernel.org/index.php/Reiser4progs">
163 Reiser4progs</ulink>.
164 </para>
165
166 <para>
167 Root privileges are required to run Gparted. If you wish to run the
168 application from the menu, further applications and configurations are
169 necessary. Examples of applications that may be used:
170 <ulink url="http://people.debian.org/~kov/gksu">gksu</ulink>,
171 <ulink url="https://launchpad.net/kdesudo">kdesudo</ulink>, or
172 <ulink url="https://github.com/tarakbumba/xdg-su">xdg-su</ulink>.
173 <!--Another solution is to use <application>pkexec</application>, from
174 <xref linkend="polkit"/>, but some configuration is necessary.-->
175 Another simple solution is <xref linkend="ssh-askpass"/>. <!--Below, we
176 describe these two alternatives: "ssh-askpass" and "pkexec".-->
177 </para>
178
179 <sect3 role="ssh-askpass">
180 <title>ssh-askpass</title>
181 <para>
182 To optionally use <xref linkend="ssh-askpass"/> if it is installed in
183 your system, run the following commands as the
184 <systemitem class="username">root</systemitem> user:
185 </para>
186
187<screen role="root"><userinput>cp -v /usr/share/applications/gparted.desktop /usr/share/applications/gparted.desktop.back &amp;&amp;
188sed -i 's/Exec=/Exec=sudo -A /' /usr/share/applications/gparted.desktop</userinput></screen>
189
190 <para>
191 Now, clicking on the menu item for Gparted, a dialog appears on the
192 screen, asking for the administrator password.</para>
193
194 </sect3>
195<!--
196 <sect3 role="pkexec" revision="sysv">
197 <title>pkexec</title>
198 <para>
199 To optionally use <application>pkexec</application>, you need <xref
200 linkend="polkit-gnome"/><!- - or <xref linkend="lxpolkit"/>- ->, and
201 <xref linkend="consolekit"/> installed with support to <xref
202 linkend="linux-pam"/> and <xref linkend="polkit"/>. As the
203 <systemitem class="username">root</systemitem> user, configure <xref
204 linkend="gparted"/> and <xref linkend="polkit"/> with the following
205 commands:
206 </para>
207
208<screen role="root"><userinput>cp -v /usr/share/applications/gparted.desktop \
209 /usr/share/applications/gparted.desktop.back &amp;&amp;
210sed -i 's:/usr/bin/gparted:/usr/bin/gparted_polkit:' \
211 /usr/share/applications/gparted.desktop &amp;&amp;
212
213cat &gt; /usr/bin/gparted_polkit &lt;&lt; "EOF" &amp;&amp;
214<literal>#!/bin/bash
215
216pkexec /usr/bin/gparted $@</literal>
217EOF
218chmod -v 0755 /usr/bin/gparted_polkit</userinput></screen>
219
220 <para>
221 Still as the <systemitem class="username">root</systemitem> user,
222 configure <xref linkend="polkit"/> and <xref linkend="gparted"/> to
223 use <application>pkexec</application>:
224 </para>
225
226<screen role="root"><userinput>cat &gt; /usr/share/polkit-1/actions/org.gnome.gparted.policy &lt;&lt; "EOF"
227<literal>&lt;?xml version="1.0" encoding="UTF-8"?&gt;
228&lt;!DOCTYPE policyconfig PUBLIC
229 "-//freedesktop//DTD PolicyKit Policy Configuration 1.0//EN"
230 "http://www.freedesktop.org/standards/PolicyKit/1/policyconfig.dtd"&gt;
231&lt;policyconfig&gt;
232
233 &lt;action id="org.freedesktop.policykit.pkexec.run-gparted"&gt;
234 &lt;description&gt;Run GParted&lt;/description&gt;
235 &lt;message&gt;Authentication is required to run GParted&lt;/message&gt;
236 &lt;defaults&gt;
237 &lt;allow_any&gt;no&lt;/allow_any&gt;
238 &lt;allow_inactive&gt;no&lt;/allow_inactive&gt;
239 &lt;allow_active&gt;auth_admin_keep&lt;/allow_active&gt;
240 &lt;/defaults&gt;
241 &lt;annotate key="org.freedesktop.policykit.exec.path"&gt;/usr/bin/gparted&lt;/annotate&gt;
242 &lt;annotate key="org.freedesktop.policykit.exec.allow_gui"&gt;true&lt;/annotate&gt;
243 &lt;/action&gt;
244
245&lt;/policyconfig&gt;</literal>
246EOF
247chmod -v 0644 /usr/share/polkit-1/actions/org.gnome.gparted.policy</userinput></screen>
248
249 <para>
250 Now, clicking in the menu item for Gparted, a dialog appears in the
251 screen, asking for the administrator password.</para>
252
253 </sect3>
254-->
255 </sect2>
256
257 <sect2 role="content">
258 <title>Contents</title>
259
260 <segmentedlist>
261 <segtitle>Installed Programs</segtitle>
262 <segtitle>Installed Libraries</segtitle>
263 <segtitle>Installed Directories</segtitle>
264
265 <seglistitem>
266 <seg>
267 gparted, gpartedbin and gparted_polkit (optional)
268 </seg>
269 <seg>
270 None
271 </seg>
272 <seg>
273 None
274 </seg>
275 </seglistitem>
276 </segmentedlist>
277
278 <variablelist>
279 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
280 <?dbfo list-presentation="list"?>
281 <?dbhtml list-presentation="table"?>
282
283 <varlistentry id="gparted-prog">
284 <term><command>gparted</command></term>
285 <listitem>
286 <para>
287 is a shell script which sets up the environment before calling
288 <command>gpartedbin</command>.
289 </para>
290 <indexterm zone="gparted gparted-prog">
291 <primary sortas="b-gparted">gparted</primary>
292 </indexterm>
293 </listitem>
294 </varlistentry>
295
296 <varlistentry id="gpartedbin">
297 <term><command>gpartedbin</command></term>
298 <listitem>
299 <para>
300 is the Gparted binary.
301 </para>
302 <indexterm zone="gparted gpartedbin">
303 <primary sortas="b-gpartedbin">gpartedbin</primary>
304 </indexterm>
305 </listitem>
306 </varlistentry>
307
308 <varlistentry id="gparted_polkit">
309 <term><command>gparted_polkit</command></term>
310 <listitem>
311 <para>
312 is an optional script which can be used to run gparted with polkit,
313 from a menu.
314 </para>
315 <indexterm zone="gparted gparted_polkit">
316 <primary sortas="b-gparted_polkit">gparted_polkit</primary>
317 </indexterm>
318 </listitem>
319 </varlistentry>
320
321 </variablelist>
322
323 </sect2>
324
325</sect1>
Note: See TracBrowser for help on using the repository browser.