source: xsoft/other/gparted.xml@ 7aa91c69

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 7aa91c69 was 7aa91c69, checked in by Douglas R. Reno <renodr@…>, 9 months ago

Update to feh-3.6.3
Update to autofs-5.1.7
Update to talloc-2.3.2
Update to gparted-1.2.0
Update to xarchiver-0.5.4.17
Update to asciidoc-9.0.5
Update to util-macros-1.19.2
Update to libXt-1.2.1 (Xorg Library)
Update to wireshark-3.4.3 (Security Update)

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

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