source: xsoft/other/gparted.xml@ 9014137

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 9014137 was 9014137, checked in by Bruce Dubbs <bdubbs@…>, 2 years ago

Archive consolkit.
Update to gparted-1.0.0.

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

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