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

11.0 qt5new trunk
Last change on this file since 7fef166 was 7fef166, checked in by Bruce Dubbs <bdubbs@…>, 5 months ago

Update to gparted-1.3.0.

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