source: xsoft/other/gparted.xml@ a4632635

10.0 10.1 11.0 11.1 7.10 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus nosym perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since a4632635 was a4632635, checked in by Pierre Labastie <pieere@…>, 7 years ago

typo

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