source: xsoft/other/gparted.xml@ 11eb3ae5

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 11eb3ae5 was 11eb3ae5, checked in by Douglas R. Reno <renodr@…>, 17 months ago

Update to llvm-10.0.1
Update to libseccomp-2.5.0
Update to pipewire-0.3.7
Minor text tweaks

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

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